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

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

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

Google Home Sample App for Matter uses the Google Home Mobile SDK to create an Android app that's similar to Google Home app (GHA) . This sample app provides the following features:

  • ค่าคอมมิชชันทั้งในรูปแบบเสมือนจริงและแบบเสมือนจริง Matter devices to the Local Android fabric
  • ออกแบบอุปกรณ์เสมือนจริงและอุปกรณ์เสมือนจริงให้แก่สิ่งทอ
  • ควบคุมอุปกรณ์บนผ้าสําหรับการพัฒนา เช่น เปิดไฟ
  • ฟีเจอร์สําหรับผู้ดูแลระบบหลายตัวช่วยให้คุณแชร์อุปกรณ์บนผ้าสําหรับพัฒนาซอฟต์แวร์ กับแอปอื่นๆ ได้ และสามารถเพิ่มไว้ในอุปกรณ์การพัฒนา ที่แชร์จากแอปอื่นๆ ได้
  • นักพัฒนาซอฟต์แวร์สาธารณูปโภค

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

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

ไปที่ Codelab Sample App for Matter

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

คุณไม่จําเป็นต้องใช้ฮับ เช่น Google Nest Hub (2nd gen) , to commission and control devices with the Sample App for Matter.

ติดตั้ง

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

    ดาวน์โหลด APK

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

    ติดตั้ง adb

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

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

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

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

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

ผ้า Matter คืออะไร

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

Canvas เป็นโดเมนที่เชื่อถือได้ร่วมกันระหว่างอุปกรณ์ต่างๆ ในเครือข่ายภายในบ้านที่ช่วยให้แต่ละฝ่ายสื่อสารกันได้

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

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

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

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

  2. ถัดไป การควบคุมจะถูกโอนไปยัง Google Play services , which is launched from a call to the Mobile SDK. To establish proof of possession, Scan QR code or tap Use pairing code.

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

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

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

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

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

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

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

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

แชร์อุปกรณ์

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

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

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

    ดาวน์โหลดค่าคอมมิชชันเป้าหมาย

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

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

    แชร์อุปกรณ์

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

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

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

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

ถัดไป แอปภายนอก (ค่าคอมมิชชันเป้าหมาย) จะว่าจ้างอุปกรณ์ให้เสร็จสมบูรณ์

การตั้งค่า

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

การตั้งค่า

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

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

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

ยูทิลิตีสําหรับนักพัฒนาซอฟต์แวร์

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

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

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

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

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

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

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

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

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

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

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