iOS サンプルアプリを使用する

このサンプルアプリは、サポートされているデバイスタイプに対して Home API を使用してデバイスにアクセスし、デバイスを操作する基本的な機能を示しています。

アカウントの認証が完了し、ストラクチャが選択されると、サンプルアプリはそのストラクチャ内のすべてのローカル デバイスを読み込みます。デバイスが部屋にある場合は、その部屋の下に表示されます。このサンプルアプリは、次のデバイスタイプをサポートしています。

  • 色温度ライト
  • 調光可能なライト
  • ドアロック
  • 拡張色ライト
  • ファン
  • 在室確認センサー
  • ライトのオン/オフ
  • オン/オフ プラグイン ユニット
  • 温度センサー
  • サーモスタット
  • 窓装飾

既存のデバイスと自動化のアクション

サンプルアプリは、[デバイス] タブと [自動化] タブの 2 つのタブで構成されています。各タブには、構造に関する情報が表示され、タスクを実行できます。

[デバイス] タブ

[デバイス] タブ(図 1)には、ストラクチャ内の部屋(バスルーム、書斎、オフィス)と各部屋のデバイス、各デバイスのステータスが表示されます。画面右上の more_horiz アイコンをクリックして、デバイスの接続を解除したり、権限を更新したりすることもできます(図 2)。

Home iOS APIs サンプルアプリの [デバイス] タブ。
図 1: [デバイス] タブの表示
Home iOS API のサンプルアプリのデバイス コントロール。
図 2: 接続解除または更新の権限

[自動化] タブ

[自動化] タブ(図 3)には、構造のすべての自動化のリストが表示されます。各自動化には、開始条件とアクションが表示されます。複数の開始条件とアクションがサポートされています。

自動化をタップして詳細を表示します(図 4 の例を参照)。この詳細ビューでは、開始条件、条件、アクションの詳細な説明を確認できます。

Home iOS API サンプルアプリの [自動化] タブ。
図 3: [自動化] タブの表示
選択した自動化の詳細ビュー。
図 4: 自動化の詳細ビュー

自動化の作成

新しい自動化を作成するには、自動化リストビューで [+ 追加] ボタンをタップします(図 3)。次の画面に、推奨される自動化のリストが表示されます。目的の自動化を選択します(図 5)。何も自動入力されない場合、構造に自動化に必要な十分なデバイスが含まれていません。たとえば、扇風機とライトの両方をオンにする場合、構造に扇風機デバイスとライトデバイスの両方を含める必要があります。両方を含めないと、自動化は表示されません。

自動化を選択すると、開始条件、条件、アクションが表示されます(図 6)。[保存] をクリックして自動化を追加します(図 7)。

自動化の候補が表示されたサンプルアプリ画面
図 5: 自動化の候補
自動化のサンプルアプリ画面。
図 6: 自動化を保存する
作成した自動化のサンプルアプリ画面。
図 7: 作成された自動化

自動化を編集する

自動化の名前と説明を編集するには、自動化の詳細ビュー(図 4)で 設定 アイコンをクリックし、[名前を編集] をクリックします(図 8)。図 9 のように、名前と説明を編集し、完了したら戻ります(図 8)。保存するには、 設定 アイコンをクリックし、[保存] をクリックします。

名前の編集ボタンを選択するアプリ画面のサンプル。
図 8: 自動化の名前を編集する
自動化の名前と説明を編集するためのアプリ画面の例。
図 9: 名前と説明のエディタ

自動化を削除する

自動化を削除するには、自動化の概要(図 7)に移動します。削除する自動化を左にスワイプし、 削除 アイコンをクリックします(図 10)。

自動化を削除するアプリ画面の例。
図 10: 自動化を削除する

汎用自動化エディタ

汎用エディタを使用すると、自動化スクリプトを作成するときに、開始条件とアクションで使用する構造内のデバイスを選択できます。条件としてサポートされている特徴も選択できます。

汎用自動化を追加するには、[自動化の候補] 画面で [汎用自動化] をタップします(図 5)。

次の画面で、自動化の名前と説明を編集できます。

開始条件の候補を追加する

開始条件の候補を追加するには、[開始条件と条件を追加] をタップします(図 11)。開始候補画面には、構造内で使用可能な開始点が表示されます(図 12)。開始候補のいずれかを選択して続行します(図 13)。

開始条件を追加します。
図 11: 汎用エディタ画面
スターター候補のリスト。
図 12: 開始条件の候補リスト
開始条件を選択します。
図 13: 開始条件を選択する

[オンまたはオフを切り替える] または [明るさを変更する](図 14 と図 15)を選択し、オンまたはオフを切り替えるか、明るさを変更します。構成が完了したら、[完了] をタップして汎用エディタ画面に戻ります。選択したスターターが汎用エディタ画面に表示されます(図 16)。

ライトをオンまたはオフにする。
図 14: ライトのオン / オフを切り替える
明るさを変える
図 15: 明るさを変更する
スターターのリスト。
図 16: スターターを追加する

アクション候補を追加する

アクション候補を追加するには、[アクションを追加] をタップします(図 17)。[アクション候補] 画面に、使用可能なアクション候補が表示されます(図 18)。いずれかのアクション候補を選択して続行します(図 19)。

アクションを追加
図 17: アクションを追加する
アクション候補のリスト
図 18: アクション候補のリスト
操作を選択します。
図 19: アクションを選択する
ライトをオンまたはオフにする
図 20: LevelControlTrait はアクションでサポートされていません

[オンまたはオフを切り替える] を選択し、デバイスのオン / オフを切り替えます。[完了] をタップして汎用エディタ画面に戻ります(図 21)。[保存] をタップして自動化を作成します(図 22)。自動化が [自動化] タブに表示されます(図 23)。

ライトをオンまたはオフにする
図 21: 照明のオン / オフを切り替える
開始条件とアクションを追加しました。
図 22: 開始条件とアクションを追加する
汎用自動化が作成された
図 23: 汎用自動化を作成