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 בוליאני

חובה.

אם הערך מוגדר כ-true, חלים כללי דקדוק נוספים ללוגיקה של הגדלה או הקטנה, לפי הסדר של מערך הרמות. לדוגמה, אם אומרים "Ok Google, תגדיל את רמת האבטחה שלי ב-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 בוליאני

חובה.

הגדרה שמציינת אם המכשיר מוכן כרגע.
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

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

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