Smart Home LockUnlock 特徵

action.devices.traits.LockUnlock - 這項特徵屬於任何支援鎖定和解鎖功能，以及/或回報鎖定狀態的裝置。

裝置屬性

無。

裝置狀態

具有此特徵的實體可能會回報下列資料： 做為 QUERY 作業的一部分。學習 如要進一步瞭解如何處理 QUERY 意圖，請參閱 意圖執行要求。

州 類型 說明
isLocked 布林值

裝置目前是否處於鎖定狀態。
isJammed 布林值

裝置是否正在卡住，因此無法判斷裝置的鎖定狀態。

範例

處於鎖定狀態的裝置

{
  "isLocked": true
}

裝置卡住的裝置

{
  "isJammed": true
}

裝置指令

具備這種特徵的裝置可能會回應下列問題 做為 EXECUTE 作業的一部分。學習 如要進一步瞭解如何處理 EXECUTE 意圖，請參閱 意圖執行要求。

action.devices.commands.LockUnlock

鎖定或解鎖裝置。

參數

參數 類型 說明
lock 布林值

必要。

當指令為鎖定時為 true，false 表示解鎖。
followUpToken String

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 String

必要。

原始 EXECUTE 要求中提供的權杖。
status String

必要。

要求的結果。

支援的值：

SUCCESS
isLocked 布林值

必要。

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

失敗

欄位 類型 說明
followUpToken String

必要。

原始 EXECUTE 要求中提供的權杖。
status String

必要。

要求的結果。

支援的值：

FAILURE
errorCode String

必要。

值可以是這個特徵的任何錯誤代碼，例如 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

裝置錯誤

查看完整清單 錯誤和例外狀況。