Ş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:
matterUniqueId
: Dize biçimindekiUniqueId
özelliği.matterOriginalVendorId
: Onaltılık dize biçimindekiVendorId
özelliği.matterOriginalProductId
: Onaltılık dize biçimindekiProductId
özelliği.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.