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

action.devices.traits.Scene – המאפיין הזה משמש להטמעת מכשירים וירטואליים יחד עם סוג המכשיר SCENE.

מידע נוסף זמין במדריך בנושא סוגים של סצנות.

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

  • מפעילים את מצב המסיבה.
  • הפעלת סצנת חצות.

כאובייקטים וירטואליים, אפשר למקם סצנות בחדרים (אם רלוונטי) כדי להבדיל בין שתי אפשרויות:

  • מתחילים את המסיבה במטבח.
  • מפעילים את מצב תאורת הלילה בחדרי השינה.

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

סצנות יתכתבו היטב עם הפעולות האישיות העתידיות לצורך דקדוק מותאם אישית (לדוגמה, הפעלת מצב מסיבה -> בואו נתחיל את המסיבה!).

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

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

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

מאפיינים סוג תיאור
sceneReversible בוליאני

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

סימן לכך שאפשר לבטל את הסצנה הזו. המאפיין הזה רלוונטי רק לסצנות שמשנות את המצב ומזכירות את המצב הקודם. המכשיר תומך בפקודה ActivateScene עם הפרמטר deactivate שמוגדר כ-true.

דוגמאות

מכשיר שתומך בסצנה שניתן להפוך אותה.

{
  "sceneReversible": true
}

מצבי המכשיר

ללא.

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

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

action.devices.commands.ActivateScene

הפעלה או השבתה של סצנה.

פרמטרים

פרמטרים סוג תיאור
deactivate בוליאני

חובה.

הערך True מבטא ביטול של סצנה אם אפשר לבטל אותה, והערך False מבטא הפעלה של סצנה.

דוגמאות

הפעלת סצנה לפי שם

{
  "command": "action.devices.commands.ActivateScene",
  "params": {
    "deactivate": false
  }
}

להשבית סביבת תאורה לפי שם.

{
  "command": "action.devices.commands.ActivateScene",
  "params": {
    "deactivate": true
  }
}

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

הרשימה המלאה של השגיאות והחריגות