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

現在(Cloud-to-cloud)を使用しているデバイスを変換する場合 Matter に設定するには、 デバイスが使用している Matter の ID と同じ ID を使用していること Matter 以外の API を使用して接続されている場合。これにより、 デバイスがユーザーの Google Home Graph に 1 回だけ表示されることを確認します。 Cloud-to-cloud デバイスの重複除去は、Google Home app (GHA) 内の特定のストラクチャ(家)に関連付けられている場合にのみ行えます。

SYNC の要件

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

  1. matterUniqueId - 文字列形式の UniqueId 属性。
  2. matterOriginalVendorId - VendorId 属性(16 進数の文字列形式)。
  3. matterOriginalProductId - ProductId 属性(16 進数の文字列形式)。
  4. roomHint - このデバイスがある部屋。

次のようなインテントに関するドキュメント SYNC Cloud-to-Cloud primer をご覧ください。

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

<ph type="x-smartling-placeholder">
</ph>
<ph type="x-smartling-placeholder">
</ph> 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 Cloud の REQUEST SYNC 遅延を避けるために、このフィールドをできるだけ早く Google に 説明しました

これらの文字列は、特定のデバイスに提供された後は変更しないでください。「 一意の ID は出荷時設定へのリセット時にのみ変更され、デバイスが表示される まったく新しいデバイスとして すべての統合に適用されます

構造の自動関連付け

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

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