Deduplikacja urządzeń w chmurze i urządzeń Matter

Podczas konwertowania urządzenia, które obecnie korzysta z Cloud-to-cloud, na Matter musisz zadbać o to, aby urządzenie używało tego samego identyfikatora w Matter, co w przypadku połączenia za pomocą interfejsów API innych niż Matter. Dzięki temu urządzenie będzie wyświetlane na karcie Google Home Graph użytkownika tylko raz. Cloud-to-cloud urządzenia można zduplikować tylko wtedy, gdy są one powiązane z określoną strukturą (domem) w Google Home app (GHA).

Wymagania SYNC

Aby uniknąć duplikatów w Home Graph, chmura partnera musi wysyłać do Google 3 nowe pola tekstowe dla każdego urządzenia w odpowiedzi SYNC. Te pola muszą odpowiadać atrybutom zdefiniowanym w klastrze informacji podstawowych dla urządzenia Matter. Dodatkowo odpowiedzi SYNC muszą zawierać roomHint:

  1. matterUniqueId – atrybut UniqueId w formacie ciągu znaków.
  2. matterOriginalVendorId – atrybut VendorId w formacie ciągu szesnastkowego.
  3. matterOriginalProductId – atrybut ProductId w formacie ciągu szesnastkowego.
  4. roomHint – pomieszczenie, w którym znajduje się to urządzenie.

Dokumentację dotyczącą intencji, np. SYNC, znajdziesz w podstawowych informacjach o integracji usług w chmurze.

Przykładowa odpowiedź SYNC poniżej pokazuje użycie 3 nowych pól oraz roomHint:

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

Gdy urządzenie, które wcześniej działało w sieci domowej użytkownika przy użyciu chmury partnera, zostanie przekształcone w urządzenie Matter, chmura partnera musi natychmiast wysłać do Google sygnał REQUEST SYNC, aby jak najszybciej zaktualizować te pola i uniknąć opóźnionego usuwania duplikatów.

Po podaniu tych ciągów znaków dla danego urządzenia nie powinny się one zmieniać. Identyfikator unikalny powinien się zmieniać tylko po przywróceniu ustawień fabrycznych, co sprawia, że urządzenie jest widoczne dla wszystkich integracji jako zupełnie nowe.

Automatyczne przypisywanie struktury

Nie ma gwarancji, że urządzenia Cloud-to-cloud będą automatycznie powiązane z określoną strukturą. W sytuacjach, w których automatyczne przypisanie struktury nie jest możliwe, odpowiednie Cloud-to-cloudurządzenia będą wyświetlane w specjalnej sekcji na ekranie głównym GHA, w sekcji Połączone z Tobą, poza pomieszczeniami. Takie urządzenia nie zostaną zduplikowane. Urządzenia nie będą automatycznie umieszczane w strukturze, jeśli użytkownik ma w GHA więcej niż jedną strukturę (dom). Urządzenia mogą nie być strukturyzowane z innych powodów.

Jeśli użytkownik ręcznie przeniesie urządzenie Cloud-to-cloud, w przypadku którego automatyczne przypisanie do struktury nie powiodło się, do struktury, podczas następnego SYNC może nastąpić deduplikacja, o ile odpowiedzi SYNC spełniają wymagania podane w wymaganiach dotyczących synchronizacji.