Home APIs Android SDK リリースノート

2026-02-09

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

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

最小バージョン

  • Google Play 開発者サービス: 26.02.34
  • Google ハブのファームウェアの最小バージョン:
    • キャスト:
      • Google Nest Wifi Pro: 3.76.508025
      • その他のすべての Cast ベースのハブ: 3.77.510748
    • Fuchsia: 29.20251023.103.2100
    • Google TV Streamer、4K: UTTK.250729.004
  • Android SDK: home.android.sdk_GHP_1_7
  • Google Home アプリ: 1.7
  • androidx.core ライブラリ: 任意のバージョンで動作します
  • Matter バージョン: 1.4.1.0。1.5.0 の試験運用版のサポート付き。

新機能

  • Permissions API
    • 権限クエリを使用すると、ユーザーがアクセスを許可したデバイスの種類をアプリで確認できます。

    • その他の重要な変更

    解決済みの既知の問題

    • History API は常に nextPageToken を返すため、無限ループが発生します。
    • 新しいアカウントにログインしようとすると、「User cancelled Permission flow」エラーが発生します。

    既知の問題

    • Google Nest Cam Indoor/Outdoor（バッテリー式または電源直結型）と Google Nest Doorbell（バッテリー式、第 2 世代）の場合、[バッテリー設定] に [バッテリー残量] オプションが表示されません。
    • チャイムの長さの設定は無視されます。
    • Philips BLE ライトが、実際にはオフラインであるにもかかわらず「オンライン」と誤って表示される。
      • 回避策: スマートホーム デバイスタイプ（SHDT）のオンライン ステータスのみに依存しないでください。代わりに、LOCAL_SYNC ソースのデバイスには Target Device State Service（TDSS）マップを使用します。

    2025-12-22

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

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

    最小バージョン

    • Google Play 開発者サービス: 25.47.30
    • Google ハブのファームウェアの最小バージョン:
      • キャスト:
        • Google Nest Wifi Pro: 3.75.479819
        • その他のすべての Cast ベースのハブ: 3.77.505721
      • Fuchsia: 28.20250723.103.2100300
      • Google TV Streamer、4K: UTTK.250729.004
    • Android SDK: home.android.sdk_GHP_1_6
    • Google Home アプリ: 1.6
    • androidx.core ライブラリ: 任意のバージョンで動作します
    • Matter バージョン: 1.4.1.0

    新機能

    • Automation API
      • 天気特性のサポート

        自動化の開始条件と条件で天気特性のサポートを追加しました。天気に基づくスターターをご覧ください。

    • デバイス API
      • カメラとドアホンのデバイス機能のサポートの拡大:
        • 新しい設定:
          • ナイトビジョン機能のオン/オフ。
          • ステータス LED の明るさ。
          • カメラのビューポート。
          • 画像の向き。
          • 復帰感度。
          • 最長アクティビティ時間。
          • チャイムの音。

          詳しくは、Android 向けカメラ デバイス ガイドをご覧ください。

    • 接続
      • アプリから開始される Google ログイン。アプリが HomeClient を Google アカウント情報で初期化して、UX フローを合理化し、アプリを実行しているユーザーを確認する必要をなくします。

      • ハブレスモード

        ユーザーは、スタンドアロンのハブなしで特定の Matter デバイスをオンボーディングして操作できるようになりました。

    • Structure API
    • Android サンプルアプリ
      • カメラとドアホンの設定
        • マイクのオン/オフ。
        • 録音のオン/オフ。
      • 事前定義された自動化
      • 扇風機とスピーカーのデバイスタイプのサポートを追加しました。
    • アプリを起点とする Google ログイン。

    既知の問題

    • デバイス コントロールが長時間使用後に動作しなくなる。
      • 回避策: ハブを再起動します。
    • Matter デバイスのコミッショニングが失敗することがあります。
    • Android 用サンプルアプリで新しいアカウントを追加しようとすると、「User cancelled Permission flow」エラーが表示される。
      • 回避策: Android デバイスの設定で Google アカウントを追加します。
    • Android Home APIs SDK を使用してコミッショニングされた Walmart onn 有線セキュリティ カメラは、Google Home アプリでライブ配信できません。

    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
      • Hub activation API を使用すると、Google Home Hub をプログラムで検出して有効にできます。Android の Hub 起動 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 分後には、デバイスを操作できるようになります。
    • ユーザーがプリセットまたは色温度選択ツールから色を選択した後、拡張カラーライトが色を更新できない。

    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 秒以上待ってから再試行します。

    解決済みの既知の問題

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

    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 アーティファクトを更新しました。

    既知の問題

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

    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 Home の住所を変更するを参照してください）。
    • 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）で家の場所が設定されていない場合、自動化の作成時に Google Home アプリが FailedPreconditionException でクラッシュします（設定方法については、Google Home の住所を変更するを参照）。

    • 回避策: 自動化を作成する前に、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 ハブのみを含む構造の場合:
      • Google Home アプリで Matter 対応デバイスがオフラインと表示されることがあります。
      • 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 デバイスがオフラインになります。
    • ハブでデータの初期化を行った後、デバイスがオンラインと報告されていても、新たにコミッショニングされたデバイスへのコマンドが失敗することがあります。