การเริ่มต้นใช้งาน SDK สำหรับอุปกรณ์เคลื่อนที่ในบ้าน

หน้านี้ครอบคลุมการใช้งานฟีเจอร์ API บางอย่างสำหรับการเตรียมใช้งานใน Google Home Mobile SDK

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

การแจ้งเตือนแบบครึ่งหน้าของ Android
รูปที่ 1: ตัวอย่างการแจ้งเตือนแบบครึ่งหน้าจอของ Android

โดยค่าเริ่มต้น Google Play services ใน Android จะใช้"การแจ้งเตือนแบบครึ่งหน้าจอ" ซึ่งครอบคลุมครึ่งล่างของหน้าจออุปกรณ์เคลื่อนที่ เพื่อแจ้งให้ผู้ใช้ทราบล่วงหน้าว่ามีอุปกรณ์ Matter ที่เตรียมใช้งานได้อยู่ใกล้เคียง

หากต้องการป้องกันไม่ให้เกิดการขัดจังหวะขณะที่แอปของคุณทำงานอยู่เบื้องหน้า คุณสามารถ ระงับการแจ้งเตือนเหล่านี้ได้โดยเรียกใช้ suppressHalfSheetNotification() เมธอดใน Mobile SDK ดูข้อมูลเพิ่มเติมได้ในเอกสารประกอบเกี่ยวกับ API

การระงับที่เปิดใช้โดย API นี้จะหมดเวลาหากแอปของคุณทำงานอยู่เบื้องหน้าเป็นเวลานานกว่า 15 นาที หากต้องการเปิดใช้การระงับอีกครั้งหลังจากหมดเวลา ให้เรียกใช้ suppressHalfSheetNotification() อีกครั้ง ไม่เช่นนั้นการแจ้งเตือนแบบครึ่งหน้าจอจะเริ่มปรากฏขึ้น

ดูการติดตั้งใช้งาน API นี้ได้ใน Google Home Sample App for Matter ดูข้อมูลเพิ่มเติมได้ที่ HalfSheetSuppressionObserver.kt

ระบุการรองรับการเตรียมใช้งาน Matter

หากใช้ Mobile SDK ในการเตรียมใช้งาน คุณต้อง เพิ่มชื่อแพ็กเกจแอป ใน Google Home Developer Console ติดตั้งใช้งาน Matter API ของเรา และระบุว่าแอปของคุณรองรับการเตรียมใช้งาน Matter โดยจัดการ Intent ACTION_COMMISSION_DEVICE

เพิ่ม intent-filter ต่อไปนี้ลงในการประกาศ application ภายในไฟล์ AndroidManifest.xml

<intent-filter>
    <action android:name="com.google.android.gms.metadata.MODULE_DEPENDENCIES" />
</intent-filter>

ดูข้อมูลอ้างอิงได้ในไฟล์ Manifest ของแอปตัวอย่าง

เครื่องมือเลือกแอป

เครื่องมือเลือกแอป

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

  1. ในหน้าจอเลือกแอป
  2. หากผู้ใช้เลือกเลือกแอปอื่น แอปจะแสดงในหน้าจอแอปอื่นๆ ที่ติดตั้ง แล้ว

แอปที่แนะนำ

เครื่องมือเลือกแอปจะแสดงแอปที่แนะนำ 2 แอป

  • แอปแรกคือ Google Home app (GHA) เสมอ
  • แอปที่ 2 คือแอปที่ผู้ผลิตอุปกรณ์ต้องการ หากมีการกำหนดไว้ในโปรเจ็กต์ Developer Consoleที่เชื่อมโยงกับ VID หรือ PID ของ อุปกรณ์ แอปที่ผู้ผลิตอุปกรณ์แนะนำ

มี 2 สถานการณ์ที่แอปจะปรากฏในหน้าจอเลือกแอป

  1. ติดตั้งแล้ว - Play services จะตรวจสอบว่าแอปพลิเคชันรองรับตัวกรอง Intent ACTION_COMMISSION_DEVICE หรือไม่ หากไม่มีตัวกรอง Intent ระบบจะนำผู้ใช้ไปยัง Play Store เพื่ออัปเดตแอป
  2. ยังไม่ได้ติดตั้ง - ระบบจะนำผู้ใช้ไปยัง Play Store เพื่อติดตั้งแอป ก่อนดำเนินการต่อ