スマートホームの OpenClose トレイトのスキーマ

action.devices.traits.OpenClose - このトレイトは、開閉をサポートするデバイスに使用します。部分的な開閉や、複数の方向への開閉をサポートするデバイスにも使用できます。

デバイスの属性

このトレイトを持つデバイスは、次の 属性をSYNCオペレーションの一部として報告できます。SYNC インテントの処理について詳しくは、インテントのフルフィルメントをご覧ください。

属性 型 説明
discreteOnlyOpenClose ブール値

（デフォルト: false）

true の場合は、デバイスを完全に開くか完全に閉じる必要があること（つまり、0% と 100% 以外の値には対応しないこと）を示します。
openDirection 配列

デバイスを開閉できる方向のリスト。デバイスが複数の方向への開閉をサポートしている場合は、この属性を含めます。
[item, ...] String

サポートされている方向。

サポートされている値:

UP
DOWN
LEFT
RIGHT
IN
OUT
commandOnlyOpenClose ブール値

（デフォルト: false）

デバイスが一方向（true）または双方向（false）のいずれの通信を使用して動作しているかどうかを示します。デバイスがこのトレイトの QUERY インテントまたは Report State に応答できない場合は、この属性を true に設定します。
queryOnlyOpenClose ブール値

（デフォルト: false）

デバイスの状態情報のみをクエリでき、制御できないかどうかを示します。開いている状態のみを報告できるセンサーは、このフィールドを true に設定する必要があります。

例

単純な開閉デバイス。 

{
  "discreteOnlyOpenClose": true
}

上下に開閉するデバイス。どちらの方向にも開くことができます。

{
  "openDirection": [
    "UP",
    "DOWN"
  ]
}

コマンドのみのデバイス。 

{
  "commandOnlyOpenClose": false
}

デバイスのステータス

このトレイトを持つエンティティは、次の ステータスを QUERY オペレーションの一部として報告できます。`QUERY` インテントの処理について詳しくは、インテントのフルフィルメントをご覧ください。

ペイロードには次のいずれかが含まれます。

一方向の開閉

州 型 説明
openPercent 数値

必須。

デバイスが開いているパーセンテージを示します。0 が閉じている状態で、100 が全開の状態です。

値は 0～100 の範囲で指定してください
targetOpenPercent 数値

位置の変更が進行中の結果として、デバイスが移動する、または移動している開閉パーセンテージを示すレベル。

値は 0～100 の範囲で指定してください

複数の方向への開閉

州 型 説明
openState 配列

必須。

サポートされている開閉方向ごとのステータスのリスト。
[item, ...] オブジェクト

指定された開閉方向の現在の状態。
openPercent 数値

必須。

デバイスが開いているパーセンテージを示します。0 が閉じている状態で、100 が全開の状態です。

値は 0～100 の範囲で指定してください
targetOpenPercent 数値

位置の変更が進行中の結果として、デバイスが移動する、または移動している開閉パーセンテージを示すレベル。

値は 0～100 の範囲で指定してください
openDirection String

必須。

デバイスが開いている方向。

サポートされている値:

UP
DOWN
LEFT
RIGHT
IN
OUT

例

単純な開閉デバイス。 

{
  "openPercent": 100
}

現在新しい位置に開いている単純な開閉デバイス。 

{
  "openPercent": 50,
  "targetOpenPercent": 100
}

デバイスを下に 30%、上に 50% 開きます。 

{
  "openState": [
    {
      "openPercent": 30,
      "openDirection": "DOWN"
    },
    {
      "openPercent": 50,
      "openDirection": "UP"
    }
  ]
}

デバイスを下に 30%、上に 50% 開き、現在上に 80% 移動しています。 

{
  "openState": [
    {
      "openPercent": 30,
      "openDirection": "DOWN"
    },
    {
      "openPercent": 50,
      "targetOpenPercent": 80,
      "openDirection": "UP"
    }
  ]
}

