Giản đồ về đặc điểm chế độ nhà thông minh

action.devices.traits.Modes – Trait này bao gồm tất cả các chế độ có sẵn và các chế độ cài đặt dành riêng cho từng chế độ của một thiết bị.

Đặc điểm này thuộc về những thiết bị có số "n-chiều" tuỳ ý chế độ mà trong đó các chế độ và chế độ cài đặt cho mỗi chế độ là tuỳ ý và riêng biệt cho từng thiết bị hoặc loại thiết bị. Mỗi chế độ có thể có nhiều chế độ cài đặt, nhưng mỗi lần bạn chỉ có thể chọn một chế độ; máy sấy không thể hãy "một cách tinh tế" "bình thường", và "nhiệm vụ nặng nề" chế độ đồng thời. Một chế độ cài đặt chỉ đơn giản có thể bật hoặc tắt thuộc về đặc điểm Toggles.

Ví dụ: Máy giặt có thể có các chế độ cài đặt cho khối lượng giặt và nhiệt độ. Cả hai đều là chế độ vì chúng độc lập với nhau, nhưng mỗi chế độ chỉ có thể ở một trạng thái mỗi lần. Người dùng có thể đặt một chế độ như nhiệt độ rõ ràng bằng một lệnh như Đặt nhiệt độ của máy giặt ở lạnh.

Một số chế độ được "theo thứ tự" và cũng có thể điều chỉnh bằng cử chỉ lên/xuống tăng/giảm độ dài lời nói. Ví dụ: kích thước tải (nhỏ, trung bình, lớn) và nhiệt độ được sắp xếp rõ ràng (lưu ý rằng nhiệt độ không phải là giá trị thực máy điều nhiệt có đích dạng số, như trên các thiết bị khác), nhưng loại tải (món ngon, loại bình thường, len, v.v.) có thể không được.

