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

Podczas konwertowania urządzenia, na którym obecnie używasz tej formy płatności (Cloud-to-cloud) do Matter, musisz upewnić się, urządzenie używa identyfikatora na platformie Matter takiego samego identyfikatora, którego używa po połączeniu za pomocą interfejsów API innych niż Matter. Dzięki temu będziesz mieć pewność, że dane urządzenie wyświetli się tylko raz na urządzeniu Google Home Graph użytkownika. Duplikaty urządzeń na Cloud-to-cloud urządzeniach można usunąć tylko wtedy, gdy są powiązane z konkretnym obiektem (domem) w budynku Google Home app (GHA).

Wymagania: SYNC

Aby w Home Graph nie wyświetlały się duplikaty, musi wysłać 3 nowe pola ciągu znaków dla każdego urządzenia w SYNC. odpowiedź do Google. Te pola muszą być zgodne z atrybutami zdefiniowanymi w Klaster informacji o urządzeniu z systemem Matter. Dodatkowo: SYNC odpowiedź musi zawierać roomHint:

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

Dokumentacja intencji takich jak: SYNC można znaleźć w narzędziu Cloud-to-Cloud Primeer.

Przykładowa odpowiedź SYNC poniżej pokazuje zastosowanie trzech 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, chmura partnera jest konwertowana na urządzenie Matter, chmura partnera musi natychmiast wysłać REQUEST SYNC. do Google, aby jak najszybciej zaktualizować te pola i uniknąć spóźnienia deduplikacji.

Te ciągi nie powinny się zmieniać po ich udostępnieniu na danym urządzeniu. Unikalny identyfikator powinien zmienić się tylko po przywróceniu ustawień fabrycznych, co sprawia, że urządzenie jest widoczne do wszystkich integracji jako zupełnie nowe urządzenie.

Automatyczne powiązanie domu

Nie ma gwarancji, że Cloud-to-cloud urządzeń nie będzie automatycznie powiązane z konkretną strukturą. W sytuacjach, gdy automatyczne powiązanie ze strukturą nie jest możliwe, odpowiednie Cloud-to-cloud urządzeń będzie widocznych w specjalnej sekcji Ekran główny użytkownika GHA w sekcji Powiązane z poza Twoimi pokojami. Duplikaty takich urządzeń nie będą usuwane. Urządzenia będą nie mogą być automatycznie umieszczane w strukturze, jeśli użytkownik ma więcej niż jeden dom (dom) w: GHA. Urządzenia mogą nie zostać uporządkowane z innych powodów.

Jeśli użytkownik przeniesie urządzenie z Cloud-to-cloud, które nie powiodło się automatycznie ręcznie utworzyć powiązanie z strukturą, może dojść do deduplikacji w następnym SYNC, o ile odpowiedzi (SYNC) są zgodne z wymaganiami w sekcji Wymagania SYNC.