סכימה של התכונות המיוחדות לבית החכם

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

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

ATTRIBUTES במכשיר

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

מאפיינים	Type	תיאור
availableArmLevels	אובייקט	מתאר את רמות האבטחה הנתמכות במכשיר. אם המאפיין הזה לא מדווח, המכשיר תומך ברמה אחת בלבד.
levels	מערך	חובה. רשימה של רמות האבטחה הזמינות הנתמכות במכשיר.
[item, ...]	אובייקט	רמת אבטחה.
level_name	String	חובה. השם הפנימי של רמת האבטחה בפקודות ובמצבים. יכול להיות שהשם הזה לא ידידותי למשתמשים והוא משותף לכל השפות.
level_values	מערך	חובה. מכיל את level_synonym ואת lang.
[item, ...]	אובייקט	מילה נרדפת לרמה מסוימת בשפה נתונה.
level_synonym	מערך	חובה. שמות ידידותיים למשתמש עבור הרמה בכל שפה נתמכת. הפריט הראשון נחשב לשם הקנוני.
[item, ...]	String	שם מילה נרדפת.
lang	String	חובה. קוד שפה של מילים נרדפות ברמה. שפות נתמכות
ordered	בוליאני	חובה. אם המדיניות מוגדרת כ-True, יחול דקדוק נוסף של לוגיקת הגדלה/הקטנה, לפי הסדר של מערך הרמות. לדוגמה, "Ok Google, הגדלה של רמת האבטחה שלי ב-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 כוונות זמין בקטע מימוש כוונה.

מדינות	Type	תיאור
isArmed	בוליאני	חובה. מציינת אם המכשיר חמוש כרגע.
currentArmLevel	String	חובה. חובה אם צוין המאפיין availableArmLevels. אם קיימות רמות אבטחה מרובות, מציין את השם של רמת האבטחה הנוכחית.
exitAllowance	Integer	מציין את השעה, בשניות, המשתמש צריך לצאת לפני ש-currentArmLevel נכנס לתוקף.

דוגמאות

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

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

פקודות מכשיר

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

action.devices.commands.ArmDisarm

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

פרמטרים

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

ביטול הפעולה של הזרוע או הנשקייה

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

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

פרמטרים	Type	תיאור
followUpToken	String	אסימון שסופק על ידי Google לתגובת המשך.
arm	בוליאני	חובה. הערך הוא True כשהפקודה היא כדי לזרוע. לא נכון.
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

ERRORS מכשיר

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