‫Smart Home FanSpeed Trait Schema

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

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

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

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

מאפיינים סוג תיאור
reversible בוליאני

(ברירת מחדל: false)

אם היא מוגדרת כ-true, המכשיר הזה תומך בהפעלת המאוורר בשני הכיוונים ויכול לקבל את הפקודה להפוך את כיוון המאוורר.
commandOnlyFanSpeed בוליאני

(ברירת מחדל: 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 בוליאני

חובה.

אם המדיניות מוגדרת כ-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 Number

מציין את מהירות המאוורר הנוכחית באחוזים. חובה אם המאפיין supportsFanSpeedPercent מוגדר עם הערך true

הערך צריך להיות בין 0 ל-100.

דוגמאות

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

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

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

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

action.devices.commands.SetFanSpeed

מגדירים את המהירות.

פרמטרים

המטען הייעודי (payload) מכיל את אחד מהערכים הבאים:

הגדרת המהירות דרך ההגדרות.

פרמטרים סוג תיאור
fanSpeed String

חובה.

הגדרות המהירות המבוקשות של המאוורר.

הגדרת המהירות באחוזים.

פרמטרים סוג תיאור
fanSpeedPercent Number

חובה.

אחוז הגדרת המהירות המבוקשת.

הערך צריך להיות בין 0 ל-100.

דוגמאות

‫Set the fan to high (הגדרת המאוורר לרמה גבוהה).

{
  "command": "action.devices.commands.SetFanSpeed",
  "params": {
    "fanSpeed": "speed_high"
  }
}

תגדיר את המאוורר ל-50%.

{
  "command": "action.devices.commands.SetFanSpeed",
  "params": {
    "fanSpeedPercent": 50
  }
}

action.devices.commands.SetFanSpeedRelative

מגדירים מהירות יחסית.

הפקודה הזו דורשת את המאפיינים הבאים: 
{
  "commandOnlyFanSpeed": true
}

פרמטרים

המטען הייעודי (payload) מכיל את אחד מהערכים הבאים:

הגדרת מהירות יחסית לפי משקל.

פרמטרים סוג תיאור
fanSpeedRelativeWeight Integer

חובה.

הערך הזה מציין את השינוי היחסי במהירות. הערך המוחלט מציין את הסכום המותאם, והסימן המספרי מציין את כיוון השינוי.

הערך צריך להיות בין -5 ל-5.

הגדרת מהירות יחסית באחוזים.

פרמטרים סוג תיאור
fanSpeedRelativePercent Number

חובה.

הערך הזה מייצג את אחוז השינוי במהירות.

הערך צריך להיות בין -100 ל-100.

דוגמאות

הנמכת מהירות המאוורר.

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