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

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

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

สิ่งที่ต้องดำเนินการก่อน

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

ติดตั้ง

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

    ดาวน์โหลด APK

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

    ติดตั้ง adb

  3. เชื่อมต่ออุปกรณ์ Android กับ USB และเปิดใช้การโอนไฟล์ แล้วติดตั้ง APK ดังนี้

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

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

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

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

ผ้าของ Matter คืออะไร

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

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

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

หากต้องการมอบหมายอุปกรณ์ Matter ให้ทําตามขั้นตอนต่อไปนี้

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

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

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

    สแกนคิวอาร์โค้ด

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

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

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

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

กลุ่มการพัฒนาจะสร้างข้อมูลเข้าสู่ระบบเพื่อควบคุมอุปกรณ์ Matter จากแอปตัวอย่างโดยตรง

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

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

แชร์อุปกรณ์

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

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

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

    ดาวน์โหลด Target Commissioner

  2. ติดตั้งค่าคอมมิชชันเป้าหมาย

    $ adb unroot && adb install GHSAFM-1.4.1-targetcommissioner-debug.apk
    
  3. จากหน้าจอหลัก ให้แตะอุปกรณ์เพื่อแสดงข้อมูลอุปกรณ์ แตะแชร์

    แชร์อุปกรณ์

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

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

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

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

ต่อจากนั้น แอปภายนอก (นายหน้าเป้าหมาย) จะทําการบวกอุปกรณ์ให้เสร็จลงในผ้าของตนเอง

การตั้งค่า

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

การตั้งค่า

การแจ้งเตือนครึ่งหน้า

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

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

ยูทิลิตีสําหรับนักพัฒนา

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

หากต้องการตรวจสอบเนื้อหาของที่เก็บข้อมูลอุปกรณ์และพื้นที่เก็บข้อมูลของผู้ใช้ ใน Logcat ให้ทําตามขั้นตอนต่อไปนี้

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

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

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

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

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

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

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

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

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