クラウド間および 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 デバイスに変換されると、パートナーのクラウドは、重複除去の遅延を避けるために、これらのフィールドをできるだけ早く更新するよう、Google に REQUEST SYNC を直ちに送信する必要があります。

これらの文字列は、特定のデバイスに提供された後は変更されることはありません。Unique ID は初期化でのみ変更されるため、デバイスはすべてのインテグレーションでまったく新しいデバイスとして認識されます。

構造の自動関連付け

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

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