סכימת מאפיינים של דוח סטטוס של בית חכם
action.devices.traits.StatusReport – התכונה הזו מדווחת על הסטטוס הנוכחי של מכשיר ספציפי או של קבוצת מכשירים מחוברים.
מכשיר ספציפי יכול לדווח על הסטטוס הנוכחי שלו וגם על הסטטוס של מכשירים קשורים בקבוצה. לדוגמה, מכשיר היעד יכול להיות מערכת אבטחה, והמכשירים הקשורים יכולים להיות חיישנים נפרדים. הדוח StatusReport משמש כצבירה לדיווח על סטטוס קולקטיבי, אבל הוא לא מחליף פנייה פרטנית.
כל מכשיר שאפשר לגשת אליו באמצעות Google Assistant צריך להיות מדווח כמכשיר נפרד בתגובה SYNC.
מאפייני המכשיר
ללא.
מצבי המכשיר
יכול להיות שישויות עם המאפיין הזה ידווחו על המצבים הבאים כחלק מהפעולה QUERY. כדי לקבל מידע נוסף על טיפול בכוונות QUERY, אפשר לעיין במאמר השלמת כוונות.
| מדינות | סוג | תיאור |
|---|---|---|
currentStatusReport |
מערך |
חובה. סטטוס השגיאה או החריגה הנוכחיים של המכשיר וכל מזהי המכשירים שקשורים אליו. |
[item, ...] |
אובייקט |
הסטטוס הנוכחי. |
blocking |
בוליאני |
הערך הוא True אם השגיאה או הסטטוס הנוכחי חוסמים את ההרצה של פקודות נוספות. |
deviceTarget |
String |
המזהה של מכשיר היעד. |
priority |
Integer |
מציינת את העדיפות של הסטטוס הזה. ככל שהערך נמוך יותר, העדיפות גבוהה יותר. העדיפות הכי גבוהה היא 0. Google מדווחת על סטטוס השגיאה או החריגה מהעדיפות הכי גבוהה לעדיפות הכי נמוכה. בהתאם לממשק, יכול להיות ש-Google תדווח רק על שגיאות או חריגות בעדיפות גבוהה. ערך מינימלי: |
statusCode |
String |
הסטטוס הנוכחי של המכשיר. רשימה מלאה של שגיאות וחריגים |
דוגמאות
Is my security system ok?
{
"currentStatusReport": [
{
"blocking": false,
"deviceTarget": "alarm_1",
"priority": 0,
"statusCode": "lowBattery"
},
{
"blocking": false,
"deviceTarget": "front_window_1",
"priority": 1,
"statusCode": "deviceOpen"
},
{
"blocking": false,
"deviceTarget": "back_window_2",
"priority": 1,
"statusCode": "deviceOpen"
},
{
"blocking": true,
"deviceTarget": "alarm_2",
"priority": 0,
"statusCode": "needsSoftwareUpdate"
}
]
}פקודות למכשיר
ללא.