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 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 configuration.
- Pilih jenis pemindaian yang cocok dengan protokol dari drop-down, lalu masukkan nilai yang akan dipindai oleh Google.
Tabel berikut menampilkan atribut yang dapat Anda tambahkan, berdasarkan protokol yang perlu digunakan oleh Google untuk memindai perangkat Anda:
| 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 |
| Dengarkan Port | Wajib diisi. Dengarkan port untuk respons penemuan UDP. | 5556 |
| Paket Discovery | Wajib diisi. Payload yang akan dikirim dalam siaran UDP. Diformat sebagai string byte dengan enkode heksadesimal. |
48454C4C4F |
Memperbarui respons SYNC di fulfillment cloud
Intent SYNC melaporkan kepada
Asisten terkait perangkat apa yang dikontrol dan kemampuan pengguna.
Untuk mendukung fulfillment lokal, platform Home 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.
Dalam
kolom otherDeviceIds
dari respons SYNC, Anda perlu menetapkan ID perangkat perangkat smart home
yang dapat dikontrol secara lokal. Kolom ini muncul di tingkat device
dalam respons. Google dapat membuat jalur fulfillment lokal pada perangkat apa pun dengan
ID yang diberikan.
Gunakan kolom customData untuk menentukan data tambahan yang perlu 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": "..."
}
}]
}
}