Google Home デベロッパー センターにようこそ。スマートホーム アクションの開発方法を学ぶことができます。注: アクションの作成は、引き続き Actions Console で行います。
コレクションでコンテンツを整理 必要に応じて、コンテンツの保存と分類を行います。

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

action.devices.traits.OpenClose - このトレイトは、開始と終了(場合によっては複数の方向の開閉)をサポートするデバイスを対象としています。

デバイスの属性

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

属性 タイプ 説明
discreteOnlyOpenClose ブール値

(デフォルト: false

true に設定すると、デバイスは完全に開いているか、完全に閉じている必要があります(0 ~ 100% の値はサポートされません)。

openDirection 配列

デバイスで開く、または閉じることができるサポートされている方向のリスト。デバイスが複数の方向の開閉に対応している場合は、この属性を使用します。

[item, ...] 文字列

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

サポートされている値:

UP
DOWN
LEFT
RIGHT
IN
OUT
commandOnlyOpenClose ブール値

(デフォルト: false

デバイスが一方向(True)または双方向(False)の通信をサポートしているかどうかを示します。デバイスがこのトレイトの QUERY インテントまたは Report State に応答できない場合は、この属性を true に設定します。

queryOnlyOpenClose ブール値

(デフォルト: false

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

シンプルな開閉デバイス。

{
  "discreteOnlyOpenClose": true
}

トップダウンのボトムアップ デバイス。どちらの方向にも開くことができます。

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

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

{
  "commandOnlyOpenClose": true
}

デバイスのステータス

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

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

一方向で開閉する

状態 タイプ 説明
openPercent Number

必須。

デバイスが開いている割合です。0 は閉じており、100 は完全に開いています。

多方向開閉

状態 タイプ 説明
openState 配列

必須。

サポートされている各オープン方向の状態のリスト。

[item, ...] オブジェクト

指定されたオープン方向の現在の状態。

openPercent Number

必須。

デバイスが開いている割合です。0 は閉じており、100 は完全に開いています。

openDirection 文字列

必須。

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

サポートされている値:

UP
DOWN
LEFT
RIGHT
IN
OUT

シンプルな開閉デバイス。

{
  "openPercent": 100
}

デバイスを下方向に 30%、上方向に 50% 開いてください。

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

デバイスのコマンド

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

action.devices.commands.OpenClose

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

パラメータ

パラメータ タイプ 説明
openPercent Number

必須。

デバイスが開いている割合です。0 は閉じており、100 は完全に開いています。

openDirection 文字列

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

サポートされている値:

UP
DOWN
LEFT
RIGHT
IN
OUT
followUpToken 文字列

フォローアップ レスポンス用の 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 文字列

必須。

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

status 文字列

必須。

リクエストの結果。

サポートされている値:

SUCCESS
openPercent Number

必須。

デバイスが開いているパーセンテージを示します。0 は閉じているが、100 は完全に開いています。

失敗

フィールド タイプ 説明
followUpToken 文字列

必須。

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

status 文字列

必須。

リクエストの結果。

サポートされている値:

FAILURE
errorCode 文字列

必須。

この値には、任意のトレイトのエラーコード(例: 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

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

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

パラメータ

パラメータ タイプ 説明
openRelativePercent Number

必須。

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

openDirection 文字列

開く方向。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
  • マッハ den Rollladen zu
  • マッハ die Rollos auf
  • schließe die Rollläden ein bisschen mehr
  • Öffne die Jalousien um 25%

en-US

  • 閉じる ブラインド 25% 自分の部屋
  • 閉じる ドア その他
  • 玄関を閉めるだけ
  • 開く 部屋のブラインド
  • オープン ブラインド to 25%
  • オープン ドア 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
  • quiero que subas la persiana al 25%
  • sube un 20% las persianas

fr-FR

  • ベース レスストア de 10%
  • ferme レスストア
  • ferme un peu レスストア
  • ouvre レスストア
  • ouvre les store de de la chambre de 25%
  • ouvre レスストア à 25%

デバイスエラー

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