Alur penyiapan di aplikasi Anda menggunakan Commissioning API dapat dimulai dengan dua cara: langsung di aplikasi Anda, atau melalui pemilih aplikasi dalam proses Sambungan Cepat. Bagian ini membahas pengalaman pengguna (UX) untuk setiap cara.
Dimulai oleh aplikasi
Dalam skenario ini, pengguna memulai penyiapan di aplikasi Anda, biasanya dari tombol 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 penyiapan selesai, sebaiknya arahkan pengguna ke halaman Beranda aplikasi, atau ke lokasi di aplikasi yang menampilkan pengontrol perangkat yang baru saja disiapkan 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 pairing.
Pengguna akan diminta untuk menyetujui penambahan perangkat ke Google fabric (sesuai dengan "Izin + Metadata" di Gambar 1) dan memilih Akun Google yang akan digunakan.
Jika pengguna memiliki lebih dari satu Rumah, mereka akan diminta untuk memilih Rumah. Jika mereka tidak memiliki Rumah yang disiapkan, Rumah bernama "Rumah" akan otomatis dibuat.
Commissioning API terhubung ke perangkat.
Pengguna akan diminta untuk memilih ruangan tempat the perangkat berada.
Pengguna akan diminta untuk mengganti nama perangkat.
Commissioning API generates Matter credentials, checks network connectivity, then executes the commissioning process, connecting the device to the chosen fabric.
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 belum dapat dilihat atau dikontrol di aplikasi. Izin diperlukan untuk mengakses dan mengontrol perangkat di aplikasi.
Dimulai oleh Sambungan Cepat
Penyiapan juga dapat dimulai menggunakan Sambungan Cepat di Android. Setelah memindai kode QR Matterperangkat, pengguna akan diminta untuk memilih aplikasi untuk melanjutkan proses penyiapan. Memilih aplikasi Anda akan 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 akan diminta untuk memindai kode QR.
Pengguna memindai kode QR Matter perangkat.
Pengguna akan diminta untuk memilih aplikasi untuk melanjutkan proses penyiapan.
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 Google fabric (sesuai dengan "Izin + Metadata" di Gambar 1) dan memilih Akun Google yang akan digunakan.
Jika pengguna memiliki lebih dari satu Rumah, mereka akan diminta untuk memilih Rumah. Jika mereka tidak memiliki Rumah yang disiapkan, Rumah bernama "Rumah" akan otomatis dibuat.
Commissioning API terhubung ke perangkat.
Pengguna akan diminta untuk memilih ruangan tempat the perangkat berada.
Pengguna akan diminta untuk mengganti nama perangkat.
Commissioning API membuat Matter kredensial, memeriksa konektivitas jaringan, lalu menjalankan proses penyiapan, 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 belum dapat dilihat atau 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, aplikasi Anda 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
Google Home Developer Consoleyang terkait dengan VID atau PID
perangkat. (Opsi ini tidak berlaku untuk developer aplikasi yang tidak
membuat Matter perangkat.)
Ada dua skenario saat aplikasi berada di layar Pilih aplikasi.
- Diinstal - Google 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 Diinstal - Pengguna akan diarahkan ke Play Store untuk menginstal aplikasi sebelum melanjutkan.