デバイスのコマンド

このトレイトを持つデバイスは、次の コマンドを EXECUTE オペレーションの一部として応答できます。EXECUTE インテントの処理について詳しくは、インテントのフルフィルメントをご覧ください。

action.devices.commands.OpenClose

デバイスの開閉状態を設定します。

パラメータ

パラメータ 型 説明
openPercent 数値

必須。

デバイスが開いているパーセンテージを示します。0 が閉じている状態で、100 が全開の状態です。

値は 0～100 の範囲で指定してください
openDirection String

開く方向。openDirection 属性で示されるように、デバイスが複数の方向をサポートしていて、ユーザーが方向を指定した場合にのみ存在します。

サポートされている値:

UP
DOWN
LEFT
RIGHT
IN
OUT
followUpToken String

フォローアップ レスポンス用に Google が提供するトークン。

例

デバイスを開きます。 

{
  "command": "action.devices.commands.OpenClose",
  "params": {
    "openPercent": 100,
    "followUpToken": "123"
  }
}

デバイスを 50% 下に開きます。 

{
  "command": "action.devices.commands.OpenClose",
  "params": {
    "openPercent": 50,
    "openDirection": "DOWN",
    "followUpToken": "456"
  }
}

デバイスの開閉状態の設定中にエラーが発生しました。

サポートされている値:

lockedState
deviceJammingDetected

フォローアップ レスポンス

このトレイトを持つデバイスは、次の フォローアップ レスポンス ペイロードを EXECUTE オペレーションの一部として返すことがあります。フォローアップ レスポンスの実装について詳しくは、スマートホーム アクションの通知をご覧ください。

ペイロードには次のいずれかが含まれます。

成功

フィールド タイプ 説明
followUpToken String

必須。

元の EXECUTE リクエストで提供されたトークン。
status String

必須。

リクエストの結果。

サポートされている値:

SUCCESS
openPercent 数値

必須。

デバイスが開いているパーセンテージを示します。0 が閉じている状態で、100 が全開の状態です。

値は 0～100 の範囲で指定してください

失敗

フィールド タイプ 説明
followUpToken String

必須。

元の EXECUTE リクエストで提供されたトークン。
status String

必須。

リクエストの結果。

サポートされている値:

FAILURE
errorCode String

必須。

値には、このトレイトのエラーコード（lockedStateなど）を指定できます。

例

車庫のドアを開けて。（成功の場合のフォローアップ レスポンス）

{
  "OpenClose": {
    "priority": 0,
    "followUpResponse": {
      "openPercent": 100,
      "status": "SUCCESS",
      "followUpToken": "1234"
    }
  }
}

車庫のドアを開けて。（失敗の場合のフォローアップ レスポンス）

{
  "OpenClose": {
    "priority": 0,
    "followUpResponse": {
      "errorCode": "lockedState",
      "status": "FAILURE",
      "followUpToken": "1234"
    }
  }
}

action.devices.commands.OpenCloseRelative

現在の状態を基準として、デバイスの開閉状態を調整します。このコマンドは、discreteOnlyOpenClose が false に設定されている場合にのみ使用できます。

このコマンドには次の属性が必要です。 
{
  "discreteOnlyOpenClose": false
}

パラメータ

パラメータ 型 説明
openRelativePercent 数値

必須。

開閉状態を変更する正確なパーセンテージ。相対的なコマンドが曖昧な場合は、正確なパーセンテージ パラメータに変換されます（例: 「ブラインドを少し開けて」と「ブラインドを 5% 開けて」）。

値は -100～100 の範囲で指定してください
openDirection String

開く方向。openDirection 属性で示されるように、デバイスが複数の方向をサポートしていて、ユーザーが方向を指定した場合にのみ存在します。

サポートされている値:

UP
DOWN
LEFT
RIGHT
IN
OUT

例

デバイスを少し開けて。 

{
  "command": "action.devices.commands.OpenCloseRelative",
  "params": {
    "openRelativePercent": 5
  }
}

