Penghapusan duplikat perangkat Cloud-to-cloud dan Matter

Saat mengonversi perangkat yang saat ini menggunakan (Cloud-to-cloud) ke Matter, Anda harus memastikan bahwa perangkat menggunakan ID yang sama di Matter seperti yang digunakan saat terhubung menggunakan API non-Matter. Dengan melakukannya, Anda dapat yang hanya ditampilkan perangkat satu kali pada Google Home Graph pengguna. Perangkat Cloud-to-cloud hanya dapat dihapus duplikatnya jika dikaitkan dengan struktur tertentu (rumah) di Google Home app (GHA).

Persyaratan SYNC

Untuk menghindari duplikat yang muncul di Home Graph, cloud partner harus mengirim tiga kolom string baru untuk setiap perangkat dalam respons SYNC ke Google. Kolom ini harus cocok dengan atribut yang ditentukan dalam Cluster Informasi Dasar untuk perangkat Matter. Selain itu, SYNC respons harus berisi roomHint:

  1. matterUniqueId — Atribut UniqueId dalam format string.
  2. matterOriginalVendorId — Atribut VendorId, dalam string heksadesimal format font.
  3. matterOriginalProductId — Atribut ProductId, dalam format string heksadesimal.
  4. roomHint - Ruangan tempat perangkat ini berada.

Dokumentasi tentang intent seperti SYNC dapat ditemukan di Pengantar Cloud-ke-Cloud.

Contoh respons SYNC di bawah menunjukkan penggunaan tiga kolom baru serta roomHint:

Respons SYNC 
{
  "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",
          }
        ]
      }
    ]
  }
}

Ketika perangkat yang sebelumnya beroperasi di jaringan rumah pengguna menggunakan cloud partner dikonversi menjadi perangkat Matter, cloud partner harus segera mengirimkan REQUEST SYNC ke Google untuk memperbarui kolom ini secepat mungkin untuk menghindari keterlambatan penghapusan duplikat.

String ini tidak boleh berubah setelah disediakan untuk perangkat tertentu. Tujuan ID unik hanya boleh berubah saat reset ke setelan pabrik, yang membuat perangkat muncul ke semua integrasi sebagai perangkat yang benar-benar baru.

Pengaitan struktur otomatis

Perangkat Cloud-to-cloud tidak dijamin akan otomatis dikaitkan dengan struktur tertentu. Jika asosiasi struktur otomatis tidak memungkinkan, perangkat Cloud-to-cloud yang relevan akan muncul di bagian khusus di layar utama GHA, di bagian berjudul Ditautkan ke Anda, di luar ruangan mana pun. Duplikat perangkat tersebut tidak akan dihapus. Perangkat akan tidak ditempatkan secara otomatis pada suatu struktur ketika pengguna memiliki lebih dari satu (rumah) di GHA. Perangkat mungkin gagal terstruktur karena alasan lain.

Jika pengguna memindahkan perangkat Cloud-to-cloud yang gagal mengaitkan struktur otomatis ke struktur secara manual, penghapusan duplikat dapat dilakukan pada SYNC berikutnya selama respons SYNC sesuai dengan persyaratan yang tercantum dalam persyaratan SYNC.