แอปตัวอย่างของ 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 การพัฒนากับแอปอื่นๆ ได้ และในทางกลับกันก็สามารถรวมอุปกรณ์ที่แชร์จากแอปอื่นๆ ไว้ใน Fabric การพัฒนาได้
  • ยูทิลิตีสำหรับนักพัฒนาแอป

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

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

ไปที่ 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 ในพื้นที่ พร้อมกับแพลตฟอร์มการพัฒนาที่อยู่ในอุปกรณ์ของตัวอย่างแอปเท่านั้น

Matter Fabric คืออะไร

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

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

อุปกรณ์อาจมี 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 แตะอินสแตนซ์นี้ของแอปตัวอย่างเพื่อแชร์อุปกรณ์

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

การตั้งค่า

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

การตั้งค่า

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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