Halaman ini membahas penggunaan fitur API commissioning tertentu dalam Google Home Mobile SDK.
Sembunyikan notifikasi penemuan yang dapat dipesan
Secara default, Google Play services pada Android menggunakan notifikasi "halfsheet" yang menutupi bagian paruh bawah layar perangkat seluler untuk memberi pengguna indikasi proaktif bahwa perangkat Matter yang dapat dipesan berada di sekitar.
Untuk mencegah gangguan saat aplikasi berada di latar depan, Anda dapat
menyembunyikan notifikasi ini dengan memanggil metode
suppressHalfSheetNotification()
di Mobile SDK. Lihat dokumentasi API untuk informasi selengkapnya.
Penghentian yang diaktifkan oleh API ini akan habis waktunya jika aplikasi Anda berada di latar depan
selama lebih dari 15 menit. Untuk mengaktifkan kembali penyembunyian setelah waktu tunggu habis, panggil
suppressHalfSheetNotification()
lagi. Jika tidak, notifikasi halfsheet
akan mulai muncul.
Implementasi API ini dapat ditemukan di
Google Home Sample App for Matter. Lihat HalfSheetSuppressionObserver.kt
untuk informasi selengkapnya.
Menunjukkan dukungan untuk commissioning Matter
Jika menggunakan Mobile SDK untuk melakukan komisi, Anda harus
menambahkan nama paket aplikasi
di Google Home Developer Console, menerapkan Matter API
kami, dan menunjukkan bahwa aplikasi Anda mendukung pengiriman Matter
dengan menangani intent ACTION_COMMISSION_DEVICE
.
Tambahkan intent-filter
berikut ke deklarasi application
dalam file
AndroidManifest.xml
Anda:
<intent-filter>
<action android:name="com.google.android.gms.metadata.MODULE_DEPENDENCIES" />
</intent-filter>
Lihat contoh manifes aplikasi untuk referensi.
Pemilih aplikasi
Ada dua cara untuk memunculkan aplikasi Anda di alat pilih aplikasi selama proses commissioning:
- Di layar Pilih aplikasi.
- Jika pengguna memilih Pilih aplikasi lain, aplikasi tersebut akan ditampilkan di layar Aplikasi Terinstal Lainnya.
Aplikasi yang Disarankan
Alat pilih aplikasi menampilkan dua aplikasi yang disarankan.
- Yang pertama selalu Google Home app (GHA).
- Yang kedua adalah untuk aplikasi pilihan dari produsen perangkat, jika ditentukan dalam project Developer Console yang terkait dengan VID atau PID perangkat.
Ada dua skenario jika aplikasi berada di layar Pilih aplikasi.
- Terinstal - Play services pastikan aplikasi mendukung
filter intent
ACTION_COMMISSION_DEVICE
. Jika filter intent tidak ada, pengguna akan diarahkan ke Play Store untuk mengupdate aplikasi. - Tidak Diinstal - Pengguna diarahkan ke Play Store untuk menginstal aplikasi sebelum melanjutkan.