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

Podczas konwertowania urządzenia, które obecnie korzysta z połączenia typu Cloud-to-cloud) na Matter, musisz się upewnić że używa ono 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 tylko raz w grafie Google Home użytkownika Google Home Graph. Urządzenia Cloud-to-cloudmożna deduplikować tylko wtedy, gdy są one powiązane z konkretną strukturą (domem) w Google Home app (GHA).

Wymagania dotyczące 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 SYNC odpowiedzi. Te pola muszą odpowiadać atrybutom zdefiniowanym w klastrze informacji podstawowych urządzenia Matter. Dodatkowo odpowiedzi SYNC muszą zawierać roomHint:

1. matterUniqueId – atrybut UniqueId w formacie tekstowym z klastra informacji podstawowych.
2. matterOriginalVendorId – atrybut VendorId w formacie szesnastkowym z klastra informacji podstawowych.
3. matterOriginalProductId – atrybut ProductId w formacie szesnastkowym z klastra informacji podstawowych.
4. roomHint – pokój, w którym znajduje się to urządzenie.

Dokumentację dotyczącą intencji, takich jak SYNC , znajdziesz w przewodniku dotyczącym połączenia typu chmura-chmura.

Poniższy przykład odpowiedzi SYNC pokazuje użycie 3 nowych pól oraz roomHint:

{
  "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 za pomocą chmury partnera, zostanie przekonwertowane na urządzenie Matter, chmura partnera musi natychmiast wysłać do Google REQUEST SYNC aby jak najszybciej zaktualizować te pola i uniknąć późnej deduplikacji.

Te ciągi znaków nie powinny się zmieniać po podaniu ich dla danego urządzenia. Unikalny identyfikator powinien się zmieniać tylko po przywróceniu ustawień fabrycznych, co sprawia, że urządzenie jest widoczne dla wszystkich integracji jako zupełnie nowe.

Automatyczne powiązanie ze strukturą

Cloud-to-cloud urządzenia nie mają gwarancji, że będą automatycznie powiązane z konkretną strukturą. W sytuacjach, w których automatyczne powiązanie ze strukturą nie jest możliwe, odpowiednie Cloud-to-cloud urządzenia będą wyświetlane w specjalnej sekcji na ekranie głównym aplikacji GHA, w sekcji zatytułowanej Połączone z Tobą, poza pokojami. Takie urządzenia nie będą deduplikowane. Urządzenia nie będą automatycznie umieszczane w strukturze, jeśli użytkownik ma więcej niż 1 strukturę (dom) w aplikacji GHA. Urządzenia mogą nie być strukturyzowane z innych powodów.

Jeśli użytkownik ręcznie przeniesie urządzenie typu Cloud-to-cloud, które nie zostało automatycznie powiązane ze strukturą, do struktury, deduplikacja może nastąpić podczas następnej synchronizacji SYNC, o ile odpowiedzi SYNC będą zgodne z wymaganiami wymienionymi w sekcji Wymagania dotyczące synchronizacji.