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

action.devices.traits.Rotation – התכונה הזו שייכת למכשירים שתומכים בסבב.

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

ATTRIBUTES במכשיר

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

מאפיינים Type תיאור
supportsDegrees בוליאני

חובה.

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

supportsPercent בוליאני

חובה.

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

rotationDegreesRange אובייקט

ייצוג הטווח במעלות שמכשיר יכול לסובב.

rotationDegreesMin מספר

חובה.

סיבוב מינימלי במעלות.

rotationDegreesMax מספר

חובה.

סיבוב מקסימלי במעלות.

supportsContinuousRotation בוליאני

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

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

commandOnlyRotation בוליאני

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

מציין אם המכשיר תומך בתקשורת חד-כיוונית (אמיתי) או דו-כיווני (לא נכון). מגדירים את המאפיין הזה כ-true אם המכשיר לא יכול להגיב לכוונת QUERY או למצב הדוח עבור התכונה הזו.

דוגמאות

מכשיר שתומך בסבב גם באחוזים וגם במעלות.

{
  "supportsDegrees": true,
  "supportsPercent": true,
  "rotationDegreesRange": {
    "rotationDegreesMin": 0,
    "rotationDegreesMax": 180
  }
}

מכשיר שתומך בסבב רק במעלות.

{
  "supportsDegrees": true,
  "supportsPercent": false,
  "rotationDegreesRange": {
    "rotationDegreesMin": 0,
    "rotationDegreesMax": 90
  }
}

מכשיר שתומך רק בפקודות סבב רציפות.

{
  "supportsDegrees": true,
  "supportsPercent": true,
  "rotationDegreesRange": {
    "rotationDegreesMin": 0,
    "rotationDegreesMax": 360
  },
  "supportsContinuousRotation": true,
  "commandOnlyRotation": true
}

מצבים של המכשיר

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

מדינות Type תיאור
rotationDegrees מספר

הרמה הנוכחית ב-rotationDegreesRange שמציינת בכמה מעלות מסובבים את המכשיר. הערך הזה צריך תמיד להיות יחסי לסיבוב בכיוון השעון.

rotationPercent מספר

הרמה הנוכחית שמציינת באחוזים את האחוז שבו המכשיר מסובב כרגע. 0.0 מתאים לסגירה ו-100.0 לפתיחה.

דוגמאות

באיזה סיבוב נעשה המכשיר? (אחוז ומעלות).

{
  "rotationDegrees": 45,
  "rotationPercent": 25
}

באיזה סיבוב נעשה המכשיר? (מעלות בלבד).

{
  "rotationDegrees": 45
}

באיזה סיבוב נעשה המכשיר? (רציף).

{
  "rotationDegrees": 270,
  "rotationPercent": 75
}

פקודות מכשיר

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

action.devices.commands.RotateAbsolute

הגדרת הסיבוב המוחלט של המכשיר.

פרמטרים

המטען הייעודי כולל אחד מהבאים:

הגדרת הסבב המוחלט במעלות.

פרמטרים Type תיאור
rotationDegrees מספר

חובה.

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

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

פרמטרים Type תיאור
rotationPercent מספר

חובה.

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

דוגמאות

הטיה של המכשיר ל-50 אחוזים.

{
  "command": "action.devices.commands.RotateAbsolute",
  "params": {
    "rotationPercent": 50
  }
}

סיבוב המכשיר ב-15 מעלות נגד כיוון השעון (rotationDegrees: 45).

{
  "command": "action.devices.commands.RotateAbsolute",
  "params": {
    "rotationDegrees": 30
  }
}

סיבוב של המכשיר ב-100 מעלות בכיוון השעון (supportsContinuousRotation: true, rotationDegrees: 270).

{
  "command": "action.devices.commands.RotateAbsolute",
  "params": {
    "rotationDegrees": 10
  }
}

אירעה שגיאה בהגדרת הסיבוב של המכשיר.

ערכים נתמכים:

deviceJammingDetected

ERRORS מכשיר

לצפייה ברשימה המלאה של השגיאות והחריגים