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

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

action.devices.traits.FanSpeed - この特性は、ファンの速度の設定をサポートするデバイスに属します。

ファンの速度(デバイスからの空調、エアコンや暖房装置の一部、空気の吹くなど)には、低、中、高、割合などの設定があります。

デバイスの属性

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

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

(デフォルト: false

true に設定すると、ファンは両方向に送られるようになります。コマンドを受け入れてファンの方向を逆にすることができます。

commandOnlyFanSpeed ブール値

(デフォルト: false

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

次の項目が含まれます。
0 オブジェクト

速度設定のサポート。

availableFanSpeeds オブジェクト

必須。

デバイスでサポートされている速度設定です。

speeds 配列

必須。

速度設定のリスト。

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

速度設定です。

speed_name 文字列

必須。

速度設定の内部名。これは、ユーザー フレンドリーな名前とは限らず、すべての言語に共通です。

speed_values 配列

必須。

サポートされている各言語の速度設定の類義語です。

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

特定の言語での速度設定の類義語です。

speed_synonym 配列

必須。

速度設定の類義語には、該当する場合は単数形と複数形の両方を含める必要があります。リスト内の最初の類義語は、速度設定の正規名と見なされます。

[item, ...] 文字列

類義語

lang 文字列

必須。

言語コード(ISO 639-1)。サポートされている言語をご覧ください。

ordered ブール値

必須。

true に設定すると、速度配列を増加(減少)させるための追加の文法が適用されます。

1 オブジェクト

速度の割合に対するサポート。

supportsFanSpeedPercent ブール値

必須。

(デフォルト: false

true に設定すると、このデバイスは、0.0 ~ 100.0 のパーセンテージで速度を調整するコマンドを受け入れます。

逆方向と割合の調整に対応した 2 つの速度設定を備えたデバイスです。

{
  "availableFanSpeeds": {
    "speeds": [
      {
        "speed_name": "speed_low",
        "speed_values": [
          {
            "speed_synonym": [
              "low",
              "slow"
            ],
            "lang": "en"
          }
        ]
      },
      {
        "speed_name": "speed_high",
        "speed_values": [
          {
            "speed_synonym": [
              "high",
              "fast"
            ],
            "lang": "en"
          }
        ]
      }
    ],
    "ordered": true
  },
  "reversible": true,
  "supportsFanSpeedPercent": true
}

デバイスのステータス

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

状態 タイプ 説明
currentFanSpeedSetting 文字列

availableFanSpeeds 属性の現在の速度設定の内部名を表します。

currentFanSpeedPercent Number

現在のファン速度をパーセンテージで示します。supportsFanSpeedPercent 属性が true に設定されている場合は必須です

リビングルームのファンの速さはどのくらいですか?

{
  "currentFanSpeedSetting": "speed_low",
  "currentFanSpeedPercent": 10
}

デバイスのコマンド

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

action.devices.commands.SetFanSpeed

速度を設定します。

パラメータ

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

速度は設定で設定できます。

パラメータ タイプ 説明
fanSpeed 文字列

必須。

ファンの速度設定のリクエストです。

速度をパーセンテージで設定します。

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

必須。

リクエストされた速度設定の割合です。

扇風機の温度を高くする。

{
  "command": "action.devices.commands.SetFanSpeed",
  "params": {
    "fanSpeed": "speed_high"
  }
}

扇風機を 50% にして。

{
  "command": "action.devices.commands.SetFanSpeed",
  "params": {
    "fanSpeedPercent": 50
  }
}

action.devices.commands.SetFanSpeedRelative

相対速度を設定します。

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

パラメータ

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

重量で相対速度を設定します。

パラメータ タイプ 説明
fanSpeedRelativeWeight Integer

必須。

この値は、速度変化の相対的な量を示します。絶対値はスケーリングされた量を示し、数値記号は変化の方向を示します。

相対速度をパーセンテージで設定します。

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

必須。

この値は、変更する速度の割合を表します。

ファンの速度を少し下げます。

{
  "command": "action.devices.commands.SetFanSpeedRelative",
  "params": {
    "fanSpeedRelativeWeight": -1
  }
}

ファンの速度を 10% 上げて。

{
  "command": "action.devices.commands.SetFanSpeedRelative",
  "params": {
    "fanSpeedRelativePercent": 10
  }
}

action.devices.commands.Reverse

ファンの方向を逆にします。

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

パラメータ

パラメータ タイプ 説明

プロパティがありません

ファンの向きを逆にして、

{
  "command": "action.devices.commands.Reverse",
  "params": {}
}

サンプル音声

de-DE

  • stell die Geschwindigkeit vom Ventilator auf hoch

en-US

  • エアコン ファン速度

es-ES

  • cambia la velocidad del ventilador メディオ

fr-FR

  • Meet 換気 au 最大

デバイスエラー

エラーと例外のリストをご覧ください。
  • maxSpeedReached: デバイスはすでに最高速度に設定されています。
  • minSpeedReached: デバイスはすでに最低速度に設定されています。