Home APIs Android SDK リリースノート

2025-10-23

  Home APIs 公開ベータ版リリース 1.5.1  

このリリースには、バグの修正と、Home APIs Android SDK のベータ版の品質の向上が含まれています。

最小バージョン

  • Google Play 開発者サービス: 25.41.30
  • Google ハブのファームウェアの最小バージョン:
    • キャスト: 3.76.495998
    • Fuchsia: 27.20250422.103.3600
  • Android SDK: home.android.sdk_1_5_1
  • Google Home アプリ: 任意のバージョンで動作します
  • androidx.core ライブラリ: 任意のバージョンで動作します
  • Matter バージョン: 1.4.1.0

新機能

  • Structure API
    • ハブの有効化 API を使用すると、Google Home ハブをプログラムで検出して有効にできます。Android のハブ アクティベーション API をご覧ください。
  • Android サンプルアプリ
    • ドアホン デバイスタイプのサポート対象:
      • OnOff
      • ライブ配信
      • 双方向通話
    • Hub Activation API: Hub を有効にする

解決済みの既知の問題

  • サンプルアプリの [デバイス] ビューにデバイスのステータスが正しく表示されない。

2025-09-26

  Home API 公開ベータ版リリース 1.5.0  

このリリースでは、カメラ デバイスのサポートが導入され、バグの修正が行われ、Home APIs Android SDK のベータ版の品質が向上しています。

最小バージョン

  • Google Play 開発者サービス: 25.37.31
  • Google ハブのファームウェアの最小バージョン:
    • Cast: 3.76.492738
    • Fuchsia: 27.20250422.103.3600
  • Android SDK: home.android.sdk_1_5
  • Google Home アプリ: 任意のバージョンで動作します
  • androidx.core ライブラリ: 任意のバージョンで動作します
  • Matter バージョン: 1.4.1.0

新機能

  • Automation API
    • 開始条件、条件、アクションが Matter 構造体をパラメータとして受け入れるようになりました。
  • デバイス API
    • カメラ デバイスタイプを追加しました。ドアベルデバイスタイプでは、次のカメラ機能も利用できます。
      • カメラのライブストリーム。
      • カメラ双方向通話。
      • カメラの録画の開始と停止。
  • Android サンプルアプリ
    • カメラ デバイスタイプのサポート:
      • カメラのライブストリーム。
      • カメラ双方向通話。
      • カメラの録画の開始と停止。
      • 制限付きのデバイスタイプの権限。
    • 複数管理者によるコミッショニング（コミッショニングされたデバイスの共有）。
    • 定義済みOnOffオートメーション。

既知の問題

  • Wi-Fi からモバイル ネットワークに切り替えると、デバイス制御のレイテンシが増加する可能性があります。
  • Cloud-to-Cloud でサポートされている扇風機デバイスタイプの制御は、サンプルアプリでは動作しない場合があります。

解決済みの既知の問題

  • 現在アクティブなハブが強制的に削除されると、5 分間、一部のデバイスを制御できなくなります。5 分後には、デバイスを操作できるようになります。
  • ユーザーがプリセットまたは色温度ピッカーから色を選択した後、Extended Color Light は色を更新できません。

2025-09-08

Android 用サンプル アプリ バージョン 1.4.1 がリリースされました。

新機能

  • 部屋を作成、名前変更、更新、削除します。
  • サードパーティの Matter ファブリックへのコミッショニング。

既知の問題を修正

  • 権限取り消しページリンクが機能するようになりました。

2025-08-29

  Home APIs 公開ベータ版リリース 1.4.1  

このリリースには、バグの修正と、Home APIs Android SDK のベータ版の品質の向上が含まれています。

最小バージョン

  • Google Play 開発者サービス: 25.33.32
  • Google ハブのファームウェアの最小バージョン:
    • キャスト: 3.76.495998
    • Fuchsia: 27.20250422.103.3600
  • Android SDK: home.android.sdk_1_4_1
  • Google Home アプリ: 任意のバージョンで動作します
  • androidx.core ライブラリ: 任意のバージョンで動作します
  • Matter バージョン: 1.4.0.0

新機能

既知の問題

  • 現在アクティブなハブが強制的に削除されると、5 分間は一部のデバイスを操作できなくなります。5 分後には、デバイスを制御する機能が回復します。

解決済みの既知の問題

  • ユーザーがサポートされていないモードにサーモスタットを設定しようとすると、Android サンプルアプリがクラッシュします。

2025-07-31

  Home APIs 公開ベータ版リリース 1.4.0  

このリリースには、バグの修正と、Home APIs Android SDK のベータ版の品質の向上が含まれています。

最小バージョン

  • Google Play 開発者サービス: 25.28.34
  • Google ハブのファームウェアの最小バージョン:
    • キャスト: 3.76.486931
    • フクシア: 27.20250422.103.3600
  • Android SDK: home.android.sdk_1_4_0
  • Google Home アプリ: どのバージョンでもご利用いただけます
  • androidx.core図書館：どのバージョンでも動作します
  • Matter バージョン: 1.4.0.0

新機能

  • オートメーション API
    • 自動化は、最大で限られた回数だけ実行されるように制限できます。実行回数を制限するをご覧ください。

既知の問題

  • 電話からログアウトして再度ログインすると、Home API アプリはデバイスを制御できなくなります。
    • 回避策: アプリを閉じるかバックグラウンドに移動し、少なくとも 10 秒待ってから再試行してください。

解決済みの既知の問題

  • ドッキングされた掃除機デバイスがドッキング状態を登録しない。

2025-07-08

Cast ファームウェア バージョン 3.76.479819 では、Google Nest Wifi Pro が Home API ハブとして機能するようになりました。

2025-06-26

  Home APIs 公開ベータ版リリース 1.3.2  

このリリースには、バグの修正と、Home APIs Android SDK のベータ版の品質の向上が含まれています。

最小バージョン

  • Google Play 開発者サービス: 25.23.31
  • Google ハブのファームウェアの最小バージョン:
    • キャスト:
      • Google Home、Google Home Mini、Google Nest Mini: 3.75.468362
      • Google Nest Audio: 3.75.476451
    • Fuchsia: 26.20250116.103.2900
  • Android SDK: home.android.sdk_1_3_2
  • Google Home アプリ: 任意のバージョンで動作します
  • androidx.core ライブラリ: 任意のバージョンで動作します
  • Matter バージョン: 1.4.0.0

新機能

  • SDK アーティファクトは 2 つの個別のアーティファクトに分割されました:
    • Home APIs SDK フレームワーク（play-services-home-17.0.0.aar）
    • SDK の特性とデバイスタイプ（play-services-home-types-17.0.0.aar）

    このリリース以降、開発者はプロジェクトのコンパイル時と実行時のライブラリ パスに両方のアーティファクトを含める必要があります。

Android サンプルアプリ

  • ユーザーはアプリから接続を解除し、権限を取り消すことができます。
  • play-services-home-17.0.0 と play-services-home-types-17.0.0 を含むように SDK アーティファクトを更新しました。

既知の問題

  • ドッキングされた掃除機デバイスがドッキング状態を登録しない。

2025-06-05

  ホーム API パブリックベータ版リリース 1.3.1  

このリリースには、バグの修正と、Home APIs Android SDK のベータ版の品質の向上が含まれています。

最小バージョン

  • Google Play サービス: 25.19.32
  • Google ハブ ファームウェアの最小バージョン:
    • キャスト: 3.75.468222
    • フクシア: 26.20250116.103.2201
  • Android SDK: home.android.sdk_202505_EAP_1_3_1_RC06
  • Google Home アプリ: どのバージョンでもご利用いただけます
  • androidx.core ライブラリ: 任意のバージョンで動作します
  • Matter バージョン: 1.4.0.0

新機能

トレイト

Android サンプルアプリ

構造、デバイス、タイプ、トレイト、自動化の状態をログに記録する関数を追加し、デバッグを容易にしました。

既知の問題

Android サンプルアプリで、[自動化を作成] ボタンをタップしても、トリガーされないことがあります。

既知の問題を修正

  • Google Home アプリ（GHA）で家の場所が設定されていない場合、自動化の作成時に Google Home アプリが FailedPreconditionException でクラッシュします（家の場所を設定する方法については、Google の自宅の住所を変更するを参照してください）。
  • Android サンプルアプリでは、connectivityState PARTIALLY_ONLINE のデバイスは以前、オフラインとしてユーザーに表示されていました。この状態は、オンラインとして表されるようになりました。

2025-05-12

  Home APIs 公開ベータ版リリース 1.3  

このリリースにはバグ修正が含まれており、Home API Android SDK のベータ版の品質が向上しています。

最小バージョン

  • Google Play サービス: 25.16.33
  • Google ハブ ファームウェアの最小バージョン:
    • キャスト: 3.75.468222
    • フクシア: 26.20250116.103.2201
  • Android SDK: home.android.sdk_202504_EAP_1_3_RC00
  • Google Home アプリ: どのバージョンでもご利用いただけます
  • androidx.core ライブラリ: 任意のバージョンで動作します
  • Matter バージョン: 1.4.0.0

新機能

既知の問題

Google Home アプリ（GHA）で家の位置情報が設定されていない場合、自動化の作成時に Google Home アプリが FailedPreconditionException でクラッシュします（設定方法については、Google の自宅の住所を変更するを参照）。

  • 回避策: 自動化を作成する前に、Discovery API を使用して自宅住所が存在することを確認します。

既知の問題を修正

  • Wi-Fi からモバイル ネットワークに切り替えると、デバイス制御のレイテンシが増加する可能性があります。
  • ハブを出荷時の設定にリセットすると、デバイスがオフラインと表示されることがあります。

2025-04-09

  Home API 公開ベータ版リリース 1.2.1  

このリリースには、バグの修正と、Home APIs Android SDK のベータ版の品質の向上が含まれています。

最小バージョン

  • Google Play 開発者サービス: 25.09.33
  • Google ハブのファームウェアの最小バージョン:
    • Cast: 3.75.468222
    • フクシア: 24.20241009.103.19006011
  • Android SDK: home.android.sdk_202503_EAP_1_2_1_RC02
  • Google Home アプリ: 任意のバージョンで動作します
  • androidx.core ライブラリ: 1.10.0
  • Matter バージョン: 1.4.0.0
1. このビルドは現在リリースに向けて展開されており、2025 年 4 月 22 日までにすべてのデバイスで利用可能になる予定です。

新機能

  • ホームグラフからオブジェクトを読み込む際のパフォーマンスを改善しました。
  • Automation API
    • エンティティ フィルタのサポートを追加しました。これにより、自動化で指定された条件に基づいて、自動化でデバイスを動的に選択できるようになります。
  • デバイス API

既知の問題

  • Wi-Fi からモバイル ネットワークに切り替えると、デバイス制御のレイテンシが増加する可能性があります。
  • ハブを出荷時の設定にリセットすると、デバイスがオフラインと表示されることがあります。

解決済みの既知の問題

  • 初期化前または初期化完了前に Discovery API が呼び出されると、 code 14: UNKNOWN と「No route found.」というメッセージを含む HomeException がスローされます。
  • 複数の構造と複数のユーザーを含む環境では、構造とユーザーを切り替えると、デバイスが返されないことがあります。

2025-03-14

  Home APIs 公開ベータ版リリース 1.2.0  

このリリースには、バグの修正と、Home APIs Android SDK のベータ版の品質の向上が含まれています。

最小バージョン

  • Google Play 開発者サービスの最小バージョン: 25.06.32
  • Google Hub のファームウェアの最小バージョン:
    • キャスト バージョン: 3.75.456944
    • Fuchsia の最小バージョン: 24.20241009.103.1900601
  • Android SDK: home.android.sdk_1_2_0_RC06
  • Google Home アプリの最小バージョン: 任意のバージョンで動作
  • androidx.coreライブラリの最小バージョン: 1.10.0
  • Matter バージョン: 1.3.0.0
    • 注: 仮の Matter デバイスタイプとクラスタはサポートされていません。

新機能

  • Automation API:
    • 自動化の条件で日付の範囲と部分的な日付をサポートします。日付の範囲を指定するをご覧ください。
    • 以前のリリースでは、Discovery API は、 BitmapConstraint を返す必要がある場合に、一部のビットマップ フィールドに対して NumberSetConstraint を返していました。これらのフィールドは、想定どおりに BitmapConstraint を返すようになりました。これは、 LevelControl トレイト コマンドの optionsMask ビットマップと optionsOverride ビットマップに限定されます。

既知の問題

  • Wi-Fi からモバイル ネットワークに切り替えると、デバイス制御のレイテンシが増加する可能性があります。
  • ハブを出荷時の設定にリセットすると、デバイスがオフラインと表示されることがあります。
  • 初期化前または初期化完了前に Discovery API が呼び出されると、 code 14: UNKNOWN と「No route found.」というメッセージを含む HomeException がスローされます。
    • 回避策: 自動化候補が実際に必要な場合にのみ、Discovery API を呼び出します。候補エンティティを事前に取得してキャッシュしないでください。エンティティで Discovery API メソッドを呼び出す前に、エンティティがオンラインかどうかを確認します。
  • 複数の構造と複数のユーザーを含む環境では、構造とユーザーを切り替えるとデバイスが返されない場合があります。

解決済みの既知の問題

  • Home APIs アプリが起動後に初めて HomeManager.structures() を呼び出すと、1 つ以上のストラクチャが存在する場合でも、ゼロ個のストラクチャが返されます。これにより、Google アカウントに関連付けられている構造がないという誤った印象を与えます。
  • 自動化の読み込み、作成、編集時に、ユーザーが長時間待機することがあります。
  • カメラアプリからセットアップ フローを開始したユーザーは、Matter のコミッショニングを完了するために QR コードを 2 回スキャンする必要があります。
  • 200 台を超えるデバイスを含む構造では、Discovery API は候補を返さないことがあります。

2025-01-29

  Home API 公開ベータ版リリース 1.1.0  

