הסכימה של מאפיין הסיבוב בבית חכם

action.devices.traits.Rotation – המאפיין הזה שייך למכשירים שתומכים בסיבוב.

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

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

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

דוגמאות

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

{
  "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, ראו ביצוע כוונות.

דוגמאות

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

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

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

{
  "rotationDegrees": 45
}

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

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

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

{
  "rotationPercent": 75,
  "targetRotationPercent": 100
}

פקודות למכשיר

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

action.devices.commands.RotateAbsolute

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

פרמטרים

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

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

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

דוגמאות

משעינים את המכשיר ב-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

שגיאות במכשיר