סכימת תכונות StartStop של בית חכם

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

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

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

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

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

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

דוגמאות

מכשיר שאפשר להשהות ושתומך בהפעלה בכמה אזורים.

{
  "pausable": true,
  "availableZones": [
    "Kitchen",
    "Living room",
    "Office",
    "Bedroom"
  ]
}

מצבי המכשיר

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

דוגמאות

האם המכשיר מושהה?

{
  "isRunning": false,
  "isPaused": true
}

האם המכשיר מושהה?

{
  "isRunning": true,
  "isPaused": false
}

האם המכשיר פועל?

{
  "isRunning": true,
  "isPaused": false,
  "activeZones": [
    "Kitchen",
    "Living room"
  ]
}

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

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

action.devices.commands.StartStop

הפעלה או עצירה של המכשיר.

פרמטרים

דוגמאות

מפעילים את המכשיר.

{
  "command": "action.devices.commands.StartStop",
  "params": {
    "start": true
  }
}

עוצרים את המכשיר.

{
  "command": "action.devices.commands.StartStop",
  "params": {
    "start": false
  }
}

מפעילים את המכשיר במשרד.

{
  "command": "action.devices.commands.StartStop",
  "params": {
    "start": true,
    "zone": "office"
  }
}

הפעל את המכשיר במטבח, בפינת האוכל ובסלון.

{
  "command": "action.devices.commands.StartStop",
  "params": {
    "start": true,
    "multipleZones": [
      "Kitchen",
      "Dining room",
      "Living room"
    ]
  }
}

action.devices.commands.PauseUnpause

להשהות או להמשיך את פעולת המכשיר.

{
  "pausable": true
}

פרמטרים

דוגמאות

להשהות את המכשיר.

{
  "command": "action.devices.commands.PauseUnpause",
  "params": {
    "pause": true
  }
}

שגיאות קשורות

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

ערכים נתמכים:

unpausableState

משפטים לדוגמה

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