Commissioning API ใน Android รองรับการจัดการหลายรายการ (หรือ การจัดการหลายรายการ) สำหรับ Matter ซึ่งหมายความว่า Commissioning API สามารถทำหน้าที่เป็นผู้จัดเตรียมอุปกรณ์ Matter หลักหรือ รอง และคุณสามารถเพิ่มผู้จัดเตรียมอุปกรณ์ของคุณเองได้
ในฐานะผู้จัดเตรียมอุปกรณ์ Matter Matter หลัก
- ในโหมดนี้ ระบบจะเพิ่ม Fabric ของ Google ก่อนโดยใช้ UX ของ Google
- คุณสามารถเพิ่มผู้จัดเตรียมอุปกรณ์ที่กำหนดเองได้
- ระบบจะเรียกผู้จัดเตรียมอุปกรณ์ของคุณหลังจากเพิ่ม Fabric ของ Google ลงในอุปกรณ์แล้ว จากนั้นจะเปิดหน้าต่างการจัดเตรียมอุปกรณ์Matter อีกครั้ง
- หาก Google จัดเตรียมอุปกรณ์ไปยัง Fabric ของตนเองไม่สำเร็จก่อนด้วยเหตุผลใดก็ตาม บริการจัดเตรียมอุปกรณ์ที่กำหนดเองของคุณจะไม่ทำงาน
ในฐานะผู้จัดเตรียมอุปกรณ์ Matter รอง Matter
- ในโหมดนี้ คุณสามารถใช้ UX การจัดเตรียมอุปกรณ์ของคุณเองและเริ่มต้นใช้งาน Fabric ของคุณเอง (หรือ Fabric อื่นๆ)
- คุณสามารถเรียก Google Commissioning API ได้ในภายหลังด้วยหน้าต่างการจัดเตรียมอุปกรณ์ที่เปิดอยู่เพื่อเพิ่ม Fabric ของ Google ในโหมดนี้ Google ขอแนะนำอย่างยิ่งว่าเมื่อผู้ใช้ปลายทางให้สิทธิ์คุณใช้ Home API แล้ว แอปควรแจ้งให้ผู้ใช้เพิ่ม Fabric ของ Google (โดยใช้ Commissioning API) อย่างชัดเจนหลังจากขั้นตอนการจัดเตรียมอุปกรณ์ของคุณเสร็จสมบูรณ์
วิธีใช้ Commissioning API ในฐานะผู้จัดเตรียมอุปกรณ์ Matter หลัก
ขั้นตอนเหล่านี้แสดงขั้นตอนการจัดเตรียมอุปกรณ์ Matter ที่มีฟีเจอร์ครบถ้วนซึ่ง Google แนะนำ Matter
ผู้ใช้เริ่มขั้นตอนการจัดเตรียมอุปกรณ์ในแอป เช่น ผู้ใช้แตะปุ่มที่มีป้ายกำกับว่าเพิ่มอุปกรณ์
UX ของ Google จะควบคุมและแสดงหน้าจอ สแกนMatterคิวอาร์โค้ด เพื่อให้ผู้ใช้สแกนคิวอาร์โค้ดเพื่อเริ่มกระบวนการตั้งค่า
ในหน้าจอเชื่อมต่ออุปกรณ์นี้กับบัญชี Google ผู้ใช้แตะยอมรับ เพื่อเพิ่มอุปกรณ์ลงในระบบนิเวศของ Google หากผู้ใช้แตะยกเลิก ในหน้าจอนี้แทน ระบบจะหยุดการจัดเตรียมอุปกรณ์ทั้งหมดทันที
ในหน้าจอเลือกบ้าน ผู้ใช้เลือกบ้านที่จะใช้ควบคุมอุปกรณ์ หากไม่มีบ้าน ระบบจะสร้างบ้านใหม่ หากไม่พบฮับที่เหมาะสมในบ้านหรือผู้ใช้ไม่มีสิทธิ์ กระบวนการจัดเตรียมอุปกรณ์จะสิ้นสุดลง
หน้าจอเชื่อมต่ออุปกรณ์แล้ว ควรปรากฏขึ้นถัดไป และ Matterกระบวนการตั้งค่า จะเริ่มขึ้น ผู้ใช้สามารถเลือกห้องและชื่ออุปกรณ์ในหน้าจอนี้
หน้าจอกำลังเตรียมความพร้อมของอุปกรณ์ จะปรากฏขึ้นเมื่ออุปกรณ์เริ่มต้นใช้งาน Fabric ของ Matter
แอปของคุณจะกลับมาควบคุมอีกครั้ง และผู้จัดเตรียมอุปกรณ์ที่กำหนดเอง (หากลงทะเบียนไว้) จะทำงานในตอนนี้
วิธีใช้ Commissioning API ในฐานะผู้จัดเตรียมอุปกรณ์ Matter รอง
ขั้นตอนเหล่านี้แสดงขั้นตอนการจัดเตรียมอุปกรณ์ Matter ที่กระบวนการจัดเตรียมอุปกรณ์ของคุณเกิดขึ้นก่อน กระบวนการจัดเตรียมอุปกรณ์ของ Google:
ผู้ใช้เริ่มขั้นตอนการจัดเตรียมอุปกรณ์ในแอปของคุณ เช่น ผู้ใช้แตะเพิ่มอุปกรณ์
ระบบจะเรียกใช้กระบวนการ UX การจัดเตรียมอุปกรณ์เพื่อเพิ่มอุปกรณ์ลงใน Fabric ของคุณ
เมื่อเสร็จสมบูรณ์แล้ว คุณสามารถกำหนดลักษณะการทำงานที่ตามมาได้โดยอิงตามความรู้เกี่ยวกับผู้ใช้ ตัวอย่างเช่น หากผู้ใช้เลือกใช้ Google Home API ซึ่งอาจบ่งชี้ว่าผู้ใช้ต้องการจัดเตรียมอุปกรณ์ไปยัง Google คุณสามารถทริกเกอร์กระบวนการจัดเตรียมอุปกรณ์ได้
กระบวนการของคุณจะเรียก Commissioning API และระบุเพย์โหลดซึ่งมีรหัสผ่าน ตัวแยกแยะ และข้อมูลอื่นๆ ที่พร้อมใช้งาน
กระบวนการจัดเตรียมอุปกรณ์ของ Google จะเพิ่มอุปกรณ์ลงใน Fabric ของ Google