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

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

ATTRIBUTES במכשיר

ללא.

מצבים של המכשיר

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

מדינות Type תיאור
isLocked בוליאני

האם המכשיר נעול כרגע.

isJammed בוליאני

האם המכשיר תקוע ולכן לא ניתן לקבוע את מצב הנעילה שלו.

דוגמאות

מכשיר נעול

{
  "isLocked": true
}

המכשיר תקוע

{
  "isJammed": true
}

פקודות מכשיר

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

action.devices.commands.LockUnlock

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

פרמטרים

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

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

בוצעה בהצלחה: נעולה

שדות Type תיאור
followUpToken String

חובה.

האסימון סופק בבקשה המקורית להחרגה.

status String

חובה.

התוצאה של הבקשה.

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

SUCCESS
isLocked בוליאני

חובה.

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

כשל

שדות Type תיאור
followUpToken String

חובה.

האסימון סופק בבקשה המקורית להחרגה.

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 מכשיר

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