Aplikasi contoh Android Home API

Aplikasi contoh menampilkan kemampuan dasar Google Home API untuk Android.

Prasyarat

Untuk mem-build, menginstal, dan menguji aplikasi, Anda harus memenuhi beberapa prasyarat:

  • Android Studio, versi 2024.2.1 ("Ladybug") atau yang lebih baru. Perhatikan bahwa versi yang lebih lama dari ini mungkin tidak berfungsi dengan baik dengan SDK Home API.

    Download Android Studio

  • Debugger Android (adb).

    Instal adb.

    Hal ini dapat dilakukan dengan SDK Manager.

Selain itu, untuk menguji Home API, Anda memerlukan:

  • Perangkat Android yang menjalankan Android 10 atau yang lebih baru yang disiapkan dengan Akun Google yang ingin Anda gunakan untuk pengembangan. Pastikan versi terbaru Android Studio diinstal dan login dengan akun pengembangan ini.
  • Jaringan Wi-Fi.
  • Untuk mengakses dan mengontrol perangkat Matter, Anda juga memerlukan hub Google yang mendukung Home API. Lihat Konektivitas di Android untuk mengetahui detailnya.

  • Minimal satu perangkat yang didukung di rumah. Jika perangkat ini (atau perangkat lain yang ingin Anda uji) menggunakan Thread, hub juga harus berupa router pembatas Thread. Jenis dan karakteristik perangkat berikut didukung oleh aplikasi contoh Android:

    • Lampu Suhu Warna (aktif dan nonaktif, kecerahan)
    • Sensor Kontak (status boolean)
    • Lampu yang Dapat Diatur Kecerahannya (menyala dan mati, kecerahan)
    • Lampu Warna yang Diperluas (menyala dan mati, kecerahan)
    • Tombol Umum
    • Sensor Kehadiran (deteksi kehadiran)
    • Lampu Aktif/Nonaktif (aktif dan nonaktif, kecerahan)
    • Sakelar Lampu Aktif/Nonaktif
    • Unit Plugin Aktif/Nonaktif (aktif dan nonaktif)
    • Sensor Aktif/Nonaktif

Mendownload kode sumber

Kode sumber untuk aplikasi contoh tersedia di GitHub.

Buka tempat Anda ingin menyimpan project, lalu clone project tersebut:

git clone https://github.com/google-home/google-home-api-sample-app-android.git

Siapkan SDK

Home API untuk Android dalam versi beta terbuka ini belum menjadi bagian dari library standar yang disediakan oleh Google untuk pengembangan. Untuk mengembangkan aplikasi Android dengan Home API, Anda perlu mendownload dan menghosting library secara lokal.

Untuk mendownload Home APIs Android SDK, Anda harus login ke Google Home Developers terlebih dahulu.

Login sekarang!

Membangun aplikasi

  1. Buka Android Studio, lalu buka folder project google-home-api-sample-app-android yang di-clone ke komputer lokal Anda.

  2. Selama penyiapan pertama, Android Studio mungkin memerlukan waktu hingga 10 menit untuk mendownload semua dependensi project dan menyelesaikan build Gradle.

  3. Hubungkan komputer ke ponsel Android fisik melalui kabel USB dan aktifkan ADB di opsi developer. Pastikan Android Studio dapat terhubung ke ponsel Android melalui ADB.

  4. Ubah nama paket untuk aplikasi contoh menjadi nama baru yang belum terdaftar sebelumnya, seperti nama yang didasarkan pada nama organisasi Anda:

    1. Buka project.
    2. Luaskan hierarki sumber.
    3. Pilih bagian paket yang ingin Anda ubah - dengan kata lain, com.example.
    4. Klik kanan paket, lalu pilih Refactor > Rename... Menu Refactor > Rename
    5. Masukkan nama baru, lalu klik Refactor.
    6. Edit file build.gradle.kts, ubah android namespace dan applicationId menjadi nama paket baru.

  5. Setelah semua library yang diperlukan didownload dan sinkronisasi Gradle selesai, klik tombol Run untuk mem-build dan menjalankan aplikasi. Saat aplikasi berhasil berjalan di ponsel, Anda akan melihat halaman utama Aplikasi Contoh.

