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