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

Podczas konwertowania urządzenia, które obecnie korzysta z połączenia chmurowego, na urządzenie 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.Cloud-to-cloudMatterMatterMatter Dzięki temu urządzenie będzie wyświetlane tylko raz na wykresie Google Home Google Home Graph. Cloud-to-cloud urządzenia moż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 na Home Graph, chmura partnera musi wysł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 dla 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 chmurowego.

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ąć opóźnionej 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ą

Nie ma gwarancji, że urządzenia Cloud-to-cloud 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 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 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 SYNC.