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

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

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

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

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

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

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

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

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

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

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

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

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

דוגמאות

מכשיר שתומך בסצנה מסתובבת.

{
  "sceneReversible": true
}

מכשיר STATES

ללא.

מכשיר COMMANDS

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

action.devices.commands.ActivateScene

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

פרמטרים

פרמטרים	סוג	תיאור
deactivate	בוליאני	חובה. יש לציין את הערך True כדי לבטל סצנה אם היא הפיך, ו-False כדי להפעיל סצנה.

דוגמאות

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

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

השבתת סצנה לפי השם שלה.

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

מכשיר ERRORS

מומלץ לעיין ברשימה המלאה של שגיאות וחריגים.