Commissioning API di Android mendukung multi-administrasi (atau multi-admin) untuk Matter, yang berarti bahwa Commissioning API dapat berfungsi sebagai komisioner Matter primer atau sekunder dan Anda dapat menambahkan komisioner Anda sendiri:
Sebagai komisioner Matter utama:
- Dalam mode ini, kain Google ditambahkan terlebih dahulu, menggunakan UX Google.
- Anda dapat menambahkan komisioner kustom.
- Komisioner Anda dipanggil setelah fabric Google ditambahkan ke perangkat, lalu jendela komisioning Matter dibuka kembali.
- Jika Google tidak dapat menyelesaikan penyiapan ke fabricnya sendiri terlebih dahulu karena alasan apa pun, layanan penyiapan kustom Anda tidak akan berjalan.
Sebagai komisioner sekunder Matter:
- Dalam mode ini, Anda dapat menerapkan UX penyiapan Anda sendiri dan melakukan penyiapan ke fabric mereka sendiri (atau ke fabric lain).
- Google Commissioning API dapat dipanggil nanti dengan jendela commissioning terbuka untuk menambahkan fabric Google. Dalam mode ini, Google sangat merekomendasikan agar, jika pengguna akhir telah memberi Anda izin untuk menggunakan Home API, aplikasi secara aktif meminta pengguna untuk menambahkan platform Google (menggunakan Commissioning API) setelah alur aktivasi Anda selesai.
Cara menggunakan Commissioning API sebagai pengomisioner Matter utama
Langkah-langkah ini menunjukkan alur penyiapan Matter berfitur lengkap yang lebih disukai Google:
Pengguna memulai alur aktivasi di aplikasi. Misalnya, pengguna mengetuk tombol berlabel Tambahkan Perangkat.
UX Google mengambil kontrol dan menampilkan layar Pindai Kode QR Matter, yang memungkinkan pengguna memindai kode QR untuk memulai proses penyiapan.
Di layar Hubungkan perangkat ini ke Akun Google Anda, pengguna mengetuk Saya setuju untuk menambahkan perangkat ke ekosistem Google. Jika pengguna mengetuk Batal di layar ini, semua proses aktivasi perangkat akan segera berakhir.
Di layar Pilih rumah, pengguna memilih rumah yang dapat digunakan untuk mengontrol perangkat. Jika tidak ada rumah yang tersedia, rumah baru akan dibuat. Jika tidak ada hub yang sesuai di rumah, atau jika pengguna tidak memiliki izin, proses aktivasi akan berakhir.
Layar Device connected akan muncul berikutnya, dan proses penyiapan Matter dimulai. Pengguna dapat memilih nama ruangan dan perangkat di layar ini.
Layar Menyiapkan perangkat Anda 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 pengelola Matter sekunder
Langkah-langkah ini menunjukkan alur aktivasi Matter tempat proses aktivasi Anda terjadi sebelum proses aktivasi Google:
Pengguna memulai alur aktivasi di aplikasi Anda. Misalnya, pengguna mengetuk Tambahkan Perangkat.
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 menyediakan payload, yang berisi kode sandi, diskriminator, dan informasi lain yang tersedia.
Proses commissioning Google menambahkan perangkat ke fabric Google.