Lược đồ đặc điểm của nút bật/tắt nhà thông minh

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 vật lý 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 cụ thể. Nếu chế độ cài đặt có nhiều hơn 2 trạng thái hoặc có trạng thái mà không có lựa chọn nhị phân nào được chọn, thì tốt hơn là bạn nên biểu thị chế độ cài đặt đó dưới dạng đặc điểm Modes, tương đương với các nút xoay nhiều trạng thái, nút chọn (vật lý hoặc HTML) hoặc các trạng thái nhị phân không được bật/tắt một cách rõ ràng (ví dụ: "AM/FM" hoặc "nóng/lạnh").

Đặc điểm 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 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ị, nên sử dụng các đặc điểm cụ thể hơn (ví dụ: thermostatMode trong đặc điểm TemperatureSetting).

THUỘC TÍNH của 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 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ị chỉ có nút bật/tắt lệnh.

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

Thiết bị chỉ có nút bật/tắt 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 hoạt động 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ế độ khử trùng có đang bật không?

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

Lệnh cho 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 trong thao tác 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 một trạng thái bật/tắt nhất định.

Thông số

Ví dụ

Bật chế độ tiết kiệm năng lượng.

{
  "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 mẫu

LỖI thiết bị