เมื่อแปลงอุปกรณ์ที่ปัจจุบันใช้ (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 เป็นไปตามข้อกำหนดที่ระบุไว้ในข้อกำหนดในการซิงค์