Mood

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.

Angka ini menunjukkan interaksi antara infrastruktur Google
    dan infrastruktur partner. Dari infrastruktur Google terdapat
    daftar partner yang tersedia untuk aplikasi klien Asisten, yang kemudian
    alur ke infrastruktur partner untuk menyelesaikan autentikasi OAuth. OAuth
    otentikasi di sisi mitra adalah {i>
partner setup webview<i}, OAuth webview,
    setelan opsional dan persyaratan, serta layanan cloud partner. Infrastruktur partner,
    lalu menampilkan kredensial OAuth ke aplikasi klien Assistant. Partner
    layanan cloud mengirimkan perangkat 
dan kemampuan yang tersedia ke layanan Asisten,
    yang kemudian menyimpan 
informasi di {i>Home Graph<i}.
Gambar 1: Interaksi antara Google dan Partner infrastruktur

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.

Diagram alir intent SYNC
Gambar 2: Intent SYNC

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.

Diagram alur intent QUERY
Gambar 3: Intent QUERY

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.

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

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.

Diagram alir intent EXECUTE
Gambar 5: Mengeksekusi intent

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.