Commissioning API mendukung multi-administrasi (atau multi-admin) untuk Matter, yang berarti bahwa Commissioning API dapat berfungsi sebagai komisaris Matter utama atau sekunder dan Anda dapat menambahkan komisaris Anda sendiri:
Sebagai komisaris Matter utama:
- Dalam mode ini, fabric Google ditambahkan terlebih dahulu, menggunakan UX Google.
- Anda dapat menambahkan komisaris kustom.
- Komisaris Anda akan dipanggil setelah Google Fabric ditambahkan ke perangkat, lalu jendela komisi Matter akan dibuka kembali.
- Jika Google tidak dapat menyelesaikan komisi ke fabric-nya sendiri terlebih dahulu karena alasan apa pun, layanan komisi kustom Anda tidak akan berjalan.
Sebagai komisaris Matter sekunder:
- Dalam mode ini, Anda dapat menerapkan UX komisi sendiri dan melakukan aktivasi ke fabric-nya sendiri (atau ke fabric lain).
- Google Commissioning API dapat dipanggil nanti dengan periode komisi terbuka untuk menambahkan Google Fabric. Dalam mode ini, Google sangat merekomendasikan agar, saat pengguna akhir telah memberi Anda izin untuk menggunakan Home API, aplikasi secara aktif meminta pengguna untuk menambahkan fabric Google (menggunakan Commissioning API) setelah alur komisi Anda selesai.
Cara menggunakan Commissioning API sebagai komisaris Matter utama
Langkah-langkah ini menunjukkan alur komisi Matter yang disukai Google dan memiliki fitur lengkap:
Pengguna memulai alur commissioning di aplikasi. Misalnya, pengguna mengetuk tombol berlabel Add Device.
UX Google mengambil kendali dan menampilkan layar Pindai Kode QR Matter, sehingga pengguna dapat 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 Cancel di layar ini, semua commissioning perangkat akan segera berakhir.
Di layar Pilih rumah, pengguna memilih rumah tempat mereka dapat mengontrol perangkat. Jika tidak ada rumah yang tersedia, rumah baru akan dibuat. Jika tidak ada hub yang sesuai yang ditemukan di rumah, atau jika pengguna tidak memiliki izin, proses komisi akan berakhir.
Layar Perangkat terhubung akan muncul berikutnya, dan proses penyiapan Matter dimulai. Pengguna dapat memilih nama ruangan dan perangkat di layar ini.
Layar Menyiapkan perangkat Anda muncul saat perangkat diaktifkan ke fabric Matter.
Aplikasi Anda akan melanjutkan kontrol, dan komisaris kustom, jika terdaftar, akan berjalan sekarang.
Cara menggunakan Commissioning API sebagai komisaris Matter sekunder
Langkah-langkah ini menunjukkan alur komisi Matter tempat proses komisi Anda terjadi sebelum proses komisi Google:
Pengguna memulai alur commissioning di aplikasi Anda. Misalnya, pengguna mengetuk Tambahkan Perangkat.
Proses UX komisi Anda dijalankan untuk menambahkan perangkat ke fabric.
Setelah selesai, Anda dapat menentukan perilaku berikutnya dengan mendasarkan perilaku tersebut pada pengetahuan Anda tentang pengguna. Misalnya, jika pengguna telah memilih untuk menggunakan Google Home API, yang kemungkinan merupakan indikasi bahwa pengguna ingin memberikan komisi kepada Google, Anda dapat memicu proses komisi.
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.