スマートホームアクションの開発方法を学ぶための新しいデベロッパーセンター、Google Home Developer Center へようこそ。

このページは Cloud Translation API によって翻訳されました。

スマートホームの 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 が全開の状態です。
`targetOpenPercent`	数値	位置の変更が進行中の結果として、デバイスが移動する、または移動中の開閉率を示すレベル。

openPercent

数値

必須。

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

targetOpenPercent

数値

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

複数の方向に開閉する場合

州	タイプ	説明
`openState`	配列	必須。サポートされている各オープン方向の状態のリスト。
`[item, ...]`	オブジェクト	指定された開く方向の現在の状態。
`openPercent`	数値	必須。デバイスが開いているパーセンテージを示します。0 が閉じている状態で、100 が全開の状態です。
`targetOpenPercent`	数値	位置の変更が進行中の結果として、デバイスが移動する、または移動中の開閉率を示すレベル。
`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 が全開の状態です。
`openDirection`	String	開く方向。`openDirection` 属性で示されるように、デバイスが複数の方向をサポートし、ユーザーが方向を指定した場合にのみ存在します。サポートされている値: `UP` `DOWN` `LEFT` `RIGHT` `IN` `OUT`
`followUpToken`	String	フォローアップレスポンス用の Google 提供トークン。

openPercent

数値

必須。

デバイスが開いているパーセンテージを示します。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 が全開の状態です。

followUpToken

String

必須。

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

status

String

必須。

リクエストの結果。

サポートされている値:

SUCCESS

openPercent

数値

必須。

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

失敗

フィールドタイプ説明

フィールド	タイプ	説明
`followUpToken`	String	必須。元の EXECUTE リクエストで提供されたトークン。
`status`	String	必須。リクエストの結果。サポートされている値: `FAILURE`
`errorCode`	String	必須。値には、このトレイトの任意のエラーコードを指定できます（例: `lockedState`）。

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% 開けて」）。
`openDirection`	String	開く方向。`openDirection` 属性で示されるように、デバイスが複数の方向をサポートし、ユーザーが方向を指定した場合にのみ存在します。サポートされている値: `UP` `DOWN` `LEFT` `RIGHT` `IN` `OUT`

openRelativePercent

数値

必須。

開閉状態を変更する正確な割合。曖昧な相対コマンドは、正確な割合パラメータに変換されます（たとえば、「ブラインドをもう少し開けて」と「ブラインドを 5% 開けて」）。

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%

デバイスエラー

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

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

デバイスの属性

例

デバイスのステータス

単一方向に開閉する場合

複数の方向に開閉する場合

例

デバイスのコマンド

action.devices.commands.OpenClose

パラメータ

例

関連するエラー

フォローアップの回答

成功

失敗

例

action.devices.commands.OpenCloseRelative

パラメータ

例

関連するエラー

サンプル音声

de-DE

en-US

es-ES

fr-FR

hi-IN

it-IT

ja-JP

ko-KR

nl-NL

pt-BR

sv-SE

デバイスエラー

`action.devices.commands.OpenClose`

`action.devices.commands.OpenCloseRelative`