Saat mengonversi perangkat yang saat ini menggunakan (Cloud-to-cloud) ke Matter, Anda harus memastikan bahwa perangkat menggunakan ID yang sama pada Matter dengan yang digunakannya saat terhubung menggunakan API non-Matter. Tindakan ini akan memastikan perangkat hanya ditampilkan sekali di Google Home Graph pengguna. Duplikat perangkat Cloud-to-cloud hanya dapat dihapus jika dikaitkan dengan struktur tertentu (rumah) di Google Home app (GHA).
Persyaratan SYNC
Agar duplikat tidak muncul di Home Graph, cloud partner harus mengirimkan tiga kolom string baru untuk setiap perangkat sebagai respons SYNC
ke Google. Kolom ini harus cocok dengan atribut yang ditentukan di Cluster Basic Information untuk perangkat Matter. Selain itu, respons
SYNC
harus berisi roomHint
:
matterUniqueId
— AtributUniqueId
dalam format string.matterOriginalVendorId
— AtributVendorId
, dalam format string heksadesimal.matterOriginalProductId
— AtributProductId
, dalam format string heksadesimal.roomHint
- Ruangan tempat perangkat ini berada.
Dokumentasi tentang intent seperti
SYNC
dapat ditemukan di primer Cloud-to-Cloud.
Contoh respons SYNC
di bawah ini menunjukkan
penggunaan tiga kolom baru serta roomHint
:
SYNC
Respons
{ "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", } ] } ] } }
Jika perangkat yang sebelumnya beroperasi di jaringan rumah pengguna menggunakan
cloud partner diubah menjadi perangkat Matter, cloud partner harus segera mengirimkan
REQUEST SYNC
ke Google untuk memperbarui kolom ini secepat mungkin agar penghapusan duplikat
tidak terlambat.
String ini tidak boleh berubah setelah disediakan untuk perangkat tertentu. ID Unik hanya boleh diubah saat reset ke setelan pabrik, yang membuat perangkat terlihat oleh semua integrasi sebagai perangkat yang benar-benar baru.
Pengaitan struktur otomatis
Perangkat Cloud-to-cloud tidak dijamin secara otomatis dikaitkan dengan struktur tertentu. Jika pengaitan struktur otomatis tidak memungkinkan, perangkat Cloud-to-cloud yang relevan akan muncul di bagian khusus layar utama GHA, di bagian berjudul Ditautkan kepada Anda, di luar ruangan mana pun. Perangkat tersebut tidak akan dihapus duplikatnya. Perangkat tidak akan ditempatkan secara otomatis dalam struktur jika pengguna memiliki lebih dari satu struktur (rumah) di GHA. Perangkat mungkin gagal distrukturkan karena alasan lain.
Jika pengguna memindahkan perangkat Cloud-to-cloud yang gagal dalam pengaitan struktur
otomatis ke dalam struktur secara manual, penghapusan duplikat dapat terjadi
di SYNC
berikutnya selama respons SYNC
sesuai dengan persyaratan yang disebutkan
dalam persyaratan SYNC.