Google Home Sample App for Matter uses the Google Home Mobile SDK to create an Android app that's similar to Google Home app (GHA) . This sample app provides the following features:
- Komisi fisik dan virtual Matter devices to the Local Android fabric
- Komisikan perangkat fisik dan virtual ke kain pengembangan
- Mengontrol perangkat pada struktur pengembangan, misalnya menyalakan lampu
- Fitur multi-admin memungkinkan Anda berbagi perangkat di struktur pengembangan dengan aplikasi lain, dan sebaliknya dapat disertakan dalam perangkat kain pengembangan yang dibagikan dari aplikasi lain
- Utilitas Developer
Panduan ini menjelaskan cara menginstal APK Sample App for Matter dan menggunakannya untuk memesan, mengontrol, dan membagikan 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
- Android O (8.1, API level 27) atau perangkat yang lebih baru tersedia untuk pengujian. Untuk memastikan bahwa perangkat Anda memiliki dukungan Matter terbaru, baca panduan Memverifikasi Modul & Layanan Matter.
- Mem-build perangkat
Matter dengan kemampuan Aktif/Nonaktif. Aplikasi
contoh ini berfungsi dengan perangkat virtual dan ESP32.
- Buat Perangkat Virtual Matter
dengan aplikasi
rootnode_dimmablelight_bCwGYSDpoe
. Saat Anda Membuat integrasi Matter di Google Home Developer Console , gunakan0xFFF1
sebagai ID Vendor Anda dan0x8000
sebagai ID Produk Anda. - Buat Perangkat Espressif dengan
all-clusters-app
. Saat Membuat integrasi Matter di Developer Console, gunakan0xFFF1
sebagai ID Vendor dan0x8001
sebagai ID Produk Anda.
- Buat Perangkat Virtual Matter
dengan aplikasi
Anda tidak memerlukan hub, misalnya Google Nest Hub (2nd gen) , to commission and control devices with the Sample App for Matter.
Menginstal
Buka bagian Rilis di repositori GitHub Sample App for Matter. Temukan APK bernama
GHSAFM-1.4.1-default-debug.apk
. Jangan pilihtargetcommissioner
:Instal Android Debug Bridge (adb):
Hubungkan perangkat Android dengan USB dan aktifkan File Transfer, lalu instal APK:
$ adb unroot && adb install GHSAFM-1.4.1-default-debug.apk
Perangkat komisi
Saat meluncurkan aplikasi contoh untuk pertama kalinya, Anda akan mendapatkan dialog berisi link ke Sample App for Matter codelab. Jika memilih Jangan tampilkan pesan ini lagi, Anda dapat mengembalikan dialog tersebut kapan saja dengan memperbarui preferensi di bagian Admin aplikasi.
Pada langkah berikutnya, Anda akan menambahkan perangkat Matter ke kain Android Lokal, beserta kain pengembangan yang bersifat lokal hanya untuk aplikasi contoh.
Apa itu kain Matter?
Fabric adalah domain kepercayaan bersama di antara perangkat dalam jaringan rumah yang memungkinkannya berkomunikasi satu sama lain.
Perangkat dapat memiliki satu atau beberapa kain yang sesuai dengan platform, aplikasi, atau grup perangkat yang berinteraksi bersama. Fabric memiliki ID unik, dan perangkat memiliki kumpulan kredensial dan certificate authority yang sama (CA). Kredensial ini ditetapkan selama Matter komisi.
Untuk mendaftarkan perangkat Matter, selesaikan langkah-langkah berikut:
Ketuk tombol Tambahkan Perangkat
untuk memulai proses komisi.Selanjutnya, kontrol ditransfer ke Google Play services , which is launched from a call to the Mobile SDK. To establish proof of possession, Scan QR code or tap Use pairing code.
Setelah komisi selesai, masukkan Nama Perangkat, lalu ketuk Selesai.
Perangkat Anda sekarang terhubung ke kain Android Lokal dan kain pengembangan.
Semua tugas komisi dan layar terkait ditangani oleh Play services saat mendaftarkan perangkat. Cara ini akan memberikan pengalaman pengguna yang konsisten dan menghilangkan kebutuhan untuk menangani izin sensitif, misalnya kredensial Wi-Fi dan Thread.
Perangkat kontrol
Fabric pengembangan membuat kredensial untuk mengontrol perangkat Matter 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 dalam spesifikasi Matter. Setelah perangkat didaftarkan ke aplikasi contoh, Anda dapat dengan mudah membagikannya ke ekosistem lainnya.
Untuk berbagi perangkat Matter dengan ekosistem lain, Anda harus menginstal platform lain di perangkat Android. Platform eksternal ini menjadi komisaris target. Kami telah membuat instance lain dari aplikasi contoh yang dapat Anda gunakan sebagai komisaris target.
Buka bagian Rilis di repositori GitHub Sample App for Matter. Temukan APK terbaru bernama
GHSAFM-[version]-targetcommissioner
, misalnyaGHSAFM-1.4.1-targetcommissioner-debug.apk
:Instal komisaris target.
$ adb unroot && adb install GHSAFM-1.4.1-targetcommissioner-debug.apk
Dari Layar utama, ketuk perangkat untuk menampilkan informasi perangkat. Ketuk Bagikan.
Aplikasi contoh memanggil Share API Mobile SDK dan sekali lagi, kontrol ditransfer ke Play services.
Sheet berbagi akan ditampilkan, sehingga Anda dapat memilih aplikasi atau platform yang ingin disambungkan dengan perangkat. Layar ini menyediakan dua cara bagi Anda untuk berbagi perangkat:
- Secara manual melalui kode penyiapan untuk dibagikan dengan aplikasi komisioner target
- Dengan aplikasi Android lokal yang telah terdaftar sebagai komisioner Matter
Aplikasi komisioner target diberi label GHSAFM-TC. Ketuk instance aplikasi contoh ini untuk membagikan perangkat Anda.
Selanjutnya, aplikasi eksternal (target Commissioner) menyelesaikan komisiing perangkat ke dalam strukturnya 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 setengah sheet
Dari layar Setelan, Anda dapat memilih untuk menonaktifkan notifikasi penemuan yang dapat dipesan secara proaktif untuk perangkat Matter.
Jika aplikasi Anda menyediakan alur penemuan atau Commissioning-nya sendiri, Anda mungkin ingin menyembunyikan notifikasi ini untuk mencegah gangguan. Lihat Menyembunyikan notifikasi penemuan komisi untuk 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 Catat konten repositori.
Klik OK pada dialog, lalu centang Logcat.
Masukan dan bantuan
Untuk mengirim pendapat atau masukan tentang cara kami dapat meningkatkan pengalaman pengembangan dengan Sample App for Matter, lengkapi Formulir Masukan kami.
Jika Anda mengalami masalah dengan Sample App for Matter, coba selesaikan langkah-langkah untuk memverifikasi lingkungan Anda:
Jika ada 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: