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

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

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

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

คู่มือนี้จะอธิบายวิธีติดตั้ง Sample App for Matter APK และใช้เพื่อจัดเตรียม ควบคุม และแชร์อุปกรณ์ 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. ไปที่ส่วนรุ่นในที่เก็บ Sample App for Matter GitHub สำหรับรุ่นล่าสุด ให้ค้นหา APK ชื่อ GHSAFM-version-default-debug.apk ในส่วนเนื้อหา อย่าเลือก targetcommissioner

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

    ติดตั้ง adb

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

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

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

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

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

Matter Fabric คืออะไร

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

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

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

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

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

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

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

    สแกนโค้ด QR

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

ตอนนี้อุปกรณ์ของคุณเชื่อมต่อกับทั้ง Local 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 Commissioner

แอปผู้ร่วมให้ข้อมูลเป้าหมายมีป้ายกำกับว่า GHSAFM-TC แตะอินสแตนซ์นี้ของแอปตัวอย่างเพื่อแชร์อุปกรณ์

จากนั้นแอปภายนอก (ผู้จัดซื้อเป้าหมาย) จะดําเนินการทดสอบอุปกรณ์ใน Fabric ของตนเองให้เสร็จสมบูรณ์

การตั้งค่า

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

การตั้งค่า

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

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

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

ยูทิลิตีสำหรับนักพัฒนาแอป

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

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

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

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

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

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

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

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

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

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

หากต้องการรับการสนับสนุนด้านเทคนิคจากชุมชน ให้ใช้แท็ก google-smart-home ใน Stack Overflow โดยทำดังนี้