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