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

Podczas konwertowania urządzenia, które obecnie korzysta z (Cloud-to-cloud) na Matter, musisz się upewnić, że urządzenie używa w systemie Matter tego samego identyfikatora, którego używa w przypadku połączenia z interfejsami API innych niż Matter. Dzięki temu urządzenie wyświetli się na urządzeniu Google Home Graph użytkownika tylko raz. Duplikowanie Cloud-to-cloud urządzeń można usuwać tylko wtedy, gdy są powiązane z konkretnym obiektem (domem) w Google Home app (GHA).

Wymagania: SYNC

Aby uniknąć wyświetlania duplikatów w usłudze Home Graph, chmura partnera musi wysłać do Google 3 nowe pola ciągu znaków dla każdego urządzenia w odpowiedzi SYNC. Te pola muszą być zgodne z atrybutami zdefiniowanymi w klastrze informacji podstawowych o urządzeniu z Matter. Dodatkowo SYNC odpowiedzi muszą zawierać roomHint:

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

Dokumentację dotyczącą intencji, takich jak SYNC, znajdziesz w narzędziu Cloud-to-Cloud Primeer.

Przykładowa odpowiedź SYNC poniżej pokazuje wykorzystanie 3 nowych pól oraz pola 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, korzystając z chmury partnera, zostanie przekonwertowane na urządzenie Matter, chmura partnera musi natychmiast wysłać do Google REQUEST SYNC, aby jak najszybciej zaktualizować te pola, co pozwoli uniknąć późnej deduplikacji.

Te ciągi nie powinny się zmieniać po ich udostępnieniu na danym urządzeniu. Unikalny identyfikator powinien się zmienić tylko po przywróceniu ustawień fabrycznych, przez co we wszystkich integracjach urządzenie wygląda na zupełnie nowe.

Automatyczne powiązanie domu

Nie ma gwarancji, że urządzenia z Cloud-to-cloud zostaną automatycznie powiązane z konkretną strukturą. Jeśli automatyczne powiązanie z strukturą nie jest możliwe, odpowiednie urządzenia z systemem Cloud-to-cloud będą widoczne poza pokojami w specjalnej sekcji ekranu głównego urządzenia GHA, w sekcji Połączone z Twoim kontem. Duplikaty takich urządzeń nie będą usuwane. 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 być uporządkowane z innych powodów.

Jeśli użytkownik ręcznie przeniesie do struktury urządzenie z Cloud-to-cloud, którego nie udało się automatycznie powiązać struktury, deduplikacja może zostać usunięta w kolejnym kroku SYNC, o ile odpowiedzi SYNC będą zgodne z wymaganiami określonymi w wymaganiach dotyczących SYNC.