Nhà thông minh bật/tắt giản đồ Trait

action.devices.traits.Toggles – Đặc điểm này thuộc về bất kỳ thiết bị nào 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ể biểu thị một nút vật lý có chế độ bật/tắt hoặc hoạt động/không hoạt động trạng thái, hộp đánh dấu trong HTML hoặc bất kỳ chế độ bật/tắt cụ thể nào khác . Nếu chế độ cài đặt có nhiều hơn hai trạng thái hoặc có trạng thái không có lựa chọn nhị phân nào được chọn, nó được biểu thị tốt hơn dưới dạng Đặc điểm Modes, tương đương với gọi điện cho nhiều tiểu bang, nút chọn (thực tế hoặc HTML) hoặc trạng thái nhị phân không được hiển thị rõ ràng bật/tắt (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. Trong thông thường, bạn nên sử dụng các nút bật/tắt này cho chức năng bị huỷ liên kết từ hành vi khác của thiết bị. Hành vi liên kết, chẳng hạn như tự xoay thiết bị bật hoặc tắt, nên sử dụng đặc điểm cụ thể hơn (ví dụ: thermostatMode trong tính chất TemperatureSetting).

ATTRIBUTE của thiết bị

Những thiết bị có đặc điểm này có thể báo cáo những điều sau trong thao tác SYNC. Để tìm hiểu tìm hiểu thêm về cách xử lý ý định SYNC, hãy xem Thực hiện ý định.

Thuộc tính Loại Mô tả
availableToggles Mảng

Bắt buộc.

Danh sách các nút bật/tắt hiện có.
[item, ...] Đối tượng

Nút bật/tắt hiện có.
name String

Bắt buộc.

Tên nội bộ của nút bật/tắt, sẽ được dùng trong các lệnh và trạng thái. Thông tin này có thể không thân thiện với người dùng và sẽ được dùng chung cho tất cả các ngôn ngữ.
name_values Mảng

Bắt buộc.

Từ đồng nghĩa của nút bật/tắt này ở mỗi ngôn ngữ được hỗ trợ.
[item, ...] Đối tượng

Từ đồng nghĩa của nút bật/tắt này bằng một ngôn ngữ đã cho.
name_synonym Mảng

Bắt buộc.

Từ đồng nghĩa của nút bật/tắt này. Chuỗi đầu tiên trong danh sách này được dùng làm tên chuẩn của cấp độ trong ngôn ngữ đó.
[item, ...] String

Tên đồng nghĩa.
lang String

Bắt buộc.

Mã ngôn ngữ (ISO 639-1). Xem các ngôn ngữ được hỗ trợ.
commandOnlyToggles Boolean

(Mặc định: false)

Cho biết thiết bị có hỗ trợ giao tiếp một chiều (true) hay hai chiều (false). Đặt thuộc tính này thành true nếu thiết bị không thể phản hồi ý định QUERY hoặc Trạng thái báo cáo đối với đặc điểm này.
queryOnlyToggles Boolean

(Mặc định: false)

Bắt buộc nếu thiết bị hỗ trợ thực thi chỉ truy vấn. Thuộc tính này cho biết liệu thiết bị chỉ có thể truy vấn về thông tin trạng thái chứ không thể kiểm soát được.

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ỉ dù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ỉ truy vấn.

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

Thiết bị STATES

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

Tiểu bang Loại Mô tả
currentToggleSettings Đối tượng

Bắt buộc.

Khoá/giá trị được ghép nối với nút bật/tắt name của thiết bị dưới dạng khoá và trạng thái hiện tại dưới dạng giá trị.
<string> Boolean

Trạng thái hiện tại của nút bật/tắt.

Ví dụ

Tính năng khử trùng đã bật chưa?

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

lệnh của thiết bị

Những thiết bị có đặc điểm này có thể phản hồi với những đặc điểm sau các lệnh trong thao tác EXECUTE. Để tìm hiểu tìm hiểu thêm về cách xử lý ý định EXECUTE, hãy xem Thực hiện ý định.

action.devices.commands.SetToggles

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

Tham số

Tham số Loại Mô tả
updateToggleSettings Đối tượng

Bắt buộc.

Khoá/giá trị được ghép nối với nút bật/tắt name của thiết bị dưới dạng khoá và trạng thái mới dưới dạng giá trị.
<string> Boolean

Trạng thái bật/tắt mới

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ách phát âm mẫu

de-DE

  • Bitte schalte Power Cool am Kühlschrank aus
  • stelle den Kühlschrank auf Power Cool

en-US

  • activate power freeze for the freezer
  • cancel power cool for the kitchen fridge

es-ES

  • pon el enfriamiento rápido en la nevera
  • quita el enfriamiento rápido

fr-FR

  • mets le mode power cool sur le réfrigérateur
  • Éteins le mode power freeze du réfrigérateur .

hi-IN

  • रेफ़्रिजरेटर का पावर कूल मोड बंद कर दो
  • रेफ़्रिजरेटर में पावर कूल मोड चालू करो

it-IT

  • disattiva il power freeze del freezer
  • imposta la funzione power freeze del surgelatore

ja-JP

  • 冷蔵庫 の 急速冷凍 つけて
  • 冷蔵庫 の 急速冷凍 を切ってくれる

ko-KR

  • 냉장고 급속 냉장 해제해
  • 냉장고 모드 급속 냉장 으로 바꿔

nl-NL

  • Zet de power cool uit op de koelkast
  • zet de koelkast op superkoelen

pt-BR

  • Ativa a função power freeze no congelador .
  • Desativa o bloqueio infantil do forno .
  • desligar o power cool da geladeira
  • iniciar o modo power freeze do freezer

sv-SE

  • Stäng av power cool i kylskåpet
  • sätt på power freeze på frysen

Thiết bị ERRORS

Xem toàn bộ danh sách lỗi và ngoại lệ.