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

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

ระงับการแจ้งเตือนการค้นพบที่ได้รับค่าคอมมิชชัน

การแจ้งเตือน Halfsheet ของ 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 ใช้ MatterAPI ของเรา รวมถึงระบุว่าแอปของคุณรองรับค่าคอมมิชชัน 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 เพื่อติดตั้งแอปก่อนที่จะดำเนินการต่อ