Buluttan buluta ve Matter cihazlarını tekilleştirme

Şu anda (Cloud-to-cloud) kullanılan bir cihazı Matter biçimine dönüştürürken cihazın, Matter olmayan API'ler kullanılarak bağlandığında Matter ile aynı kimliği kullandığından emin olmanız gerekir. Böylece cihaz, kullanıcının Google Home Graph cihazında yalnızca bir kez gösterilir. Cloud-to-cloud cihazlar yalnızca Google Home app (GHA) içindeki belirli bir yapıyla (ev) ilişkilendirildiklerinde tekilleştirilebilir.

SYNC gereksinimleri

Yinelenen iş ortaklarının Home Graph öğesinde görünmesini önlemek amacıyla, iş ortağının bulutunun Google'a SYNC yanıtında her cihaz için üç yeni dize alanı göndermesi gerekir. Bu alanlar, Matter cihazının 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 belgelere Cloud-Cloud Primer'da ulaşabilirsiniz.

Aşağıdaki örnek SYNC yanıtında üç yeni alanın yanı sıra roomHint öğesinin de kullanımı gösterilmektedir:

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ç gecikmeyi önlemek için bu alanları mümkün olan en kısa sürede güncellemek amacıyla Google'a hemen bir REQUEST SYNC göndermelidir.

Bu dizeler belirli bir cihaz için sağlandıktan sonra hiçbir zaman değişmemelidir. Benzersiz Kimlik yalnızca fabrika ayarlarına sıfırlandığında değişmelidir. Bu sayede, cihaz tüm entegrasyonlarda tamamen yeni bir cihaz olarak görünür.

Otomatik yapı ilişkilendirmesi

Cloud-to-cloud cihazların belirli bir yapıyla otomatik olarak ilişkilendirileceği garanti edilmez. Otomatik yapı ilişkilendirmenin mümkün olmadığı durumlarda, ilgili Cloud-to-cloud cihazlar herhangi bir odanın dışında Ana ekranınız başlıklı bir bölümün altında GHA ana ekranının özel bir bölümünde görünür. Bu tür cihazlar tekilleştirilmeyecek. Kullanıcı, GHA içindeki birden fazla yapıya (ana sayfa) sahip olduğunda cihazlar otomatik olarak bir yapıya yerleştirilmez. Cihazlar başka nedenlerle yapılandırılamayabilir.

Bir kullanıcı, otomatik yapı ilişkilendirmesini manuel olarak bir yapıya dönüştüremeyen bir Cloud-to-cloud cihazını taşırsa SYNC yanıtları SYNC koşullarında belirtilen şartlara uygun olduğu sürece tekilleştirme bir sonraki SYNC tarihinde gerçekleştirilebilir.