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 jaringan 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 mengimplementasikan UX komisioning Anda sendiri dan menggabungkannya ke dalam jaringan mereka sendiri (atau ke jaringan lain).
- Google Commissioning API dapat dipanggil nanti dengan jendela commissioning terbuka untuk menambahkan struktur 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 API Komisioning sebagai komisioner Matter utama
Langkah-langkah ini menunjukkan alur komisioning berfitur lengkap Matter yang disukai Google:
Pengguna memulai alur komisioning di aplikasi. Misalnya, pengguna mengetuk tombol berlabel Tambahkan Perangkat.
Google UX mengambil kendali dan menampilkanPindaiMatter Kode QR layar, yang memungkinkan pengguna memindai kode QR untuk memulai proses pengaturan.
Pada layar Hubungkan perangkat ini ke akun Google Anda, pengguna mengetuk Saya setuju untuk menambahkan perangkat ke ekosistem Google. Sebaliknya, jika pengguna mengetuk Batal di layar ini, semua pengoperasian perangkat akan langsung berakhir.
Pada 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 ditemukan di rumah, atau jika pengguna tidak memiliki izin, proses komisioning berakhir.
Layar Device connected akan muncul berikutnya, dan proses Matter penyiapan dimulai. Pengguna dapat memilih nama ruangan dan perangkat di layar ini.
Layar Mempersiapkan perangkat Anda muncul saat perangkat dihubungkan ke jaringan Matter.
Aplikasi Anda melanjutkan kontrol, dan komisioner kustom, jika terdaftar, akan berjalan sekarang.
Cara menggunakan Commissioning API sebagai pengomisioner Matter sekunder
Langkah-langkah ini menunjukkan alur aktivasi Matter tempat proses aktivasi Anda terjadi sebelum proses aktivasi Google:
Pengguna memulai alur komisioning di aplikasi Anda. Misalnya, pengguna mengetuk Tambahkan Perangkat.
Proses UX penyiapan Anda dijalankan untuk menambahkan perangkat ke fabric Anda.
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 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.