Contoh Aplikasi Google Home untuk Masalah

Aplikasi Contoh Google Home untuk Matter

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:

  • Menyiapkan perangkat fisik dan virtual Matter ke fabric Android Lokal
  • Menugaskan perangkat fisik dan virtual ke fabric pengembangan
  • Mengontrol perangkat di fabric pengembangan Anda, misalnya menyalakan lampu
  • Fitur multi-admin memungkinkan Anda berbagi perangkat di fabric pengembangan dengan aplikasi lain, dan sebaliknya dapat menyertakan perangkat di fabric pengembangan yang dibagikan dari aplikasi lain
  • Utilitas Developer

Panduan ini menjelaskan cara menginstal APK Sample App for Matter dan menggunakannya untuk melakukan aktivasi, 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

Anda tidak memerlukan hub, misalnya Google Nest Hub (2nd gen), untuk mengaktifkan dan mengontrol perangkat dengan Sample App for Matter.

Instal

  1. Buka bagian Rilis di repositori GitHub Sample App for Matter. Untuk rilis terbaru, temukan di bagian Aset APK yang bernama GHSAFM-version-default-debug.apk. Jangan pilih targetcommissioner.

  2. Instal Android Debug Bridge (adb):

    Instal adb

  3. Hubungkan perangkat Android Anda dengan USB dan aktifkan Transfer File, lalu instal APK:

    $ adb unroot && adb install GHSAFM-version-default-debug.apk

Memastikan perangkat

Saat meluncurkan aplikasi contoh untuk pertama kalinya, Anda akan mendapatkan dialog dengan link ke codelab Sample App for Matter. Jika Anda memilih Jangan tampilkan pesan ini lagi, Anda dapat menampilkan kembali dialog ini kapan saja dengan memperbarui preferensi Anda 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 itu kain Matter?

Aplikasi Contoh Google Home untuk Matter

Fabric Matter adalah domain kepercayaan bersama di antara perangkat dalam jaringan rumah yang memungkinkan perangkat tersebut saling berkomunikasi.

Perangkat dapat memiliki satu atau beberapa kain yang sesuai dengan platform, aplikasi, atau grup perangkat yang berinteraksi bersama. Fabric memiliki ID unik, dan perangkat berbagi setelan kredensial dan otoritas sertifikat (CA) yang sama. Kredensial ini ditetapkan selama Matter penyiapan.

Untuk mengaktifkan perangkat Matter, selesaikan langkah-langkah berikut:

  1. Ketuk tombol Tambahkan Perangkat untuk memulai proses aktivasi.

    Tambahkan perangkat

  2. Selanjutnya, kontrol ditransfer ke Google Play services, yang diluncurkan dari panggilan ke Mobile SDK. Untuk membuat bukti kepemilikan, Pindai kode QR atau ketuk Gunakan kode penyambungan.

    Pindai Kode QR

  3. Setelah commissioning selesai, masukkan Nama Perangkat, lalu ketuk Selesai.

Perangkat Anda kini terhubung ke fabric Android Lokal dan fabric pengembangan.

Semua pekerjaan penyiapan dan layar terkait ditangani oleh Play services saat melakukan penyiapan 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 mengalihkan perangkat ke Aktif atau Nonaktif. Ketuk perangkat untuk mengakses detail perangkat.

Perangkat Ditambahkan

Bagikan perangkat

Berbagi perangkat disebut sebagai alur multi-admin dalam spesifikasi Matter. Setelah perangkat di-commissioning ke aplikasi contoh, Anda dapat dengan mudah membagikannya ke ekosistem lain.

Untuk membagikan perangkat Matter Anda ke ekosistem lain, Anda harus menginstal platform lain di perangkat Android Anda. Platform eksternal ini menjadi komisioner target. Kita telah membuat instance lain dari aplikasi contoh yang dapat Anda gunakan sebagai target pengirim perintah.

  1. Buka bagian Rilis di repositori GitHub Sample App for Matter. Untuk rilis terbaru, temukan di bagian Aset APK yang bernama GHSAFM-version-targetcommissioner-debug.apk. Jangan pilih default.

  2. Instal pengelola target.

    $ adb unroot && adb install GHSAFM-version-targetcommissioner-debug.apk

  3. Dari Layar utama, ketuk perangkat untuk menampilkan informasi perangkat. Ketuk Bagikan.

    Bagikan perangkat

Aplikasi contoh memanggil Share API Mobile SDK dan sekali lagi, kontrol ditransfer ke Play services.

Lembar berbagi akan ditampilkan, sehingga Anda dapat memilih aplikasi atau platform yang ingin digunakan untuk menyambungkan perangkat. Layar ini menyediakan dua cara bagi Anda untuk membagikan perangkat:

  1. Secara manual melalui kode penyiapan yang akan dibagikan dengan aplikasi komisioner target
  2. Dengan aplikasi Android lokal yang telah terdaftar sebagai komisaris Matter

Aplikasi target komisioner diberi label GHSAFM-TC. Ketuk instance aplikasi contoh ini untuk membagikan perangkat Anda.

Selanjutnya, aplikasi eksternal (komisioner target) menyelesaikan komisioning 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.

Setelan

Notifikasi setengah halaman

Dari layar Setelan, Anda dapat memilih untuk menonaktifkan notifikasi penemuan proaktif yang dapat digunakan untuk Matter perangkat.

Jika aplikasi Anda menyediakan alur penemuan atau pemesanan sendiri, Anda dapat menonaktifkan notifikasi ini untuk mencegah gangguan.Matter Lihat Menekan notifikasi penemuan yang dapat dioperasikan untuk mengetahui 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:

  1. Klik Log repositori konten.

  2. Klik OK pada dialog, lalu periksa Logcat.

Masukan dan bantuan

Untuk mengirimkan pendapat atau masukan Anda tentang cara meningkatkan kualitas 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 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: