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