Chào mừng bạn đến với Trung tâm nhà phát triển Google Home, điểm đến mới để tìm hiểu cách phát triển các hành động nhà thông minh. Lưu ý: Bạn sẽ tiếp tục xây dựng các hành động trong bảng điều khiển Actions.

Giản đồ khóa tính năng mở khóa 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á.

ATTRIBUTES thiết bị

Không có.

Thiết bị STATES

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 toán tử 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 Nội dung mô tả
isLocked Boolean

Xem thiết bị hiện có bị khóa hay không.

isJammed Boolean

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

Ví dụ

Thiết bị đã khóa

{
  "isLocked": true
}

Thiết bị bị kẹt

{
  "isJammed": true
}

Thiết bị COMMANDS

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

Khóa hoặc mở khóa thiết bị.

Thông số

Thông số Loại Nội dung mô tả
lock Boolean

Bắt buộc.

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

followUpToken Chuỗi

Mã thông báo do Google cung cấp để phản hồi theo dõi.

Ví dụ

Khóa cửa trước.

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

Mở khóa cửa trước.

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

Đã xảy ra lỗi khi khóa hoặc mở khóa 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 hoạt động EXECUTE. Để tìm hiểu thêm về cách triển khai các phản hồi tiếp theo, hãy xem bài viết Thông báo về tính năng Hành động dành cho nhà thông minh.

Trọng tải chứa một trong những mục sau:

Thành công: Đã khóa

Các trường Loại Mô tả
followUpToken Chuỗi

Bắt buộc.

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

status Chuỗi

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ị khóa hay không.

Lỗi

Các trường Loại Mô tả
followUpToken Chuỗi

Bắt buộc.

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

status Chuỗi

Bắt buộc.

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

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

FAILURE
errorCode Chuỗi

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ụ

Khóa 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ở khóa 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"
    }
  }
}

Khóa 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"
    }
  }
}

Lời nói 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 đủ các lỗi và ngoại lệ.