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:
- Menugaskan perangkat Matter fisik dan virtual Matter ke fabric Android Lokal
- Menugaskan 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 perangkat yang dibagikan dari aplikasi lain di fabric pengembangan
- Utilitas Developer
Panduan ini menjelaskan cara menginstal APK Sample App for Matter dan menggunakan nya untuk menugaskan, mengontrol, dan berbagi perangkat Matter.
Untuk mendownload kode sumber, mempelajari cara mengintegrasikan Mobile SDK, dan menyesuaikan layar di Android Studio, coba Sample App for Matter codelab.
Buka Sample App for Matter codelab
Prasyarat
- Perangkat Android O (8.1, level API 27) atau yang lebih baru tersedia untuk pengujian. Untuk memastikan perangkat Anda memiliki dukungan Matter terbaru, tinjau panduan Memverifikasi Modul & Layanan Matter.Matter
- Buat perangkat Matter dengan kemampuan Aktif/Nonaktif. Aplikasi contoh 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 menyelidikinya jika aplikasi contoh digunakan terhadap MVD.
- Buat Matter Perangkat Virtual
dengan aplikasi
rootnode_dimmablelight_bCwGYSDpoe. Saat Anda Membuat Matter integrasi di Google Home Developer Console, gunakan0xFFF1sebagai ID Vendor dan0x8000sebagai ID Produk. - Buat Perangkat Espressif
dengan
all-clusters-app. Saat Anda Membuat integrasi Matter di Developer Console, gunakan0xFFF1sebagai ID Vendor dan0x8001sebagai ID Produk.
Anda tidak memerlukan hub, misalnya Google Nest Hub (2nd gen), untuk menugaskan 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 Transfer File, lalu instal APK:
$ adb unroot && adb install GHSAFM-version-default-debug.apk
Menugaskan perangkat
Saat Anda meluncurkan aplikasi contoh untuk pertama kalinya, Anda akan mendapatkan dialog dengan link ke Sample App for Matter codelab. Jika Anda memilih Jangan tampilkan pesan ini lagi, Anda dapat menampilkan kembali dialog 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 hanya untuk aplikasi contoh.
Apa yang dimaksud dengan fabric Matter?
Fabric Matter adalah domain kepercayaan bersama di antara perangkat dalam jaringan rumah yang memungkinkan perangkat tersebut berkomunikasi satu sama lain.
Perangkat dapat memiliki satu atau beberapa fabric yang sesuai dengan platform, aplikasi, atau grup perangkat yang berinteraksi bersama. Fabric memiliki ID unik, dan perangkat berbagi kumpulan kredensial dan otoritas sertifikat (CA) yang sama. Kredensial ini ditetapkan selama Matter penugasan.
Untuk menugaskan perangkat Matter, selesaikan langkah-langkah berikut:
Ketuk tombol Tambahkan Perangkat untuk memulai proses penugasan.
Selanjutnya, kontrol akan ditransfer ke Google Play services, yang diluncurkan dari panggilan ke Mobile SDK. Untuk menetapkan bukti kepemilikan, Pindai kode QR atau ketuk Gunakan kode penyambungan.
Setelah penugasan selesai, masukkan Nama Perangkat, lalu ketuk Selesai.
Perangkat Anda kini terhubung ke fabric Android Lokal dan fabric pengembangan.
Semua pekerjaan penugasan dan layar terkait ditangani oleh Play services saat menugaskan 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 Matter perangkat langsung dari aplikasi contoh.
Dari layar Utama, Anda dapat mengaktifkan atau menonaktifkan perangkat. Ketuk perangkat untuk mengakses detail perangkat.
Berbagi perangkat
Berbagi perangkat disebut sebagai alur multi-admin dalam Matter spesifikasi. Setelah perangkat ditugaskan ke aplikasi contoh, Anda dapat dengan mudah membagikannya ke ekosistem lain.
Untuk membagikan perangkat Matter ke ekosistem lain, Anda harus menginstal platform lain di perangkat Android. Platform eksternal ini akan menjadi penugasan target. Kami telah membuat instance lain dari aplikasi contoh yang dapat Anda gunakan sebagai penugasan 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 penugasan target.
$ adb unroot && adb install GHSAFM-version-targetcommissioner-debug.apkDari layar Utama, ketuk perangkat untuk menampilkan informasi perangkat. Ketuk Bagikan.
Aplikasi contoh memanggil Mobile SDK Share API dan sekali lagi, kontrol akan ditransfer ke Play services.
Sheet berbagi akan ditampilkan, sehingga Anda dapat memilih aplikasi atau platform yang ingin digunakan untuk menyambungkan perangkat. Layar ini menyediakan dua cara untuk membagikan perangkat:
- Secara manual melalui kode penyiapan yang akan dibagikan dengan aplikasi penugasan target
- Dengan aplikasi Android lokal yang telah terdaftar sebagai a Matter penugasan
Aplikasi penugasan target diberi label GHSAFM-TC. Ketuk instance aplikasi contoh ini untuk membagikan perangkat Anda.
Selanjutnya, aplikasi eksternal (penugasan target) akan menyelesaikan penugasan perangkat ke fabric-nya sendiri.
Setelan
Dari layar Utama, klik ikon setelan setelan. Di sini, Anda memiliki opsi untuk memperbarui preferensi pengguna, mendapatkan bantuan, dan mempelajari aplikasi lebih lanjut.
Notifikasi setengah layar
Dari layar Setelan, Anda dapat memilih untuk menonaktifkan notifikasi penemuan perangkat yang dapat ditugaskan secara proaktif untuk perangkat Matter.
Jika aplikasi Anda menyediakan alur Matter penemuan atau penugasan sendiri, Anda mungkin ingin menekan notifikasi ini untuk mencegah gangguan. Lihat Menekan notifikasi penemuan perangkat yang dapat ditugaskan 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 periksa Logcat.
Masukan dan bantuan
Untuk mengirimkan pendapat atau masukan tentang cara kami dapat meningkatkan pengalaman pengembangan dengan Sample App for Matter, isi Formulir Masukan kami.
Jika Anda mengalami masalah dengan Sample App for Matter, coba selesaikan langkah-langkah untuk memverifikasi lingkungan Anda:
Jika Anda 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: