現在 (Cloud-to-cloud)を使用しているデバイスを Matter に変換する場合は、デバイスが Matter 以外の API を使用して接続するときと同じ ID をデバイスが Matter で使用するようにする必要があります。Matterこれにより、デバイスはユーザーの Google Home Graph に一度だけ表示されます。Cloud-to-cloud デバイスの重複排除は、 特定の構造(家)に関連付けられている場合にのみ可能です(Google Home app (GHA))。
SYNC の要件
重複が Home Graph に表示されないようにするには、パートナーの
クラウドで、
SYNC
レスポンス内の各デバイスに対して 3 つの新しい文字列フィールドを Google に送信する必要があります。これらのフィールドは、Matter デバイスの基本
情報クラスタで定義されている属性と一致している必要があります。また、SYNC
レスポンスには roomHint が含まれている必要があります。
matterUniqueId\- 基本 情報クラスタのUniqueId属性(文字列形式)。matterOriginalVendorId\- 基本情報クラスタのVendorId属性(16 進文字列 形式)。matterOriginalProductId\- 基本情報クラスタのProductId属性(16 進文字列 形式)。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に持っている場合、デバイスは自動的に構造に配置されません。デバイスが構造化されない原因は他にもあります。