โปรดทราบ โปรแกรมทดลองใช้สําหรับนักพัฒนาซอฟต์แวร์ใหม่จะเปิดตัวเร็วๆ นี้ สมัครที่นี่ และร่วมเป็นหนึ่งในคนกลุ่มแรกที่ได้ลองใช้เครื่องมือใหม่ๆ และแสดงความคิดเห็น

แอปตัวอย่างของ 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

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

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

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

การตั้งค่า

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

การตั้งค่า

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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