Giản đồ Trait Smart Home FanSpeed
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.
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 quá trình SYNC
. Để tìm hiểu thêm về cách xử lý ý định SYNC
, vui lòng xem phần Thực hiện ý định.
Thuộc tính | Loại | Nội dung mô tả |
---|---|---|
reversible |
Boolean |
(Mặc định: Nếu bạn đặt chính sách này thành true (đúng), 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: 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 cho trait này. |
Chứa bất kỳ mục nào sau đây: | ||
0
|
Đối tượng |
Hỗ trợ chế độ cài đặt tốc độ. |
availableFanSpeeds |
Đối tượng |
Bắt buộc. Chế độ cài đặt tốc độ mà thiết bị hỗ trợ. |
speeds |
Mảng |
Bắt buộc. Danh sách chế độ cài đặt tốc độ. |
[item, ...] |
Đối tượng |
Chế độ cài đặt tốc độ. |
speed_name |
Chuỗi |
Bắt buộc. Tên nội bộ của chế độ cài đặt tốc độ. Nội dung này có thể không thân thiện với người dùng và sẽ được chia sẻ 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ữ cụ thể. |
speed_synonym |
Mảng |
Bắt buộc. Từ đồng nghĩa với 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, ...] |
Chuỗi |
Từ đồng nghĩa. |
lang |
Chuỗi |
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 đúng, thì ngữ pháp bổ sung cho logic tăng hoặc giảm sẽ á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: Nếu bạn đặt chính sách này thành true (đúng), 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ó hai chế độ cài đặt tốc độ, hỗ trợ điều chỉnh hướng đảo ngược 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 của 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 trong thao tác QUERY
. Để tìm hiểu thêm về cách xử lý ý định QUERY
, vui lòng xem phần Thực hiện ý định.
Tiểu bang | Loại | Mô tả |
---|---|---|
currentFanSpeedSetting |
Chuỗi |
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 |
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 |
Ví dụ
Quạt trong phòng khách chạy với tốc độ bao nhiêu?
{ "currentFanSpeedSetting": "speed_low", "currentFanSpeedPercent": 10 }
Lệnh trên thiết bị
Các thiết bị có trait này có thể phản hồi các lệnh sau đây trong quá trình thao tác EXECUTE
. Để tìm hiểu thêm về cách xử lý ý định EXECUTE
, vui lòng xem phần Thực hiện ý định.
action.devices.commands.SetFanSpeed
Đặt tốc độ.
Thông số
Gói dữ liệu có một trong các nội dung sau:
Đặt tốc độ theo chế độ cài đặt.
Thông số | Loại | Mô tả |
---|---|---|
fanSpeed |
Chuỗi |
Bắt buộc. Chế độ cài đặt tốc độ quạt mà bạn yêu cầu. |
Đặt tốc độ theo phần trăm.
Thông số | Loại | Nội dung mô tả |
---|---|---|
fanSpeedPercent |
Number |
Bắt buộc. Phần trăm cài đặt tốc độ 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ố
Gói dữ liệu có một trong các nội dung sau:
Đặt tốc độ tương đối theo trọng lượng.
Thông số | Loại | Nội dung 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ố lượng được tính tỷ lệ trong khi ký hiệu số cho biết hướng thay đổi. |
Đặt tốc độ tương đối theo phần trăm.
Thông số | Loại | Nội dung mô tả |
---|---|---|
fanSpeedRelativePercent |
Number |
Bắt buộc. Giá trị này biểu thị phần trăm tốc độ 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 phần trăm.
{ "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 | Nội dung 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 danh sách đầy đủ lỗi và trường hợp ngoại lệ.maxSpeedReached
: Thiết bị đã được đặt ở tốc độ tối đa.minSpeedReached
: Thiết bị đã được đặt ở tốc độ tối thiểu.