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

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

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

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

• 色温度ライト（オン、オフ、明るさ）
• 接触センサー（ブール値の状態）
• 調光ライト（オン、オフ、明るさ）
• ドアロック
• 拡張カラーライト（オン、オフ、明るさ）
• 汎用スイッチ
• Google ボーダー ルーター
• Google カメラ
• Google Doorbell
• 在室確認センサー（在室確認）
• オン/オフライト（オンとオフ、明るさ）
• オン/オフ ライトスイッチ
• オン/オフ プラグイン ユニット（オン、オフ）
• オン/オフ センサー

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

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

[デバイス] タブ

[Devices] タブ（図 1）には、ストラクチャ内の部屋（Backyard、Attic、Travel）と各部屋のデバイス、および各デバイスのステータスが表示されます。デバイスのトレイトを表示または編集するには、デバイス名をタップします。これで、そのデバイスの操作画面が表示されます（図 2）。

ストラクチャにデバイスを追加するには、[デバイス] タブ（図 1）で [デバイスを追加] をタップし、手順に沿って QR コードを使用するか、使用せずにデバイスを追加します。

[自動化] タブ

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

自動化をタップすると、図 4 の例に示すように詳細が表示されます。この詳細ビューでは、自動化を削除したり、開始条件を必要とせずに自動化を手動で実行したりできます。ただし、この自動化で [手動で実行] ボタンがサポートされている必要があります。

また、自動化の詳細ビュー（図 4）では、isActive を切り替えて自動化をオンまたはオフにできます。isValid フィールドは SDK によって設定され、デバイスやトレイトのサポートに問題がある場合や、その他の問題がある場合は false になります。

自動化の作成

新しい自動化を作成するには、自動化リストビュー（図 3）で [作成] ボタンをタップします。[New Automation] 画面が表示されます（図 5）。

[+Add Starter] ボタンと [+Add Action] ボタン（図 5）を使用して、自動化に 1 つ以上の開始条件とアクションを追加します。図 6 と図 7 は、それぞれ開始条件とアクションを選択する例を示しています。選択を完了して、開始条件またはアクションを保存すると、開始条件の [開始条件を更新] ボタンと [開始条件を削除] ボタン（アクションの場合は [アクションを更新] ボタンと [アクションを削除] ボタン）が表示されます。これにより、自動化自体を保存する前に、開始条件やアクションを編集または削除できます。

開始条件とアクションの追加が完了したら、[新しい自動化] 画面に戻り、[自動化を作成] をタップします（図 8）。

トラブルシューティング

このアプリは、発生する可能性のある一般的なイベントのダイアログ メッセージを表示します。これらのイベントの解決方法については、adb ログをご覧ください。

サンプルアプリの使用中に問題が発生した場合は、Android のトラブルシューティングをご覧ください。