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'sinde 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çimindeki 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 intent'lerle ilgili dokümanları Cloud'dan Cloud'a giriş belgesinde bulabilirsiniz.

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

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şir. Bu durumda cihaz, tüm entegrasyonlarda tamamen yeni bir cihaz olarak görünür.

Otomatik yapı ilişkilendirme

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 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.