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
เป็นรหัสผลิตภัณฑ์ - สร้างอุปกรณ์เอสเปรสโซด้วย
all-clusters-app
เมื่อคุณ สร้างการผสานรวม Matter ใน Developer Console ให้ใช้0xFFF1
เป็นรหัสผู้ให้บริการ และใช้0x8001
เป็นรหัสผลิตภัณฑ์
- สร้างอุปกรณ์เสมือน Matterด้วยแอป
คุณไม่จําเป็นต้องมีฮับ เช่น Google Nest Hub (2nd gen) เพื่อค่าคอมมิชชันและควบคุมอุปกรณ์ด้วย Sample App for Matter
ติดตั้ง
ไปที่ส่วน "รุ่น" ในที่เก็บ Sample App for Matter ของ GitHub ค้นหา APK ชื่อ
GHSAFM-1.2.2-default-debug.apk
อย่าเลือกtargetcommissioner
:ติดตั้ง Android Debug Bridge (adb):
เชื่อมต่ออุปกรณ์ Android กับ USB และเปิดใช้ File Transfer จากนั้นติดตั้ง APK ดังนี้
$ adb unroot && adb install GHSAFM-1.2.2-default-debug.apk
อุปกรณ์ค่าคอมมิชชัน
เมื่อเปิดแอปตัวอย่างเป็นครั้งแรก คุณจะได้รับกล่องโต้ตอบที่มีลิงก์ไปยัง Sample App for Matter Codelab หากเลือกไม่ต้องแสดงข้อความนี้อีก คุณสามารถย้ายกล่องโต้ตอบกลับมาได้ทุกเมื่อโดยอัปเดตค่ากําหนดในส่วนผู้ดูแลระบบของแอป
ในขั้นตอนถัดไป คุณจะต้องเพิ่มอุปกรณ์ Matter ลงในผ้า Android ในเครื่อง ตลอดจนผ้าสําหรับการพัฒนาที่ใช้เก็บแอปตัวอย่างเท่านั้น
ผ้า Matter คืออะไร
Canvas เป็นโดเมนที่เชื่อถือได้ร่วมกันระหว่างอุปกรณ์ต่างๆ ในเครือข่ายภายในบ้านที่ช่วยให้แต่ละฝ่ายสื่อสารกันได้
อุปกรณ์อาจมีผ้าอย่างน้อย 1 ชิ้นที่สอดคล้องกับแพลตฟอร์ม แอป หรือกลุ่มอุปกรณ์ที่โต้ตอบกัน สิ่งทอจะมีรหัสที่ไม่ซ้ํากัน และอุปกรณ์จะใช้ข้อมูลเข้าสู่ระบบและผู้ออกใบรับรองชุดเดียวกัน (CA) ข้อมูลเข้าสู่ระบบเหล่านี้ได้รับการกําหนดระหว่างMatterค่าคอมมิชชัน
หากต้องการค่าคอมมิชชันสําหรับอุปกรณ์ Matter ให้ทําตามขั้นตอนต่อไปนี้
แตะปุ่ม
เพิ่มอุปกรณ์ เพื่อเริ่มขั้นตอนการว่าจ้างจากนั้นการควบคุมจะโอนไปยัง Google Play services ซึ่งเปิดใช้งานจากการโทรไปยัง Mobile SDK หากต้องการส่งหลักฐานการครอบครอง ให้สแกนคิวอาร์โค้ด หรือแตะใช้รหัสการจับคู่
เมื่อค่าคอมมิชชันเสร็จสมบูรณ์ ให้ป้อนชื่ออุปกรณ์ แล้วแตะเสร็จสิ้น
ปัจจุบันอุปกรณ์ของคุณเชื่อมต่อกับทั้งผ้า Android และผ้าพัฒนาการแล้ว
การว่าจ้างงานและหน้าจอที่เกี่ยวข้องทั้งหมดจะจัดการโดย Play services เมื่อกําหนดให้อุปกรณ์ค่าคอมมิชชัน วิธีนี้จะช่วยให้ผู้ใช้ได้รับประสบการณ์ที่สม่ําเสมอและลดความจําเป็นในการจัดการสิทธิ์ที่มีความละเอียดอ่อน เช่น ข้อมูลเข้าสู่ระบบ Wi-Fi และชุดข้อความ
ควบคุมอุปกรณ์
สิ่งทอพัฒนาจะสร้างข้อมูลเข้าสู่ระบบเพื่อควบคุมอุปกรณ์ Matter จากแอปตัวอย่างโดยตรง
จากหน้าจอหลัก คุณจะสลับอุปกรณ์เป็นเปิดหรือปิดก็ได้ แตะอุปกรณ์เพื่อเข้าถึงรายละเอียดอุปกรณ์
แชร์อุปกรณ์
การแชร์อุปกรณ์จะเรียกว่าขั้นตอนหลายผู้ดูแลระบบในข้อมูลจําเพาะของ Matter เมื่อระบบกําหนดให้อุปกรณ์ใช้งานแอปตัวอย่าง คุณจะแชร์อุปกรณ์กับระบบนิเวศอื่นๆ ได้อย่างง่ายดาย
หากต้องการแชร์อุปกรณ์ Matter กับระบบนิเวศอื่นๆ คุณจะต้องติดตั้งแพลตฟอร์มอื่นในอุปกรณ์ Android แพลตฟอร์มภายนอกนี้จะเป็นค่าคอมมิชชันเป้าหมาย เราได้สร้างอินสแตนซ์แอปตัวอย่างอีกรายการที่คุณสามารถใช้เป็นค่าคอมมิชชันเป้าหมาย
ไปที่ส่วน "รุ่น" ในที่เก็บ Sample App for Matter ของ GitHub ค้นหา APK เวอร์ชันล่าสุดชื่อ
GHSAFM-[version]-targetcommissioner
เช่นGHSAFM-1.2.2-targetcommissioner-debug.apk
:ติดตั้งค่าคอมมิชชันเป้าหมาย
$ adb unroot && adb install GHSAFM-1.0.1-targetcommissioner-debug.apk
จากหน้าจอหลัก ให้แตะอุปกรณ์เพื่อแสดงข้อมูลอุปกรณ์ แตะ แชร์
แอปตัวอย่างเรียก Mobile SDK API การแชร์ และอีกครั้งก็จะโอนการควบคุมไปยัง Play services
การ์ดการแชร์จะปรากฏขึ้น ให้คุณเลือกแอปหรือแพลตฟอร์มที่ต้องการจับคู่อุปกรณ์ได้ หน้าจอนี้ให้คุณแชร์อุปกรณ์ได้ 2 วิธี ดังนี้
- แชร์ด้วยตนเองผ่านรหัสการตั้งค่าเพื่อแชร์กับแอปค่าคอมมิชชันเป้าหมาย
- ใช้แอป Android ในพื้นที่ซึ่งลงทะเบียนเป็นค่าคอมมิชชัน Matter
แอปค่าคอมมิชชันเป้าหมายจะมีป้ายกํากับ GHSAFM-TC แตะอินสแตนซ์ของแอปตัวอย่างเพื่อแชร์อุปกรณ์
ถัดไป แอปภายนอก (ค่าคอมมิชชันเป้าหมาย) จะว่าจ้างอุปกรณ์ให้เสร็จสมบูรณ์
การตั้งค่า
จากหน้าจอหลัก ให้คลิกไอคอนการตั้งค่า
คุณมีตัวเลือกในการอัปเดตค่ากําหนดของผู้ใช้ รับความช่วยเหลือ และดูข้อมูลเพิ่มเติมเกี่ยวกับแอปได้ที่นี่ยูทิลิตีสําหรับนักพัฒนาซอฟต์แวร์
จากหน้าจอการตั้งค่า คุณสามารถเข้าถึงยูทิลิตีสําหรับนักพัฒนาซอฟต์แวร์ได้ด้วย
หากต้องการตรวจสอบเนื้อหาของที่เก็บอุปกรณ์และการตั้งค่าของผู้ใช้ DataStore ใน Logcat ให้ทําตามขั้นตอนต่อไปนี้
คลิกบันทึกเนื้อหาที่เก็บ
คลิกตกลงในกล่องโต้ตอบ แล้วเลือก Logcat
ความคิดเห็นและความช่วยเหลือ
หากต้องการส่งความคิดเห็นหรือความคิดเห็นของคุณเกี่ยวกับวิธีที่เราปรับปรุงประสบการณ์การพัฒนาด้วย Sample App for Matter โปรดกรอกแบบฟอร์มความคิดเห็น
หากพบปัญหาเกี่ยวกับ Sample App for Matter ให้ลองทําตามขั้นตอนเพื่อยืนยันสภาพแวดล้อมให้เสร็จสมบูรณ์
หากมีข้อสงสัยเกี่ยวกับการใช้แอปตัวอย่างหรือสํารวจข้อบกพร่องของโค้ด คุณส่งปัญหาไปยังเครื่องมือติดตามปัญหาในที่เก็บ GitHub ได้โดยทําดังนี้
หากต้องการคําแนะนําอย่างเป็นทางการจาก Google สําหรับคําถามทางเทคนิค ให้ใช้ฟอรัมนักพัฒนาซอฟต์แวร์สมาร์ทโฮม โดยทําดังนี้
หากต้องการรับการสนับสนุนด้านเทคนิคจากชุมชน ให้ใช้แท็ก google-smart-home
ใน Stack Overflow