סכימה של תכונות מנגנון ההתראה על בית חכם

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

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

פרמטרים

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

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

פרמטרים סוג תיאור
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

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

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