סכימת תכונות של מהירות מעריצים לבית חכם

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

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

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

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

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

מכשיר STATES

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

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

דוגמאות

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

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

COMMANDS של מכשיר

מכשירים עם התכונה הזו עשויים להגיב לפקודות הבאות כחלק מהפעולה 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

מכשיר ERRORS

כדאי לעיין ברשימה המלאה של שגיאות וחריגים.

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