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

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

アカウントの認証が完了し、ストラクチャが選択されると、サンプルアプリは、そのストラクチャで見つかったすべてのローカル デバイスを読み込みます。

デバイスが部屋に割り当てられている場合は、その部屋の下に表示されます。サンプルアプリは、次のデバイスタイプをサポートしています。

  • 色温度ライト
  • 調光可能なライト
  • ドアロック
  • Extended Color Light
  • ファン
  • Google ボーダー ルーター
  • Google カメラ
  • Google Doorbell
  • 在室確認センサー
  • オン / オフライト
  • オン / オフ プラグイン ユニット
  • 温度センサー
  • サーモスタット
  • カーテン類

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

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

[デバイス] タブ

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

Home iOS API サンプルアプリの [Devices] タブ。
図 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: 自動化を削除する

汎用自動化エディタ

汎用エディタでは、自動化スクリプトを作成する際に、開始条件とアクションで使用するストラクチャ内の任意のデバイスを選択できます。また、条件としてサポートされているトレイトも選択できます。

一般的な自動化を追加するには、[Automation Suggestions] 画面(図 5)で [Generic Automation] をタップします。

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

スターター候補を追加

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

[開始条件を追加] ボタンと [条件を追加] ボタンが表示された一般的な自動化エディタの画面
図 11: 汎用エディタ画面
スターター候補のリスト。
図 12: 開始条件の候補のリスト
選択したデバイスで使用可能な特性を表示する開始条件の選択画面
図 13: 開始条件を選択する

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

ライトをオンまたはオフにする。
図 14: ライトのオン / オフ
レベル調整の開始条件を設定するための明るさスライダー コントロール
図 15: 明るさの変更
新しく追加されたスターターがリストに表示されている一般的な自動化エディタ
図 16: 開始条件の追加

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

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

開始条件の下に [アクションを追加] ボタンが表示されている汎用自動化エディタ
図 17: アクションを追加
アクション候補のリスト
図 18: アクション候補のリスト
選択したデバイスでサポートされているトレイトを表示するアクション選択画面
図 19: アクションを選択
ライトをオンまたはオフにする
図 20: LevelControlTrait はアクションでサポートされていません

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

ライトをオンまたはオフにする
図 21: ライトをオンまたはオフにする
開始条件とアクションを追加しました。
図 22: 開始条件とアクションを追加
新しく作成された汎用自動化が表示されている [自動化] タブ
図 23: 作成された汎用自動化