โปรแกรมสำหรับนักพัฒนาแอป Google Home ช่วยให้ผู้ผลิตอุปกรณ์เชื่อมต่ออุปกรณ์สมาร์ทโฮมกับระบบนิเวศของ Google Home ได้ เรากำลังขยายเส้นทางการตอบสนองในเครื่องของ Smart Home Actions ด้วยความสามารถในการเพิ่มอุปกรณ์ที่เปิดใช้ Matter เพื่อตั้งค่าโดยใช้ Google Home app (GHA) และควบคุมอุปกรณ์ดังกล่าวโดยใช้ Google Assistant, GHA, หรือจออัจฉริยะ เช่น Google Nest Hub (2nd gen)
เอกสารนี้อธิบายวิธีเริ่มต้นใช้งานการสร้างและผสานรวมแพลตฟอร์มที่รองรับ Matterในระบบนิเวศของ Google Home
ข้อจำกัดความรับผิด
โปรดทราบสิ่งต่อไปนี้เกี่ยวกับขั้นตอนที่อธิบายไว้ในMatter เอกสาร
- เราขอแนะนำให้บัญชีที่ใช้สำหรับการพัฒนาเชื่อมต่อฮับที่เปิดใช้ Matterเพียงฮับเดียวเพื่อใช้ในการทดสอบ การเชื่อมต่อฮับที่เปิดใช้ Matter-enabled หลายฮับพร้อมกันหรือเชื่อมต่อกับโครงสร้างเดียวกันระหว่างการทดสอบอาจทำให้เกิดลักษณะการทำงานที่ไม่คาดคิด
- ขั้นตอนทั้งหมดจะถือว่าใช้เครื่อง 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
- ฮับ
- อุปกรณ์ที่รองรับ Google Nest เช่น Google Nest Hub (2nd gen) คุณต้องมีฮับเพื่อควบคุมอุปกรณ์ที่เปิดใช้ Matter ผ่าน พื้นผิวอื่นๆ เช่น Assistant, GHA และจออัจฉริยะ
- อุปกรณ์ที่เปิดใช้ Matter
- อุปกรณ์หรือบอร์ดพัฒนาที่แฟลชด้วยบิลด์หรือแอปตัวอย่างที่เปิดใช้งานMatter
- อุปกรณ์เคลื่อนที่
- โทรศัพท์ทดสอบที่ใช้เพื่อช่วยในการจับคู่ ปัจจุบันคือโทรศัพท์ Android
ข้อกำหนดเบื้องต้น
นักพัฒนาแอปต้องมีสิ่งต่อไปนี้จึงจะผสานรวมอุปกรณ์ที่เปิดใช้ Matter กับ ระบบนิเวศของ Google Home ได้อย่างสมบูรณ์
- ฮับ Google ที่รองรับ Thread เพื่อทำหน้าที่เป็นทั้ง Border Router สำหรับอุปกรณ์ที่เปิดใช้ Thread และเส้นทางการตอบสนอง ในเครื่องสำหรับการกำหนด Intent ของสมาร์ทโฮม
- อุปกรณ์เคลื่อนที่ (โทรศัพท์ทดสอบ) ที่มีคุณสมบัติตรงตามข้อกำหนดขั้นต่ำ ดังนี้
- Android O (8.1, ระดับ API 27 ขึ้นไป)
- iOS (v16.5 ขึ้นไป)
- ความสามารถ BLE
- รหัสตัวแทนจำหน่ายรายย่อย (VID) และรหัสผลิตภัณฑ์ (PID) สำหรับอุปกรณ์ที่เปิดใช้งาน Matter
- อุปกรณ์ที่เปิดใช้ Matter อุปกรณ์นี้ควรเป็นอุปกรณ์ประเภท Matter ที่ระบบนิเวศของ Google Home รองรับ และอาจเป็นอุปกรณ์ต่อไปนี้
- ผลิตภัณฑ์ของคุณเองที่มีเฟิร์มแวร์ที่เปิดใช้ Matter
- อุปกรณ์ Matter อย่างใดอย่างหนึ่งต่อไปนี้เพื่อใช้ในการ ยืนยันแบบครบวงจร
| ตัวแทนจำหน่ายรายย่อย | แพลตฟอร์ม | การรองรับ Thread | คู่มือ |
|---|---|---|---|
| Bouffalo Lab | BL602 | ||
| BL702 | |||
| Espressif | ESP32 | การทดสอบ OTA | |
| Nordic Semiconductor | nRF52840 DK | การทดสอบ OTA | |
| NXP | ชุดพัฒนา IOTZTB-DK006 kit | ||
| Realtek | Ameba D Series | ||
| Silicon Labs | EFR32MG24 Dev Kit | ||
| EFR32MG Zigbee and Thread Starter Kit | |||
| Telink | TLSR9528 | คู่มือนักพัฒนาแอป Telink Matter | |
| Texas Instruments | ชุดพัฒนา CC2652R7 LaunchPad kit |
รหัสตัวแทนจำหน่ายรายย่อย
โดยค่าเริ่มต้น คุณสามารถใช้ VID รายการใดรายการหนึ่งที่ Alliance จัดสรรไว้เพื่อวัตถุประสงค์ในการ
ทดสอบ เลือกรายการใดรายการหนึ่งต่อไปนี้:
0xFFF1, 0xFFF2, 0xFFF3, 0xFFF4.
หากต้องการใช้ VID เวอร์ชันที่ใช้งานจริงเพื่อให้การผสานรวมได้รับการรับรองและเปิดตัว คุณต้องให้ Google ยืนยัน VID ดังกล่าว ก่อนเพื่อให้แน่ใจว่า Alliance ได้ออก VID ให้คุณแล้ว
คุณควรใช้ VID นี้ในเฟิร์มแวร์ของอุปกรณ์
อุปกรณ์ Matter จะจับคู่ในระบบนิเวศของ Google Home ได้เฉพาะในบางสถานการณ์ของรหัสตัวแทนจำหน่ายรายย่อยและประเภทอุปกรณ์
- คุณใช้ VID ทดสอบในอุปกรณ์ของผู้ใช้ทั่วไปไม่ได้
- VID เวอร์ชันที่ใช้งานจริงต้องออกโดย Connectivity Standards Alliance (Alliance) 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
| ผู้ใช้ประเภทใดบ้างที่จัดเตรียมอุปกรณ์ลงในระบบนิเวศของ Google Home ได้ | |||
|---|---|---|---|
| ประเภท VID | สถานะการรับรอง VID และการผสานรวมคอนโซล | เวอร์ชันที่ใช้งานจริง
(ผู้ใช้ทั่วไป) |
เวอร์ชันสำหรับการพัฒนา
(นักพัฒนาแอป Field Trial ผู้ใช้) |
| ทดสอบ | ไม่มีการผสานรวมใน Developer Console (ไม่สามารถรับรองได้) | ||
| ทดสอบ | มีการผสานรวมใน Developer Console (ไม่สามารถ รับรองได้) | ||
| เวอร์ชันที่ใช้งานจริง | ไม่ได้รับการรับรอง ไม่มีผสานรวมใน Developer Console | ||
| เวอร์ชันที่ใช้งานจริง | ไม่ได้รับการรับรอง มีผสานรวมใน Developer Console | ||
| เวอร์ชันที่ใช้งานจริง | ได้รับการรับรองใน DCL ของ Alliance ไม่มีผสานรวมใน Developer Console | ||
| เวอร์ชันที่ใช้งานจริง | ได้รับการรับรองใน DCL ของ Alliance และมีการผสานรวม ใน Developer Console | ||
รหัสสินค้า
ระบบจะอ่านข้อมูลเกี่ยวกับอุปกรณ์จาก Matterคลัสเตอร์ข้อมูลพื้นฐาน รหัสสินค้าที่เข้ารหัสไว้ในเฟิร์มแวร์ของอุปกรณ์ ต้องตรงกับรหัสสินค้าของการผสานรวมMatter ใน Play Console
ฟีเจอร์ที่ไม่รองรับ
ระบบยังไม่ได้เปิดเผยคลัสเตอร์ Matter บางคลัสเตอร์ต่อผู้ใช้ แม้ว่า ระบบอาจใช้คลัสเตอร์ดังกล่าวก็ตาม ในกรณีส่วนใหญ่ หมายความว่าแอตทริบิวต์ที่เปิดเผยผ่านคลัสเตอร์เหล่านี้จะไม่ปรากฏต่อผู้ใช้
| Cluster Type | Clusters |
|---|---|
| Core |
|
| Application |
|
¹ ดูวิธีที่การดำเนินการนี้ส่งผลต่อสวิตช์ไฟเปิด/ปิดได้ที่สวิตช์ไฟเปิด/ปิด