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

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

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

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

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

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

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

אחת ההבדלים בין סצנות לבין יעדים פיזיים היא ש-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
  }
}

ERRORS במכשיר

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