Otorisasi akun di Android

Sebelum melanjutkan otorisasi akun, pastikan Anda memiliki:

1. Google Home app (GHA) yang diinstal di perangkat seluler Android Anda.
2. Setidaknya salah satu jenis perangkat yang didukung ini untuk Aplikasi Contoh di rumah:
   • Lampu Suhu Warna (nyala dan mati, kecerahan)
   • Sensor Kontak (status boolean)
   • Lampu yang Dapat Diredupkan (nyala dan mati, kecerahan)
   • Kunci Pintu
   • Ekstensi Lampu Warna (nyala dan mati, kecerahan)
   • Sakelar Umum
   • Router Pembatas Google
   • Google Kamera
   • Google Doorbell
   • 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
3. Dua perangkat untuk menguji otomatisasi contoh.

Sebelum menggunakan perangkat melalui Home API, perangkat harus dapat dikontrol dari GHA.

Menjalankan Aplikasi Contoh Android

Sebelum mengizinkan akun, verifikasi bahwa Aplikasi Contoh dikonfigurasi dengan cakupan OAuth yang sesuai untuk project Anda. Secara default, kode sumber Aplikasi Contoh menggunakan cakupan https://www.googleapis.com/auth/home.platform.v2. Banyak fitur di Aplikasi Contoh dibatasi oleh cakupan home.platform.v2 dan memerlukan persetujuan partner untuk mengaksesnya. Untuk mengizinkan dan menggunakan Aplikasi Contoh dengan cakupan https://www.googleapis.com/auth/home.platform.selected.devices standar, alihkan homePlatformScope ke HOME_PLATFORM_SCOPE_VERSION_1 secara manual di HomeModule.kt seperti yang dijelaskan dalam Membangun aplikasi.

Jalankan Aplikasi Contoh Android. Saat pertama kali menjalankannya, Anda akan diminta untuk mengizinkan akses ke rumah di Akun Google Anda. Tindakan ini memberikan izin Aplikasi Contoh untuk mengakses dan mengontrol struktur dan perangkat di rumah tersebut.

Jika Anda tidak memiliki struktur, pengguna dapat membuatnya selama alur izin tanpa harus menggunakan GHA.

Perilaku izin default aplikasi akan berbeda bergantung pada apakah aplikasi terdaftar di Google Home Developer Console atau tidak.

Jika aplikasi tidak terdaftar di Developer Console, aplikasi akan berada dalam status belum diverifikasi. Hal ini direkomendasikan untuk menguji penggunaan Home API:

• Hanya pengguna yang terdaftar sebagai pengguna penguji di konsol OAuth yang dapat memberikan izin untuk aplikasi. Ada batas 100 pengguna penguji untuk aplikasi yang tidak terverifikasi.

• Aplikasi yang tidak diverifikasi akan memiliki akses ke perangkat dari jenis perangkat apa pun yang didukung oleh OAuth untuk Home API (daftar jenis perangkat di Developer Console). Semua perangkat dalam struktur akan diberikan akses.

Jika aplikasi terdaftar di Developer Console dan telah disetujui untuk mengakses satu atau beberapa jenis perangkat, dan verifikasi brand telah diselesaikan untuk OAuth, aplikasi tersebut akan berada dalam status terverifikasi. Status ini diperlukan untuk meluncurkan aplikasi ke produksi:

• Batas pengguna pengujian tidak lagi berlaku. Setiap pengguna dapat memberikan izin ke aplikasi.
• Pengguna hanya dapat memberikan izin ke jenis perangkat yang disetujui di Developer Console.

Ketuk Izinkan akses ke rumah yang dipilih:

• Jika ada rumah yang terhubung ke akun Anda, pilih rumah untuk memberikan izin. Jika tidak ada perangkat yang ditemukan di rumah yang dipilih, Anda dapat:
  1. Ketuk Izinkan akses ke rumah lain untuk memilih rumah lain.
  2. Siapkan perangkat pilihan Anda di rumah tersebut menggunakan Google Home app (GHA). Ingat, hanya jenis perangkat ini yang memiliki dukungan untuk kontrol di Aplikasi Contoh ini:
     • Lampu Suhu Warna (nyala dan mati, kecerahan)
     • Sensor Kontak (status boolean)
     • Lampu yang Dapat Diredupkan (nyala dan mati, kecerahan)
     • Kunci Pintu
     • Ekstensi Lampu Warna (nyala dan mati, kecerahan)
     • Sakelar Umum
     • Router Pembatas Google
     • Google Kamera
     • Google Doorbell
     • 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
• Jika tidak ada rumah yang terhubung ke akun Anda, Anda akan melihat layar dengan pesan Tidak ada struktur untuk akun yang dipilih.
  1. Geser kembali untuk kembali ke tampilan Aplikasi Contoh utama.
  2. Untuk menyiapkan rumah, gunakan GHA. Kemudian, coba berikan izin ke Aplikasi Contoh lagi.

Alur izin dapat dibuka kembali kapan saja dengan memilih ikon profil account_circle di kanan atas layar Aplikasi Contoh mana pun.

Setelah berhasil memberikan izin ke rumah yang memiliki perangkat, Anda akan diarahkan ke tampilan perangkat. Anda dapat mengontrol perangkat dan mengamati perubahan statusnya melalui Aplikasi Contoh.