Perhatian! Program Pratinjau Developer yang baru akan segera diluncurkan. Daftar di sini dan jadilah salah satu developer pertama yang mencoba alat baru serta berikan masukan.

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:

  • Komisikan perangkat Matter fisik dan virtual ke kain Android Lokal
  • Memasukkan perangkat fisik dan virtual ke struktur pengembangan
  • Mengontrol perangkat di kain pengembangan, misalnya menyalakan lampu
  • Fitur multi-admin memungkinkan Anda berbagi perangkat pada struktur pengembangan dengan aplikasi lain, dan sebaliknya, dapat disertakan dalam perangkat pengembangan yang dibagikan dari aplikasi lain
  • Utilitas Developer

Panduan ini menjelaskan cara menginstal APK Sample App for Matter dan menggunakannya untuk mendapatkan komisi, 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 melakukan komisi dan mengontrol perangkat dengan Sample App for Matter.

Menginstal

  1. Buka bagian Rilis di repositori GitHub Sample App for Matter. Cari APK bernama GHSAFM-1.4.1-default-debug.apk. Jangan pilih targetcommissioner:

    Download APK

  2. Instal Android Debug Bridge (adb):

    Menginstal adb

  3. 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 dengan link ke codelab Sample App for Matter. Jika memilih Jangan tampilkan pesan ini lagi, Anda dapat mengaktifkan kembali dialog kapan saja dengan memperbarui preferensi di bagian Admin aplikasi.

Pada langkah berikutnya, Anda akan menambahkan perangkat Matter ke kain Android Lokal, bersama dengan kain pengembangan yang hanya tersedia untuk aplikasi contoh.

Apa yang dimaksud dengan kain Matter?

Aplikasi Contoh Google Home untuk Matter

Fabric adalah domain kepercayaan bersama di antara perangkat di jaringan rumah yang memungkinkannya berkomunikasi satu sama lain.

Perangkat dapat memiliki satu atau beberapa kain yang sesuai dengan platform, aplikasi, atau grup perangkat yang saling berinteraksi. Fabric memiliki ID unik, dan perangkat memiliki kumpulan kredensial dan certificate authority yang sama (CA). Kredensial ini ditetapkan selama komisi Matter.

Untuk memesan perangkat Matter, selesaikan langkah-langkah berikut:

  1. Ketuk tombol Tambahkan Perangkat untuk memulai proses komisi.

    Tambahkan perangkat

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

    Pindai Kode QR

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

Perangkat Anda sekarang terhubung ke Fabric Android lokal dan fabric pengembangan.

Semua tugas komisi dan layar terkait ditangani oleh Play services saat mendaftarkan perangkat. Hal ini memberikan pengalaman pengguna yang konsisten dan meniadakan 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.

Perangkat Ditambahkan

Bagikan perangkat

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

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 komisioner target.

  1. Buka bagian Rilis di repositori GitHub Sample App for Matter. Cari APK terbaru bernama GHSAFM-[version]-targetcommissioner, misalnya GHSAFM-1.4.1-targetcommissioner-debug.apk:

    Download Target Commissioner

  2. Instal komisioner target.

    $ adb unroot && adb install GHSAFM-1.4.1-targetcommissioner-debug.apk
    
  3. Dari Layar utama, ketuk perangkat untuk menampilkan informasi perangkat. Ketuk Bagikan.

    Bagikan perangkat

Aplikasi contoh memanggil Mobile SDK Share API 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:

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

Aplikasi target komisaris diberi label GHSAFM-TC. Ketuk instance aplikasi contoh ini untuk berbagi perangkat.

Selanjutnya, aplikasi eksternal (target Commissioner) akan menyelesaikan operasi 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 Halfsheet

Dari layar Setelan, Anda dapat memilih untuk menonaktifkan notifikasi penemuan komisi secara proaktif untuk perangkat Matter.

Jika aplikasi Anda menyediakan alur penemuan atau komisi Matter sendiri, Anda mungkin perlu menyembunyikan notifikasi ini untuk mencegah gangguan. Lihat Menyembunyikan notifikasi komisi untuk informasi selengkapnya.

Utilitas developer

Dari layar Setelan, Anda juga dapat mengakses Utilitas developer.

Untuk meninjau konten repositori DataStore Perangkat dan Preferensi Pengguna di Logcat, selesaikan langkah-langkah berikut:

  1. Klik Catat konten repositori.

  2. Klik OK pada 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.

Kirimkan masukan Anda

Jika Anda mengalami masalah dengan Sample App for Matter, coba selesaikan langkah-langkah ini untuk memverifikasi lingkungan:

Jika ada pertanyaan tentang penggunaan aplikasi contoh atau menemukan bug kode, Anda dapat mengirim 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: