Buluttan buluta ve Matter cihazlarını tekilleştirme

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

SYNC koşulları

Home Graph üzerinde yinelenen öğelerin görünmesini önlemek için iş ortağının bulutu, Google'a verilen SYNC yanıtındaki 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çimindeki UniqueId özelliği.
  2. matterOriginalVendorId: Onaltılık dize biçimindeki VendorId özelliği.
  3. matterOriginalProductId: Onaltılık dize biçimindeki ProductId özelliği.
  4. roomHint - Bu cihazın bulunduğu oda.

SYNC gibi amaçlarla ilgili dokümanları Cloud-to-Cloud primer'da bulabilirsiniz.

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

SYNC Yanıt 
{
  "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, geç tekilleştirmeyi önlemek için iş ortağının bulutu bu alanları mümkün olduğunca hızlı bir şekilde güncellemek üzere Google'a hemen bir REQUEST SYNC göndermelidir.

Bu dizeler, belirli bir cihaz için sağlandıktan sonra asla değişmemelidir. Unique ID yalnızca fabrika ayarlarına sıfırlama işleminde değişmelidir. Bu durumda cihaz, tüm entegrasyonlarda tamamen yeni bir cihaz olarak görünür.

Otomatik yapı ilişkilendirmesi

Cloud-to-cloud cihazlarını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 özel bir bölümünde, Size bağlı başlıklı bir bölümün altında, odaların dışında görünür. Bu tür cihazlar yinelenen öğe olarak değerlendirilmez. Kullanıcının GHA içinde birden fazla yapı (ev) varsa cihazlar otomatik olarak bir yapıya yerleştirilmez. Cihazlar başka nedenlerden dolayı yapılandırılmayabilir.

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ı SENKRONİZASYON GEREKLİLİKLERİ'nde belirtilen koşullara uyduğu sürece sonraki SYNC'de tekilleştirme işlemi gerçekleşebilir.