Smart Home LockUnlock Trait Schema

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

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

ללא.

מצבי המכשיר

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

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

דוגמאות

מכשיר נעול

{
  "isLocked": true
}

המכשיר שנתקע

{
  "isJammed": true
}

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

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

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

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

הצלחה: נעול

שדות	סוג	תיאור
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

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

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