הסכימה של מאפיין ArmDisarm לבית חכם

action.devices.traits.ArmDisarm – המאפיין הזה תומך בהפעלה ובהשבתה, למשל במערכות אבטחה.

במכשירים עם כמה רמות אבטחה, צריך לדווח על הרמות האלה באמצעות המאפיין availableArmLevels.

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

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

מאפיינים	סוג	תיאור
availableArmLevels	אובייקט	תיאור רמות האבטחה הנתמכות במכשיר. אם המאפיין הזה לא מדווח, המכשיר תומך רק ברמה אחת.
levels	מערך	חובה. רשימה של רמות האבטחה הזמינות שנתמכות במכשיר.
[item, ...]	אובייקט	רמת אבטחה.
level_name	String	חובה. השם הפנימי של רמת האבטחה שמשמש בפקודות ובמצבים. השם הזה יכול להיות לא ידידותי למשתמש, והוא משותף בכל השפות.
level_values	מערך	חובה. מכיל את level_synonym ואת lang.
[item, ...]	אובייקט	שם חלופי של רמה בשפה נתונה.
level_synonym	מערך	חובה. שמות ידידותיים למשתמש לרמה בכל שפה נתמכת. הפריט הראשון נחשב לשם הקנוני.
[item, ...]	String	שם המילה הנרדפת.
lang	String	חובה. קוד השפה של שמות הסינונים של הרמה. כאן מפורטות השפות הנתמכות.
ordered	בוליאני	חובה. אם הערך מוגדר כ-true, תחול תחביר נוסף ללוגיקת ההגדלה/הקטנה, לפי הסדר של מערך הרמות. לדוגמה, אם אומרים "Ok Google, increase my security level by 1", Assistant קובעת את רמת האבטחה הנוכחית ומגדילה אותה ביחידה אחת. אם הערך הזה מוגדר כ-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	בוליאני	חובה. מציין אם המכשיר מוכן כרגע לפעולה.
currentArmLevel	String	חובה. חובה לציין את הערך הזה אם צוין המאפיין availableArmLevels. אם יש כמה רמות אבטחה, השם של רמת האבטחה הנוכחית.
exitAllowance	Integer	משך הזמן, בשניות, שהמשתמש צריך להישאר לפני ש-currentArmLevel ייכנס לתוקף.

דוגמאות

מערכת אבטחה שמדווחת על רמת דריכה ייחודית

{
  "isArmed": true,
  "currentArmLevel": "L1"
}

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

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

action.devices.commands.ArmDisarm

מגדירים את רמת ההתראה של המכשיר הזה.

פרמטרים

המטען הייעודי מכיל אחד מהפריטים הבאים:

ביטול הפעולה של הפעלה או השבתה

פרמטרים	סוג	תיאור
followUpToken	String	אסימון ש-Google מספקת לתשובה חוזרת.
arm	בוליאני	חובה. הערך True מופיע כשהפקודה היא להפעלת האזעקה. False כדי להשבית את האזעקה.
cancel	בוליאני	חובה. הערך True מוחזר כשהפקודה היא ביטול הערך של arm.

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

פרמטרים	סוג	תיאור
followUpToken	String	אסימון ש-Google מספקת לתשובה חוזרת.
arm	בוליאני	חובה. הערך True מופיע כשהפקודה היא להפעלה. False כדי להשבית את האזעקה.
armLevel	String	ה-level_name להפעלה.

דוגמאות

הפעלת המערכת

{
  "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

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

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