クラウド間および Matter デバイスの重複除去

現在 （Cloud-to-cloud）を使用しているデバイスを Matter に変換する場合は、デバイスが Matter 以外の API を使用して接続するときと同じ ID をデバイスが Matter で使用するようにする必要があります。Matterこれにより、デバイスはユーザーの Google Home Graph に 1 回だけ表示されます。Cloud-to-cloud デバイスの重複排除は、 特定の構造（家）に関連付けられている場合にのみ可能です（Google Home app (GHA)）。

SYNC の要件

Home Graph に重複が表示されないようにするには、パートナーの クラウドが SYNC レスポンスでデバイスごとに 3 つの新しい文字列フィールドを Google に送信する必要があります。これらのフィールドは、Matter デバイスの基本 情報クラスタで定義された属性と一致している必要があります。また、SYNC レスポンスには roomHint が含まれている必要があります。

  1. matterUniqueId \- 基本 情報クラスタの UniqueId 属性（文字列形式）。
  2. matterOriginalVendorId \- 基本情報クラスタの VendorId 属性（16 進文字列 形式）。
  3. matterOriginalProductId \- 基本情報クラスタの ProductId 属性（16 進文字列 形式）。
  4. roomHint - このデバイスが設置されている部屋。

SYNC などのインテントに関するドキュメントは、クラウド間入門ガイドをご覧ください。

次の SYNC レスポンスの例では、 3 つの新しいフィールドと roomHint の使用方法を示しています。

SYNC レスポンス 
{
  "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",
          }
        ]
      }
    ]
  }
}

パートナーのクラウドを使用してユーザーのホーム ネットワークで動作していたデバイスが Matter デバイスに変換された場合、 パートナーのクラウドは、重複排除の遅延を避けるために、これらのフィールドをできるだけ早く更新するよう REQUEST SYNC を Google に送信する必要があります。

特定のデバイスに指定された文字列は、変更しないでください。一意の ID は、出荷時の設定にリセットされた場合にのみ変更されます。これにより、デバイスはすべての統合で完全に新しいデバイスとして表示されます。

自動構造関連付け

Cloud-to-cloud デバイスが特定の構造に 自動的に 関連付けられるとは限りません。自動構造関連付けができない場合、関連する Cloud-to-cloudデバイスは、 GHAのメイン画面の専用セクションに、部屋の外の[Linked to you]というタイトルのセクションの下に表示されます。このようなデバイスは重複排除されません。ユーザーが複数の 構造（家）をGHAに持っている場合、デバイスは自動的に構造に配置されません。他の理由でデバイスを構造化できない場合があります。

自動構造関連付けに失敗したCloud-to-cloudデバイスをユーザーが手動で構造に移動した場合、SYNCレスポンスがSYNC requirementsの要件に記載されている要件に準拠している限り、次のSYNCで重複除去が行われることがあります。