Mendukung penemuan perangkat

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:

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

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

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

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": "..."
      }
    }]
  }
}
Sebelumnya
Ringkasan
Berikutnya
Menerapkan aplikasi fulfillment lokal