ThermostatMode スキーマ
sdm.devices.traits.ThermostatMode
このトレイトは、さまざまなサーモスタット モードをサポートする THERMOSTAT のデバイスタイプに使用します。
フィールド
項目 | 説明 | データ型 |
---|---|---|
availableModes |
サポートされているサーモスタットのモードのリスト。 | array(string) 値: ["HEAT", "COOL", "HEATCOOL", "OFF"]) |
mode |
現在のサーモスタットのモード。 | string 値: 「HEAT」、「COOL」、「HEATCOOL」、「OFF」 |
GET リクエストとレスポンスの例
リクエスト
GET /enterprises/project-id/devices/device-id
レスポンス
{
"name" : "enterprises/project-id/devices/device-id",
"traits" : {
"sdm.devices.traits.ThermostatMode
" : {
"availableModes" : ["HEAT", "COOL", "HEATCOOL", "OFF"],
"mode" : "COOL"
}
}
}
コマンド
SetMode
サーモスタットのモードを変更する。
SetMode リクエストとレスポンス
リクエスト
POST /enterprises/project-id/devices/device-id:executeCommand
{
"command" : "sdm.devices.commands.ThermostatMode.SetMode
",
"params" : {
"mode" : "HEAT"
}
}
レスポンス
{}
SetMode リクエスト フィールド
項目 | 説明 | データ型 |
---|---|---|
mode |
サーモスタットを変更するモード。 | string 値: 「HEAT」、「COOL」、「HEATCOOL」、「OFF」 |
エラー
このトレイトに関連して、次のエラーコードが返されることがあります。
エラー メッセージ | RPC | トラブルシューティング |
---|---|---|
現在のサーモスタット モードではコマンドを使用できません。 | FAILED_PRECONDITION |
ThermostatMode トレイトによれば、一部のサーモスタット モデルでは、サーモスタット モードがオフのときにエコモードを変更できないことがあります。エコモードを変更する前に、サーモスタットのモードを HEAT、COOL、HEATCOOL のいずれかに変更する必要があります。 |
API エラーコードの完全なリストについては、API エラーコード リファレンスをご覧ください。