將目前使用 (Cloud-to-cloud) 的裝置轉換為 Matter 時,您必須確保裝置在透過非 Matter API 連線時,在 Matter 上使用的 ID。這樣可確保裝置在使用者 Google Home Graph 上只會顯示一次。Cloud-to-cloud 裝置只有在與 Google Home app (GHA) 中的特定結構 (住家) 相關聯時,才能刪除重複的裝置。
SYNC
規定
為避免 Home Graph 中出現重複項目,合作夥伴的雲端必須在向 Google 的 SYNC
回應中,為每部裝置傳送三個新的字串欄位。這些欄位必須符合 Matter 裝置基本資訊叢集中定義的屬性。此外,SYNC
回應必須包含 roomHint
:
matterUniqueId
:字串格式的UniqueId
屬性。matterOriginalVendorId
:VendorId
屬性,採十六進位字串格式。matterOriginalProductId
:ProductId
屬性,採十六進位字串格式。roomHint
- 這部裝置所在的房間。
如需 SYNC
等意圖的說明文件,請參閱「雲端至雲端入門」。
下方的 SYNC
回應範例顯示如何使用三個新欄位和 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
上執行簡化作業。