Giản đồ đặ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ợ tính năng khoá và mở khoá, và/hoặc báo cáo trạng thái khoá.

ATTRIBUTE của 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

Liệu thiết bị có đang ở trạng thái khoá hay không.
isJammed Boolean

Liệu thiết bị có bị kẹt hay không và do đó không xác định được trạng thái khoá của thiết bị.

Ví dụ

Thiết bị đang khoá

{
  "isLocked": true
}

Thiết bị bị kẹt

{
  "isJammed": true
}

lệnh của 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 phần 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.

True khi lệnh là để khoá, false để mở khoá.
followUpToken String

Mã thông báo do Google cung cấp để 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

Nội dung 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 phản hồi tiếp theo sau đây trong thao tác EXECUTE. Để tìm hiểu thêm về cách triển khai phản hồi tiếp theo, hãy xem bài viết Thông báo cho Hành động nhà thông minh.

Trọng tải 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ị này 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. (phản hồ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. (phản hồ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. (phản hồi tiếp theo cho trường hợp không thành công)

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

Câu lệnh mẫu

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

Thiết bị ERRORS

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