Home Mobile SDK Commissioning

Halaman ini membahas penggunaan fitur API pemilihan tertentu di Google Home Mobile SDK.

Sembunyikan notifikasi penemuan yang dilakukan dengan komisi

Secara default, Google Play services di Android menggunakan notifikasi "halfsheet" yang menutupi separuh bagian bawah layar perangkat seluler untuk memberikan indikasi proaktif kepada pengguna bahwa perangkat Matter yang dapat dijalankan berada di sekitar.

Untuk mencegah gangguan saat aplikasi berada di latar depan, Anda dapat menekan notifikasi ini dengan memanggil metode suppressHalfSheetNotification() di Mobile SDK. Lihat dokumentasi API untuk informasi selengkapnya.

Pembatalan yang diaktifkan oleh API ini akan habis jika aplikasi Anda berada di latar depan selama lebih dari 15 menit. Untuk mengaktifkan kembali penyembunyian setelah waktu tunggu, panggil suppressHalfSheetNotification() lagi, jika tidak, notifikasi setengah sheet akan mulai muncul.

Implementasi API ini dapat ditemukan di Google Home Sample App for Matter. Lihat HalfSheetSuppressionObserver.kt untuk informasi selengkapnya.

Menunjukkan dukungan untuk komisi Matter

Jika menggunakan Mobile SDK untuk komisi, Anda harus menambahkan nama paket aplikasi di Google Home Developer Console, menerapkan Matter API kami, dan menunjukkan bahwa aplikasi Anda mendukung komisi 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 manifes aplikasi contoh kami sebagai referensi.

Pemilih aplikasi

Ada dua cara aplikasi Anda muncul di alat pilih aplikasi selama proses Komisi:

1. Di layar Pilih aplikasi.
2. Jika pengguna memilih Pilih aplikasi lain, aplikasi akan ditampilkan di layar Aplikasi Diinstal Lainnya.

Aplikasi yang Disarankan

Alat pilih aplikasi menampilkan dua aplikasi yang disarankan.

• Yang pertama selalu Google Home app (GHA).
• Yang kedua adalah untuk aplikasi pembuat perangkat pilihan, jika ditentukan dalam project Developer Console yang terkait dengan VID atau PID perangkat.

Ada dua skenario saat aplikasi berada di layar Choose an app.

1. Diinstal - Play services periksa apakah aplikasi mendukung filter intent ACTION_COMMISSION_DEVICE. Jika filter intent tidak ada, pengguna akan diarahkan ke Play Store untuk mengupdate aplikasi.
2. Tidak Diinstal - Pengguna diarahkan ke Play Store untuk menginstal aplikasi sebelum melanjutkan.