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

Đường dẫn thực hiện đơn hàng tại địa phương được thiết lập khi Google so khớp một thiết bị có thể kiểm soát tại địa phương với một thiết bị được trả về trong phản hồi SYNC từ dịch vụ thực hiện đơn hàng 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 phát hiện trong bảng điều khiển Actions. Bạn cũng cần cập nhật phản hồi SYNC từ dịch vụ thực hiện trên đám mây để cho Google biết về thiết bị có thể điều khiển tại chỗ.

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. Chuyển đến chế độ tích hợp Cloud-to-cloud trong Google Home Developer Console:

   Chuyển đến Developer Console.

2. Chuyển đến Project > Cloud-to-cloud (Dự án > Đám mây với đám mây) ở bên trái màn hình, sau đó chọn Edit (Chỉnh sửa) cho chế độ tích hợp. Trên trang Thiết lập và định cấu hình, hãy di chuyển đến mục Hoàn tất đơn hàng tại địa phương rồi bật chế độ cài đặt này. Nhập URL sau vào từng trường URL kiểm thử, chèn mã dự án của bạn rồi nhấp vào Lưu:

   https://<project-id>.web.app/local-home/index.html

3. Nhấp vào + Add scan configuration (Thêm cấu hình quét) trong mục Device discovery (Phát hiện thiết bị) để thêm một cấu hình quét mới.

4. Chọn một loại giao thức so khớp quét trong trình đơn thả xuống và nhập các giá trị để Google quét.

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

Cập nhật phản hồi SYNC trong dịch vụ thực hiện trên đám mây

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

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

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

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ị đầu cuối bằng cách sử dụng một trung tâm (ví dụ: số cổng và thông tin khác dành riêng cho 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.

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