デバイスを 10% 閉じて。 

{
  "command": "action.devices.commands.OpenCloseRelative",
  "params": {
    "openRelativePercent": -10
  }
}

デバイスを 50% 下に開きます。 

{
  "command": "action.devices.commands.OpenCloseRelative",
  "params": {
    "openRelativePercent": 50,
    "openDirection": "DOWN"
  }
}

デバイスの開閉状態の設定中にエラーが発生しました。

サポートされている値:

lockedState
deviceJammingDetected

サンプル音声

de-DE

  • Bitte öffne die Jalousien auf 30%
  • Fensterläden um 25 % schliessen
  • Ist die Jalousie zu?
  • Mach den Rollladen zu
  • Mach die Rollos auf
  • schließe die Rollläden ein bisschen mehr
  • Öffne die Jalousien um 25%

en-US

  • Are the blinds in the kitchen open
  • Close the blinds 25% in my room
  • Close the door more
  • Just close the front door
  • open the blinds in my room
  • open the blinds to 25%
  • open the door by 25%

es-ES

  • abre la ventana del salón
  • cerrar persianas del dormitorio un 20%
  • cierra la cortina del salón
  • cierra mucho más la ventana
  • está abierta la puerta
  • quiero que subas la persiana al 25%
  • sube un 20% las persianas

fr-FR

  • baisse les stores de 10%
  • est-ce que la porte d'entrée est ouverte
  • ferme les stores
  • ferme un peu les stores
  • ouvre les stores
  • ouvre les stores de la chambre de 25%
  • ouvre les stores à 25%

hi-IN

  • कृपया 25% पर्दे को खुला रखो
  • क्या मैंने सामने वाला दरवाजा खुला छोड दिया?
  • पर्दे को 25% बंद करोगे
  • पर्दे खोलो
  • ब्लाइंड 25% खुले पर सेट कर दीजिए
  • ब्लाइंड को थोड़ा और बंद कर दिजिए
  • ब्लाइंड बंद करें

it-IT

  • abbassa un po' di più le tapparelle
  • apri la serranda
  • apri la tapparella al 30%
  • apri le serrande del 30%
  • chiudi le serrande
  • chiudi le tende del 25%
  • è aperta la porta d'ingresso

ja-JP

  • 25% に ブラインド を開けて
  • 25% ブラインド を閉めてください
  • 25% ブラインド 開けて
  • ブラインド 閉めて
  • ブラインド 開けて
  • 少し ブラインド を閉じて
  • 玄関のドア は開いてますか

ko-KR

  • 문 살짝만 닫아 줘
  • 블라인드 25% 열어 줘
  • 블라인드 25% 까지 열어 줘
  • 블라인드 30프로 닫아
  • 블라인드 닫아 줘
  • 블라인드 열어 줘
  • 안방 문 열렸어

nl-NL

  • doe de gordijnen 25% open
  • doe de jaloezieën voor 25% dicht
  • doe het raam ietsje meer dicht
  • is de voordeur open
  • open de gordijnen
  • sluit het gordijn
  • zet de luxaflex voor 50% open

pt-BR

  • Abrir janela 50%
  • As cortinas estão abertas?
  • Fecha a persiana toda
  • Fechar a janela 10%
  • a cortina do quarto está aberta?
  • abra a persiana até 30%
  • abre as cortinas
  • abre as cortinas a 50%
  • abrir as cortinas
  • abrir as cortinas na sala em 30%
  • fecha a persiana por favor
  • fecha um bocado a janela
  • fechar as cortinas em 25%
  • fechar um pouco mais as cortinas

sv-SE

  • Dra upp persiennerna
  • Dra upp persiennerna till 25%
  • stäng persiennen i mitt rum 25%
  • stäng persiennerna
  • är ytterdörren öppen?
  • öppna persiennerna med 25%

デバイスエラー

エラーと例外の全リストをご覧ください。