Jalur fulfillment lokal ditetapkan saat Google cocok dengan perangkat yang dapat dikontrol secara lokal
ke perangkat yang ditampilkan di SYNC
respons 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 agar dapat
Google mengetahui 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 Konfigurasi SDK rumah lokal (opsional) > Tambahkan konfigurasi pemindaian perangkat, klik Konfigurasi pemindaian baru.
- Pilih jenis protokol yang cocok dengan pemindaian dari menu drop-down dan masukkan nilai untuk Google untuk memindai.
Tabel berikut menunjukkan atribut yang dapat Anda tambahkan, berdasarkan protokol yang Anda inginkan agar digunakan Google untuk memindai perangkat Anda:
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 di
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 Audio | Wajib. Port pemroses untuk respons penemuan UDP. | 5556 |
Paket Penemuan | Wajib. Payload yang akan dikirim dalam siaran UDP. Diformat sebagai string byte yang dienkode dengan heksadesimal. |
48454C4C4F |
Memperbarui respons SYNC di fulfillment cloud
Intent SYNC
melaporkan
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 perangkat
ID di kolom otherDeviceIds
ke ID verifikasi yang ditampilkan oleh
Pengendali IDENTIFY
. Entri perangkat tanpa kolom otherDeviceIds
dikecualikan dari fulfillment lokal.
Di kolom
otherDeviceIds
kolom respons SYNC
, Anda perlu menyetel ID perangkat smart home
yang dapat dikontrol secara lokal. Kolom ini muncul di tingkat device
dalam responsnya. Google dapat menetapkan jalur fulfillment lokal di perangkat apa pun dengan
ID yang diberikan.
Gunakan kolom customData
untuk menentukan data tambahan yang diperlukan Google
menghubungkan ke perangkat mandiri, atau 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": "..." } }] } }