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

サンプルアプリは、サポートされているデバイスタイプで Home API を使用したデバイスへのアクセスと制御の基本的な機能を紹介します。

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

  • 色温度光
  • 調光可能なライト
  • ドアロック
  • Extended Color Light
  • ファン
  • Google カメラ
  • 在宅確認センサー
  • ライトのオン/オフ
  • オン/オフ プラグイン ユニット
  • 温度センサー
  • サーモスタット
  • 窓カバー

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

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

[デバイス] タブ

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

Home iOS APIs サンプルアプリの [デバイス] タブ。
図 1: [デバイス] タブのビュー
Home iOS APIs サンプルアプリのデバイス コントロール。
図 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)。続行するには、スターター候補の 1 つを選択します (図 13)。

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

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

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

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

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

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

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

ライトをオンまたはオフにする
図 21: ライトをオンまたはオフにする
スターターとアクションを追加しました。
図 22: スターターとアクションを追加
汎用オートメーションが作成された
図 23: 汎用オートメーションが作成されました