智慧門鎖解鎖傳統結構定義

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

裝置 ERRORS

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