Buluttan buluta ve Matter cihazlarını tekilleştirme

Şu anda (Cloud-to-cloud) kullanan bir cihazı Matter'e dönüştürürken cihazın Matter'de, Matter olmayan API'ler kullanılarak bağlandığında kullandığı 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)'da belirli bir yapıyla (ev) ilişkilendirildiklerinde tekilleştirilebilir.

SYNC gereksinimleri

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

  1. matterUniqueId: Temel Bilgiler kümesindeki dize biçiminde olan UniqueId özelliği.
  2. matterOriginalVendorId: Temel Bilgiler kümesinden onaltılık dize biçimindeki VendorId özelliği.
  3. matterOriginalProductId: Temel Bilgiler kümesinden onaltılık dize biçimindeki ProductId özelliği.
  4. roomHint: Bu cihazın bulunduğu oda.

SYNC gibi intent'lerle ilgili dokümanları Cloud-to-Cloud temel bilgiler sayfasında bulabilirsiniz.

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

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 iş ortağının bulutu, geç tekilleştirmeyi önlemek için bu alanları mümkün olan en kısa sürede güncellemek üzere 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ırlama işleminde değişmelidir. Bu işlem, cihazın tüm entegrasyonlara 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ı, GHA ana ekranının özel bir bölümünde, Sizinle bağlantılı başlıklı bir bölümün altında, herhangi bir odanın dışında görünür. Bu tür cihazlar tekilleştirilmez. Kullanıcının GHA uygulamasında birden fazla yapısı (evi) varsa cihazlar otomatik olarak bir yapıya yerleştirilmez. Cihazlar başka nedenlerle yapılandırılamayabilir.

Kullanıcı, otomatik yapı ilişkilendirmesi başarısız olan bir Cloud-to-cloud cihazını manuel olarak bir yapıya taşırsa SYNC yanıtları SYNC gereksinimleri bölümünde belirtilen şartlara uygun olduğu sürece bir sonraki SYNC işleminde tekilleştirme gerçekleşebilir.