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

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

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

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

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

מאפיינים	סוג	תיאור
reversible	בוליאני	(ברירת המחדל: false) אם המדיניות מוגדרת כ-True, המכשיר הזה תומך במאווררים בשני הכיוונים ויכול לקבל את הפקודה לשינוי כיוון המאוורר.
commandOnlyFanSpeed	בוליאני	(ברירת המחדל: false) מציינת אם המכשיר תומך בתקשורת חד-כיוונית (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	בוליאני	חובה. (ברירת המחדל: 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: מילוי Intent.

מדינות	סוג	תיאור
currentFanSpeedSetting	String	הוא מייצג את השם הפנימי של הגדרת המהירות הנוכחית מהמאפיין availableFanSpeeds.
currentFanSpeedPercent	מספר	מציין את מהירות המאוורר הנוכחית באחוזים. חובה אם המאפיין supportsFanSpeedPercent מוגדר כ-true

דוגמאות

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

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

CommandS במכשיר

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

action.devices.commands.SetFanSpeed

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

פרמטרים

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

קביעת המהירות לפי ההגדרות.

פרמטרים	סוג	תיאור
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
}

פרמטרים

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

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

פרמטרים	סוג	תיאור
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

ERRORS במכשיר

ראה את הרשימה המלאה של שגיאות וחריגים.

• maxSpeedReached: המכשיר כבר מוגדר למהירות המקסימלית.
• minSpeedReached: המכשיר כבר מוגדר למהירות המינימלית.