歡迎使用 Google Home 開發人員中心,探索全新功能,瞭解如何開發智慧住宅動作。注意:請繼續在「動作」控制台中建立動作。
透過集合功能整理內容 你可以依據偏好儲存及分類內容。

Smart Home LockLock 特性

action.devices.traits.LockUnlock - 這個屬性適用於任何支援鎖定和解鎖和/或回報鎖定狀態的裝置。

裝置屬性

無。

裝置狀態:STATE

具有此特性的實體可能會在 QUERY 作業中回報下列狀態。如要進一步瞭解如何處理 QUERY 意圖,請參閱意圖執行要求一文。

類型 說明
isLocked 布林

裝置目前是否處於鎖定狀態。

isJammed 布林

無法判斷裝置目前是否卡住,因此無法判斷鎖定狀態。

範例

裝置已鎖定

{
  "isLocked": true
}

卡住了的裝置

{
  "isJammed": true
}

裝置指令

具有此特性的裝置可能會在 EXECUTE 作業中回應下列指令。如要進一步瞭解如何處理 EXECUTE 意圖,請參閱意圖執行要求一文。

action.devices.commands.LockUnlock

鎖定或解除鎖定裝置。

參數

參數 類型 說明
lock 布林

必填。

當指令為鎖定時,值為 True,解鎖 False 則為 False。

followUpToken 字串

Google 提供的後續追蹤權杖。

範例

鎖上前門。

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

解鎖前門。

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

鎖定或解除鎖定裝置時發生錯誤。

支援的值:

remoteSetDisabled
deviceJammingDetected
notSupported
alreadyLocked
alreadyUnlocked

後續回應

具有此特性的裝置可能會透過 EXECUTE 作業傳回下列後續回應酬載。如要進一步瞭解如何執行後續回應,請參閱智慧型住宅動作通知

酬載包含下列其中一個值:

成功:已鎖定

欄位 類型 說明
followUpToken 字串

必填。

原始 EXECUTE 要求中提供的憑證。

status 字串

必填。

要求的結果。

支援的值:

SUCCESS
isLocked 布林

必填。

指出裝置是否處於鎖定狀態。

失敗

欄位 類型 說明
followUpToken 字串

必填。

原始 EXECUTE 要求中提供的憑證。

status 字串

必填。

要求的結果。

支援的值:

FAILURE
errorCode 字串

必填。

這個值可以是此特性的任何錯誤代碼,例如 deviceJammingDetected

範例

鎖上前門。(針對成功情況進行後續追蹤)

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

解鎖前門。(針對成功情況進行後續追蹤)

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

鎖上前門。(失敗案例的後續回應)

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

話語範例

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

裝置錯誤:ERRORS

請參閱錯誤和例外狀況的完整清單。