Selamat datang di Pusat Developer Google Home, tujuan baru untuk mempelajari cara mengembangkan tindakan smart home. Catatan: Anda akan terus membuat tindakan di konsol Actions.

Mood

Tetap teratur dengan koleksi Simpan dan kategorikan konten berdasarkan preferensi Anda.

Intent smart home adalah objek pesan sederhana yang menjelaskan tindakan yang dilakukan Smart Action seperti menyalakan lampu atau mentransmisikan audio ke speaker.

Semua intent smart home terdapat dalam namespace action.devices dan Anda harus menyediakan fulfillment untuk intent tersebut. Setiap kali Asisten Google mengirimkan intent untuk melakukan fulfillment, token akses OAuth 2 pihak ketiga milik pengguna diteruskan dalam header Authorization.

Berikut adalah intent smart home yang didukung:

SINKRONKAN

Intent action.devices.SYNC digunakan untuk meminta daftar perangkat smart home yang telah dihubungkan pengguna dan tersedia untuk digunakan.

Saat pengguna menyiapkan perangkat dengan aplikasi Google Home, mereka juga mendapatkan autentikasi ke infrastruktur cloud Anda. Kemudian, Asisten akan menerima token OAuth2. Pada tahap ini, Asisten Google akan mengirimkan intent action.devices.SYNC ke fulfillment Anda untuk mengambil daftar awal perangkat dan kemampuan pengguna dari infrastruktur cloud Anda.

Gambar ini menunjukkan interaksi antara infrastruktur Google
    dan infrastruktur partner. Dari infrastruktur Google, terdapat daftar partner yang tersedia untuk aplikasi klien Asisten, yang kemudian mengalir ke infrastruktur partner untuk menyelesaikan autentikasi OAuth. Autentikasi OAuth di sisi partner adalah webview penyiapan partner, webview OAuth, persyaratan dan ketentuan opsional, serta layanan cloud partner. Infrastruktur partner, kemudian menampilkan kredensial OAuth ke aplikasi klien Asisten. Layanan cloud partner mengirimkan perangkat dan kemampuan yang tersedia ke layanan Asisten, yang kemudian menyimpan informasinya di Home Graph.
Gambar 1: Interaksi antara infrastruktur Google dan Partner

Untuk menghindari pembatalan tautan dan penautan ulang akun pengguna, Anda dapat mengirim sinkronisasi permintaan ke Asisten Google. Tindakan ini akan mengirimkan intent action.devices.SYNC ke fulfillment Anda untuk menyinkronkan daftar perangkat dan kemampuan. Lihat Menerapkan Sinkronisasi Permintaan untuk mengetahui informasi selengkapnya.

Diagram alur intent SYNC
Gambar 2: Menyinkronkan intent

Selama penyiapan pemenuhan pesanan lokal, platform Beranda Lokal memeriksa respons SYNC dari fulfillment cloud Action smart home Anda. Untuk mempelajari lebih lanjut cara mengubah respons SYNC guna mendukung fulfillment lokal, lihat Memperbarui respons SYNC dalam pemenuhan cloud.

QUERY

Intent action.devices.QUERY digunakan untuk mengkueri status perangkat smart home saat ini.

Saat pengguna membuat kueri status perangkat, untuk menjawab pertanyaan seperti Ok Google, lampu apa yang menyala di dapur?, Asisten Google akan mengirimkan intent action.devices.QUERY ke fulfillment Anda.

Diagram alir intent QUERY
Gambar 3: Intent QUERY

Untuk pengalaman pengguna terbaik, Anda harus mengimplementasikan Status Laporan untuk secara proaktif melaporkan status perangkat pengguna saat ini langsung ke Home Graph. Misalnya, hal ini akan memberi tahu Asisten Google apakah pengguna Anda menyalakan lampu smart dengan saklar lampu fisik.

Melaporkan status perangkat menggunakan Status Laporan
Gambar 4: Melaporkan status perangkat

EKSEKUSI

Intent action.devices.EXECUTE digunakan untuk memberikan perintah untuk dieksekusi di perangkat smart home.

Saat pengguna mengirim perintah ke perangkat dengan Asisten Google, fulfillment Anda akan menerima intent action.devices.EXECUTE ke pemenuhan Anda yang menjelaskan tindakan dan perangkat yang harus ditindaklanjuti. Pengguna dapat menjalankan tindakan di perangkat dengan perintah seperti Ok Google, nyalakan lampu ruang tamu saya.

Diagram alir intent EXECUTE
Gambar 5: Niat EKSEKUTIF

PUTUSKAN KONEKSI

Intent action.devices.DISCONNECT dipicu untuk memberi tahu Anda jika pengguna telah membatalkan tautan akun aplikasi dari Asisten Google. Setelah menerima intent action.devices.DISCONNECT, Anda tidak boleh melaporkan status untuk perangkat pengguna ini.