このリリースには、バグの修正と、Home APIs Android SDK のベータ版の品質の向上が含まれています。

最小バージョン

  • Google Play 開発者サービスの最小バージョン: 25.02.32
  • Google Hub のファームウェアの最小バージョン:
    • キャスト バージョン: 3.75.456944
    • Fuchsia の最小バージョン: 24.20241009.103.1900500
  • Android SDK: home.android.sdk_202412_EAP_1_1_RC04
  • Google Home アプリの最小バージョン: 任意のバージョンで動作
  • androidx.core ライブラリの最小バージョン: 1.10.0
  • Matter バージョン: 1.3.0.0
    • 注: 仮の Matter デバイスタイプとクラスタはサポートされていません。

新機能

既知の問題

  • 自動化の読み込み、作成、編集時に、ユーザーが長時間待機することがあります。
  • カメラアプリからセットアップ フローを開始したユーザーは、Matter のコミッショニングを完了するために QR コードを 2 回スキャンする必要があります。
  • 200 台を超えるデバイスを含む構造では、Discovery API は候補を返さないことがあります。

解決済みの既知の問題

  • ログインしている Google アカウントの切り替えに失敗し、エラーが発生することがあります。
  • Google TV デバイスは、 MediaPlayback トレイトを使用する自動化では動作しない場合があります。
  • Google ハブのみを含む構造の場合:
    • Matter 対応デバイスが Google Home アプリでオフラインと表示されることがあります。
    • Google アシスタントで Matter デバイスを操作できません。
    • スマートディスプレイでは、Matter デバイスを操作したり、Matter デバイスの状態を表示したりすることはできません。
  • 一部のデバイスでは、アプリが必ずしも正確な状態を反映するとは限らず、Google Home アプリなどの Google アプリとは異なる状態を報告する場合があります。これは通常、デバイスが Google に状態を報告していないことが原因です。
    • 回避策: Google アプリで状態を確認すると、不一致が解消されます。

2025-01-14

Home API の初期化に関するガイダンスを更新しました。

Home のインスタンスはコンテキスト シングルトンとして初期化されるべきであることを明確にしました。これにより、アプリのユーザー エクスペリエンスが向上し、無効なセッションによるエラーを回避できます。

2025-01-07

  ホーム API パブリックベータ版リリース  

公開デベロッパー ベータ版では、すべてのデベロッパーがアプリのビルドとテストを開始できます。

このリリースには、バグの修正が含まれており、Google Nest Audio や Google TV デバイスのサポートの改善など、Home APIs Android SDK のベータ版の品質が向上しています。

最小バージョン

  • Google Play サービスの最小バージョン: 24.45.34
  • Google Hub のファームウェアの最小バージョン:
    • キャスト バージョン: 3.74.444798
    • Fuchsia の最小バージョン: 22.20240805.103.161
  • Android SDK: home.android.sdk_202411_EAP_1_0_1_RC00
  • Google Home アプリ（GHA）の最小バージョン: どのバージョンでも動作します
  • androidx.core ライブラリの最小バージョン: 1.10.0
  • Matter バージョン: 1.3.0.0
    • 注: 仮の Matter デバイスタイプとクラスタはサポートされていません。

既知の問題

  • ログインしている Google アカウントの切り替えに失敗し、エラーが発生することがあります。
    • 回避策: 権限フローを再実行するか、アプリを再起動します。
  • Google TV デバイスは、 MediaPlayback トレイトを使用する自動化では動作しない場合があります。
  • Google ハブのみを含む構造の場合:
    • Matter 対応デバイスが Google Home アプリ（GHA）でオフラインと表示されることがあります。
    • Google アシスタントで Matter デバイスを操作できません。
    • スマートディスプレイでは、Matter デバイスを操作したり、Matter デバイスの状態を表示したりすることはできません。
  • 一部のデバイスでは、アプリが正確な状態を常に反映するとは限らず、Google Home アプリ（GHA）などの Google アプリが報告する状態とは異なる状態をアプリが報告することがあります。通常、これはデバイスが Google に状態を報告していないことが原因です。
    • 回避策: Google アプリで状態を確認すると、不一致が解消されます。

解決済みの既知の問題

  • プロセス中にアプリを最小化すると、コミッショニングが失敗することがあります。
  • サーバー側の問題により、自動化で「OK Google」の起動が機能しないことがあります。
  • 構造内に Matter デバイスがない Fuchsia を実行しているハブを使用する場合、ハブが 3 時間以上アイドル状態のままになっていると、最初の Matter デバイスをコミッショニングすると Matter デバイスがオフラインになります。
  • ハブのデータの初期化を行った後、デバイスがオンラインと報告されていても、新たにコミッショニングされたデバイスへのコマンドが失敗することがあります。