Smart Home ArmDisarm Trait Schema
action.devices.traits.ArmDisarm
– התכונה הזו תומכת בהפעלה ובהשבתה של אמצעי אבטחה, כמו אלה שמשמשים במערכות אבטחה.
במכשירים עם כמה רמות אבטחה, צריך לדווח על הרמות האלה באמצעות המאפיין availableArmLevels
.
מאפייני המכשיר
מכשירים עם המאפיין הזה עשויים לדווח על המאפיינים הבאים כחלק מהפעולה SYNC
. SYNC
מידע נוסף על טיפול בכוונות
מאפיינים | סוג | תיאור |
---|---|---|
availableArmLevels |
אובייקט |
מתאר את רמות האבטחה הנתמכות של המכשיר. אם המאפיין הזה לא מדווח, המכשיר תומך רק ברמה אחת. |
levels |
מערך |
חובה. רשימה של רמות האבטחה הזמינות שהמכשיר תומך בהן. |
[item, ...] |
אובייקט |
רמת אבטחה. |
level_name |
String |
חובה. השם הפנימי של רמת האבטחה שמשמשת בפקודות ובמצבים. השם הזה לא תמיד ידידותי למשתמשים, והוא משותף לכל השפות. |
level_values |
מערך |
חובה. כולל את |
[item, ...] |
אובייקט |
מילה נרדפת לרמה בשפה מסוימת. כדי לספק חלופה לשפה, צריך לפחות פריט אחד עם ערך |
level_synonym |
מערך |
חובה. שמות ידידותיים למשתמש לרמה בכל שפה נתמכת. הפריט הראשון נחשב לשם הקנוני. |
[item, ...] |
String |
שם המילה הנרדפת. כדי לספק חלופה לשפה, צריך לפחות פריט אחד עם ערך |
lang |
String |
חובה. קוד שפה למילים נרדפות של הרמה. כאן מפורטות השפות הנתמכות. |
ordered |
Boolean |
חובה. אם המאפיין מוגדר כ-True, חלים כללי דקדוק נוספים ללוגיקה של הגדלה או הקטנה, לפי הסדר של מערך הרמות. לדוגמה, אם אומרים "Ok Google, increase my security level by 1", Assistant קובעת את רמת האבטחה הנוכחית ואז מגדילה אותה ב-1. אם הערך הזה מוגדר כ-False, לא תהיה תמיכה בדקדוק נוסף ללוגיקה של הגדלה או הקטנה. |
דוגמאות
מערכת אבטחה עם שתי רמות דריכה שונות
{ "availableArmLevels": { "levels": [ { "level_name": "L1", "level_values": [ { "level_synonym": [ "Home and Guarding", "SL1" ], "lang": "en" }, { "level_synonym": [ "Zuhause und Bewachen", "SL1" ], "lang": "de" } ] }, { "level_name": "L2", "level_values": [ { "level_synonym": [ "Away and Guarding", "SL2" ], "lang": "en" }, { "level_synonym": [ "Weg und Bewachen", "SL2" ], "lang": "de" } ] } ], "ordered": true } }
מצבי המכשיר
יכול להיות שיירשמו לישויות עם המאפיין הזה המצבים הבאים כחלק מהפעולה QUERY
. QUERY
מידע נוסף על טיפול בכוונות
מדינות | סוג | תיאור |
---|---|---|
isArmed |
Boolean |
חובה. הגדרה שמציינת אם המכשיר מופעל כרגע. |
currentArmLevel |
String |
חובה. חובה אם מציינים את המאפיין |
exitAllowance |
Integer |
מציין את הזמן, בשניות, שנותר למשתמש עד שההגדרה |
דוגמאות
מערכת אבטחה שמדווחת על רמת דריכה נפרדת
{ "isArmed": true, "currentArmLevel": "L1" }
פקודות למכשיר
מכשירים עם המאפיין הזה עשויים להגיב לפקודות הבאות כחלק מהפעולה EXECUTE
. EXECUTE
מידע נוסף על טיפול בכוונות
action.devices.commands.ArmDisarm
מגדירים את רמת ההתראה של המכשיר.
פרמטרים
המטען הייעודי מכיל אחד מהערכים הבאים:
ביטול הפעולה של הפעלת האבטחה או השבתת האבטחה
פרמטרים | סוג | תיאור |
---|---|---|
followUpToken |
String |
אסימון ש-Google מספקת לתשובה להמשך הטיפול. |
arm |
Boolean |
חובה. הערך הוא True אם הפקודה היא הפעלה. False כדי להשבית את האזעקה. |
cancel |
Boolean |
חובה. הערך True אם הפקודה היא ביטול של הערך |
הפעלה או השבתה של המכשיר, עם רמת אבטחה אופציונלית.
פרמטרים | סוג | תיאור |
---|---|---|
followUpToken |
String |
אסימון ש-Google מספקת לתשובה להמשך הטיפול. |
arm |
Boolean |
חובה. הערך הוא True אם הפקודה היא הפעלה. False כדי להשבית את האזעקה. |
armLevel |
String |
ה- |
דוגמאות
הפעלת האזעקה
{ "command": "action.devices.commands.ArmDisarm", "params": { "arm": true, "followUpToken": "123" } }
הגדרת המערכת למצב הפעלה L1
{ "command": "action.devices.commands.ArmDisarm", "params": { "arm": true, "armLevel": "L1", "followUpToken": "456" } }
ביטול הפעלת האבטחה
{ "command": "action.devices.commands.ArmDisarm", "params": { "arm": true, "cancel": true } }
שגיאות קשורות
אירעה שגיאה בהפעלת האבטחה או בהשבתת האבטחה של המכשיר.
ערכים נתמכים:
alreadyInState
deviceTampered
passphraseIncorrect
pinIncorrect
securityRestriction
tooManyFailedAttempts
userCancelled