Lược đồ đặc điểm khoá/mở khoá nhà thông minh

action.devices.traits.LockUnlock – Đặc điểm này thuộc về mọi thiết bị hỗ trợ khoá và mở khoá, và/hoặc báo cáo trạng thái khoá.

THUỘC TÍNH thiết bị

Không có.

TRẠNG THÁI thiết bị

Các thực thể có đặc điểm này có thể báo cáo các trạng thái sau đây trong thao tác QUERY. Để tìm hiểu thêm về cách xử lý ý định QUERY, hãy xem bài viết Thực hiện ý định.

Tiểu bang Loại Mô tả
isLocked Boolean

Thiết bị hiện có bị khoá hay không.
isJammed Boolean

Thiết bị hiện có bị kẹt hay không và do đó không xác định được trạng thái khoá.

Ví dụ

Thiết bị bị khoá

{
  "isLocked": true
}

Thiết bị bị kẹt

{
  "isJammed": true
}

LỆNH thiết bị

Các thiết bị có đặc điểm này có thể phản hồi các lệnh sau đây trong thao tác EXECUTE. Để tìm hiểu thêm về cách xử lý ý định EXECUTE, hãy xem bài viết Thực hiện ý định.

action.devices.commands.LockUnlock

Khoá hoặc mở khoá thiết bị.

Thông số

Thông số Loại Mô tả
lock Boolean

Bắt buộc.

Đúng khi lệnh là khoá, sai khi lệnh là mở khoá.
followUpToken String

Mã thông báo do Google cung cấp cho câu trả lời tiếp theo.

Ví dụ

Khoá cửa trước.

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

Mở khoá cửa trước.

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

Đã xảy ra lỗi khi khoá hoặc mở khoá thiết bị.

Các giá trị được hỗ trợ:

remoteSetDisabled
deviceJammingDetected
notSupported
alreadyLocked
alreadyUnlocked

Câu trả lời tiếp theo

Các thiết bị có đặc điểm này có thể trả về tải trọng câu trả lời tiếp theo sau đây trong thao tác EXECUTE. Để tìm hiểu thêm về cách triển khai câu trả lời tiếp theo, hãy xem bài viết Thông báo cho các Hành động dành cho nhà thông minh.

Tải trọng chứa một trong những nội dung sau:

Thành công: Đã khoá

Trường Loại Mô tả
followUpToken String

Bắt buộc.

Mã thông báo được cung cấp trong yêu cầu EXECUTE ban đầu.
status String

Bắt buộc.

Kết quả của yêu cầu.

Các giá trị được hỗ trợ:

SUCCESS
isLocked Boolean

Bắt buộc.

Cho biết thiết bị có bị khoá hay không.

Lỗi

Trường Loại Mô tả
followUpToken String

Bắt buộc.

Mã thông báo được cung cấp trong yêu cầu EXECUTE ban đầu.
status String

Bắt buộc.

Kết quả của yêu cầu.

Các giá trị được hỗ trợ:

FAILURE
errorCode String

Bắt buộc.

Giá trị có thể là bất kỳ mã lỗi nào cho đặc điểm này, ví dụ: deviceJammingDetected.

Ví dụ

Khoá cửa trước. (câu trả lời tiếp theo cho trường hợp thành công)

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

Mở khoá cửa trước. (câu trả lời tiếp theo cho trường hợp thành công)

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

Khoá cửa trước. (câu trả lời tiếp theo cho trường hợp lỗi)

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

Mẫu câu lệnh

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

LỖI thiết bị

Xem danh sách đầy đủ các lỗi và ngoại lệ.