Giản đồ mẫu và bản sao thiết bị

Mẫu thiết bị

Mẫu thiết bị được xác định theo các trường trong phần này.

Các trường mẫu thiết bị chỉ được chứa chữ cái, số và các ký hiệu sau: dấu chấm (.), dấu gạch nối (-), dấu gạch dưới (_), dấu cách ( ) và dấu cộng (+). Ký tự đầu tiên của trường phải là chữ cái hoặc số.

Ví dụ
{
  "project_id": "my-devices-project",
  "device_model_id": "my-devices-project-prototype-light-v1",
  "manifest": {
    "manufacturer": "Assistant SDK developer",
    "product_name": "Assistant SDK light",
    "device_description": "Assistant SDK light device"
  },
  "device_type": "action.devices.types.LIGHT",
  "traits": ["action.devices.traits.OnOff"]
}
Lược đồ
{
  "project_id": string,
  "device_model_id": string,
  "manifest": {
    "manufacturer": string,
    "product_name": string,
    "device_description": string
  },
  "device_type": string,
  "traits": [ string ]
}
  • project_id: (Chuỗi) Bắt buộc. Mã dự án trên Google Cloud Platform của dự án Bảng điều khiển hành động cần liên kết với mẫu thiết bị này. Một dự án có thể chứa nhiều mẫu thiết bị.
  • device_model_id: (Chuỗi) Bắt buộc. Giá trị nhận dạng duy nhất trên toàn cầu cho mẫu thiết bị này; sử dụng project_id làm tiền tố để giúp tránh xung đột trên phạm vi của tất cả dự án. Được dùng trong các chỉ số và trong quá trình đăng ký thiết bị.
  • manifest: (đối tượng(Manifest)) Bắt buộc. Siêu dữ liệu mô tả mẫu thiết bị và nhà sản xuất. Điều này có thể được hiển thị trong bảng điều khiển SDK (sắp ra mắt), trang tổng quan về chỉ số và các giao diện trực quan khác có liên quan.
    • manifest.manufacturer: (Chuỗi) Bắt buộc. Tên của nhà sản xuất thiết bị.
    • manifest.product_name: (Chuỗi) Bắt buộc. Tên sản phẩm dành cho người tiêu dùng cho mẫu thiết bị này.
    • manifest.device_description: (Chuỗi) Không bắt buộc. Nội dung mô tả về mẫu thiết bị này.
  • device_type: (Chuỗi) Bắt buộc. Loại phần cứng của thiết bị. Chọn trong số các lựa chọn sau:
    • action.devices.types.CAMERA
    • action.devices.types.DISHWASHER
    • action.devices.types.DRYER
    • action.devices.types.LIGHT
    • action.devices.types.OUTLET
    • action.devices.types.PHONE
    • action.devices.types.REFRIGERATOR
    • action.devices.types.SCENE
    • action.devices.types.SOUNDBAR
    • action.devices.types.SPEAKER
    • action.devices.types.SWITCH
    • action.devices.types.THERMOSTAT
    • action.devices.types.TV
    • action.devices.types.VACUUM
    • action.devices.types.WASHER
  • traits: (Array<String>) Không bắt buộc. Danh sách trait mà thiết bị hỗ trợ. Các đặc điểm bao gồm các lệnh, thuộc tính và trạng thái của thiết bị. Bạn không cần xác định Gói hành động để sử dụng đặc điểm tích hợp sẵn.

Phiên bản thiết bị

Thực thể thiết bị được xác định theo các trường trong phần này.

Các trường thực thể thiết bị phải bắt đầu bằng một chữ cái hoặc số. Mã thiết bị chỉ được chứa chữ cái, chữ số và các ký hiệu sau: dấu chấm (.), dấu gạch ngang (-), dấu gạch dưới (_) và dấu cộng (+). Biệt hiệu thiết bị chỉ có thể chứa số, chữ cái và dấu cách ( ).

Ví dụ
  {
    "id": "my_led_1",
    "model_id": "my-devices-project-prototype-light-v1",
    "nickname": "My Assistant Light",
    "client_type": "SDK_LIBRARY"
  }
Lược đồ
  {
    "id": string,
    "model_id": string,
    "nickname": string,
    "client_type": string
  }
  • id: (Chuỗi) Bắt buộc. Giá trị nhận dạng của thiết bị thử nghiệm. Phải là duy nhất trong tất cả các thiết bị đã đăng ký trong cùng một dự án dành cho nhà phát triển của Google.
  • model_id: (Chuỗi) Bắt buộc. Giá trị nhận dạng của mẫu thiết bị; phải giống với device_model_id được liên kết với thiết bị thử nghiệm này. Mẫu thiết bị phải được đăng ký trước đó.
  • nickname: (Chuỗi) Không bắt buộc. Biệt hiệu của thiết bị. Tên này sẽ được dùng để tham chiếu đến thiết bị trong các giao diện trực quan như phần cài đặt Trợ lý.
  • client_type: (Chuỗi) Bắt buộc. Loại thiết bị khách. Phải là một trong các giá trị sau: SDK_SERVICE hoặc SDK_LIBRARY.