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

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 מכשיר

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