Google Home Sample App for Matter menggunakan Google Home Mobile SDK untuk membuat aplikasi Android yang mirip dengan Google Home app (GHA). Aplikasi contoh ini menyediakan fitur berikut:
- Mengaktifkan perangkat Matter fisik dan virtual ke Fabric Android lokal
- Mengonfigurasi perangkat fisik dan virtual ke fabric pengembangan
- Mengontrol perangkat di fabric pengembangan, misalnya menyalakan lampu
- Fitur multi-admin memungkinkan Anda berbagi perangkat di fabric pengembangan dengan aplikasi lain, dan sebaliknya dapat menyertakan dalam perangkat fabric pengembangan yang dibagikan dari aplikasi lain
- Utilitas Developer
Panduan ini menjelaskan cara menginstal APK Sample App for Matter dan menggunakannya untuk komisi, kontrol, dan berbagi perangkat Matter.
Untuk mendownload kode sumber, pelajari cara mengintegrasikan Mobile SDK, dan menyesuaikan layar di Android Studio, coba codelab Sample App for Matter kami.
Buka codelab Sample App for Matter
Prasyarat
- Perangkat Android O (8.1, API level 27) atau yang lebih baru yang tersedia untuk pengujian. Untuk memastikan perangkat Anda memiliki dukungan Matter terbaru, tinjau panduan Memverifikasi Modul & Layanan Matter.
- Buat perangkat Matter dengan kemampuan Aktif/Nonaktif. Contoh
aplikasi ini berfungsi dengan perangkat virtual dan ESP32.
- Perangkat Virtual Matter (MVD). Untuk meminimalkan masalah lingkungan, sebaiknya gunakan MVD untuk memulai. Jika Anda mengalami masalah, akan jauh lebih mudah untuk menyelidiki apakah aplikasi contoh digunakan terhadap MVD.
- Buat Perangkat Virtual Matter
dengan aplikasi
rootnode_dimmablelight_bCwGYSDpoe
. Saat Anda Membuat integrasi Matter di Google Home Developer Console, gunakan0xFFF1
sebagai ID Vendor dan0x8000
sebagai ID Produk. - Mem-build Perangkat Espressif
dengan
all-clusters-app
. Saat Anda Membuat integrasi Matter di Developer Console, gunakan0xFFF1
sebagai ID Vendor dan0x8001
sebagai ID Produk.
Anda tidak memerlukan hub, misalnya Google Nest Hub (2nd gen), untuk mengaktifkan dan mengontrol perangkat dengan Sample App for Matter.
Instal
Buka bagian Rilis di repositori GitHub Sample App for Matter. Untuk rilis terbaru, temukan di bagian Aset APK bernama
GHSAFM-version-default-debug.apk
. Jangan pilihtargetcommissioner
.Instal Android Debug Bridge (adb):
Hubungkan perangkat Android Anda dengan USB dan aktifkan File Transfer, lalu instal APK:
$ adb unroot && adb install GHSAFM-version-default-debug.apk
Mengonfigurasi perangkat
Saat meluncurkan aplikasi contoh untuk pertama kalinya, Anda akan mendapatkan dialog dengan link ke codelab Sample App for Matter. Jika memilih Jangan tampilkan kembali pesan ini, Anda dapat menampilkan kembali dialog tersebut kapan saja dengan memperbarui preferensi di bagian Admin aplikasi.
Pada langkah berikutnya, Anda akan menambahkan perangkat Matter ke Fabric Android Lokal, beserta fabric pengembangan yang bersifat lokal untuk aplikasi contoh saja.
Apa yang dimaksud dengan platform Matter?
Fabric Matter adalah domain kepercayaan bersama di antara perangkat dalam jaringan rumah yang memungkinkan perangkat tersebut berkomunikasi satu sama lain.
Perangkat mungkin memiliki satu atau beberapa fabric yang sesuai dengan platform, aplikasi, atau grup perangkat yang berinteraksi bersama. Fabric memiliki ID unik, dan perangkat memiliki kumpulan kredensial dan certificate authority (CA) yang sama. Kredensial ini ditetapkan selama komisi Matter.
Untuk mengaktifkan perangkat Matter, selesaikan langkah-langkah berikut:
Ketuk tombol
Tambahkan Perangkat untuk memulai proses komisioning.Selanjutnya, kontrol akan ditransfer ke Google Play services, yang diluncurkan dari panggilan ke Mobile SDK. Untuk membuat bukti kepemilikan, Pindai kode QR atau ketuk Gunakan kode penyambungan.
Setelah komisi selesai, masukkan Nama Perangkat, lalu ketuk Selesai.
Perangkat Anda kini terhubung ke fabric Android Lokal dan fabric pengembangan.
Semua pekerjaan komisioning dan layar terkait ditangani oleh Play services saat melakukan komisioning perangkat. Hal ini memberikan pengalaman pengguna yang konsisten dan menghilangkan kebutuhan untuk menangani izin sensitif, misalnya, kredensial Wi-Fi dan Thread.
Mengontrol perangkat
Fabric pengembangan membuat kredensial untuk mengontrol perangkat Matter langsung dari aplikasi contoh.
Dari Layar utama, Anda dapat mengaktifkan atau menonaktifkan perangkat Aktif atau Nonaktif. Ketuk perangkat untuk mengakses detail perangkat.
Bagikan perangkat
Berbagi perangkat disebut sebagai alur multi-admin dalam spesifikasi Matter. Setelah perangkat ditugaskan ke aplikasi contoh, Anda dapat dengan mudah membagikannya ke ekosistem lain.
Untuk berbagi perangkat Matter dengan ekosistem lain, Anda harus menginstal platform lain di perangkat Android. Platform eksternal ini menjadi target komisaris. Kami telah membuat instance lain aplikasi contoh yang dapat Anda gunakan sebagai komisaris target.
Buka bagian Rilis di repositori GitHub Sample App for Matter. Untuk rilis terbaru, temukan di bagian Aset APK bernama
GHSAFM-version-targetcommissioner-debug.apk
. Jangan pilihdefault
.Instal komisaris target.
$ adb unroot && adb install GHSAFM-version-targetcommissioner-debug.apk
Dari Layar utama, ketuk perangkat untuk menampilkan informasi perangkat. Ketuk Bagikan.
Aplikasi contoh memanggil Mobile SDK Share API dan sekali lagi, kontrol ditransfer ke Play services.
Sheet berbagi akan ditampilkan, yang memungkinkan Anda memilih aplikasi atau platform yang ingin disambungkan dengan perangkat. Layar ini menyediakan dua cara untuk membagikan perangkat:
- Secara manual melalui kode penyiapan yang akan dibagikan ke aplikasi komisaris target
- Dengan aplikasi Android lokal yang telah terdaftar sebagai komisaris Matter
Aplikasi komisaris target diberi label GHSAFM-TC. Ketuk instance aplikasi contoh ini untuk membagikan perangkat Anda.
Selanjutnya, aplikasi eksternal (target commissioner) menyelesaikan komisi perangkat ke dalam fabric-nya sendiri.
Setelan
Dari Layar utama, klik ikon setelan
. Di sini, Anda memiliki opsi untuk memperbarui preferensi pengguna, mendapatkan bantuan, dan mempelajari aplikasi lebih lanjut.Notifikasi halfsheet
Dari layar Setelan, Anda dapat memilih untuk menonaktifkan notifikasi penemuan komisi proaktif untuk perangkat Matter.
Jika aplikasi Anda menyediakan alur penemuan atau penerimaan Matter-nya sendiri, Anda dapat menyembunyikan notifikasi ini untuk mencegah gangguan. Lihat Menyembunyikan notifikasi penemuan yang dapat memperoleh komisi untuk mengetahui informasi selengkapnya.
Utilitas developer
Dari layar Setelan, Anda juga dapat mengakses Utilitas developer.
Untuk meninjau konten repositori DataStore Preferensi Perangkat dan Pengguna di Logcat, selesaikan langkah-langkah berikut:
Klik Log repositories content.
Klik OK ke dialog, lalu centang Logcat.
Masukan dan bantuan
Untuk mengirimkan pendapat atau masukan tentang cara kami dapat meningkatkan pengalaman pengembangan dengan Sample App for Matter, lengkapi Formulir Masukan kami.
Kirim masukan Anda kepada kami
Jika Anda mengalami masalah dengan Sample App for Matter, coba selesaikan langkah-langkah untuk memverifikasi lingkungan Anda:
Jika memiliki pertanyaan tentang penggunaan aplikasi contoh atau menemukan bug kode, Anda dapat mengirimkan masalah ke Issue Tracker di repositori GitHub:
Untuk mendapatkan panduan resmi dari Google terkait pertanyaan teknis, gunakan Forum Developer Smart Home:
Untuk mendapatkan dukungan teknis dari komunitas, gunakan tag google-smart-home
di
Stack Overflow: