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 Home APIs SDK.

    Download Android Studio

  • Android debugger (adb).

    Instal adb.

    Hal ini dapat dilakukan dengan SDK Manager.

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 dari Android Studio diinstal dan login dengan akun pengembangan ini.
  • Jaringan Wi-Fi.
  • Untuk mengakses dan mengontrol Matter perangkat, Anda juga memerlukan hub Google yang mendukung Home API. Lihat Konektivitas di Android untuk mengetahui detailnya.

  • Setidaknya 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 (nyala dan mati, kecerahan)
    • Sensor Kontak (status boolean)
    • Lampu yang Dapat Diredupkan (nyala dan mati, kecerahan)
    • Ekstensi Lampu Warna (nyala dan mati, kecerahan)
    • Sakelar Umum
    • Google Kamera
    • Sensor Kehadiran (deteksi kehadiran)
    • Lampu On/Off (nyala dan mati, kecerahan)
    • Sakelar Lampu On/Off
    • Unit Plugin On/Off (nyala dan mati)
    • Sensor On/Off

Mendownload kode sumber

Kode sumber untuk Aplikasi Contoh tersedia di GitHub.

Buka tempat Anda ingin menyimpan project, lalu clone:

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

Menyiapkan 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 harus mendownload dan menghosting library secara lokal.

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

Login sekarang

Membangun aplikasi

  1. Buka Android Studio, lalu buka folder project google-home-api-sample-app-android yang di-clone ke mesin 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 Anda 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 pernah didaftarkan 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 dan pilih Refactor > Rename... Menu Refactor > Rename
    5. Masukkan nama baru dan klik Refactor.
    6. Edit file build.gradle.kts, ubah android namespace dan applicationId ke nama paket baru.

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

Membuat sertifikat penandatanganan

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

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

    Hubungkan perangkat seluler ke mesin lokal Anda. Android Studio akan mencantumkan perangkat yang terhubung berdasarkan 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 mengetahui 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 di 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 APIs and Services, lalu klik Credentials di menu navigasi.

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

    1. Klik Konfigurasi layar izin. Halaman layar izin OAuth akan ditampilkan.
    2. Bergantung pada kasus penggunaan Anda, pilih Internal atau External, lalu klik Create. Panel layar izin OAuth akan ditampilkan.
    3. Masukkan informasi di App information page sesuai dengan petunjuk di layar, lalu klik Save and continue. Panel Scopes akan ditampilkan.
    4. Anda tidak perlu menambahkan cakupan apa pun, jadi klik Save and continue. Panel Test users akan ditampilkan.
    5. Klik Audience , lalu klik tombol + ADD USERS.
    6. Masukkan alamat email pengguna uji coba Anda, lalu klik tombol SAVE.
    7. Klik Save and continue. Panel Summary akan ditampilkan.
    8. Tinjau informasi layar izin OAuth Anda, lalu klik Back to dashboard.

Lihat Menyiapkan layar izin OAuth di situs Bantuan Konsol Google Cloud untuk mengetahui detail selengkapnya. Pastikan untuk menambahkan setidaknya satu pengguna uji coba 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 native/Android app.
    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 terhubung ke mesin lokal Anda, klik Run project lagi untuk menjalankan Aplikasi Contoh di perangkat seluler Anda.

Setelah diinstal, aplikasi akan tersedia di perangkat seluler Anda sebagai Home API Sample App.