Buluttan buluta ve Matter cihazlarını tekilleştirme

Şu anda (Cloud-to-cloud) kullanan bir cihazı Matter birimine dönüştürürken cihazın, Matter dışı API'leri kullanarak bağlanırken kullandığı kimliğin Matter üzerinde kullanıldığı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 cihaz yalnızca Google Home app (GHA) içindeki belirli bir yapıyla (ev) ilişkili olduklarında tekilleştirilebilir.

SYNC gereksinimleri

Yinelemelerin Home Graph içinde görünmesini önlemek amacıyla iş ortağının bulutu, Google'a gönderilen 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ç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 niyetlerle ilgili belgeler Cloud-to-Cloud başlangıç kılavuzunda bulunabilir.

Aşağıdaki örnek SYNC yanıtında roomHint ile üç yeni alanın 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 kullanıcının ev ağında bir iş ortağının bulutunu kullanarak çalışan bir cihaz Matter cihaza dönüştürüldüğünde, iş ortağının bulutu, geç tekilleştirmeyi önlemek amacıyla bu alanların mümkün olan en kısa sürede güncellenmesi için Google'a hemen bir REQUEST SYNC göndermelidir.

Bu dizeler, belirli bir cihaz için sağlandıktan sonra asla değişmemelidir. Benzersiz kimlik yalnızca fabrika ayarlarına sıfırlandığında değişir, bu da cihazın tüm entegrasyonlarda tamamen yeni bir cihaz olarak görünmesini sağlar.

Otomatik yapı ilişkilendirmesi

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ı, tüm odaların dışında GHA ana ekranının özel bir bölümünde, Size bağlı başlıklı bir bölümde gösterilir. Bu tür cihazlar tekilleştirilmez. Kullanıcının GHA içinde birden fazla yapısı (ev) olduğunda cihazlar otomatik olarak bir yapıya yerleştirilmez. Cihazlar başka nedenlerle yapılandırılmayabilir.

Bir kullanıcı, otomatik yapı ilişkilendirmesinde başarısız olan bir Cloud-to-cloud cihazı manuel olarak bir yapıya taşırsa SYNC yanıtları, SENKRONİZASYON gereksinimlerinde belirtilen gereksinimlere uyduğu sürece sonraki SYNC tarihinde tekilleştirme işlemi yapılabilir.