Home Mobile SDK Commissioning

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

Menekan notifikasi penemuan yang dapat menghasilkan komisi

Notifikasi Setengah Layar Android
Gambar 1: Contoh notifikasi setengah layar Android

Secara default, Google Play services di Android menggunakan notifikasi "setengah layar" yang menutupi setengah bagian bawah layar perangkat seluler untuk memberikan indikasi proaktif kepada pengguna bahwa perangkat Matter yang dapat memperoleh komisi berada di dekatnya.

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

Penekanan yang diaktifkan oleh API ini akan berakhir jika aplikasi Anda berada di latar depan selama lebih dari 15 menit. Untuk mengaktifkan kembali penekanan setelah waktu tunggu berakhir, 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 penyiapan Matter

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

Pemilih aplikasi

Ada dua cara aplikasi Anda muncul di pemilih aplikasi selama proses penyiapan:

  1. Di layar Pilih aplikasi.
  2. Jika pengguna memilih Pilih aplikasi lain, opsi ini akan ditampilkan 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 untuk aplikasi pilihan pembuat perangkat, jika ditentukan dalam project Developer Console yang terkait dengan VID atau PID perangkat. Aplikasi komisioner pilihan pembuat perangkat

Ada dua skenario saat aplikasi berada di layar Pilih aplikasi.

  1. Terinstal - 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.