Google Home Sample App for Matter menggunakan Google Home Mobile SDK membuat aplikasi Android yang mirip dengan Google Home app (GHA). Aplikasi contoh ini menyediakan fitur berikut:
- Lakukan pengiriman pada perangkat Matter fisik dan virtual ke Fabric Android lokal
- Mengonfigurasi perangkat fisik dan virtual ke fabric pengembangan
- Kontrol perangkat pada fabric pengembangan Anda, misalnya mengaktifkan ringan
- Fitur multi-admin memungkinkan Anda berbagi perangkat di struktur pengembangan dengan aplikasi lain, dan sebaliknya dapat disertakan dalam pengembangan perangkat kain yang dibagikan dari aplikasi lain
- Utilitas Developer
Panduan ini menjelaskan cara menginstal APK Sample App for Matter dan menggunakannya untuk memberikan komisi, mengontrol, dan membagikan Matter perangkat.
Untuk mendownload kode sumber, pelajari cara mengintegrasikan Mobile SDK, serta menyesuaikan layar di Android Studio, coba Codelab Sample App for Matter.
Buka codelab Sample App for Matter
Prasyarat
- Perangkat Android O (8.1, API level 27) atau yang lebih baru tersedia untuk pengujian. Kepada pastikan perangkat Anda memiliki Matter terbaru dukungan, tinjau Verifikasi Modul Matter & Layanan kami.
- Buat perangkat Matter dengan kemampuan Aktif/Nonaktif. Ini
aplikasi contoh berfungsi dengan perangkat virtual dan ESP32.
- Perangkat Virtual Matter (MVD). Untuk meminimalkan masalah lingkungan, sebaiknya gunakan MVD untuk memulainya. Jika Anda mengalami masalah, akan jauh lebih mudah untuk menyelidiki apakah aplikasi contoh digunakan untuk MVD atau tidak.
- Mem-build Perangkat Virtual Matter
dengan aplikasi
rootnode_dimmablelight_bCwGYSDpoe. Jika Anda Membuat integrasi Matter di Google Home Developer Console, gunakan0xFFF1sebagai ID Vendor dan0x8000sebagai ID Produk Anda. - Membuat Perangkat Espressif
dengan
all-clusters-app. Jika Anda Membuat integrasi Matter di Developer Console, gunakan0xFFF1sebagai ID Vendor dan0x8001sebagai ID Produk Anda.
Anda tidak memerlukan hub, misalnya Google Nest Hub (2nd gen), ke komisi dan mengontrol perangkat dengan Sample App for Matter.
Instal
Buka bagian Rilis di GitHub Sample App for Matter repositori resource. Untuk rilis terbaru, cari di bagian Aset APK yang bernama
GHSAFM-version-default-debug.apk. Jangan pilihtargetcommissioner.Instal Android Debug Bridge (adb):
Hubungkan perangkat Android dengan USB dan aktifkan Transfer File, lalu instal APK:
$ adb unroot && adb install GHSAFM-version-default-debug.apk
Perangkat komisi
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, bersama dengan fabric pengembangan yang bersifat lokal untuk sampel aplikasi saja.
Apa yang dimaksud dengan kain Matter?
Fabric Matter adalah domain kepercayaan bersama di antara perangkat dalam jaringan rumah yang memungkinkan mereka untuk berkomunikasi satu sama lain.
Perangkat mungkin memiliki satu atau beberapa kain yang sesuai dengan platform, aplikasi, atau sekelompok perangkat yang berinteraksi bersama. Kain memiliki keunikan ID, dan perangkat memiliki kumpulan kredensial dan certificate authority yang sama (CA). Kredensial ini ditetapkan selama Matter komisioning.
Untuk melakukan commissioning pada perangkat Matter, selesaikan langkah-langkah berikut:
Ketuk tombol Tambahkan Perangkat untuk memulai proses komisioning.
Selanjutnya, kontrol ditransfer ke Google Play services, yang diluncurkan dari panggilan ke Mobile SDK. Untuk membuktikan Anda, Pindai kode QR atau ketuk Gunakan kode penyambungan.
Saat commissioning selesai, masukkan Device Name, lalu ketuk Done.
Perangkat Anda kini terhubung ke fabric Android Lokal dan fabric pengembangan.
Semua pekerjaan komisi dan layar terkait ditangani oleh Play services saat melakukan komisi perangkat. Hal ini memberikan pengalaman pengguna yang konsisten dan menghilangkan kebutuhan untuk menangani izin sensitif, misalnya, kredensial Wi-Fi dan Thread.
Mengontrol perangkat
Kain 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.
Bagikan perangkat
Berbagi perangkat disebut sebagai alur multi-admin di 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 memiliki platform lain yang diinstal di perangkat Android Anda. Platform eksternal ini menjadi target komisaris. Kami telah membuat dari aplikasi contoh yang dapat Anda gunakan sebagai target komisaris.
Buka bagian Rilis di GitHub Sample App for Matter repositori resource. 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.apkDari 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.
Lembar berbagi akan ditampilkan, memungkinkan Anda untuk memilih aplikasi atau platform yang Anda perangkat yang ingin disambung. Layar ini menyediakan dua cara bagi Anda untuk berbagi perangkat:
- Secara manual melalui kode penyiapan yang akan dibagikan ke aplikasi komisaris target
- Dengan aplikasi Android lokal yang telah terdaftar sebagai Komisioner Matter
Aplikasi komisaris target diberi label GHSAFM-TC. Ketuk contoh aplikasi contoh untuk berbagi perangkat Anda.
Selanjutnya, aplikasi eksternal (target komisaris) menyelesaikan commissioning aplikasi perangkat ke dalam kainnya sendiri.
Setelan
Dari Layar utama, klik setelan Ikon . 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 fungsi proaktif yang dapat ditugaskan notifikasi penemuan untuk Matter perangkat.
Jika aplikasi Anda menyediakan penemuan Matter sendiri atau alur komisi, sebaiknya Anda menyembunyikan notifikasi ini untuk mencegah interupsi. Lihat Menghentikan penemuan yang dapat ditugaskan notifikasi untuk informasi selengkapnya.
Utilitas developer
Dari layar Setelan, Anda juga dapat mengakses Utilitas developer.
Untuk meninjau konten repositori Device dan User Preferences DataStore 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 Anda agar kami dapat meningkatkan kualitas pengembangan ini pengalaman dengan Sample App for Matter, lengkapi Formulir Masukan.
Kirimkan masukan Anda kepada kami
Jika Anda mengalami masalah dengan Sample App for Matter, coba selesaikan langkah-langkah untuk memverifikasi lingkungan:
Jika Anda memiliki pertanyaan tentang penggunaan aplikasi contoh atau menemukan {i>bug<i} 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
{i>Stack Overflow<i}: