Smart Home ArmDisarm Trait Schema

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

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

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

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

מאפיינים סוג תיאור
availableArmLevels אובייקט

מתאר את רמות האבטחה הנתמכות של המכשיר. אם המאפיין הזה לא מדווח, המכשיר תומך רק ברמה אחת.

levels מערך

חובה.

רשימה של רמות האבטחה הזמינות שהמכשיר תומך בהן.

[item, ...] אובייקט

רמת אבטחה.

level_name String

חובה.

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

level_values מערך

חובה.

כולל את level_synonym ואת lang.

[item, ...] אובייקט

מילה נרדפת לרמה בשפה מסוימת. כדי לספק חלופה לשפה, צריך לפחות פריט אחד עם ערך lang של en.

level_synonym מערך

חובה.

שמות ידידותיים למשתמש לרמה בכל שפה נתמכת. הפריט הראשון נחשב לשם הקנוני.

[item, ...] String

שם המילה הנרדפת. כדי לספק חלופה לשפה, צריך לפחות פריט אחד עם ערך lang של en.

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

חובה.

חובה אם מציינים את המאפיין availableArmLevels. אם קיימות כמה רמות אבטחה, מוצג השם של רמת האבטחה הנוכחית.

exitAllowance Integer

מציין את הזמן, בשניות, שנותר למשתמש עד שההגדרה currentArmLevel תיכנס לתוקף.

דוגמאות

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

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

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

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

action.devices.commands.ArmDisarm

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

פרמטרים

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

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

פרמטרים סוג תיאור
followUpToken String

אסימון ש-Google מספקת לתשובה להמשך הטיפול.

arm Boolean

חובה.

הערך הוא True אם הפקודה היא הפעלה. False כדי להשבית את האזעקה.

cancel Boolean

חובה.

הערך True אם הפקודה היא ביטול של הערך arm.

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

פרמטרים סוג תיאור
followUpToken String

אסימון ש-Google מספקת לתשובה להמשך הטיפול.

arm Boolean

חובה.

הערך הוא 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

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

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