Nhà thông minh bật/tắt giản đồ đặc điểm

action.devices.traits.Toggles – Đặc điểm này thuộc về mọi thiết bị có chế độ cài đặt chỉ có thể tồn tại ở một trong hai trạng thái.

Các chế độ cài đặt này có thể đại diện cho một nút thực có trạng thái bật/tắt hoặc đang hoạt động/không hoạt động, một hộp đánh dấu trong HTML hoặc bất kỳ loại phần tử nào khác được bật/tắt một cách cụ thể. Nếu chế độ cài đặt có nhiều hơn hai trạng thái hoặc có một trạng thái mà không có tuỳ chọn nhị phân nào được chọn, thì chế độ cài đặt đó sẽ được biểu thị tốt hơn dưới dạng một thuộc tính Modes, tương đương với các nút xoay nhiều trạng thái, nút chọn (thực hoặc HTML) hoặc trạng thái nhị phân không bật/tắt rõ ràng (ví dụ: "AM/FM" hoặc "nóng/lạnh").

Thuộc tính này bao gồm một hoặc nhiều nút bật/tắt riêng lẻ mà người dùng có thể đặt. Nhìn chung, bạn nên sử dụng các nút bật/tắt này cho chức năng không liên kết với hành vi khác của thiết bị. Hành vi được liên kết, chẳng hạn như bật hoặc tắt chính thiết bị, phải sử dụng các đặc điểm cụ thể hơn (ví dụ: thermostatMode trong đặc điểm TemperatureSetting).

Thuộc tính thiết bị

Các thiết bị có đặc điểm này có thể báo cáo các thuộc tính sau đây trong quá trình thực hiện thao tác SYNC. Để tìm hiểu thêm về cách xử lý ý định SYNC, hãy xem phần Thực hiện ý định.

Ví dụ

Thiết bị có nhiều nút bật/tắt.

{
  "availableToggles": [
    {
      "name": "sterilization_toggle",
      "name_values": [
        {
          "name_synonym": [
            "Clean",
            "Bio clean"
          ],
          "lang": "en"
        }
      ]
    },
    {
      "name": "energysaving_toggle",
      "name_values": [
        {
          "name_synonym": [
            "Energy saving",
            "Eco"
          ],
          "lang": "en"
        }
      ]
    }
  ]
}

Thiết bị có nút bật/tắt chỉ bằng lệnh.

{
  "availableToggles": [
    {
      "name": "filter_toggle",
      "name_values": [
        {
          "name_synonym": [
            "Filtered",
            "Filter"
          ],
          "lang": "en"
        }
      ]
    }
  ],
  "commandOnlyToggles": true
}

Thiết bị có nút bật/tắt chỉ dành cho truy vấn.

{
  "availableToggles": [
    {
      "name": "filter_toggle",
      "name_values": [
        {
          "name_synonym": [
            "Filtered",
            "Filter"
          ],
          "lang": "en"
        }
      ]
    }
  ],
  "queryOnlyToggles": true
}

Trạng thái thiết bị

Các thực thể có đặc điểm này có thể báo cáo các trạng thái sau đây trong quá trình thực hiện thao tác QUERY. Để tìm hiểu thêm về cách xử lý ý định QUERY, hãy xem phần Thực hiện ý định.

Ví dụ

Chế độ vô trùng có đang bật không?

{
  "currentToggleSettings": {
    "sterilization_toggle": true,
    "energysaving_toggle": false
  }
}

LỆNH của thiết bị

Các thiết bị có đặc điểm này có thể phản hồi các lệnh sau đây trong quá trình hoạt động EXECUTE. Để tìm hiểu thêm về cách xử lý ý định EXECUTE, hãy xem phần Thực hiện ý định.

action.devices.commands.SetToggles

Đặt trạng thái bật/tắt nhất định.

Thông số

Ví dụ

Bật chế độ tiết kiệm pin.

{
  "command": "action.devices.commands.SetToggles",
  "params": {
    "updateToggleSettings": {
      "energysaving_toggle": true
    }
  }
}

Tắt bộ lọc.

{
  "command": "action.devices.commands.SetToggles",
  "params": {
    "updateToggleSettings": {
      "filter_toggle": false
    }
  }
}

Câu lệnh mẫu

LỖI thiết bị