Hỗ trợ khám phá thiết bị

Đường dẫn thực hiện cục bộ được thiết lập khi Google so khớp với một thiết bị có thể điều khiển cục bộ cho một thiết bị được trả về trong SYNC phản hồi từ phương thức thực hiện của bạn trên đám mây.

Để cho phép Google phát hiện thiết bị của bạn trên mạng cục bộ và thiết lập đường dẫn thực hiện cục bộ, bạn cần thêm thông tin khám phá vào bảng điều khiển Actions. Bạn cũng cần cập nhật phản hồi SYNC từ phương thức thực hiện trên đám mây để cho phép Google biết về thiết bị có thể điều khiển cục bộ.

Thiết lập thông tin cấu hình quét

Để chỉ định thông tin khám phá, hãy làm theo các bước sau:

  1. Mở dự án nhà thông minh trong bảng điều khiển Actions.
  2. Trong bảng điều hướng bên trái, hãy nhấp vào Hành động.
  3. Trong phần Định cấu hình SDK cục bộ trên trang chủ (không bắt buộc) > Thêm cấu hình quét thiết bị, nhấp vào Cấu hình quét mới.
  4. Chọn loại giao thức quét phù hợp với từ trình đơn thả xuống và nhập giá trị cho Google để quét.

Các bảng sau đây cho thấy những thuộc tính mà bạn có thể thêm, dựa trên giao thức mà bạn muốn Google sử dụng để quét tìm thiết bị của mình:

mDNS
Thuộc tính Mô tả Giá trị mẫu
Tên dịch vụ Bắt buộc. Tên dịch vụ do thiết bị xuất bản ở định dạng service.domain. _http._tcp.local
Tên

Bắt buộc. Lọc ra một phiên bản dịch vụ duy nhất trong instance.service.domain.

Nền tảng này coi giá trị này là biểu thức chính quy và trả về bất kỳ giá trị nào thiết bị phù hợp.
my-device-[0-9]{4}\._http\._tcp\.local
UPnP
Thuộc tính Mô tả Giá trị mẫu
Loại dịch vụ Bắt buộc. Giá trị nhận dạng đủ điều kiện của dịch vụ UPnP ở định dạng domain:service:type:version. schemas-upnp-org:service:SwitchPower:1
OUI (Giao diện người dùng đồ hoạ)

Không bắt buộc. Giá trị nhận dạng duy nhất của tổ chức.

Giá trị 24 bit xác định nhà sản xuất thiết bị. Thông thường là ba octet đầu tiên của địa chỉ MAC thiết bị.
1A:2B:3C
UDP
Thuộc tính Mô tả Giá trị mẫu
Địa chỉ phát sóng Bắt buộc. Địa chỉ IP đích cho thông báo truyền tin UDP. 255.255.255.255
Cổng phát sóng Bắt buộc. Cổng đích cho thông báo truyền tin UDP. 5555
Cổng nghe Bắt buộc. Cổng nghe phản hồi khám phá UDP. 5556
Gói khám phá

Bắt buộc. Tải trọng cần gửi trong thông báo truyền tin UDP.

Được định dạng dưới dạng một chuỗi byte được mã hoá hệ thập lục phân.
48454C4C4F

Cập nhật phản hồi SYNC trong phương thức thực hiện trên đám mây

Ý định SYNC báo cáo để Trợ lý những thiết bị mà người dùng điều khiển và khả năng của các thiết bị đó.

Để hỗ trợ phương thức thực hiện cục bộ, nền tảng Local Home sẽ kiểm tra phản hồi SYNC từ phương thức thực hiện trên đám mây của Hành động nhà thông minh và cố gắng so khớp với thiết bị Các mã trong trường otherDeviceIds so với mã xác minh do Trình xử lý IDENTIFY. Các mục nhập trên thiết bị không có trường otherDeviceIds bị loại trừ khỏi phương thức thực hiện cục bộ.

Trong otherDeviceIds của phản hồi SYNC, bạn cần đặt mã thiết bị của nhà thông minh các thiết bị có thể điều khiển cục bộ. Trường này xuất hiện ở cấp device trong câu trả lời. Google có thể thiết lập đường dẫn thực hiện cục bộ trên bất kỳ thiết bị nào có mã nhận dạng đã cấp.

Sử dụng trường customData để chỉ định mọi dữ liệu bổ sung mà Google cần kết nối với một thiết bị độc lập hoặc để nhắm đến các thiết bị cuối qua một thiết bị trung tâm (ví dụ: số cổng và thông tin cụ thể khác về giao thức).

Ví dụ:

Đoạn mã sau đây cho biết cách bạn có thể tạo trình xử lý SYNC.

Độc lập/Trung tâm
{
  "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": "..."
      }
    }]
  }
}