Skema Atribut SmartLock LockLock

action.devices.traits.LockUnlock - Ciri ini termasuk perangkat yang mendukung penguncian dan pembukaan kunci, dan/atau melaporkan status terkunci.

ATRIBUT Perangkat

Tidak ada.

STATUS Perangkat

Entitas dengan karakteristik ini dapat melaporkan status berikut sebagai bagian dari operasi QUERY. Untuk mempelajari penanganan intent QUERY lebih lanjut, lihat fulfillment intent.

Negara bagian	Jenis	Deskripsi
isLocked	Boolean	Apakah perangkat terkunci saat ini.
isJammed	Boolean	Apakah perangkat sedang macet dan oleh karena itu statusnya terkunci tidak dapat ditentukan.

Contoh

Perangkat yang terkunci

{
  "isLocked": true
}

Perangkat yang macet

{
  "isJammed": true
}

COMMAND Perangkat

Perangkat dengan karakteristik ini dapat merespons perintah berikut sebagai bagian dari operasi EXECUTE. Untuk mempelajari penanganan intent EXECUTE lebih lanjut, lihat fulfillment intent.

action.devices.commands.LockUnlock

Kunci atau buka kunci perangkat.

Parameter

Parameter	Jenis	Deskripsi
lock	Boolean	Wajib. True jika perintah ditujukan untuk mengunci dan false untuk membuka kunci.
followUpToken	String	Token yang disediakan Google untuk respons tindak lanjut.

Contoh

Kunci pintu depan.

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

Buka kunci pintu depan.

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

Error terkait

Terjadi error saat mengunci atau membuka kunci perangkat.

Nilai yang didukung:

remoteSetDisabled

deviceJammingDetected

notSupported

alreadyLocked

alreadyUnlocked

Respons tindak lanjut

Perangkat dengan karakteristik ini dapat menampilkan payload respons tindak lanjut berikut sebagai bagian dari operasi EXECUTE. Untuk mempelajari cara menerapkan respons tindak lanjut lebih lanjut, lihat Notifikasi untuk Action smart home.

Payload berisi salah satu dari hal berikut:

Berhasil: Terkunci

Kolom	Jenis	Deskripsi
followUpToken	String	Wajib. Token disediakan dalam permintaan EXECUTE asli.
status	String	Wajib. Hasil permintaan. Nilai yang didukung: SUCCESS
isLocked	Boolean	Wajib. Menunjukkan apakah perangkat dikunci.

Kegagalan

Kolom	Jenis	Deskripsi
followUpToken	String	Wajib. Token disediakan dalam permintaan EXECUTE asli.
status	String	Wajib. Hasil permintaan. Nilai yang didukung: FAILURE
errorCode	String	Wajib. Nilainya dapat berupa kode error untuk sifat ini, misalnya, deviceJammingDetected.

Contoh

Kunci pintu depan. (tindak lanjut untuk kasus yang berhasil)

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

Buka kunci pintu depan. (tindak lanjut untuk kasus yang berhasil)

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

Kunci pintu depan. (tindak lanjut untuk kasus kegagalan)

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

Contoh ucapan

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

Perangkat ERRORS

Lihat daftar lengkap error dan pengecualian.