Intent smart home adalah objek pesan sederhana yang mendeskripsikan Tindakan smart home apa yang harus dilakukan, seperti menyalakan lampu atau mentransmisikan audio ke speaker.
Semua intent smart home dimuat dalam
action.devices
dan Anda harus menyediakan fulfillment untuknya. Kapan saja
Google Assistant mengirim intent ke fulfillment, yakni
token akses OAuth 2 pihak ketiga diteruskan di header Otorisasi.
Berikut adalah intent smart home yang didukung:
SINKRONKAN
Intent action.devices.SYNC
digunakan untuk meminta daftar
smart home perangkat yang telah terhubung dan
yang tersedia untuk digunakan.
Saat pengguna menyiapkan perangkatnya dengan Google Home app (GHA), mereka juga
mendapatkan otentikasi ke infrastruktur cloud Anda. Lalu:
Assistant menerima token OAuth2. Pada tahap ini,
Assistant mengirim intent action.devices.SYNC
ke
fulfillment untuk mengambil daftar awal perangkat dan kemampuan pengguna dari
infrastruktur cloud Anda.
Untuk menghindari pembatalan tautan dan penautan ulang akun pengguna, Anda dapat mengirim sinkronisasi permintaan
ke Assistant. Tindakan ini akan mengirimkan intent action.devices.SYNC
ke fulfillment Anda untuk menyinkronkan daftar perangkat dan kemampuan. Lihat
Terapkan Permintaan Sinkronisasi untuk informasi selengkapnya
tidak akurat atau tidak sesuai.
Selama penyiapan fulfillment lokal,
Platform Local Home memeriksa respons SYNC
dari
Fulfillment cloud Action smart home. Untuk mempelajari lebih
lanjut tentang cara
untuk 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
dari smart home perangkat.
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 pesanan.
Untuk pengalaman pengguna terbaik, Anda harus menerapkan Report State untuk melaporkan secara proaktif status perangkat pengguna saat ini secara langsung ke Google Home Graph. Misalnya, hal ini memungkinkan Assistant mengetahui apakah pengguna menyalakan lampu smart dengan saklar lampu fisik.
JALANKAN
Intent action.devices.EXECUTE
digunakan untuk memberikan perintah
untuk dijalankan di smart home perangkat.
Saat pengguna mengirimkan perintah ke perangkat dengan Assistant,
fulfillment akan menerima intent action.devices.EXECUTE
pada pemenuhan Anda yang
menjelaskan tindakan dan perangkat
yang harus ditindaklanjuti. Pengguna dapat menjalankan tindakan
di perangkat dengan perintah seperti Ok Google, nyalakan lampu ruang keluarga.
PUTUSKAN KONEKSI
Intent action.devices.DISCONNECT
dipicu untuk memberi tahu Anda
saat pengguna membatalkan tautan akun aplikasi dari Assistant.
Setelah menerima intent action.devices.DISCONNECT
, Anda tidak boleh melaporkan
untuk perangkat pengguna ini.