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

現在（Cloud-to-cloud）を使用しているデバイスを Matter に変換する場合は、デバイスが Matter 以外の API を使用して接続するときに使用する ID と同じ 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 - VendorId 属性（16 進数の文字列形式）。
  3. matterOriginalProductId - ProductId 属性（16 進数の文字列形式）。
  4. roomHint - このデバイスが設置されている部屋。

SYNC などのインテントのドキュメントは、Cloud-to-Cloud の概要をご覧ください。

次の 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 で重複除去が行われることがあります。