Commissioning API di Android mendukung multi-administrasi (atau multi-admin) untuk Matter, yang berarti Commissioning API dapat berfungsi sebagai komisioner Matter utama atau sekunder dan Anda dapat menambahkan komisioner Anda sendiri:
Sebagai komisioner Matter utama:
- Dalam mode ini, fabric Google ditambahkan terlebih dahulu, menggunakan UX Google.
- Anda dapat menambahkan komisioner kustom.
- Komisioner Anda akan dipanggil setelah fabric Google di tambahkan ke perangkat, lalu Matter jendela commissioning akan dibuka kembali.
- Jika Google tidak dapat menyelesaikan commissioning ke fabricnya sendiri terlebih dahulu karena alasan apa pun, layanan commissioning kustom Anda tidak akan berjalan.
Sebagai komisioner Matter sekunder:
- Dalam mode ini, Anda dapat menerapkan UX commissioning Anda sendiri dan melakukan aktivasi ke fabric Anda sendiri (atau ke fabric lainnya).
- Google Commissioning API dapat dipanggil nanti dengan jendela commissioning terbuka untuk menambahkan fabric Google. Dalam mode ini, Google sangat merekomendasikan agar, saat pengguna akhir memberi Anda izin untuk menggunakan Home API, aplikasi secara aktif meminta pengguna untuk menambahkan fabric Google (menggunakan Commissioning API) setelah alur commissioning Anda selesai.
Cara menggunakan Commissioning API sebagai komisioner Matter utama
Langkah-langkah ini menunjukkan alur commissioning Matter Matter berfitur lengkap yang direkomendasikan Google:
Pengguna memulai alur commissioning di aplikasi. Misalnya, pengguna mengetuk tombol berlabel Add Device.
UX Google mengambil kontrol dan menampilkan layar Scan Matter QR Code, yang memungkinkan pengguna memindai kode QR untuk memulai proses penyiapan.
Di layar Connect this device to your Google account, pengguna mengetuk I agree untuk menambahkan perangkat ke ekosistem Google. Jika pengguna mengetuk Cancel di layar ini, semua commissioning perangkat akan segera berakhir.
Di layar Choose a home, pengguna memilih rumah tempat mereka dapat mengontrol perangkat. Jika tidak ada rumah yang tersedia, rumah baru akan dibuat. Jika tidak ada hub yang sesuai ditemukan di rumah, atau jika pengguna tidak memiliki izin, proses commissioning akan berakhir.
Layar Device connected akan muncul berikutnya, dan proses penyiapan Matter akan dimulai. Pengguna dapat memilih nama ruangan dan perangkat di layar ini.
Layar Getting your device ready akan muncul saat perangkat diaktifkan ke fabric Matter.
Aplikasi Anda melanjutkan kontrol, dan komisioner kustom, jika terdaftar, akan berjalan sekarang.
Cara menggunakan Commissioning API sebagai komisioner Matter sekunder
Langkah-langkah ini menunjukkan alur Matter commissioning tempat proses commissioning Anda terjadi sebelum proses commissioning Google:
Pengguna memulai alur commissioning di aplikasi Anda. Misalnya, pengguna mengetuk Add Device.
Proses UX commissioning Anda dijalankan untuk menambahkan perangkat ke fabric Anda.
Setelah selesai, Anda dapat menentukan perilaku berikutnya dengan mendasarkan perilaku pada pengetahuan Anda tentang pengguna. Misalnya, jika pengguna telah memilih untuk menggunakan Google Home API, yang kemungkinan merupakan indikasi bahwa pengguna ingin melakukan commissioning ke Google, Anda dapat memicu proses commissioning.
Proses Anda memanggil Commissioning API dan memberikan payload, yang berisi kode sandi, diskriminator, dan informasi lain yang tersedia.
Proses commissioning Google menambahkan perangkat ke fabric Google.