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 demikian, perangkat hanya akan muncul satu kali di Google Home Graph pengguna.Google Home Graph Perangkat Cloud-to-cloud hanya dapat di-deduplikasi jika dikaitkan dengan struktur (rumah) tertentu di Google Home app (GHA).

Persyaratan SYNC

Untuk menghindari duplikat muncul di Home Graph, cloud partner harus mengirimkan 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, respons SYNC harus berisi roomHint:

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

Dokumentasi tentang intent seperti SYNC dapat ditemukan di panduan Cloud-to-Cloud.

Contoh respons SYNC di bawah 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",
          }
        ]
      }
    ]
  }
}

Saat 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 guna menghindari deduplikasi yang terlambat.

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

Asosiasi struktur otomatis

Perangkat Cloud-to-cloud tidak dijamin akan dikaitkan secara otomatis dengan struktur tertentu. Jika asosiasi struktur otomatis tidak memungkinkan, perangkat Cloud-to-cloud yang relevan akan muncul di bagian khusus layar utama GHA, di bagian berjudul **Ditautkan ke Anda** , di luar ruangan mana pun.Cloud-to-cloudGHA Perangkat tersebut tidak akan di-deduplikasi. 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 asosiasi struktur otomatis ke dalam struktur secara manual, deduplikasi dapat terjadi pada SYNC berikutnya selama respons SYNC sesuai dengan persyaratan yang tercantum dalam persyaratan SYNC.