スマートホームの 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"
    }
  }
}

サンプル音声

<ph type="x-smartling-placeholder">

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

デバイスエラー

詳しくは、 エラーと例外をご覧ください。