การเริ่มต้นใช้งาน 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, ใช้ API ของ Matter และระบุว่าแอปของคุณรองรับการจัดสรร 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 เพื่อติดตั้งแอปก่อนดำเนินการต่อ