แอปตัวอย่างของ Google Home สําหรับกรณี

แอปตัวอย่างของ Google Home สำหรับ Matter

Google Home Sample App for Matter ใช้ Google Home Mobile SDK ในการสร้างแอป Android ที่คล้ายกับ Google Home app (GHA) แอปตัวอย่างนี้มีฟีเจอร์ต่อไปนี้

  • อุปกรณ์Matter จริงและเสมือนของค่าคอมมิชชัน Android Fabric ในพื้นที่
  • มอบหมายอุปกรณ์จริงและอุปกรณ์เสมือนให้แพลตฟอร์มสำหรับการพัฒนา
  • ควบคุมอุปกรณ์บน Fabric สำหรับการพัฒนาซอฟต์แวร์ของคุณ เช่น การเปิด ไฟ
  • ฟีเจอร์สำหรับผู้ดูแลระบบหลายคนช่วยให้คุณแชร์อุปกรณ์ในระบบการพัฒนาได้ กับแอปอื่นๆ และในทางกลับกัน ก็ให้รวมไว้ในการพัฒนา อุปกรณ์ Fabric ที่ใช้ร่วมกันจากแอปอื่น
  • ยูทิลิตีสำหรับนักพัฒนาซอฟต์แวร์

คู่มือนี้อธิบายวิธีติดตั้ง APK ของ Sample App for Matter และใช้ เพื่อค่าคอมมิชชัน ควบคุม และแชร์อุปกรณ์ Matter เครื่องได้

หากต้องการดาวน์โหลดซอร์สโค้ด ให้ดูวิธีผสานรวม Mobile SDK และปรับแต่งหน้าจอใน Android Studio โปรดลองใช้ Codelab ของ Sample App for Matter

ไปที่ Codelab ของ Sample App for Matter

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

คุณไม่จำเป็นต้องใช้ฮับ เช่น Google Nest Hub (2nd gen) เพื่อค่าคอมมิชชัน และควบคุมอุปกรณ์ด้วย Sample App for Matter

ติดตั้ง

  1. ไปที่ส่วนรุ่น ใน Sample App for Matter GitHub ที่เก็บได้ หากต้องการดูผลงานล่าสุด ให้ดูในส่วน "เนื้อหา" APK ชื่อ GHSAFM-version-default-debug.apk อย่าเลือก targetcommissioner

  2. ติดตั้ง Android Debug Bridge (adb)

    ติดตั้ง adb

  3. เชื่อมต่ออุปกรณ์ Android ด้วย USB แล้วเปิดใช้ File Transfer จากนั้น ติดตั้ง APK

    $ adb unroot && adb install GHSAFM-version-default-debug.apk

อุปกรณ์ค่าคอมมิชชัน

เมื่อเปิดแอปตัวอย่างเป็นครั้งแรก คุณจะเห็นกล่องโต้ตอบ ลิงก์ไปยัง Sample App for Matter Codelab หากเลือกไม่ต้องแสดงข้อความนี้อีก คุณจะนำกล่องโต้ตอบดังกล่าวกลับมาได้ ได้ทุกเมื่อด้วยการอัปเดตค่ากำหนดในส่วนผู้ดูแลระบบของแอป

ในขั้นตอนถัดไป คุณจะต้องเพิ่มอุปกรณ์ Matter ลงใน Android Fabric ที่ผลิตในท้องถิ่น ตลอดจนผ้าเพื่อการพัฒนาที่พร้อมให้คุณทดลองใช้โดยเฉพาะ แอปเท่านั้น

Matter Fabric คืออะไร

แอปตัวอย่างของ Google Home สำหรับ Matter

Fabric Matter เป็นโดเมนที่เชื่อถือได้ซึ่งใช้ร่วมกันระหว่างอุปกรณ์ต่างๆ ในเครือข่ายภายในบ้านที่ทำให้พวกเขาสื่อสารกันได้

อุปกรณ์อาจมี Fabric อย่างน้อย 1 รายการที่สอดคล้องกับแพลตฟอร์ม แอป หรือกลุ่มอุปกรณ์ที่ทำงานร่วมกัน ผ้ามีลักษณะเฉพาะ รหัส และอุปกรณ์จะใช้ข้อมูลเข้าสู่ระบบและผู้ออกใบรับรองชุดเดียวกัน (CA) ระบบจะกำหนดข้อมูลเข้าสู่ระบบเหล่านี้ในช่วง Matter การจัดเตรียม

หากต้องการจัดเตรียมอุปกรณ์ Matter ให้ทำตามขั้นตอนต่อไปนี้

  1. แตะ "เพิ่ม" ปุ่มอุปกรณ์เพื่อเริ่มขั้นตอนการเริ่มใช้งาน

    เพิ่มอุปกรณ์

  2. ถัดไป ระบบจะโอนการควบคุมไปยัง Google Play services ซึ่งเปิดตัวแล้ว จากการโทรไปยัง Mobile SDK ในการส่งหลักฐาน ครอบครอง ให้สแกนคิวอาร์โค้ด หรือแตะใช้รหัสการจับคู่

    สแกนโค้ด QR

  3. เมื่อดำเนินการเสร็จแล้ว ให้ป้อนชื่ออุปกรณ์ แล้วแตะเสร็จสิ้น

ตอนนี้อุปกรณ์ของคุณเชื่อมต่อกับทั้ง Fabric ของ Android ในพื้นที่และ Fabric ของการพัฒนาแล้ว

