Buluttan buluta ve Matter cihazlarını tekilleştirme

Şu anda (Cloud-to-cloud) kullanan bir cihazı Matter'a dönüştürürken cihazın Matter'da Matter olmayan API'ler kullanılarak bağlandığında kullandığı kimliği kullandığından emin olmanız gerekir. Bu işlem, cihazın kullanıcının Google Home Graph'ünde yalnızca bir kez gösterilmesini sağlar. Cloud-to-cloud cihazları yalnızca Google Home app (GHA)'de belirli bir yapıyla (ev) ilişkilendirildiğinde tekilleştirilebilir.

SYNC koşulları

Home Graph'te yinelenen öğelerin görünmesini önlemek için iş ortağının bulutu, Google'a gönderdiği SYNC yanıtında her cihaz için üç yeni dize alanı göndermelidir. Bu alanlar, Matter cihaz için Temel Bilgi Kümesi'nde tanımlanan özelliklerle eşleşmelidir. Ayrıca, SYNC yanıtları roomHint içermelidir:

1. matterUniqueId: Dize biçiminde UniqueId özelliği.
2. matterOriginalVendorId: Onaltılık dize biçiminde VendorId özelliği.
3. matterOriginalProductId: Onaltılık dize biçiminde ProductId özelliği.
4. roomHint: Bu cihazın bulunduğu oda.

SYNC gibi amaçlarla ilgili belgeler Cloud-to-Cloud primer'inde bulunabilir.

Aşağıdaki örnek SYNC yanıtında, roomHint ile birlikte üç yeni alanın kullanımı gösterilmektedir:

{
  "requestId": "ff36a3cc-ec34-11e6-b1a0-64510650abcf",
  "payload": {
    "agentUserId": "1836.15267389",
    "devices": [
      {
        "id": "456",
        "type": "action.devices.types.LIGHT",
        "traits": [
          "action.devices.traits.OnOff",
          "action.devices.traits.Brightness",
          "action.devices.traits.ColorSetting",
        ],
        "willReportState": true,
        "roomHint": "office",
        "deviceInfo": { ... },
        "matterUniqueId": "00112233aabbccddeeff",
        "matterOriginalVendorId": "0xfff1",
        "matterOriginalProductId": "0x1234",
        "otherDeviceIds": [
          {
            "deviceId": "local-device-id",
          }
        ]
      }
    ]
  }
}

Daha önce bir iş ortağının bulutunu kullanarak kullanıcının ev ağında çalışan bir cihaz Matter cihazına dönüştürüldüğünde, iş ortağının bulutunun Google'a derhal REQUEST SYNC göndererek bu alanları en kısa sürede güncellemesi gerekir. Böylece, gecikme yaşanabilir.

Belirli bir cihaz için sağlanan bu dizeler hiçbir zaman değiştirilmemelidir. Benzersiz kimlik yalnızca fabrika ayarlarına sıfırlandığında değişmelidir. Bu da cihazın tüm entegrasyonlara tamamen yeni bir cihaz olarak görünmesini sağlar.

Otomatik yapı ilişkilendirme

Cloud-to-cloud cihazların belirli bir yapıyla otomatik olarak ilişkilendirileceği garanti edilmez. Otomatik yapı ilişkilendirmesinin mümkün olmadığı durumlarda, ilgili Cloud-to-cloud cihazlar GHA'ın ana ekranının Size bağlı başlıklı bölümünde, oda dışında özel bir bölümde görünür. Bu tür cihazlar tekilleştirilmez. Kullanıcının GHA'te birden fazla yapısı (evi) varsa cihazlar otomatik olarak bir yapıya yerleştirilmez. Cihazlar başka nedenlerle yapılandırılamayabilir.

Bir kullanıcı, otomatik yapı ilişkilendirmesi başarısız olan bir Cloud-to-cloud cihazı manuel olarak bir yapıya taşırsa SYNC yanıtları SYNC koşullarında belirtilen koşullara uygun olduğu sürece bir sonraki SYNC'de tekilleştirme yapılabilir.