Halaman ini membahas penggunaan fitur API commissioning tertentu di Google Home Mobile SDK.
Menyembunyikan notifikasi penemuan yang dapat di-commission
Secara default, Google Play services di Android menggunakan"setengah layar" notifikasi yang mencakup bagian bawah layar perangkat seluler untuk memberi pengguna indikasi proaktif bahwa perangkat yang dapat di-commissionMatter berada di dekatnya.
Untuk mencegah gangguan saat aplikasi Anda berada di latar depan, Anda dapat
menyembunyikan notifikasi ini dengan memanggil
suppressHalfSheetNotification()
metode di Mobile SDK. Lihat dokumentasi API untuk mengetahui informasi selengkapnya.
Penyembunyian 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 setengah layar akan mulai muncul.
Implementasi API ini dapat ditemukan di
Google Home Sample App for Matter. Lihat
HalfSheetSuppressionObserver.kt
untuk mengetahui informasi selengkapnya.
Menunjukkan dukungan untuk commissioning Matter
Jika Anda menggunakan Mobile SDK untuk melakukan commissioning, Anda harus
menambahkan nama paket aplikasi
di Google Home Developer Console, menerapkan API Matter
kami, dan menunjukkan bahwa aplikasi Anda mendukung commissioning Matter
dengan menangani intent ACTION_COMMISSION_DEVICE.
Tambahkan intent-filter berikut ke deklarasi application dalam file AndroidManifest.xml:
<intent-filter>
<action android:name="com.google.android.gms.metadata.MODULE_DEPENDENCIES" />
</intent-filter>
Lihat manifes aplikasi contoh kami sebagai referensi.
Pemilih aplikasi
Ada dua cara aplikasi Anda muncul di pemilih aplikasi selama proses commissioning:
- Di layar Pilih aplikasi.
- Jika pengguna memilih Pilih aplikasi lain, aplikasi akan muncul di layar Aplikasi Terinstal Lainnya.
Aplikasi yang Disarankan
Pemilih aplikasi menampilkan dua aplikasi yang disarankan.
- Yang pertama selalu Google Home app (GHA).
- Yang kedua adalah aplikasi pilihan pembuat perangkat, jika ditentukan dalam project
Developer Console yang terkait dengan VID atau PID
perangkat.
Ada dua skenario saat aplikasi berada di layar Pilih aplikasi.
- Terinstal - Play services memeriksa apakah aplikasi mendukung filter intent
ACTION_COMMISSION_DEVICE. Jika filter intent tidak ada, pengguna akan diarahkan ke Play Store untuk mengupdate aplikasi. - Tidak Terinstal - Pengguna akan diarahkan ke Play Store untuk menginstal aplikasi sebelum melanjutkan.