Membuat sertifikat penandatanganan

Saat Anda menjalankan atau men-debug aplikasi di Android Studio, aplikasi akan otomatis membuat sertifikat debug yang ditujukan untuk pengembangan dan proses debug. Lihat Android Studio: Menandatangani build debug untuk mengetahui penjelasan lengkapnya.

  1. Buat sertifikat penandatanganan aplikasi debug dengan menjalankan aplikasi di Android Studio. Saat Anda menjalankan atau men-debug aplikasi di Android Studio, Android Studio akan otomatis menghasilkan sertifikat penandatanganan aplikasi yang ditujukan untuk pengembangan dan proses debug. Lihat Android Studio: Menandatangani build debug untuk mengetahui penjelasan lengkapnya.

    Hubungkan perangkat seluler ke komputer lokal. Android Studio akan mencantumkan perangkat yang terhubung menurut nomor model. Pilih perangkat Anda dari daftar, lalu klik Run project. Tindakan ini akan mem-build dan menginstal aplikasi contoh di perangkat seluler Anda.

    Untuk petunjuk yang lebih mendetail, lihat Menjalankan aplikasi di perangkat hardware di situs Android Developers.

    Sekarang hentikan aplikasi yang sedang berjalan.

  2. Dapatkan sidik jari SHA-1 sertifikat debug Anda dengan mengikuti petunjuk yang dijelaskan dalam artikel Mengelola Klien OAuth / Jenis Aplikasi / Aplikasi native / Android di situs Bantuan Konsol Google Cloud.

  1. Di konsol Google Cloud, buka dasbor pemilih project dan pilih project yang ingin Anda gunakan untuk membuat kredensial OAuth.
  2. Buka halaman API dan Layanan, lalu klik Kredensial di menu navigasi.

  3. Jika Anda belum mengonfigurasi layar izin untuk project Google Cloud ini, tombol Configure consent screen akan muncul. Dalam hal ini, konfigurasi layar izin Anda menggunakan prosedur berikut. Jika tidak, lanjutkan ke bagian berikutnya.

    1. Klik Konfigurasi layar izin. Halaman OAuth consent screen akan ditampilkan.
    2. Bergantung pada kasus penggunaan Anda, pilih Internal atau External, lalu klik Create. Panel OAuth consent screen akan ditampilkan.
    3. Masukkan informasi di halaman Informasi aplikasi sesuai dengan petunjuk di layar, lalu klik Simpan dan lanjutkan. Panel Scopes akan ditampilkan.
    4. Anda tidak perlu menambahkan cakupan apa pun, jadi klik Save and continue. Panel Test users akan ditampilkan.
    5. Klik Audiens, lalu klik tombol + TAMBAHKAN PENGGUNA.
    6. Masukkan alamat email pengguna pengujian, lalu klik tombol SIMPAN.
    7. Klik Simpan dan lanjutkan. Panel Ringkasan akan ditampilkan.
    8. Tinjau informasi layar izin OAuth Anda, lalu klik Kembali ke dasbor.

Lihat Menyiapkan layar izin OAuth di situs Bantuan Konsol Google Cloud untuk mengetahui detail selengkapnya. Pastikan untuk menambahkan setidaknya satu pengguna pengujian sebelum melanjutkan.

Menyiapkan kredensial OAuth

  1. Daftarkan aplikasi contoh untuk OAuth 2.0 dan buat kredensial OAuth dengan mengikuti petunjuk yang diberikan di Menyiapkan OAuth 2.0.
    1. Tunjukkan jenis aplikasi, yaitu aplikasi native/Android.
    2. Tambahkan sidik jari SHA-1 ke klien OAuth dengan mengikuti petunjuk di Menyiapkan OAuth 2.0 / Aplikasi native / Android di situs Bantuan Konsol Google Cloud. Anda harus membuat kunci SHA-1 dari kunci Android Studio default selama proses pengembangan.

Menjalankan aplikasi

  1. Dengan perangkat seluler yang terhubung ke komputer lokal, klik Run project lagi untuk menjalankan aplikasi contoh di perangkat seluler.

Setelah diinstal, aplikasi akan tersedia di perangkat seluler Anda sebagai Aplikasi Contoh Home API.