Google Home Sample App for Matter ใช้ Google Home Mobile SDK เพื่อสร้างแอป Android ที่คล้ายกับ Google Home app (GHA) แอปตัวอย่างนี้มีฟีเจอร์ดังต่อไปนี้
- ตั้งค่าอุปกรณ์จริงและอุปกรณ์ Matter เสมือนให้ผ้า Android
- จัดหาอุปกรณ์จริงและอุปกรณ์เสมือนให้แก่ผ้าสําหรับการพัฒนา
- ควบคุมอุปกรณ์บนผืนผ้าการพัฒนา เช่น เปิดไฟ
- คุณลักษณะการดูแลระบบหลายรายการช่วยให้คุณสามารถแชร์อุปกรณ์บนพื้นที่สําหรับการพัฒนากับแอปอื่นๆ และในทางกลับกันสามารถรวมไว้ในอุปกรณ์การพัฒนาที่แชร์กับแอปอื่นๆ
- ยูทิลิตีนักพัฒนาซอฟต์แวร์
คําแนะนํานี้จะอธิบายวิธีติดตั้ง APK Sample App for Matter และใช้เพื่อค่าคอมมิชชัน ควบคุม และแชร์อุปกรณ์ Matter
หากต้องการดาวน์โหลดซอร์สโค้ด ดูวิธีผสานรวม Mobile SDK และปรับแต่งหน้าจอใน Android Studio ลองใช้ Codelab Sample App for Matter
ไปที่ Sample App for Matter Codelab
สิ่งที่ต้องดำเนินการก่อน
- อุปกรณ์ที่ใช้ Android O (8.1, API ระดับ 27) หรือใหม่กว่าจะพร้อมสําหรับการทดสอบ เพื่อให้แน่ใจว่าอุปกรณ์ของคุณมีการสนับสนุน Matter ล่าสุด โปรดอ่านคู่มือยืนยันโมดูลและบริการ Matter
- สร้างอุปกรณ์ Matter ที่มีความสามารถในการเปิด/ปิด ตัวอย่างแอปนี้ใช้ได้กับอุปกรณ์เสมือนและ ESP32
- สร้างอุปกรณ์เสมือน Matter ด้วยแอป
rootnode_dimmablelight_bCwGYSDpoeเมื่อคุณสร้างการผสานรวม Matter ใน Google Home Developer Console ให้ใช้0xFFF1เป็นรหัสผู้ให้บริการและ0x8000เป็นรหัสผลิตภัณฑ์ - สร้างอุปกรณ์ Espressif ด้วย
all-clusters-appเมื่อคุณสร้างการผสานรวม Matter ใน Developer Console ให้ใช้0xFFF1เป็นรหัสผู้ให้บริการและ0x8001เป็นรหัสผลิตภัณฑ์
- สร้างอุปกรณ์เสมือน Matter ด้วยแอป
คุณไม่จําเป็นต้องมีฮับ เช่น Google Nest Hub (2nd gen) เพื่อฝากและควบคุมอุปกรณ์ด้วย Sample App for Matter
ติดตั้ง
ไปที่ส่วน "รุ่น" ในที่เก็บ GitHub Sample App for Matter ค้นหา APK ชื่อ
GHSAFM-1.4.1-default-debug.apkอย่าเลือกtargetcommissioner:ติดตั้ง Android Debug Bridge (adb) ดังนี้
เชื่อมต่ออุปกรณ์ Android กับ USB และเปิดใช้การโอนไฟล์ แล้วติดตั้ง APK ดังนี้
$ adb unroot && adb install GHSAFM-1.4.1-default-debug.apk
อุปกรณ์ค่าคอมมิชชัน
เมื่อเปิดแอปตัวอย่างเป็นครั้งแรก คุณจะได้รับกล่องโต้ตอบที่มีลิงก์ไปยัง Sample App for Matter Codelab หากเลือกไม่ต้องแสดงข้อความนี้อีก คุณสามารถนํากล่องโต้ตอบกลับมาได้ทุกเมื่อโดยอัปเดตค่ากําหนดของคุณในส่วน "ผู้ดูแลระบบ"
ในขั้นตอนถัดไป คุณจะต้องเพิ่มอุปกรณ์ Matter ลงในผ้า Android ในเครื่อง พร้อมด้วยผ้าสําหรับการพัฒนาที่อยู่ในพื้นที่เฉพาะสําหรับแอปตัวอย่าง
ผ้าของ Matter คืออะไร
Fabric คือโดเมนที่เชื่อถือได้ของอุปกรณ์ต่างๆ ในบ้านซึ่งเป็นเครือข่ายที่แชร์ร่วมกันซึ่งจะช่วยให้สื่อสารกันได้
อุปกรณ์อาจมีผ้าอย่างน้อย 1 ชิ้นที่สอดคล้องกับแพลตฟอร์ม แอป หรือกลุ่มอุปกรณ์ที่โต้ตอบกัน Fabric มีรหัสที่ไม่ซ้ํากันและอุปกรณ์จะใช้ข้อมูลรับรองและผู้ออกใบรับรองชุดเดียวกัน (CA) ระบบจะกําหนดข้อมูลเข้าสู่ระบบเหล่านี้ระหว่างค่าคอมมิชชัน Matter
หากต้องการมอบหมายอุปกรณ์ Matter ให้ทําตามขั้นตอนต่อไปนี้
แตะปุ่มเพิ่มอุปกรณ์เพื่อเริ่มขั้นตอนการว่าจ้าง
ต่อจากนั้นระบบจะโอนการควบคุมไปยัง Google Play services ซึ่งเปิดใช้งานจากการเรียกไปยัง Mobile SDK ในการส่งหลักฐานการครอบครอง สแกนโค้ด QR หรือแตะใช้รหัสการจับคู่
เมื่อค่าคอมมิชชันเสร็จสมบูรณ์ ให้ป้อนชื่ออุปกรณ์แล้วแตะเสร็จสิ้น
ขณะนี้อุปกรณ์ของคุณเชื่อมต่อกับทั้งผ้า Android ท้องถิ่นและผ้าพัฒนาแล้ว
งานที่มอบหมายและหน้าจอที่เกี่ยวข้องทั้งหมดจะจัดการโดย Play services เมื่อตั้งค่าอุปกรณ์ การดําเนินการนี้จะมอบประสบการณ์ของผู้ใช้ที่สอดคล้องกันและนําข้อกําหนดในการจัดการสิทธิ์ที่ละเอียดอ่อนออก เช่น ข้อมูลเข้าสู่ระบบ Wi-Fi และเทรด
ควบคุมอุปกรณ์
ผ้าสําหรับการพัฒนาจะสร้างข้อมูลเข้าสู่ระบบเพื่อควบคุมอุปกรณ์ Matter จากแอปตัวอย่างโดยตรง
จากหน้าจอหลัก คุณสามารถสลับอุปกรณ์เป็นเปิดหรือปิดได้ แตะอุปกรณ์เพื่อเข้าถึงรายละเอียดของอุปกรณ์
แชร์อุปกรณ์
การแชร์อุปกรณ์เรียกว่าขั้นตอนการทํางานแบบหลายผู้ดูแลระบบในข้อกําหนดของ Matter เมื่ออุปกรณ์ได้รับมอบหมายจากแอปตัวอย่างแล้ว คุณจะแชร์ อุปกรณ์ดังกล่าวกับระบบนิเวศอื่นๆ ได้อย่างง่ายดาย
หากต้องการแชร์อุปกรณ์ Matter กับระบบนิเวศอื่นๆ คุณจะต้องติดตั้งแพลตฟอร์มอื่นในอุปกรณ์ Android แพลตฟอร์มภายนอกนี้จะเป็นค่าคอมมิชชันเป้าหมาย เราได้สร้างอินสแตนซ์ตัวอย่างอีกแอปหนึ่ง ที่คุณสามารถใช้เป็นนายหน้าเป้าหมาย
ไปที่ส่วน "รุ่น" ในที่เก็บ GitHub Sample App for Matter ค้นหา APK ล่าสุดชื่อ
GHSAFM-[version]-targetcommissionerตัวอย่างเช่นGHSAFM-1.4.1-targetcommissioner-debug.apk:ติดตั้งค่าคอมมิชชันเป้าหมาย
$ adb unroot && adb install GHSAFM-1.4.1-targetcommissioner-debug.apkจากหน้าจอหลัก ให้แตะอุปกรณ์เพื่อแสดงข้อมูลอุปกรณ์ แตะแชร์
ตัวอย่างแอปเรียกใช้ Mobile SDK Share API และจะโอนการควบคุมไปยัง Play services อีกครั้ง
ชีตที่แชร์จะปรากฏขึ้นเพื่อให้คุณเลือกแอปหรือแพลตฟอร์มที่ต้องการจับคู่อุปกรณ์ หน้าจอนี้ช่วยให้คุณแชร์อุปกรณ์ได้ 2 วิธีดังนี้
- แชร์ผ่านรหัสการตั้งค่าด้วยตนเองเพื่อแชร์กับแอปค่าคอมมิชชันเป้าหมาย
- เมื่อใช้แอป Android ในเครื่องที่ลงทะเบียนเป็น Matter ค่าคอมมิชชัน
แอปค่าคอมมิชชันเป้าหมายจะมีป้ายกํากับเป็น GHSAFM-TC แตะตัวอย่างของแอป เพื่อแชร์อุปกรณ์
ต่อจากนั้น แอปภายนอก (นายหน้าเป้าหมาย) จะทําการบวกอุปกรณ์ให้เสร็จลงในผ้าของตนเอง
การตั้งค่า
จากหน้าจอหลัก ให้คลิกไอคอน การตั้งค่า ในที่นี้จะมีตัวเลือกให้คุณ อัปเดตค่ากําหนดของผู้ใช้ รับความช่วยเหลือ และเรียนรู้เพิ่มเติมเกี่ยวกับแอปพลิเคชันนี้
การแจ้งเตือนครึ่งหน้า
จากหน้าจอการตั้งค่า คุณเลือกปิดใช้การแจ้งเตือน เชิงรุกที่ค้นพบได้สําหรับกรณี
หากแอปพลิเคชันมีขั้นตอนการค้นพบหรือค่าคอมมิชชันของตนเอง คุณอาจต้องระงับการแจ้งเตือนเหล่านี้เพื่อไม่ให้การทํางานหยุดชะงัก ดูข้อมูลเพิ่มเติมได้ที่ระงับการแจ้งเตือนการค้นพบที่เรียกเก็บเงินได้
ยูทิลิตีสําหรับนักพัฒนา
คุณยังสามารถเข้าถึงยูทิลิตีสําหรับนักพัฒนาจากหน้าจอการตั้งค่าได้
หากต้องการดูเนื้อหาของที่เก็บอุปกรณ์และค่ากําหนดผู้ใช้ของ DataStore ใน Logcat ให้ทําตามขั้นตอนต่อไปนี้
คลิกบันทึกเนื้อหาของที่เก็บ
คลิกตกลงที่กล่องโต้ตอบ แล้วเลือก Logcat
ความคิดเห็นและความช่วยเหลือ
หากต้องการส่งความคิดเห็นหรือความคิดเห็นของคุณเกี่ยวกับวิธีที่เราสามารถปรับปรุงประสบการณ์การพัฒนาด้วย Sample App for Matter ให้กรอกแบบฟอร์มความคิดเห็นให้ครบถ้วน
หากพบปัญหากับ Sample App for Matter ให้ลองทําตามขั้นตอนการยืนยันสภาพแวดล้อมให้เรียบร้อย
หากมีข้อสงสัยเกี่ยวกับการใช้แอปตัวอย่างหรือพบข้อบกพร่องของโค้ด คุณส่งปัญหาไปยังเครื่องมือติดตามปัญหาในที่เก็บ GitHub ได้โดยทําดังนี้
หากต้องการรับคําแนะนําอย่างเป็นทางการจาก Google สําหรับคําถามทางเทคนิค โปรดใช้ฟอรัมนักพัฒนาซอฟต์แวร์สมาร์ทโฮม
หากต้องการรับการสนับสนุนทางเทคนิคจากชุมชน ให้ใช้แท็ก google-smart-home ในสแต็คโอเวอร์โฟลว์