Alur aktivasi di aplikasi Anda menggunakan Commissioning API dapat dimulai dengan dua cara: langsung di aplikasi Anda, atau melalui pemilih aplikasi dalam proses Fast Pair. Bagian ini membahas pengalaman pengguna (UX) untuk setiap jenis.
Dimulai oleh aplikasi
Dalam skenario ini, pengguna memulai proses aktivasi di aplikasi Anda, biasanya dari pesan ajakan (CTA) "Tambahkan Perangkat". Sebaiknya tampilkan tombol Tambahkan Perangkat sebagai berikut:
- Tempat pengguna melihat semua perangkat mereka, seperti halaman Kontrol
- Tempat pengguna dapat mengelola rumah, seperti halaman Setelan
- Halaman Beranda aplikasi Anda
Setelah proses aktivasi selesai, sebaiknya arahkan pengguna ke Halaman beranda aplikasi, atau ke lokasi di aplikasi yang menampilkan pengontrol perangkat yang baru saja disiapkan atau menampilkan daftar lengkap semua perangkat, termasuk perangkat yang baru saja disiapkan.
UX diilustrasikan dalam Gambar 2:
Pengguna aplikasi mengklik Tambahkan perangkat.
Pengguna memindai kode QR atau memasukkan kode penyambungan.
Pengguna akan diminta untuk menyetujui penambahan perangkat ke platform Google (ini sesuai dengan "Izin + Metadata" pada Gambar 1) dan memilih Akun Google yang akan digunakan.
Jika pengguna memiliki lebih dari satu Rumah, mereka akan diminta untuk memilih Rumah. Jika mereka belum menyiapkan Rumah, Rumah bernama "Rumah" akan dibuat secara otomatis.
Commissioning API terhubung ke perangkat.
Pengguna akan diminta untuk memilih ruangan tempat perangkat berada.
Pengguna diminta untuk mengganti nama perangkat.
Commissioning API membuat kredensial Matter, memeriksa konektivitas jaringan, lalu menjalankan proses commissioning, menghubungkan perangkat ke fabric yang dipilih.
Jika izin ke struktur dan perangkat pengguna telah diberikan, perangkat akan muncul di Home bersama dengan perangkat lain di Home tersebut, dan dapat dikontrol menggunakan aplikasi.
Jika izin ke struktur dan perangkat pengguna belum diberikan, perangkat belum dapat dilihat atau dikontrol di aplikasi. Izin diperlukan untuk mengakses dan mengontrol perangkat di aplikasi.
Dimulai oleh Sambungan Cepat
Proses aktivasi juga dapat dimulai menggunakan Sambungan Cepat di Android. Setelah memindai kode QR Matter perangkat, pengguna akan diminta untuk memilih aplikasi guna melanjutkan proses aktivasi. Memilih aplikasi Anda menggunakan Commissioning API dari aplikasi, seperti yang diilustrasikan dalam Gambar 3.
Jika pengguna belum menginstal aplikasi di perangkat selulernya, mereka akan diminta untuk menginstal sebelum melanjutkan. UX dari layar izin dan seterusnya sama dengan yang ada di Gambar 2.
Pengguna diminta untuk memindai kode QR.
Pengguna memindai kode QR Matter perangkat.
Pengguna diminta memilih aplikasi untuk melanjutkan proses aktivasi.
Jika aplikasi belum diinstal, pengguna akan diminta untuk menginstalnya.
Aplikasi didownload dari Google Play Store.
Aplikasi diinstal.
Setelah aplikasi berhasil diinstal, pengguna akan diminta untuk melanjutkan.
Pengguna akan diminta untuk menyetujui penambahan perangkat ke platform Google (ini sesuai dengan "Izin + Metadata" pada Gambar 1) dan memilih Akun Google yang akan digunakan.
Jika pengguna memiliki lebih dari satu Rumah, mereka akan diminta untuk memilih Rumah. Jika mereka belum menyiapkan Rumah, Rumah bernama "Rumah" akan dibuat secara otomatis.
Commissioning API terhubung ke perangkat.
Pengguna akan diminta untuk memilih ruangan tempat perangkat berada.
Pengguna diminta untuk mengganti nama perangkat.
Commissioning API membuat kredensial Matter, memeriksa konektivitas jaringan, lalu menjalankan proses commissioning, menghubungkan perangkat ke fabric yang dipilih.
Jika izin ke struktur dan perangkat pengguna telah diberikan, perangkat akan muncul di Rumah bersama perangkat lain di Rumah tersebut, dan dapat dikontrol menggunakan aplikasi.
Jika izin ke struktur dan perangkat pengguna belum diberikan, perangkat tidak akan terlihat atau dapat dikontrol di aplikasi. Izin diperlukan untuk mengakses dan mengontrol perangkat di aplikasi.
Pemilih aplikasi
Ada dua cara aplikasi Anda muncul di pemilih aplikasi selama proses penyiapan:
- Di layar Pilih aplikasi.
- 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 Google Home Developer Console yang terkait dengan VID atau PID perangkat. (Opsi ini tidak berlaku untuk developer aplikasi yang tidak membuat perangkat Matter.)
Ada dua skenario saat aplikasi berada di layar Pilih aplikasi.
- Terinstal - Google 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. - Tidak Diinstal - Pengguna diarahkan ke Play Store untuk menginstal aplikasi sebelum melanjutkan.