スキーマの定義

モバイルアプリから Thing を操作する際、あらかじめスキーマを設計しておく必要があります。

ここでは、スキーマ、アクション、アクションリザルト、ステートの概念があることを前提に説明します。概要についてはスキーマをご覧ください。

スキーマ

JavaScript では、アクションやステートを扱うに当たって、アクションの名前やその詳細なパラメータ、ステートの各フィールドの情報などをスキーマとして定義します。Android では、スキーマをクラスの形で明示し、API に設定して利用しますが、現バージョンの JavaScript SDK では設計情報として利用します。

上記の機能概要に示すように、Thing 側の実装やバージョンアップ時の考慮など、スキーマはフレームワーク全体で共有される概念です。JavaScript ではスキーマを明確に定義しなくても実装できますが、フレームワーク全体の実装のためにはスキーマを定義し、それに基づいた実装を行うのが理想です。

ここでは、スキーマの例として、簡単なエアコンを定義します。以下に示すように、アクションとステートを定義し、これら全体に対してスキーマ名とスキーマバージョンを定めます。

アクションの例

このエアコンでは 3 つのアクションを同時に指定できるものとします。それぞれ、スキーマとして以下のような情報を定義します。

TurnPower アクション：電源を入れるかどうかの boolean 値（true で電源を入れる）

アクション名：turnPower

パラメータの例：
```
{
  "power" : true
}
```
SetPresetTemperature アクション：設定温度（15～30 の数値）

アクション名：setPresetTemperature

パラメータの例：
```
 {
   "presetTemperature" : 25
 }
```
SetFanSpeed アクション：ファンの強さ（0～10 の数値）

アクション名：setFanSpeed

パラメータの例：
```
{
  "fanSpeed" : 5
}
```

ステートの例

ステートとして、これら 3 つの設定値に加え、現在の温度と湿度を参照できるものとします。以下にステートの例を示します。

{
  "power" : true,
  "presetTemperature" : 25,
  "fanspeed" : 5,
  "currentTemperature" : 28,
  "currentHumidity" : 65
}