הסכימה של מאפיין 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

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

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