Intent

Intent smart home adalah objek pesan sederhana yang menjelaskan integrasi Cloud-to-cloud yang akan dilakukan, seperti menyalakan lampu atau mentransmisikan audio ke speaker.

Semua intent smart home ada di namespace action.devices dan Anda harus menyediakan pemenuhannya. Setiap kali Google Assistant mengirim intent ke pemenuhan, token akses OAuth 2 pihak ketiga pengguna akan diteruskan di header Otorisasi.

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 mereka dengan Google Home app (GHA), mereka juga diautentikasi ke infrastruktur cloud Anda. Kemudian, Assistant menerima token OAuth2. Pada tahap ini, Assistant mengirim intent action.devices.SYNC ke pemenuhan 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, ada 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, setelan dan persyaratan 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 informasi tersebut di Home Graph.
Gambar 1: Interaksi antara infrastruktur Google dan Partner

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

Diagram alur intent SYNC
Gambar 2: Maksud SYNC

Selama penyiapan fulfillment lokal, platform Local Home 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 di fulfillment cloud.

QUERY

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

Saat pengguna menanyakan status perangkat, untuk menjawab pertanyaan seperti Ok Google, lampu apa yang menyala di dapur?, Assistant mengirim intent action.devices.QUERY ke pemenuhan Anda.

Diagram alur intent QUERY
Gambar 3: Intent QUERY

Untuk pengalaman pengguna yang terbaik, Anda harus menerapkan Report State untuk melaporkan secara proaktif status perangkat pengguna saat ini langsung ke Google Home Graph. Misalnya, hal ini memungkinkan Assistant mengetahui apakah pengguna Anda menyalakan lampu smart dengan sakelar lampu fisik.

Melaporkan status perangkat menggunakan Report State
Gambar 4: Laporkan status perangkat

JALANKAN

Intent action.devices.EXECUTE digunakan untuk memberikan perintah yang akan dijalankan di perangkat smart home.

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

Diagram alur intent EXECUTE
Gambar 5: Intent EXECUTE

PUTUSKAN SAMBUNGAN

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

Sebelumnya
Jenis dan karakteristik perangkat
Berikutnya
Fulfillment