Local Home SDK meningkatkan integrasi smart home Anda dengan Asisten Google dengan menambahkan jalur fulfillment lokal untuk merutekan intent smart home.
SDK ini memungkinkan Anda menulis aplikasi fulfillment lokal, menggunakan TypeScript atau JavaScript, yang berisi logika bisnis smart home Anda. Perangkat Google Home atau Google Nest dapat memuat dan menjalankan aplikasi Anda di perangkat. Aplikasi Anda berkomunikasi langsung dengan perangkat smart yang ada melalui Wi-Fi di jaringan area lokal (LAN) untuk memenuhi perintah pengguna, melalui protokol yang ada.
Integrasi SDK menawarkan peningkatan performa pada Action smart home Anda, termasuk latensi yang lebih rendah dan keandalan yang lebih tinggi. Fulfillment lokal didukung untuk semua jenis perangkat dan karakteristik perangkat, kecuali yang menggunakan verifikasi pengguna sekunder.
Memahami cara kerjanya
Setelah mendapatkan respons SYNC
dari fulfillment cloud Anda, platform Local Home memindai jaringan area lokal
pengguna menggunakan mDNS, siaran UDP, atau UPnP untuk menemukan
perangkat smart yang terhubung ke Asisten.
Platform mengirim intent IDENTIFY
untuk menentukan apakah perangkat
dapat dikontrol secara lokal, dengan membandingkan ID perangkat dalam respons IDENTIFY
dengan ID perangkat yang ditampilkan oleh respons SYNC
sebelumnya. Jika perangkat yang terdeteksi merupakan
hub atau jembatan, platform akan mengirim intent REACHABLE_DEVICES
dan memperlakukan
hub sebagai perangkat proxy untuk berkomunikasi secara lokal.
Saat menerima respons yang mengonfirmasi perangkat lokal, platform akan membuat jalur fulfillment lokal ke perangkat Google Home atau Google Nest pengguna, lalu merutekan perintah pengguna untuk fulfillment lokal.
Saat pengguna memicu Action smart home yang memiliki jalur fulfillment lokal,
Asisten akan mengirimkan intent EXECUTE
atau intent QUERY
ke
perangkat Google Home atau Google Nest, bukan fulfillment cloud. Perangkat kemudian
menjalankan aplikasi fulfillment lokal untuk memproses intent.
Platform Local Home tidak bersifat deterministik dalam memilih perangkat Google Home atau Google Nest yang akan
memicu perintah. Intent EXECUTE
dan QUERY
dapat berasal melalui
perangkat Google Home atau Google Nest apa pun yang ditentukan dalam struktur
Home Graph yang sama dengan perangkat target.
Aplikasi fulfillment lokal
Aplikasi fulfillment lokal berisi logika bisnis untuk memproses intent yang dikirim oleh platform Local Home dan mengakses perangkat smart Anda melalui jaringan area lokal. Tidak ada modifikasi hardware yang diharapkan untuk mengintegrasikan fulfillment lokal. Aplikasi memenuhi permintaan Action smart home dengan mengirimkan perintah kontrol ke perangkat smart melalui protokol lapisan aplikasi, termasuk HTTP, TCP, atau UDP. Jika jalur fulfillment lokal gagal, fulfillment cloud Anda akan digunakan sebagai jalur eksekusi penggantian.
Untuk mendukung pembuatan aplikasi, Local Home SDK menyediakan dua class utama berikut:
DeviceManager
: Menyediakan metode untuk berkomunikasi dengan perangkat smart menggunakan TCP, soket UDP, atau permintaan HTTP.App
: Menyediakan metode untuk melampirkan pengendali untuk intent yang dikirim Google setelah menemukan perangkat yang dapat dikontrol secara lokal (IDENTIFY
,REACHABLE_DEVICES
). Class ini juga memenuhi perintah pengguna (EXECUTE
), dan menjawab kueri pengguna terkait status perangkat saat ini (QUERY
).
Selama pengembangan, Anda dapat mem-build dan menguji aplikasi dengan memuatnya di server hosting Anda sendiri atau mesin pengembangan lokal. Dalam produksi, Google menghosting aplikasi Anda di lingkungan sandbox JavaScript yang aman di perangkat Google Home atau Google Nest pengguna.
Report State API saat ini tidak didukung untuk fulfillment lokal. Google mengandalkan fulfillment cloud Anda untuk memproses permintaan ini.
Siklus proses aplikasi
Aplikasi fulfillment lokal Anda dimuat secara on demand saat platform Local Home menemukan perangkat lokal baru yang cocok dengan konfigurasi pemindaian project, atau memiliki intent tertunda untuk dikirimkan terkait perangkat yang telah diidentifikasi sebelumnya.
Perangkat Google Home atau Google Nest memiliki keterbatasan memori dan aplikasi fulfillment lokal Anda dapat dihentikan kapan saja karena tekanan memori dalam sistem. Hal ini dapat terjadi jika aplikasi Anda mulai menggunakan terlalu banyak memori, atau jika sistem perlu memberi ruang untuk aplikasi lain. Platform Local Home akan memulai ulang aplikasi Anda hanya saat ada intent baru untuk dikirimkan dan resource memori yang cukup untuk dijalankan aplikasi.
Platform Local Home akan menghapus muatan aplikasi Anda setelah waktu tunggu tidak ada aktivitas saat pengguna
membatalkan tautan akunnya atau tidak ada lagi perangkat yang mendukung fulfillment
lokal yang terkait dengan agentUserId
pengguna.
Perangkat yang didukung
Platform Local Home menjalankan aplikasi fulfillment lokal Anda di perangkat Google Home atau Google Nest yang didukung. Tabel berikut menjelaskan perangkat yang didukung, dan runtime yang digunakan di setiap perangkat. Untuk mempelajari persyaratan runtime lebih lanjut, lihat Lingkungan eksekusi.
Perangkat | Type | Lingkungan |
---|---|---|
Google Home | Speaker | Chrome |
Google Home Mini | Speaker | Chrome |
Google Home Max | Speaker | Chrome |
Nest Mini | Speaker | Chrome |
Nest Hub | Display | Chrome |
Nest Hub Max | Display | Chrome |
Nest Wifi | Router | Node.js |
Titik | Chrome |
Lingkungan eksekusi
Lingkungan eksekusi untuk aplikasi fulfillment lokal Anda bergantung pada perangkat Anda. Platform Local Home mendukung lingkungan runtime berikut:
- Chrome: Aplikasi fulfillment lokal Anda dijalankan dalam konteks browser
Chrome
window
yang menjalankan Chrome M80 atau yang lebih baru dengan dukungan untuk ECMAScript versi ES2018. - Node.js: Aplikasi fulfillment lokal Anda dijalankan sebagai skrip dalam proses Node.js yang menjalankan Node v10.x LTS atau yang lebih baru dengan dukungan untuk ECMAScript versi ES2018.
Struktur kode sumber
Sebaiknya gabung dependensi Anda ke dalam satu file JavaScript menggunakan konfigurasi pemaket yang disediakan oleh Local Home SDK dan kemas kode sumber Anda sebagai Ekspresi Fungsi yang Segera dipanggil (IIFE).
Jalur implementasi
Untuk memanfaatkan Local Home SDK untuk integrasi smart home, Anda harus melakukan tugas-tugas berikut:
1 | Menyiapkan konfigurasi pemindaian | Konfigurasikan konsol Actions dengan parameter yang diperlukan untuk Asisten guna menemukan perangkat yang dapat dikontrol secara lokal. |
2 | Memperbarui respons SYNC di fulfillment cloud Anda | Dalam fulfillment cloud Anda, ubah pengendali
permintaan SYNC
untuk mendukung kolom
otherDeviceIds yang digunakan platform untuk membuat
jalur fulfillment lokal. Di kolom tersebut, tentukan ID perangkat yang dapat
dikontrol secara lokal.
|
3 | Mengimplementasikan aplikasi fulfillment lokal | Gunakan Local Home SDK untuk membuat aplikasi JavaScript guna
menangani intent IDENTIFY ,
EXECUTE , dan
QUERY . Untuk perangkat proxy hub atau bridge, Anda juga harus
menangani intent REACHABLE_DEVICES .
|
4 | Menguji dan men-debug aplikasi | Uji integrasi Anda (atau lakukan penilaian mandiri) menggunakan Google Home Test Suite. |
Sebelum memulai
- Pelajari dasar-dasar membuat Action smart home.
- Di konsol Actions, pastikan Anda memiliki project smart home dan penautan akun telah dikonfigurasi.
- Pastikan Anda login dengan Akun Google yang sama di konsol Actions dan di Asisten pada perangkat pengujian.
- Anda memerlukan lingkungan Node.js untuk menulis aplikasi. Untuk menginstal Node.js dan npm, sebaiknya gunakan Node Version Manager.
- Agar berfungsi dengan Local Home SDK versi terbaru, Anda harus mendaftarkan perangkat pengujian ke Program Pratinjau Cast.