งานที่จัดเตรียมไว้และหน้าจอที่เกี่ยวข้องทั้งหมดจะจัดการโดย Play servicesเมื่อจัดเตรียมอุปกรณ์ วิธีนี้จะช่วยให้ผู้ใช้ได้รับประสบการณ์การใช้งานที่สอดคล้องกันและไม่ต้องจัดการสิทธิ์ที่มีความละเอียดอ่อน เช่น ข้อมูลเข้าสู่ระบบ Wi-Fi และเทรด

ควบคุมอุปกรณ์

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

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

เพิ่มอุปกรณ์แล้ว

แชร์อุปกรณ์

การแชร์อุปกรณ์เรียกว่าขั้นตอนการแชร์สำหรับหลายผู้ดูแลระบบในข้อกำหนด Matter เมื่ออุปกรณ์ได้รับมอบหมายแอปตัวอย่างแล้ว คุณจะแชร์ได้ง่ายๆ กับระบบนิเวศอื่นๆ

หากต้องการแชร์อุปกรณ์ Matter กับระบบนิเวศอื่นๆ คุณจะต้องติดตั้งแพลตฟอร์มอื่นในอุปกรณ์ Android ช่วงเวลานี้ แพลตฟอร์มภายนอกจะกลายเป็นค่าคอมมิชชันเป้าหมาย เราได้สร้างอินสแตนซ์อื่นของแอปตัวอย่างที่คุณใช้เป็นผู้อนุญาตเป้าหมายได้

  1. ไปที่ส่วนรุ่น ใน Sample App for Matter GitHub ที่เก็บได้ หากต้องการดูผลงานล่าสุด ให้ดูในส่วน "เนื้อหา" APK ชื่อ GHSAFM-version-targetcommissioner-debug.apk อย่าเลือก default

  2. ติดตั้งผู้ประเมินเป้าหมาย

    $ adb unroot && adb install GHSAFM-version-targetcommissioner-debug.apk

  3. จากหน้าจอหลัก ให้แตะอุปกรณ์เพื่อแสดงข้อมูลอุปกรณ์ แตะ แชร์

    แชร์อุปกรณ์

แอปตัวอย่างจะเรียก Mobile SDK Share API แล้วดำเนินการอีกครั้ง โอนการควบคุมไปยัง Play services แล้ว

ระบบจะแสดงชีตที่แชร์ ซึ่งช่วยให้คุณสามารถเลือกแอปหรือแพลตฟอร์มที่ ต้องการจับคู่อุปกรณ์ด้วย หน้าจอนี้มีวิธีการแชร์ 2 วิธี อุปกรณ์:

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

แอปค่าคอมมิชชันเป้าหมายจะติดป้ายกำกับเป็น GHSAFM-TC แตะอินสแตนซ์ของ แอปตัวอย่างเพื่อแชร์อุปกรณ์ของคุณ

จากนั้น แอปภายนอก (เจ้าหน้าที่เป้าหมาย) จะดำเนินการฟังก์ชัน มาทำเป็นผ้าของตัวเอง

การตั้งค่า

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

การตั้งค่า

การแจ้งเตือน Halfsheet

จากหน้าจอการตั้งค่า คุณเลือกปิดใช้การรับค่าคอมมิชชันเชิงรุกได้ การแจ้งเตือนการค้นพบสำหรับอุปกรณ์ Matter เครื่อง

หากแอปพลิเคชันของคุณมีการค้นหา Matter ของตนเอง หรือ เราขอแนะนำให้คุณระงับการแจ้งเตือนเหล่านี้เพื่อป้องกัน การรบกวน ดูระงับการค้นพบที่ได้รับค่าคอมมิชชัน การแจ้งเตือน เพื่อดูข้อมูลเพิ่มเติม

ยูทิลิตีของนักพัฒนาซอฟต์แวร์

จากหน้าจอการตั้งค่า คุณยังเข้าถึงยูทิลิตีสําหรับนักพัฒนาซอฟต์แวร์ได้ด้วย

วิธีตรวจสอบเนื้อหาในที่เก็บ Device and User Preferences DataStore ใน Logcat ให้ทำตามขั้นตอนต่อไปนี้

  1. คลิกบันทึกเนื้อหาของที่เก็บ

  2. คลิกตกลงในกล่องโต้ตอบ แล้วเลือก Logcat

ความคิดเห็นและความช่วยเหลือ

เพื่อส่งความคิดเห็นหรือความคิดเห็นของคุณเกี่ยวกับวิธีที่เราสามารถปรับปรุงการพัฒนา ประสบการณ์เกี่ยวกับ Sample App for Matter ด้วยการกรอกแบบฟอร์มความคิดเห็น

ส่งความคิดเห็นถึงเรา

หากคุณมีปัญหาเกี่ยวกับSample App for Matter ให้ลองกรอก ขั้นตอนในการยืนยันสภาพแวดล้อมของคุณ

หากมีข้อสงสัยเกี่ยวกับการใช้แอปตัวอย่างหรือพบข้อบกพร่องของโค้ด คุณสามารถส่งปัญหาไปยังเครื่องมือติดตามปัญหาในที่เก็บ GitHub ได้โดยทำดังนี้

หากต้องการคำแนะนำอย่างเป็นทางการจาก Google สำหรับคำถามทางเทคนิค ให้ใช้สมาร์ทโฮม ฟอรัมนักพัฒนาซอฟต์แวร์:

หากต้องการรับการสนับสนุนด้านเทคนิคจากชุมชน ให้ใช้แท็ก google-smart-home ใน สแต็กโอเวอร์โฟลว์: