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

action.devices.traits.LockUnlock – התכונה הזו שייכת לכל מכשיר שתומכים בנעילה ובביטול נעילה ו/או דיווח על מצב נעילה.

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

ללא.

מכשיר STATES

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

מדינות	סוג	תיאור
isLocked	בוליאני	האם המכשיר נעול כרגע.
isJammed	בוליאני	האם המכשיר תקוע כרגע ולכן לא ניתן לקבוע את מצב הנעילה שלו.

דוגמאות

המכשיר נעול

{
  "isLocked": true
}

מכשיר תקוע

{
  "isJammed": true
}

COMMANDS של מכשיר

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

action.devices.commands.LockUnlock

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

פרמטרים

פרמטרים	סוג	תיאור
lock	בוליאני	חובה. יש לציין True כשהפקודה היא לנעול, או FALSE כדי לבטל את הנעילה.
followUpToken	String	אסימון ש-Google סיפקה למענה בהמשך.

דוגמאות

נעילת הדלת הקדמית.

{
  "command": "action.devices.commands.LockUnlock",
  "params": {
    "lock": true,
    "followUpToken": "123"
  }
}

מבטלים את הנעילה של הדלת הקדמית.

{
  "command": "action.devices.commands.LockUnlock",
  "params": {
    "lock": false,
    "followUpToken": "567"
  }
}

שגיאות קשורות

אירעה שגיאה במהלך הנעילה או ביטול הנעילה של המכשיר.

ערכים נתמכים:

remoteSetDisabled

deviceJammingDetected

notSupported

alreadyLocked

alreadyUnlocked

תגובות המשך

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

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

הצלחה: ננעלה

שדות	סוג	תיאור
followUpToken	String	חובה. האסימון סופק בבקשת ה-EXECUTE המקורית.
status	String	חובה. תוצאת הבקשה. ערכים נתמכים: SUCCESS
isLocked	בוליאני	חובה. אינדיקטור שמציין אם המכשיר נעול.

כשל

שדות	סוג	תיאור
followUpToken	String	חובה. האסימון סופק בבקשת ה-EXECUTE המקורית.
status	String	חובה. תוצאת הבקשה. ערכים נתמכים: FAILURE
errorCode	String	חובה. הערך יכול להיות כל קוד שגיאה של התכונה הזו, לדוגמה deviceJammingDetected.

דוגמאות

נעילת הדלת הקדמית. (תגובת המשך למקרה הצלחה)

{
  "LockUnlock": {
    "priority": 0,
    "followUpResponse": {
      "status": "SUCCESS",
      "isLocked": true,
      "followUpToken": "1234"
    }
  }
}

מבטלים את נעילת הדלת הקדמית. (תגובת המשך למקרה הצלחה)

{
  "LockUnlock": {
    "priority": 0,
    "followUpResponse": {
      "status": "SUCCESS",
      "isLocked": false,
      "followUpToken": "1234"
    }
  }
}

נעילת הדלת הקדמית. (תגובת המשך במקרה של כשל)

{
  "LockUnlock": {
    "priority": 0,
    "followUpResponse": {
      "status": "FAILURE",
      "errorCode": "deviceJammingDetected",
      "followUpToken": "1234"
    }
  }
}

ביטויים לדוגמה

de-DE

• Bitte Eingangstür abschließen
• Bitte schließ die Eingangstür auf

en-US

• lock my doors
• unlock study room

es-ES

• cierra la puerta con llave
• quitar el cerrojo de la puerta de entrad a

fr-FR

• déverrouille la porte d'entrée
• verrouille la porte d'entrée

hi-IN

• फ़्रंट डोर अनलॉक करो
• सामने के दरवाजे को लॉक करो

it-IT

• apri la porta d'ingresso
• puoi chiudere la porta d'ingresso a chiave

ja-JP

• 玄関のドア を施錠して
• 玄関 開錠して

ko-KR

• 도어락 잠가 줘
• 현관 도어락 열어 줄래

nl-NL

• Ontgrendel de voordeur
• doe de voordeur op slot

pt-BR

• Tranca a porta do quarto .
• destranca a porta da cozinha
• destrancar a porta da frente
• trancar a porta da frente

sv-SE

• lås upp ytterdörren
• lås ytterdörren

מכשיר ERRORS

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