הסכימה של מאפיין FanSpeed לבית חכם
action.devices.traits.FanSpeed
– המאפיין הזה שייך למכשירים שתומכים בהגדרת מהירות המאוורר.
מאפייני המכשיר
מכשירים עם התכונה הזו עשויים לדווח על המאפיינים
הבאים כחלק מהפעולה SYNC
. למידע נוסף על טיפול בכוונות מסוג SYNC
, ראו ביצוע כוונות.
מאפיינים | סוג | תיאור |
---|---|---|
reversible |
בוליאני |
(ברירת המחדל: אם ההגדרה הזו מוגדרת כ-true, המכשיר תומך בהפעלת המאוורר בשני הכיוונים ויכול לקבל את הפקודה להפוך את כיוון המאוורר. |
commandOnlyFanSpeed |
בוליאני |
(ברירת המחדל: השדה הזה מציין אם המכשיר תומך בתקשורת חד-כיוונית (true) או דו-כיוונית (false). יש להגדיר את המאפיין הזה כ-True אם המכשיר לא יכול להגיב ל-Intent QUERY או למצב הדיווח של התכונה הזו. |
מכיל את אחד מהפריטים הבאים: | ||
0
|
אובייקט |
תמיכה בהגדרות מהירות. |
availableFanSpeeds |
מפגע |
חובה. הגדרות המהירות שנתמכות במכשיר. |
speeds |
מערך |
חובה. רשימת הגדרות המהירות. |
[item, ...] |
אובייקט |
הגדרת המהירות. |
speed_name |
String |
חובה. שם פנימי של הגדרת המהירות. האפשרות הזו עשויה להיות לא ידידותית למשתמש, והיא תשותף בכל השפות. |
speed_values |
מערך |
חובה. מילים נרדפות להגדרת המהירות בכל השפות הנתמכות. |
[item, ...] |
אובייקט |
שם נרדף להגדרת המהירות בשפה נתונה. |
speed_synonym |
מערך |
חובה. מילים נרדפות להגדרת המהירות צריכות לכלול צורות יחיד ורבים, אם רלוונטי. הסינונימי הראשון ברשימה ייחשב לשם הקנוני של הגדרת המהירות. |
[item, ...] |
String |
מילה נרדפת. |
lang |
String |
חובה. קוד השפה (ISO 639-1). כאן מפורטות השפות הנתמכות. |
ordered |
בוליאני |
חובה. אם הערך מוגדר כ-true, תחול תחביר נוסף לצורך לוגיקה של עלייה או ירידה, לפי הסדר (הגדלה) של מערך המהירויות. |
1
|
מפגע |
תמיכה באחוז המהירות. |
supportsFanSpeedPercent |
בוליאני |
חובה. (ברירת המחדל: אם הערך מוגדר כ-true, המכשיר הזה יקבל פקודות לשינוי המהירות באמצעות אחוזים מ-0.0 עד 100.0. |
דוגמאות
מכשיר עם שתי הגדרות מהירות, תמיכה בכיוון הפוך ובהתאמות באחוזים.
{ "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 }
מצבי המכשיר
ישויות עם המאפיין הזה יכולות לדווח על המצבים הבאים כחלק מהפעולה QUERY
. למידע נוסף על טיפול בכוונות מסוג QUERY
, ראו ביצוע כוונות.
מדינות | סוג | תיאור |
---|---|---|
currentFanSpeedSetting |
String |
זהו השם הפנימי של הגדרת המהירות הנוכחית מהמאפיין |
currentFanSpeedPercent |
מספר |
מהירות המאוורר הנוכחית באחוזים. חובה אם המאפיין |
דוגמאות
מה המהירות של המאווררים בסלון?
{ "currentFanSpeedSetting": "speed_low", "currentFanSpeedPercent": 10 }
פקודות למכשיר
מכשירים עם התכונה הזו עשויים להגיב לפקודות הבאות כחלק מהפעולה EXECUTE
. למידע נוסף על טיפול באובייקטים של EXECUTE
, ראו מימוש של Intent.
action.devices.commands.SetFanSpeed
מגדירים את המהירות.
פרמטרים
המטען הייעודי מכיל אחד מהפריטים הבאים:
קביעת המהירות לפי ההגדרות.
פרמטרים | סוג | תיאור |
---|---|---|
fanSpeed |
String |
חובה. הגדרות המהירות המבוקשות של המאוורר. |
מגדירים את המהירות לפי אחוז.
פרמטרים | סוג | תיאור |
---|---|---|
fanSpeedPercent |
מספר |
חובה. אחוז ההגדרה המבוקשת של המהירות. |
דוגמאות
מגדירים את המאוורר לטמפרטורה גבוהה.
{ "command": "action.devices.commands.SetFanSpeed", "params": { "fanSpeed": "speed_high" } }
מגדירים את המאוורר ל-50%.
{ "command": "action.devices.commands.SetFanSpeed", "params": { "fanSpeedPercent": 50 } }
action.devices.commands.SetFanSpeedRelative
מגדירים מהירות יחסית.
כדי להשתמש בפקודה הזו, צריך את המאפיינים הבאים:{ "commandOnlyFanSpeed": true }
פרמטרים
המטען הייעודי מכיל אחד מהפריטים הבאים:
מגדירים את המהירות היחסית לפי משקל.
פרמטרים | סוג | תיאור |
---|---|---|
fanSpeedRelativeWeight |
Integer |
חובה. הערך הזה מציין את השינוי היחסי במהירות. הערך המוחלט מציין את הסכום המותאם, והסימן המספרי מציין את כיוון השינוי. |
מגדירים את המהירות היחסית לפי אחוזים.
פרמטרים | סוג | תיאור |
---|---|---|
fanSpeedRelativePercent |
מספר |
חובה. הערך הזה מייצג את אחוז השינוי במהירות. |
דוגמאות
מורידים מעט את מהירות המאוורר.
{ "command": "action.devices.commands.SetFanSpeedRelative", "params": { "fanSpeedRelativeWeight": -1 } }
הגברת מהירות המאוורר ב-10 אחוזים.
{ "command": "action.devices.commands.SetFanSpeedRelative", "params": { "fanSpeedRelativePercent": 10 } }
action.devices.commands.Reverse
היפוך כיוון המאוורר.
כדי להשתמש בפקודה הזו, צריך את המאפיינים הבאים:{ "reversible": true }
פרמטרים
פרמטרים | סוג | תיאור |
---|---|---|
אין נכסים |
דוגמאות
משנים את כיוון המאוורר.
{ "command": "action.devices.commands.Reverse", "params": {} }
ביטויים לדוגמה
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
שגיאות במכשיר
הרשימה המלאה של השגיאות והחריגותmaxSpeedReached
: המכשיר כבר מוגדר למהירות המקסימלית.minSpeedReached
: המכשיר כבר מוגדר למהירות המינימלית.