เริ่มต้นใช้งาน Matter

โปรแกรมนักพัฒนาแอป Home ของ Google ช่วยให้ผู้ผลิตอุปกรณ์เชื่อมต่ออุปกรณ์สมาร์ทโฮมกับระบบนิเวศของ Google Home ได้ เรากําลังขยายเส้นทางการดําเนินการแบบดั้งเดิมของการดำเนินการสมาร์ทโฮมด้วยความสามารถในการเพิ่มอุปกรณ์ที่พร้อมใช้งานMatterสำหรับการตั้งค่าโดยใช้ Google Home app (GHA) และควบคุมอุปกรณ์เหล่านั้นโดยใช้ Google Assistant, GHA หรือจออัจฉริยะอย่าง Google Nest Hub (2nd gen)

เอกสารประกอบนี้อธิบายวิธีเริ่มต้นสร้างและผสานรวมแพลตฟอร์มที่รองรับMatterในระบบนิเวศของ Google Home

ข้อจำกัดความรับผิด

โปรดคำนึงถึงสิ่งต่อไปนี้เกี่ยวกับขั้นตอนที่อธิบายไว้ในMatterเอกสารประกอบ

• เราขอแนะนําให้บัญชีที่ใช้สําหรับการพัฒนามีฮับที่เปิดใช้ Matter เพียงฮับเดียวที่เชื่อมต่อไว้สําหรับการทดสอบ ฮับที่เปิดใช้ Matter หลายตัวที่เชื่อมต่อพร้อมกันหรือเชื่อมต่อกับโครงสร้างเดียวกันระหว่างการทดสอบอาจส่งผลให้เกิดลักษณะการทำงานที่ไม่คาดคิด
• ขั้นตอนทั้งหมดจะสมมติให้ใช้เครื่อง Linux ที่ใช้ Ubuntu 20.04 เพื่อสร้างและแฟลชตัวอย่าง Matter ซึ่ง Google ได้ทดสอบแล้ว แม้ว่าระบบจะรองรับเครื่อง macOS แต่เราขอแนะนำให้ใช้ Linux วิธีการเฉพาะสำหรับ Mac จะระบุไว้ในขั้นตอนตามความจำเป็น

วิธีสร้าง

หากต้องการสร้างอุปกรณ์ที่พร้อมใช้งาน Matter ซึ่งผสานรวมกับระบบนิเวศของ Google Home คุณจะต้องทำงานกับบอร์ดการพัฒนาที่เข้ากันได้กับ Matter และ Matter SDK

วิธีที่ง่ายที่สุดในการเริ่มต้นใช้งานคือการดู Codelab เราขอแนะนำให้ทำ Codelab ต่อไปนี้อย่างน้อย 1 รายการ

หลังจากนั้น ให้ตรวจสอบรายการอุปกรณ์ที่รองรับเพื่อให้แน่ใจว่าระบบนิเวศของ Google Home รองรับสิ่งที่คุณวางแผนจะผสานรวม จากนั้นอ่านรายการตรวจสอบสำหรับนักพัฒนาแอปเพื่อทำความเข้าใจขั้นตอนการพัฒนาทั้งหมด ตั้งแต่การสร้างโปรเจ็กต์ไปจนถึงการเปิดตัว

อุปกรณ์ที่รองรับ รายการตรวจสอบสำหรับนักพัฒนาแอป

คำจำกัดความ

คำศัพท์ต่อไปนี้ใช้ในเอกสารนี้

Border Router

ฮับที่ใช้ Thread Border Router อเนกประสงค์สำหรับอุปกรณ์ที่เปิดใช้ Thread

Hub

อุปกรณ์ Google Nest ที่รองรับ เช่น Google Nest Hub (2nd gen) คุณต้องมีฮับเพื่อควบคุมอุปกรณ์ที่พร้อมใช้งาน Matter ผ่านแพลตฟอร์มอื่นๆ เช่น Assistant, GHA จออัจฉริยะ

อุปกรณ์ที่เปิดใช้ Matter

อุปกรณ์หรือบอร์ดการพัฒนาที่แฟลชด้วยบิลด์หรือแอปตัวอย่างที่พร้อมใช้งาน Matter

อุปกรณ์เคลื่อนที่

โทรศัพท์ทดสอบที่ใช้ช่วยในการจับคู่ ปัจจุบันเป็นโทรศัพท์ Android

ข้อกำหนดเบื้องต้น

นักพัฒนาแอปต้องมีสิ่งต่อไปนี้จึงจะผสานรวมอุปกรณ์ที่เปิดใช้ Matter เข้ากับระบบนิเวศของ Google Home ได้อย่างเต็มที่

