Jalur fulfillment lokal dibuat saat Google mencocokkan perangkat yang dapat dikontrol secara lokal
ke perangkat yang ditampilkan dalam respons SYNC
dari fulfillment cloud Anda.
Agar Google dapat menemukan perangkat Anda di jaringan lokal dan membuat
jalur fulfillment lokal, Anda perlu menambahkan informasi penemuan di Konsol Actions.
Anda juga perlu memperbarui respons SYNC dari fulfillment cloud Anda untuk memberi tahu
Google tentang perangkat yang dapat dikontrol secara lokal.
Menyiapkan informasi konfigurasi pemindaian
Untuk menentukan informasi penemuan, ikuti langkah-langkah berikut:
- Buka project smart home Anda di konsol Actions.
- Di navigasi sebelah kiri, klik Tindakan.
- Di bagian Configure local home SDK (opsional) > Tambahkan konfigurasi pemindaian perangkat, klik New scan config.
- Pilih jenis protokol yang cocok dengan pemindaian dari drop-down, lalu masukkan nilai yang ingin dipindai oleh Google.
Tabel berikut menampilkan atribut yang dapat Anda tambahkan, berdasarkan protokol yang Anda inginkan untuk digunakan oleh Google guna memindai perangkat:
| Atribut | Deskripsi | Nilai Contoh |
|---|---|---|
| Nama Layanan |
Wajib diisi. Nama layanan yang dipublikasikan oleh perangkat dalam format
service.domain.
|
_http._tcp.local |
| Nama |
Wajib diisi. Filter untuk instance layanan unik dalam format |
my-device-[0-9]{4}\._http\._tcp\.local |
| Atribut | Deskripsi | Nilai Contoh |
|---|---|---|
| Jenis Layanan |
Wajib diisi. ID layanan UPnP yang sepenuhnya memenuhi syarat dalam format
domain:service:type:version.
|
schemas-upnp-org:service:SwitchPower:1 |
| OUI |
Opsional. ID Unik Organisasi. Nilai 24-bit yang mengidentifikasi produsen perangkat. Biasanya, tiga oktet pertama dari alamat MAC perangkat. |
1A:2B:3C |
| Atribut | Deskripsi | Nilai Contoh |
|---|---|---|
| Alamat Siaran | Wajib diisi. Alamat IP tujuan untuk siaran UDP. | 255.255.255.255 |
| Port Siaran | Wajib diisi. Port tujuan untuk siaran UDP. | 5555 |
| Port Dengarkan | Wajib diisi. Port pemrosesan untuk respons penemuan UDP. | 5556 |
| Paket Discovery | Wajib diisi. Payload yang akan dikirim dalam siaran UDP. Diformat sebagai string byte terenkode heksadesimal. |
48454C4C4F |
Memperbarui respons SYNC dalam fulfillment cloud
Intent SYNC melaporkan kepada
Asisten untuk perangkat apa yang dikontrol dan kemampuan pengguna.
Untuk mendukung fulfillment lokal, platform Local Home memeriksa respons SYNC
dari fulfillment cloud Action smart home Anda dan mencoba mencocokkan ID
perangkat di kolom otherDeviceIds dengan ID verifikasi yang ditampilkan oleh
pengendali IDENTIFY. Entri perangkat tanpa kolom otherDeviceIds
dikecualikan dari fulfillment lokal.
Di kolom
otherDeviceIds
dari respons SYNC, Anda perlu menetapkan ID perangkat perangkat smart home
yang dapat dikontrol secara lokal. Kolom ini muncul pada tingkat device dalam respons. Google dapat membuat jalur fulfillment lokal di perangkat apa pun dengan
ID yang diberikan.
Gunakan kolom customData untuk menentukan data tambahan yang harus dihubungkan Google ke perangkat mandiri, atau untuk menargetkan perangkat akhir melalui hub (misalnya, nomor port dan informasi khusus protokol lainnya).
Contoh
Cuplikan berikut menunjukkan cara membuat pengendali SYNC.
{
"requestId": "ff36a3cc-ec34-11e6-b1a0-64510650abcf",
"payload": {
"agentUserId": "1836.15267389",
"devices": [{
"id": "123",
"type": "action.devices.types.OUTLET",
"traits": [
"action.devices.traits.OnOff"
],
"name": {
"name": "Night light"
},
"willReportState": false,
"otherDeviceIds": [{
"deviceId": "local-device-id"
}],
"customData": {
"port": 5555,
"authToken": "..."
}
}]
}
}