Giản đồ về đặc điểm tốc độ quạt nhà thông minh

action.devices.traits.FanSpeed – Đặc điểm này thuộc về các thiết bị hỗ trợ đặt tốc độ của quạt.

Tốc độ quạt (tức là thổi không khí từ thiết bị ở nhiều mức độ, có thể là một phần của điều hoà không khí/thiết bị sưởi hoặc trong ô tô), có thể bao gồm các chế độ cài đặt như thấp, trung bình và cao hoặc một tỷ lệ phần trăm.

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ả
reversible Boolean

(Mặc định: false)

Nếu bạn đặt chính sách này thành true, thì thiết bị này sẽ hỗ trợ thổi quạt theo cả hai hướng và có thể chấp nhận lệnh đảo ngược hướng quạt.
commandOnlyFanSpeed 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.
Chứa bất kỳ mục nào sau đây:
0 Đối tượng

Hỗ trợ cài đặt tốc độ.
availableFanSpeeds Đối tượng

Bắt buộc.

Các chế độ cài đặt tốc độ mà thiết bị hỗ trợ.
speeds Mảng

Bắt buộc.

Danh sách các chế độ cài đặt tốc độ.
[item, ...] Đối tượng

Cài đặt tốc độ.
speed_name String

Bắt buộc.

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

Bắt buộc.

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

Từ đồng nghĩa với chế độ cài đặt tốc độ trong một ngôn ngữ đã cho.
speed_synonym Mảng

Bắt buộc.

Từ đồng nghĩa của chế độ cài đặt tốc độ, phải bao gồm cả dạng số ít và số nhiều, nếu có. Từ đồng nghĩa đầu tiên trong danh sách sẽ được coi là tên chuẩn của chế độ cài đặt tốc độ.
[item, ...] String

Từ đồ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

Bắt buộc.

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

Hỗ trợ tỷ lệ phần trăm tốc độ.
supportsFanSpeedPercent Boolean

Bắt buộc.

(Mặc định: false)

Nếu bạn đặt chính sách này thành true, thì thiết bị này sẽ chấp nhận các lệnh điều chỉnh tốc độ sử dụng tỷ lệ phần trăm từ 0,0 đến 100,0.

Ví dụ

Thiết bị có hai chế độ cài đặt tốc độ, hỗ trợ đảo chiều và điều chỉnh theo tỷ lệ phần trăm.

{
  "availableFanSpeeds": {
    "speeds": [
      {
        "speed_name": "speed_low",
        "speed_values": [
          {
            "speed_synonym": [
              "Low",
              "Slow"
            ],
            "lang": "en"
          }
        ]
      },
      {
        "speed_name": "speed_high",
        "speed_values": [
          {
            "speed_synonym": [
              "High",
              "Fast"
            ],
            "lang": "en"
          }
        ]
      }
    ],
    "ordered": true
  },
  "reversible": true,
  "supportsFanSpeedPercent": 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ả
currentFanSpeedSetting String

Thuộc tính này đại diện cho tên nội bộ của chế độ cài đặt tốc độ hiện tại trong thuộc tính availableFanSpeeds.
currentFanSpeedPercent Number

Cho biết tốc độ quạt hiện tại theo phần trăm. Bắt buộc nếu thuộc tính supportsFanSpeedPercent được đặt thành true

Ví dụ

Quạt trong phòng khách hiện ở tốc độ bao nhiêu?

{
  "currentFanSpeedSetting": "speed_low",
  "currentFanSpeedPercent": 10
}

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

Đặt tốc độ.

Thông số

Tải trọng chứa một trong các mục sau:

Bạn có thể đặt tốc độ theo chế độ cài đặt.

Thông số Loại Mô tả
fanSpeed String

Bắt buộc.

Chế độ cài đặt tốc độ quạt yêu cầu.

Đặt tốc độ theo phần trăm.

Thông số Loại Mô tả
fanSpeedPercent Number

Bắt buộc.

Tỷ lệ phần trăm cài đặt tốc độ mà bạn yêu cầu.

Ví dụ

Đặt quạt ở mức cao.

{
  "command": "action.devices.commands.SetFanSpeed",
  "params": {
    "fanSpeed": "speed_high"
  }
}

Đặt quạt ở mức 50%.

{
  "command": "action.devices.commands.SetFanSpeed",
  "params": {
    "fanSpeedPercent": 50
  }
}

action.devices.commands.SetFanSpeedRelative

Đặt tốc độ tương đối.

Lệnh này yêu cầu các thuộc tính sau: 
{
  "commandOnlyFanSpeed": true
}

Thông số

Tải trọng chứa một trong các mục sau:

Đặt tốc độ tương đối theo trọng lượng.

Thông số Loại Mô tả
fanSpeedRelativeWeight Số nguyên

Bắt buộc.

Giá trị này cho biết mức thay đổi tốc độ tương đối. Giá trị tuyệt đối cho biết số tiền được chia theo tỷ lệ trong khi ký hiệu bằng số cho biết hướng thay đổi.

Đặt tốc độ tương đối theo phần trăm.

Thông số Loại Mô tả
fanSpeedRelativePercent Number

Bắt buộc.

Giá trị này biểu thị phần trăm tốc độ cần thay đổi.

Ví dụ

Giảm tốc độ quạt một chút.

{
  "command": "action.devices.commands.SetFanSpeedRelative",
  "params": {
    "fanSpeedRelativeWeight": -1
  }
}

Tăng tốc độ quạt thêm 10%.

{
  "command": "action.devices.commands.SetFanSpeedRelative",
  "params": {
    "fanSpeedRelativePercent": 10
  }
}

action.devices.commands.Reverse

Đảo ngược hướng quạt.

Lệnh này yêu cầu các thuộc tính sau: 
{
  "reversible": true
}

Thông số

Thông số Loại Mô tả

Không có thuộc tính nào

Ví dụ

Đảo ngược hướng quạt.

{
  "command": "action.devices.commands.Reverse",
  "params": {}
}

Cách phát âm mẫu

de-DE

  • stell die Geschwindigkeit vom Ventilator auf hoch

en-US

  • drop the AC fan speed to medium

es-ES

  • cambia la velocidad del ventilador a medio

fr-FR

  • mets la ventilation au maximum

hi-IN

  • बेडरूम में पंखे की गति मीडियम करें

it-IT

  • metti il condizionatore in salotto a velocità media

ja-JP

  • エアコン の風量を 高速 にセット

ko-KR

  • 선풍기 강풍 으로 틀어 줘

nl-NL

  • zet de snelheid van de ventilator op medium

pt-BR

  • definir a velocidade do ventilador para baixa
  • põe a ventoinha no máximo

sv-SE

  • Ställ in fläkten på medel

Thiết bị ERRORS

Xem toàn bộ danh sách lỗi và ngoại lệ.
  • maxSpeedReached: Tốc độ tối đa trên thiết bị đã được đặt.
  • minSpeedReached: Tốc độ tối thiểu trên thiết bị đã được đặt.