เมื่อแปลงอุปกรณ์ที่ใช้ (Cloud-to-cloud) เป็น Matter คุณต้องตรวจสอบว่าอุปกรณ์ใช้รหัสเดียวกับ Matter ที่อุปกรณ์ใช้เมื่อเชื่อมต่อโดยใช้ API ที่ไม่ใช่ Matter การทําเช่นนี้จะช่วยให้มั่นใจได้ว่า อุปกรณ์จะแสดงขึ้นเพียงครั้งเดียวใน Google Home Graph ของผู้ใช้ ระบบจะกรองอุปกรณ์ Cloud-to-cloud ที่ซ้ํากันออกได้ก็ต่อเมื่อเชื่อมโยงอยู่กับโครงสร้างเฉพาะ (บ้าน) ในGoogle Home app (GHA)
ข้อกําหนดของ SYNC
ระบบคลาวด์ของพาร์ทเนอร์ต้องส่งช่องสตริงใหม่ 3 ช่องสําหรับอุปกรณ์แต่ละเครื่องในการตอบกลับ Google SYNC
เพื่อไม่ให้ซ้ํากันใน Home Graph ช่องเหล่านี้ต้องตรงกับแอตทริบิวต์ที่กําหนดไว้ในคลัสเตอร์ข้อมูลพื้นฐานสําหรับอุปกรณ์ Matter นอกจากนี้
SYNC
คําตอบต้องมี roomHint
:
matterUniqueId
— แอตทริบิวต์UniqueId
ในรูปแบบสตริงmatterOriginalVendorId
— แอตทริบิวต์VendorId
ในรูปแบบสตริงเลขฐานสิบหกmatterOriginalProductId
— แอตทริบิวต์ProductId
ในรูปแบบสตริงเลขฐานสิบหกroomHint
- ห้องที่มีอุปกรณ์นี้
ดูเอกสารเกี่ยวกับ Intent เช่น SYNC
ได้ใน Primer ของ 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 โดยทันทีเพื่ออัปเดตฟิลด์เหล่านี้โดยเร็วที่สุดเพื่อหลีกเลี่ยงการกรองข้อมูลล่าช้า
สตริงเหล่านี้ไม่ควรเปลี่ยนแปลงเมื่อแสดงในอุปกรณ์นั้นๆ รหัสที่ไม่ซ้ํากันควรรีเซ็ตเมื่อรีเซ็ตเป็นค่าเริ่มต้นจากโรงงานเท่านั้น ซึ่งทําให้อุปกรณ์ปรากฏในการผสานรวมทั้งหมดว่าเป็นอุปกรณ์ใหม่
การเชื่อมโยงโครงสร้างอัตโนมัติ
Cloud-to-cloudไม่มีการรับประกันว่าอุปกรณ์ดังกล่าวจะเชื่อมโยงโดยอัตโนมัติกับโครงสร้างหนึ่งๆ ในกรณีที่ทําการเชื่อมโยงโครงสร้างอัตโนมัติไม่ได้ อุปกรณ์ Cloud-to-cloud ที่เกี่ยวข้องจะปรากฏในส่วนเฉพาะของหน้าจอหลักของ GHA ในส่วนที่มีชื่อว่าลิงก์กับคุณ นอกห้องใดๆ โดยจะไม่มีการกรองอุปกรณ์ที่ซ้ํากันออก อุปกรณ์จะไม่ถูกวางในโครงสร้างโดยอัตโนมัติเมื่อผู้ใช้มีมากกว่า 1 โครงสร้าง (บ้าน) ใน GHA อุปกรณ์อาจไม่ได้รับการจัดโครงสร้าง เนื่องจากสาเหตุอื่น
หากผู้ใช้ย้ายอุปกรณ์ Cloud-to-cloud ที่ล้มเหลวในการเชื่อมโยงโครงสร้างอัตโนมัติไปยังโครงสร้างด้วยตนเอง การกรองข้อมูลที่ซ้ํากันออกอาจเกิดขึ้นในอีก SYNC
ตราบเท่าที่ SYNC
เป็นไปตามข้อกําหนดที่ระบุไว้ในข้อกําหนดของ SYNC