סכימה של תכונות הסיבוב של הבית החכם
action.devices.traits.Rotation
– התכונה הזו שייכת למכשירים שתומכים בסבב.
אפשר לציין את הסיבוב באחוז או במעלות, ואם המכשיר תומך בסבב במעלה, כיוון הסיבוב של ברירת המחדל הוא בכיוון השעון.
ATTRIBUTES במכשיר
מכשירים עם התכונה הזו עשויים לדווח על המאפיינים הבאים כחלק מהפעולה של SYNC
. מידע נוסף על טיפול ב-SYNC
כוונות זמין בקטע מימוש כוונה.
מאפיינים | Type | תיאור |
---|---|---|
supportsDegrees |
בוליאני |
חובה. הערך של הפרמטר הזה צריך להיות true אם המכשיר מאפשר סיבוב לפי מעלה. |
supportsPercent |
בוליאני |
חובה. הערך של הפרמטר הזה צריך להיות true אם המכשיר מאפשר סיבוב באחוזים |
rotationDegreesRange |
אובייקט |
ייצוג הטווח במעלות שמכשיר יכול לסובב. |
rotationDegreesMin |
מספר |
חובה. סיבוב מינימלי במעלות. |
rotationDegreesMax |
מספר |
חובה. סיבוב מקסימלי במעלות. |
supportsContinuousRotation |
בוליאני |
(ברירת מחדל: הערך של הפרמטר הזה צריך להיות true אם המכשיר מאפשר סיבוב רציף. אם תתקבל שאילתה יחסית, הפקודה |
commandOnlyRotation |
בוליאני |
(ברירת מחדל: מציין אם המכשיר תומך בתקשורת חד-כיוונית (אמיתי) או דו-כיווני (לא נכון). מגדירים את המאפיין הזה כ-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 |
מספר |
הרמה הנוכחית ב- |
rotationPercent |
מספר |
הרמה הנוכחית שמציינת באחוזים את האחוז שבו המכשיר מסובב כרגע. 0.0 מתאים לסגירה ו-100.0 לפתיחה. |
דוגמאות
באיזה סיבוב נעשה המכשיר? (אחוז ומעלות).
{ "rotationDegrees": 45, "rotationPercent": 25 }
באיזה סיבוב נעשה המכשיר? (מעלות בלבד).
{ "rotationDegrees": 45 }
באיזה סיבוב נעשה המכשיר? (רציף).
{ "rotationDegrees": 270, "rotationPercent": 75 }
פקודות מכשיר
מכשירים עם התכונה הזו עשויים להגיב לפקודות הבאות, במסגרת הפעולה EXECUTE
. מידע נוסף על טיפול ב-EXECUTE
כוונות זמין בקטע מימוש כוונה.
action.devices.commands.RotateAbsolute
הגדרת הסיבוב המוחלט של המכשיר.
פרמטרים
המטען הייעודי כולל אחד מהבאים:
הגדרת הסבב המוחלט במעלות.
פרמטרים | Type | תיאור |
---|---|---|
rotationDegrees |
מספר |
חובה. ערך מוחלט במעלות, שמציין את הסיבוב האחרון של המכשיר בכיוון השעון. הערך חייב להיות בתוך מאפיין |
הגדרת הסבב המוחלט באחוזים.
פרמטרים | 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