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 menetapkan
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 di konsol Actions.
- Di navigasi sebelah kiri, klik Tindakan.
- Di bagian Configure local home SDK (optional) > Add device Scan configuration, klik New Scan config.
- Pilih jenis protokol pencocokan pemindaian dari menu drop-down, lalu masukkan nilai untuk dipindai oleh Google.
Tabel berikut menunjukkan atribut yang dapat Anda tambahkan, berdasarkan protokol yang Anda inginkan agar digunakan Google untuk memindai perangkat:
Atribut | Deskripsi | Nilai Contoh |
---|---|---|
Nama Layanan |
Wajib. Nama layanan yang dipublikasikan oleh perangkat dalam format
service.domain .
|
_http._tcp.local |
Nama |
Wajib. Filter instance layanan unik dalam
format |
my-device-[0-9]{4}\._http\._tcp\.local |
Atribut | Deskripsi | Nilai Contoh |
---|---|---|
Jenis Layanan |
Wajib. 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. Alamat IP tujuan untuk siaran UDP. | 255.255.255.255 |
Port Siaran | Wajib. Port tujuan untuk siaran UDP. | 5555 |
Port Dengarkan | Wajib. Port dengarkan untuk respons penemuan UDP. | 5556 |
Paket Penemuan | Wajib. Payload yang dikirim dalam siaran UDP. Diformat sebagai string byte dengan enkode heksadesimal. |
48454C4C4F |
Memperbarui respons SYNC di fulfillment cloud
Intent SYNC
melaporkan kepada
Asisten perangkat apa yang dikontrol pengguna dan kemampuannya.
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
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 di perangkat apa pun dengan
ID yang diberikan.
Gunakan kolom customData
untuk menentukan data tambahan yang diperlukan Google
terhubung 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": "..." } }] } }