Đặc điểm này bao gồm một hoặc nhiều chế độ riêng lẻ mà người dùng có thể đặt. Nhìn chung, các chế độ này nên được dùng cho chức năng đã huỷ liên kết khỏi thiết bị khác hành vi. Hành vi được liên kết, chẳng hạn như tự bật hoặc tắt thiết bị, phải sử dụng đặc điểm cụ thể hơn (ví dụ: thermostatMode trong trait 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ả
availableModes Mảng

Bắt buộc.

Danh sách các chế độ hiện có.

[item, ...] Đối tượng

Chế độ có sẵn.

name String

Bắt buộc.

Tên nội bộ của chế độ, 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 chế độ này trong mỗi ngôn ngữ được hỗ trợ.

[item, ...] Đối tượng

Từ đồng nghĩa của chế độ này bằng một ngôn ngữ đã cho.

name_synonym Mảng

Bắt buộc.

Từ đồng nghĩa của chế độ 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ợ.

settings Mảng

Bắt buộc.

Các chế độ cài đặt được hỗ trợ cho chế độ này.

[item, ...] Đối tượng

Chế độ cài đặt được hỗ trợ.

Cần có ít nhất 2 mục.

setting_name String

Bắt buộc.

Tên nội bộ của chế độ cài đặ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ữ.

setting_values Mảng

Bắt buộc.

Từ đồng nghĩa của chế độ cài đặt này trong mỗi ngôn ngữ được hỗ trợ.

[item, ...] Đối tượng

Từ đồng nghĩa của chế độ cài đặt bằng ngôn ngữ đã cho.

setting_synonym Mảng

Bắt buộc.

Từ đồng nghĩa của chế độ cài đặ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ợ.

ordered Boolean

(Mặc định: false)

Nếu bạn đặt giá trị này thành true, thì ngữ pháp bổ sung cho logic tăng/giảm sẽ được áp dụng theo thứ tự (tăng) của mảng cài đặt.

commandOnlyModes 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.

queryOnlyModes 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 chế độ và chế độ cài đặt.

{
  "availableModes": [
    {
      "name": "load_mode",
      "name_values": [
        {
          "name_synonym": [
            "Load",
            "Size",
            "Load size"
          ],
          "lang": "en"
        }
      ],
      "settings": [
        {
          "setting_name": "small_load",
          "setting_values": [
            {
              "setting_synonym": [
                "Small",
                "Half"
              ],
              "lang": "en"
            }
          ]
        },
        {
          "setting_name": "medium_load",
          "setting_values": [
            {
              "setting_synonym": [
                "Medium",
                "Normal"
              ],
              "lang": "en"
            }
          ]
        },
        {
          "setting_name": "large_load",
          "setting_values": [
            {
              "setting_synonym": [
                "Large",
                "Full"
              ],
              "lang": "en"
            }
          ]
        }
      ],
      "ordered": true
    },
    {
      "name": "temp_mode",
      "name_values": [
        {
          "name_synonym": [
            "Temperature",
            "Temp"
          ],
          "lang": "en"
        }
      ],
      "settings": [
        {
          "setting_name": "hot_temp",
          "setting_values": [
            {
              "setting_synonym": [
                "Hot",
                "White"
              ],
              "lang": "en"
            }
          ]
        },
        {
          "setting_name": "warm_temp",
          "setting_values": [
            {
              "setting_synonym": [
                "Warm",
                "Color"
              ],
              "lang": "en"
            }
          ]
        },
        {
          "setting_name": "cold_temp",
          "setting_values": [
            {
              "setting_synonym": [
                "Cold",
                "Delicate"
              ],
              "lang": "en"
            }
          ]
        }
      ],
      "ordered": false
    }
  ]
}

Thiết bị chỉ có chế độ dùng lệnh.

{
  "availableModes": [
    {
      "name": "light_mode",
      "name_values": [
        {
          "name_synonym": [
            "Light",
            "Lighting"
          ],
          "lang": "en"
        }
      ],
      "settings": [
        {
          "setting_name": "day_light",
          "setting_values": [
            {
              "setting_synonym": [
                "Day",
                "Bright"
              ],
              "lang": "en"
            }
          ]
        },
        {
          "setting_name": "night_light",
          "setting_values": [
            {
              "setting_synonym": [
                "Night",
                "Dark"
              ],
              "lang": "en"
            }
          ]
        },
        {
          "setting_name": "reading_light",
          "setting_values": [
            {
              "setting_synonym": [
                "Reading",
                "Ambiant"
              ],
              "lang": "en"
            }
          ]
        }
      ],
      "ordered": false
    }
  ],
  "commandOnlyModes": true,
  "queryOnlyModes": false
}

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ả
currentModeSettings Đối tượng

Bắt buộc.

Khoá/giá trị ghép nối với chế độ name của thiết bị làm khoá và setting_name hiện tại là giá trị.

<string> String

Hiện tại setting_name.

Ví dụ

Thiết bị đang ở chế độ nào?

{
  "currentModeSettings": {
    "load_mode": "small_load",
    "temp_mode": "cold_temp"
  }
}

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.SetModes

Cập nhật phần cài đặt chế độ.

Tham số

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

Bắt buộc.

Khoá/giá trị ghép nối với chế độ name của thiết bị làm khoá và setting_name mới là giá trị.

<string> String

setting_name mới.

Ví dụ

Đặt thành tải lớn.

{
  "command": "action.devices.commands.SetModes",
  "params": {
    "updateModeSettings": {
      "load_mode": "large_load"
    }
  }
}

Cách phát âm mẫu

de-DE

  • Stelle den Staubsauger auf Ruhemodus

en-US

  • set the vacuum to energy saver mode

es-ES

  • pon la lavadora en modo frío

fr-FR

  • mets l'aspirateur en silencieux

hi-IN

  • वैक्यूम पर कार्पेट मोड लगाएं

it-IT

  • imposta l'aspirapolvere su silenzioso

ja-JP

  • 掃除機 静音 モードに設定して

ko-KR

  • 세탁기 세탁량 많음 으로 설정해

pt-BR

  • acionar a função autolimpeza do aspirador
  • ligar o modo de aquecimento

Thiết bị ERRORS

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