1. Google Hub ที่รองรับเทรดเพื่อทำหน้าที่เป็นทั้ง Border Router สำหรับอุปกรณ์ที่เปิดใช้เทรด และเป็นเส้นทางการตอบสนองในเครื่องสำหรับการกำหนดเส้นทาง Intent ของสมาร์ทโฮม
2. อุปกรณ์เคลื่อนที่ (โทรศัพท์ทดสอบ) ที่เป็นไปตามข้อกำหนดขั้นต่ำ
   • Android O (8.1, API ระดับ 27 ขึ้นไป)
   • iOS (v16.5 ขึ้นไป)
   • ความสามารถของ BLE
3. รหัสผู้ให้บริการ (VID) และรหัสผลิตภัณฑ์ (PID) สำหรับอุปกรณ์ที่พร้อมใช้งาน Matter
4. อุปกรณ์ที่เปิดใช้ Matter อุปกรณ์นี้ควรเป็นหนึ่งในMatterประเภทอุปกรณ์ที่รองรับในระบบนิเวศ Google Home และอาจเป็นอุปกรณ์ต่อไปนี้
   • ผลิตภัณฑ์ของคุณเองที่มีเฟิร์มแวร์ที่เปิดใช้ Matter
   • อุปกรณ์ Matter เครื่องใดเครื่องหนึ่งต่อไปนี้เพื่อใช้สำหรับการยืนยันจากต้นทางถึงปลายทาง

รหัสตัวแทนจำหน่ายรายย่อย

โดยค่าเริ่มต้น คุณสามารถใช้ VID รายการใดรายการหนึ่งซึ่ง CSA จัดสรรไว้เพื่อการทดสอบ เลือกข้อใดข้อหนึ่งต่อไปนี้ 0xFFF1, 0xFFF2, 0xFFF3, 0xFFF4

หากต้องการใช้ VID เวอร์ชันที่ใช้งานจริงเพื่อให้การผสานรวมได้รับการรับรองและเปิดตัวได้ คุณต้องขอให้ Google ยืนยันก่อนเพื่อให้แน่ใจว่า CSA ได้ออก VID ให้คุณ

คุณควรใช้ VID นี้ในเฟิร์มแวร์ของอุปกรณ์

อุปกรณ์ Matter จะจับคู่ได้ในระบบนิเวศ Google Home เท่านั้นในบางกรณีของรหัสผู้ให้บริการและประเภทอุปกรณ์

• VID ทดสอบใช้กับอุปกรณ์ของผู้บริโภคไม่ได้
• Connectivity Standards Alliance (Alliance) ต้องเป็นผู้ออก VID สำหรับเวอร์ชันที่ใช้งานจริง Google จะตรวจสอบว่าคุณเป็นเจ้าของ VID ดังกล่าวก่อนจึงจะใช้ VID นั้นใน Google Home Developer Console ได้ เมื่อดำเนินการเสร็จแล้ว คุณจะสร้างการผสานรวมสําหรับ VID นั้นได้
• สําหรับการพัฒนาและวัตถุประสงค์ Field Trial คุณต้องสร้างโปรเจ็กต์และการผสานรวมด้วยชุดค่าผสม VID และ PID ที่เกี่ยวข้องใน Developer Console ผู้ใช้ที่สั่งอุปกรณ์มาต้องเป็นสมาชิกของโปรเจ็กต์หรืออยู่ในรายชื่อผู้ใช้ Field Trial
• ผู้ใช้ทั่วไปจะใช้ผลิตภัณฑ์ของคุณได้ก็ต่อเมื่อผลิตภัณฑ์ได้รับการรับรองจาก Alliance

VID และ PID ใช้ได้เพียงครั้งเดียวสำหรับการผสานรวม 1 ครั้ง หากต้องการใช้ VID หรือ PID เดียวกันในการผสานรวม คุณจะต้องดำเนินการอย่างใดอย่างหนึ่งต่อไปนี้

• แก้ไขการผสานรวมโดยใช้ VID หรือ PID เป็น VID หรือ PID อื่น
• ลบการผสานรวมโดยใช้ VID หรือ PID

รหัสผลิตภัณฑ์

ระบบจะอ่านข้อมูลเกี่ยวกับอุปกรณ์จาก Matterคลัสเตอร์ข้อมูลพื้นฐาน รหัสผลิตภัณฑ์ที่เข้ารหัสในเฟิร์มแวร์ของอุปกรณ์ต้องตรงกับรหัสผลิตภัณฑ์ของMatterการผสานรวมในคอนโซลนักพัฒนาซอฟต์แวร์

ฟีเจอร์ที่ไม่รองรับ

คลัสเตอร์ Matter บางรายการยังไม่แสดงต่อผู้ใช้ แต่ระบบอาจใช้คลัสเตอร์ดังกล่าว ในกรณีส่วนใหญ่ ผู้ใช้ปลายทางจะไม่เห็นแอตทริบิวต์ที่แสดงผ่านคลัสเตอร์เหล่านี้

¹ ดูว่าการเปลี่ยนแปลงนี้ส่งผลต่อสวิตช์เปิด/ปิดไฟอย่างไร