Android アプリに Home API を追加するには、いくつかの前提条件を満たす必要があります。
前提条件
開発には、次のツールがインストールされたパソコンが必要です。
Android Studio、バージョン 2024.2.1(「Ladybug」)以降。これより前のバージョンでは、Home APIs SDK が正常に動作しない可能性があります。
Android デバッガ(
adb)。adbをインストールします。これは SDK Manager で行えます。
Home API をテストするには、次のものが必要です。
- 開発に使用する Google アカウントが設定された、Android 10 以降を搭載した Android デバイス。最新バージョンの Android Studio がインストールされ、このデベロッパー アカウントでログインしていることを確認します。
- Wi-Fi ネットワーク。
- Matter デバイスにアクセスして操作するには、Home API をサポートする Google ハブも必要です。詳しくは、Android での接続 をご覧ください。
家の中にサポートされているデバイスが 1 台以上ある。このデバイス(またはテストする他のデバイス)が Thread を使用している場合、ハブも Thread Border Router (TBR) である必要があります。Android サンプルアプリでは、次のデバイスタイプとトレイトがサポートされています。
- 色温度ライト(オン、オフ、明るさ)
- 接触センサー(ブール値の状態)
- 調光ライト(オン、オフ、明るさ)
- ドアロック
- 拡張カラーライト(オン、オフ、明るさ)
- 汎用スイッチ
- Google ボーダー ルーター
- Google カメラ
- Google Doorbell
- 在室確認センサー(在室確認)
- オン/オフライト(オンとオフ、明るさ)
- オン/オフ ライトスイッチ
- オン/オフ プラグイン ユニット(オン、オフ)
- オン/オフ センサー
サポートされているハブ
Home API をサポートしているのは、特定の Google Nest Hub のみです。
SDK を設定する
このオープンベータ版の Home API は、Google が開発用に提供している標準ライブラリにはまだ含まれていません。Home API を使用してアプリを開発するには、ライブラリをダウンロードしてローカルでホストする必要があります。
Home API Android SDK をダウンロードするには、まず Google Home Developers にログインする必要があります。