เมื่อแปลงอุปกรณ์ที่ปัจจุบันใช้ (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- ห้องที่อุปกรณ์นี้อยู่
คุณดูเอกสารประกอบเกี่ยวกับ Intent เช่น
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 ทันทีเพื่ออัปเดตฟิลด์เหล่านี้ให้เร็วที่สุดเพื่อหลีกเลี่ยงการ
ลบรายการที่ซ้ำกันในภายหลัง
สตริงเหล่านี้ไม่ควรเปลี่ยนแปลงเมื่อมีการระบุไว้สำหรับอุปกรณ์หนึ่งๆ รหัสที่ไม่ซ้ำกันควรเปลี่ยนแปลงเมื่อรีเซ็ตเป็นค่าเริ่มต้นเท่านั้น ซึ่งจะทำให้อุปกรณ์ปรากฏในการผสานรวมทั้งหมดเป็นอุปกรณ์ใหม่ทั้งหมด
การเชื่อมโยงโครงสร้างอัตโนมัติ
ระบบไม่รับประกันว่าจะเชื่อมโยงอุปกรณ์ Cloud-to-cloud กับโครงสร้างที่เฉพาะเจาะจง โดยอัตโนมัติ ในกรณีที่ การเชื่อมโยงโครงสร้างอัตโนมัติเป็นไปไม่ได้ อุปกรณ์ที่เกี่ยวข้อง Cloud-to-cloudจะปรากฏในส่วนเฉพาะของหน้าจอหลักของ GHAในส่วนที่มีชื่อว่าเชื่อมโยงกับ คุณ นอกห้อง ระบบจะไม่ลบรายการที่ซ้ำกันของอุปกรณ์ดังกล่าว ระบบจะไม่วางอุปกรณ์ไว้ในโครงสร้างโดยอัตโนมัติเมื่อผู้ใช้มีโครงสร้าง (บ้าน) มากกว่า 1 รายการใน GHA อุปกรณ์อาจไม่ได้รับการจัดโครงสร้างเนื่องจากเหตุผลอื่นๆ
หากผู้ใช้ย้ายอุปกรณ์ Cloud-to-cloud ที่การเชื่อมโยงโครงสร้างอัตโนมัติล้มเหลวไปยังโครงสร้างด้วยตนเอง ระบบอาจลบรายการที่ซ้ำกันใน SYNC ครั้งถัดไป ตราบใดที่การตอบกลับ SYNC เป็นไปตามข้อกำหนดที่ระบุไว้ในข้อกำหนดของ SYNC