Skema Buka Kunci Smart Home

action.devices.traits.LockUnlock - Sifat ini dimiliki oleh perangkat apa pun yang mendukung penguncian dan pembukaan kunci, dan/atau pelaporan status terkunci.

ATTRIBUTES Perangkat

Tidak ada.

NEGARA Perangkat

Entitas dengan karakteristik ini dapat melaporkan hal berikut status sebagai bagian dari operasi QUERY. Untuk mempelajari selengkapnya tentang menangani intent QUERY, lihat Pemenuhan intent.

Negara bagian Jenis Deskripsi
isLocked Boolean

Apakah perangkat saat ini terkunci.
isJammed Boolean

Apakah perangkat saat ini macet sehingga status terkuncinya tidak dapat ditentukan.

Contoh

Perangkat yang terkunci

{
  "isLocked": true
}

Perangkat yang macet

{
  "isJammed": true
}

Perangkat COMMANDS

Perangkat dengan karakteristik ini dapat merespons hal berikut sebagai bagian dari operasi EXECUTE. Untuk mempelajari selengkapnya tentang menangani intent EXECUTE, lihat Pemenuhan intent.

action.devices.commands.LockUnlock

Kunci atau buka kunci perangkat.

Parameter

Parameter Jenis Deskripsi
lock Boolean

Wajib.

True jika perintah untuk mengunci, 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"
  }
}

Terjadi error saat mengunci atau membuka kunci perangkat.

Nilai yang didukung:

remoteSetDisabled
deviceJammingDetected
notSupported
alreadyLocked
alreadyUnlocked

Respons selanjutnya

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

Payload berisi salah satu hal berikut:

Berhasil: Dikunci

Kolom Jenis Deskripsi
followUpToken String

Wajib.

Token yang diberikan dalam permintaan EXECUTE asli.
status String

Wajib.

Hasil permintaan.

Nilai yang didukung:

SUCCESS
isLocked Boolean

Wajib.

Menunjukkan apakah perangkat terkunci.

Gagal

Kolom Jenis Deskripsi
followUpToken String

Wajib.

Token yang diberikan dalam permintaan EXECUTE asli.
status String

Wajib.

Hasil permintaan.

Nilai yang didukung:

FAILURE
errorCode String

Wajib.

Nilainya dapat berupa kode error untuk fitur ini, misalnya, deviceJammingDetected.

Contoh

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

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

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

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

Kunci pintu depan. (respons 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.