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