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 bởi các trường trong phần này.

Trường mẫu thiết bị chỉ có thể chứa chữ cái, số và các thông tin sau ký hiệu: 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 một trường phải là một 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"]
}
Giản đồ
{
  "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 Actions để 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 một tiền tố để giúp tránh xung đột trên phạm vi của tất cả dự án. Đã dùng về các chỉ số và trong quá trình đăng ký thiết bị.
  • manifest: (đối tượng(Tệp kê khai)) Bắt buộc. Siêu dữ liệu mô tả mẫu thiết bị và nhà sản xuất. Nội dung này có thể được nêu trong SDK (sắp ra mắt) bảng điều khiển, trang tổng quan 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 thiết bị của nhà sản xuất.
    • manifest.product_name: (Chuỗi) Bắt buộc. Dành cho người tiêu dùng tên sản phẩm cho mẫu thiết bị này.
    • manifest.device_description: (Chuỗi) Không bắt buộc. Nội dung mô tả mẫu thiết bị này.
  • device_type: (Chuỗi) Bắt buộc. Loại phần cứng thiết bị. Chọn từ các nguồ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 của thiết bị Google Cloud. Đặ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 tính năng tích hợp sẵn.

Phiên bản thiết bị

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

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ó thể 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 (_) và dấu cộng (+). Biệt hiệu của thiết bị chỉ có thể chứa số, chữ cái và ký hiệu 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"
  }
Giản đồ
  {
    "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 duy nhất trong tất cả các thiết bị được đăng ký trong cùng một Google Dự án của nhà phát triển.
  • model_id: (Chuỗi) Bắt buộc. Mã nhận dạng của mẫu thiết bị; phải giống với device_model_id 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 đây.
  • nickname: (Chuỗi) Không bắt buộc. Biệt hiệu cho thiết bị. Tên này sẽ được dùng để tham chiếu đến thiết bị trong giao diện trực quan như Cài đặt Trợ lý.
  • client_type: (Chuỗi) Bắt buộc. Loại thiết bị khách. Phải SDK_SERVICE hoặc SDK_LIBRARY.