Home APIs Android SDK リリースノート

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 ハブのファームウェアの最小バージョン:
    • Cast: 3.76.486931
    • Fuchsia: 27.20250422.103.3600
  • Android SDK: home.android.sdk_1_4_0
  • Google Home アプリ: どのバージョンでも動作します
  • androidx.core ライブラリ: 任意のバージョンで動作します
  • Matter バージョン: 1.4.0.0

新機能

既知の問題

  • スマートフォンからログアウトして再度ログインすると、Home APIs アプリでデバイスを操作できなくなる。
    • 回避策: アプリを閉じるかバックグラウンドで実行し、10 秒以上待ってから再試行します。

解決済みの既知の問題

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

2025-07-08

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

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

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

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

最小バージョン

  • Google Play 開発者サービス: 25.19.32
  • Google ハブのファームウェアの最小バージョン:
    • Cast: 3.75.468222
    • Fuchsia: 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 APIs Android SDK のベータ版の品質の向上が含まれています。

最小バージョン

  • Google Play 開発者サービス: 25.16.33
  • Google ハブのファームウェアの最小バージョン:
    • Cast: 3.75.468222
    • Fuchsia: 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）で家の位置情報が設定されていない場合、自動化の作成時に FailedPreconditionException で Google Home アプリがクラッシュします（設定方法については、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
    • Fuchsia: 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 APIs 公開ベータ版リリース 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

  Home APIs の一般提供版のリリース  

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

このリリースには、バグの修正が含まれており、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 デバイスがオフラインになります。
  • ハブでデータの初期化を行うと、デバイスがオンラインと報告されていても、新たにコミッショニングされたデバイスへのコマンドが失敗することがあります。