Mendukung penemuan perangkat

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:

  1. Buka project smart home Anda di konsol Actions.
  2. Di navigasi sebelah kiri, klik Tindakan.
  3. Di bagian Konfigurasi SDK rumah lokal (opsional) > Tambahkan konfigurasi pemindaian perangkat, klik Konfigurasi pemindaian baru.
  4. 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:

mDNS
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 instance.service.domain.

Platform memperlakukan nilai ini sebagai ekspresi reguler dan menampilkan perangkat yang cocok.
my-device-[0-9]{4}\._http\._tcp\.local
UPnP
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
UDP
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.

Mandiri/Hub
{
  "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": "..."
      }
    }]
  }
}