การเริ่มต้นใช้งาน 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 ใช้ 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 เพื่อติดตั้งแอปก่อนดำเนินการต่อ