הסכימה של מאפיין FanSpeed לבית חכם

action.devices.traits.FanSpeed – המאפיין הזה שייך למכשירים שתומכים בהגדרת מהירות המאוורר.

מהירויות של מאווררים (כלומר, יצירת אוויר מהמכשיר ברמות שונות, שעשויות להיות חלק ממיזוג אוויר או מיחידה לחימום, או ברכב) עשויות לכלול הגדרות כמו נמוכה, בינונית וגבוהה, או אחוז.

מאפייני המכשיר

מכשירים עם המאפיין הזה עשויים לדווח על המאפיינים הבאים כחלק מהפעולה SYNC. למידע נוסף על טיפול בכוונות מסוג SYNC, ראו ביצוע כוונות.

מאפיינים	סוג	תיאור
reversible	בוליאני	(ברירת המחדל: false) אם ההגדרה הזו מוגדרת כ-true, המכשיר תומך בהפעלת המאוורר בשני הכיוונים ויכול לקבל את הפקודה להפוך את כיוון המאוורר.
commandOnlyFanSpeed	בוליאני	(ברירת המחדל: false) השדה הזה מציין אם המכשיר תומך בתקשורת חד-כיוונית (true) או דו-כיוונית (false). מגדירים את המאפיין הזה כ-true אם המכשיר לא יכול להגיב לכוונה מסוג QUERY או לדיווח על המצב של המאפיין הזה.
מכיל את אחד מהפריטים הבאים:
0	אובייקט	תמיכה בהגדרות מהירות.
availableFanSpeeds	אובייקט	חובה. הגדרות המהירות שנתמכות במכשיר.
speeds	מערך	חובה. רשימת הגדרות המהירות.
[item, ...]	אובייקט	הגדרת המהירות.
speed_name	String	חובה. השם הפנימי של הגדרת המהירות. הפתרון הזה לא ידידותי למשתמש, והוא ישותף בכל השפות.
speed_values	מערך	חובה. מילים נרדפות להגדרת המהירות בכל השפות הנתמכות.
[item, ...]	אובייקט	שם נרדף להגדרת המהירות בשפה נתונה.
speed_synonym	מערך	חובה. מילים נרדפות להגדרת המהירות צריכות לכלול גם את הצורה היחידה וגם את הצורה הרבים, אם רלוונטי. המונח הנרדף הראשון ברשימה ייחשב לשם הקנוני של הגדרת המהירות.
[item, ...]	String	מילה נרדפת.
lang	String	חובה. קוד השפה (ISO 639-1). כאן מפורטות השפות הנתמכות.
ordered	בוליאני	חובה. אם הערך מוגדר כ-true, תחול תחביר נוסף לצורך לוגיקה של עלייה או ירידה, לפי הסדר (הגדלה) של מערך המהירויות.
1	אובייקט	תמיכה באחוז מהמהירות.
supportsFanSpeedPercent	בוליאני	חובה. (ברירת המחדל: false) אם הערך מוגדר כ-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	זהו השם הפנימי של הגדרת המהירות הנוכחית מהמאפיין availableFanSpeeds.
currentFanSpeedPercent	מספר	הערך הזה מציין את מהירות המאוורר הנוכחית באחוזים. חובה אם המאפיין supportsFanSpeedPercent מוגדר כ-true

דוגמאות

מה המהירות של המאווררים בסלון?

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

פקודות למכשיר

מכשירים עם המאפיין הזה עשויים להגיב לפקודות הבאות כחלק מהפעולה EXECUTE. למידע נוסף על טיפול בכוונות מסוג EXECUTE, ראו ביצוע כוונות.

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: המכשיר כבר מוגדר למהירות המינימלית.