Alur komisi 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 masing-masing.
Dimulai oleh aplikasi
Dalam skenario ini, pengguna mulai melakukan commissioning 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 komisi selesai, sebaiknya arahkan pengguna ke Halaman utama aplikasi, atau ke lokasi di aplikasi yang menampilkan pengontrol perangkat yang baru saja mereka siapkan kepada pengguna 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 diminta untuk menyetujui penambahan perangkat ke fabric Google (ini sesuai dengan "Consent + 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 pengguna tidak menyiapkan Rumah, Rumah bernama "Rumah" akan otomatis dibuat.
Commissioning API terhubung ke perangkat.
Pengguna diminta untuk memilih ruangan tempat perangkat berada.
Pengguna diminta untuk mengganti nama perangkat.
Commissioning API menghasilkan kredensial Matter, memeriksa konektivitas jaringan, lalu menjalankan proses commissioning, yang menghubungkan perangkat ke fabric yang dipilih.
Jika izin ke struktur dan perangkat pengguna telah diberikan, perangkat akan muncul di Rumah bersama dengan perangkat lain di Rumah tersebut, dan dapat dikontrol menggunakan aplikasi.
Jika izin ke struktur dan perangkat pengguna belum diberikan, perangkat seharusnya belum terlihat atau dapat dikontrol di aplikasi. Izin diperlukan untuk mengakses dan mengontrol perangkat di aplikasi.
Dimulai oleh Sambungan Cepat
Komisi juga dapat dimulai menggunakan Sambungan Cepat di Android. Setelah memindai kode QR Matter perangkat, pengguna akan diminta untuk memilih aplikasi untuk melanjutkan proses commissioning. 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 pada Gambar 2.
Pengguna akan diminta untuk memindai kode QR.
Pengguna memindai kode QR Matter perangkat.
Pengguna diminta untuk memilih aplikasi guna melanjutkan proses komisi.
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 diminta untuk menyetujui penambahan perangkat ke fabric Google (ini sesuai dengan "Consent + 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 pengguna tidak menyiapkan Rumah, Rumah bernama "Rumah" akan otomatis dibuat.
Commissioning API terhubung ke perangkat.
Pengguna diminta untuk memilih ruangan tempat perangkat berada.
Pengguna diminta untuk mengganti nama perangkat.
Commissioning API membuat kredensial Matter, memeriksa konektivitas jaringan, lalu menjalankan proses komisi, yang menghubungkan perangkat ke fabric yang dipilih.
Jika izin ke struktur dan perangkat pengguna telah diberikan, perangkat akan muncul di Rumah bersama dengan perangkat lain di Rumah tersebut, dan dapat dikontrol menggunakan aplikasi.
Jika izin ke struktur dan perangkat pengguna belum diberikan, perangkat seharusnya belum 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 komisi:
- 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
mem-build perangkat Matter.)
Ada dua skenario saat aplikasi berada di layar Pilih aplikasi.
- Terinstal - Google 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.