Aplikasi contoh Android Home API

Aplikasi contoh ini menampilkan kemampuan dasar Google Home API.

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 benar 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.
  • Hub Google yang mendukung Home API.

  • 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 (menyala dan mati, kecerahan)
    • Sensor Kontak (status boolean)
    • Lampu yang Dapat Diredupkan (nyala dan mati, kecerahan)
    • Lampu Warna yang Diperpanjang (aktif dan nonaktif, kecerahan)
    • Tombol Umum
    • Sensor Penghuni (deteksi penghuni)
    • Lampu Aktif/Nonaktif (aktif dan nonaktif, kecerahan)
    • Sakelar Lampu Aktif/Nonaktif
    • Unit Plugin Aktif/Nonaktif (aktif dan nonaktif)
    • Sensor Aktif/Nonaktif

  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 Konfigurasi layar izin 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. Jika Anda ingin menambahkan pengguna untuk menguji akses ke aplikasi, klik Tambahkan pengguna. Panel Tambahkan pengguna akan ditampilkan. Pengguna pengujian memiliki hak istimewa untuk memberikan izin di aplikasi Anda.
    6. Di kolom kosong, tambahkan satu atau beberapa alamat email Akun Google, lalu klik Tambahkan.
    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.

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 dalam versi beta terbuka ini belum menjadi bagian dari library standar yang disediakan oleh Google untuk pengembangan. Untuk mengembangkan aplikasi 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.

Membuat dan menjalankan

  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.
    • Jika Anda mendapatkan error selama langkah ini, seperti Gradle Sync Failed, klik Coba Lagi untuk memulai sinkronisasi lagi.
  3. Ubah nama paket untuk aplikasi contoh menjadi nama baru yang belum 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 pada paket, lalu pilih Refactor > Rename...
    5. Klik Semua Direktori.
    6. Masukkan nama baru, lalu klik Refactor.
    7. Edit file build.gradle.kts, ubah android namespace dan applicationId menjadi nama paket baru.
    8. Edit file AndroidManifest.xml dan ubah paket menjadi nama paket baru di mana pun nama tersebut muncul dalam file.

  4. Buat kunci OAuth dengan menjalankan aplikasi di Android Studio. Saat Anda menjalankan atau men-debug aplikasi di Android Studio, Android Studio akan otomatis membuat kunci OAuth 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 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.

  5. Dapatkan sidik jari SHA-1 sertifikat OAuth dengan mengikuti petunjuk yang dijelaskan dalam artikel Menyiapkan OAuth 2.0 / Aplikasi native / Android di situs Bantuan Konsol Google Cloud.

  6. 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.
    3. Tambahkan pengguna pengujian. Pengguna pengujian memiliki hak istimewa untuk memberikan izin di aplikasi contoh.

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