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

現在（Cloud-to-cloud）を使用しているデバイスを Matter に変換する場合は、デバイスが Matter 以外の API を使用して接続したときと同じ ID を 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 - 16 進数文字列形式の VendorId 属性。
  3. matterOriginalProductId - 16 進数文字列形式の ProductId 属性。
  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 のメイン画面の専用セクション（部屋の外にある [リンク済みのもの]）に表示されます。このようなデバイスは重複除去されません。GHA に複数のストラクチャ（家）が設定されている場合、デバイスはストラクチャに自動的に配置されません。その他の理由でデバイスを構造化できない場合があります。

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