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

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