סכימת מאפיינים של מאוורר בבית חכם

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

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

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

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

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