Lược đồ đặc điểm FanSpeed (Tốc độ quạt) của nhà thông minh

action.devices.traits.FanSpeed – Đặc điểm này thuộc về các thiết bị hỗ trợ việc đặ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 khác nhau, có thể là một phần của thiết bị điều hoà không khí hoặc sưởi ấm, 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 theo tỷ lệ phần trăm.

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 hoạt động SYNC. Để tìm hiểu thêm về cách xử lý ý định SYNC, hãy xem bài viết Thực hiện ý định.

Thuộc tính Loại Mô tả
reversible Boolean

(Mặc định: false)

Nếu bạn đặt thành true, 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 liệu thiết bị có hỗ trợ sử dụng 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 Báo cáo trạng thái cho đặc điểm này.
Chứa bất kỳ mục nào sau đây:
0 Object

Hỗ trợ chế độ cài đặt tốc độ.
availableFanSpeeds Object

Bắt buộc.

Chế độ cài đặt tốc độ được thiết bị hỗ trợ.
speeds Array

Bắt buộc.

Danh sách chế độ cài đặt tốc độ.
[item, ...] Object

Chế độ 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 độ. Tên này có thể không thân thiện với người dùng và sẽ được chia sẻ trên tất cả các ngôn ngữ.
speed_values Array

Bắt buộc.

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

Từ đồng nghĩa cho chế độ cài đặt tốc độ trong một ngôn ngữ nhất định. Bạn phải có ít nhất một mục có giá trị lang là en để cung cấp phương án dự phòng ngôn ngữ.
speed_synonym Array

Bắt buộc.

Từ đồng nghĩa cho chế độ cài đặt tốc độ, nên 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 chính tắc của chế độ cài đặt tốc độ.
[item, ...] String

Từ đồng nghĩa. Bạn phải có ít nhất một mục có giá trị lang là en để cung cấp phương án dự phòng ngôn ngữ.
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 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 dần) của mảng tốc độ.
1 Object

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 thành true, thiết bị này sẽ chấp nhận các lệnh điều chỉnh tốc độ bằng cách sử dụng tỷ lệ phần trăm từ 0,0 đến 100,0.

Ví dụ

Thiết bị có 2 chế độ cài đặt tốc độ, hỗ trợ đảo ngược hướng 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
}

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 bài viết Thực hiện ý định.

Tiểu bang Loại Mô tả
currentFanSpeedSetting String

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

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

Giá trị phải nằm trong khoảng từ 0 đến 100.

Ví dụ

Quạt trong phòng khách đang chạy ở tốc độ nào?

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

LỆNH 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 bài viết Thực hiện ý định.

action.devices.commands.SetFanSpeed

Đặt tốc độ.

Thông số

Tải trọng chứa một trong những nội dung sau:

Đặ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 độ được yêu cầu của quạt.

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

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

Bắt buộc.

Tỷ lệ phần trăm chế độ cài đặt tốc độ được yêu cầu.

Giá trị phải nằm trong khoảng từ 0 đến 100.

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 những nội dung sau:

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

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

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 mức đã điều chỉnh theo tỷ lệ, trong khi dấu số cho biết hướng thay đổi.

Giá trị phải nằm trong khoảng từ -5 đến 5.

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

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

Bắt buộc.

Giá trị này đại diện cho tỷ lệ phần trăm tốc độ cần thay đổi.

Giá trị phải nằm trong khoảng từ -100 đến 100.

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âu nói 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

LỖI thiết bị

Xem danh sách đầy đủ các lỗi và trường hợp ngoại lệ.
  • maxSpeedReached: Thiết bị đã được đặt ở tốc độ cao nhất.
  • minSpeedReached: Thiết bị đã được đặt ở tốc độ thấp nhất.