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á.

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 quá trình thực hiện thao tác QUERY. Để tìm hiểu thêm về cách xử lý ý định QUERY, hãy xem phần Thực hiện ý định.

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

Thiết bị hiện có đang 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 quá trình hoạt động 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.

Đú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 để 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 phản hồi tiếp theo sau đây trong quá trình 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 phần 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 liệu 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

  • Bitte Eingangstür abschließen
  • Bitte schließ die Eingangstür auf
  • lock my doors
  • unlock study room
  • cierra la puerta con llave
  • quitar el cerrojo de la puerta de entrad a
  • déverrouille la porte d'entrée
  • verrouille la porte d'entrée
  • फ़्रंट डोर अनलॉक करो
  • सामने के दरवाजे को लॉक करो
  • apri la porta d'ingresso
  • puoi chiudere la porta d'ingresso a chiave
  • 玄関のドア を施錠して
  • 玄関 開錠して
  • 도어락 잠가 줘
  • 현관 도어락 열어 줄래
  • Ontgrendel de voordeur
  • doe de voordeur op slot
  • Tranca a porta do quarto .
  • destranca a porta da cozinha
  • destrancar a porta da frente
  • trancar a porta da frente
  • lås upp ytterdörren
  • lås ytterdörren

LỖI thiết bị

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