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 Google Home Graph użytkownika tylko raz. Cloud-to-cloud urządzenia można deduplikować 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ą być zgodne z atrybutami zdefiniowanymi w klastrze informacji podstawowych dla urządzenia Matter. Dodatkowo odpowiedzi SYNC muszą zawierać roomHint:

  1. matterUniqueId – atrybut UniqueId w formacie ciągu tekstowego z klastra Informacje podstawowe.
  2. matterOriginalVendorId – atrybut VendorId w formacie szesnastkowym z klastra Informacje podstawowe.
  3. matterOriginalProductId – atrybut ProductId w formacie szesnastkowym z klastra Informacje podstawowe.
  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 należy ich zmieniać. Identyfikator unikalny powinien się zmieniać tylko po przywróceniu ustawień fabrycznych, co sprawia, że urządzenie jest postrzegane przez wszystkie integracje 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 GHApod tytułem 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ż 1 strukturę (dom). Urządzenia mogą nie zostać skonfigurowane z innych powodów.

Jeśli użytkownik ręcznie przeniesie urządzenie Cloud-to-cloud, które nie zostało automatycznie powiązane ze strukturą, do struktury, podczas następnego SYNC może nastąpić deduplikacja, o ile odpowiedzi SYNC spełniają wymagania podane w wymaganiach dotyczących synchronizacji.