Home APIs Android SDK リリースノート

2026-05-01

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

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

最小バージョン

新機能

  • サーモスタット トレイトで読み取り/更新、オン/オフ、タイマー機能がサポートされるようになりました

解決済みの既知の問題

  • Matter デバイスのコミッショニングが失敗することがあります。
  • Philips BLE ライトの状態が正しく表示されない。
  • レイテンシにより、ネットワークが不安定になり、応答時間が遅くなる。

既知の問題

  • Google TV Streamer（4K）を使用して一部のデバイスをコミッショニングできない。
  • ハブが Google Nest Wifi Pro、Google Nest Hub、Google Nest Hub Max の場合、Google Home アプリにはマルチパート デバイスが複数のタイルとして表示されます。

2026-04-10

Home APIs 1.8 リリースに合わせて、Home APIs Android サンプルアプリが更新されました。

サンプルアプリ

2026-04-09

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

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

最小バージョン

  • Google Play 開発者サービス: 26.12.32
  • Google Hub ファームウェア、Cast、Google Nest Wifi Pro: 3.78.518349
  • Google ハブ ファームウェア、Cast、その他の Cast ベースのハブ: 3.78.526062
  • Google Hub ファームウェア、Fuchsia: 29.20251023.103.2101601
  • Google ハブ ファームウェア、Google TV Streamer、4K: UTTK.250729.004
  • Android SDK: home.android.sdk_GHP_1_8_0
  • Google Home アプリ: どのバージョンでも動作します。
  • androidx.core ライブラリ: どのバージョンでも動作します。
  • Matter バージョン: 1.4.1.0
  • Matter バージョン: 1.5.0 の試験運用サポート

新機能

解決済みの既知の問題

  • Google Nest Learning Thermostat（第 4 世代）の温度単位（摂氏/華氏）を変更できない。
  • ウェブ版 Google Home のモバイル版では、上部のアイコンと戻るボタンがヘッダーで隠れてしまいます。ユーザーが戻ったり、重要なユーザー インターフェース要素を確認したりできない場合があります。
  • Android TV ハブで、Matter デバイスが「オフライン」と誤って報告されることがあります。

既知の問題

  • Matter デバイスのコミッショニングが失敗することがあります。

2026-03-13

  Home APIs パブリック ベータ版リリース 1.7.1  

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

最小バージョン

  • Google Play 開発者サービス:
  • Google Hub ファームウェア、Cast、Google Nest Wifi Pro: 3.78.518349
  • Google Hub ファームウェア、Cast、その他の Cast ベースのハブ: 3.78.516526
  • Google Hub ファームウェア、Fuchsia: 29.20251023.103.2201
  • Google ハブ ファームウェア、Google TV Streamer、4K: UTTK.250729.004
  • Android SDK: home.android.sdk_GHP_1_7_1
  • Google Home アプリ: 1.7.1
  • androidx.core ライブラリ: どのバージョンでも動作します。
  • Matter バージョン: 1.4.1.0
  • Matter バージョン: 1.5.0 の試験運用サポート

新機能

その他の重要な変更

  • ハブレス モードが削除されました。

サンプルアプリ

解決済みの既知の問題

  • Google Nest Cam Indoor/Outdoor（バッテリー式または電源直結型）と Google Nest Doorbell（バッテリー式、第 2 世代）では、[バッテリー設定] に [バッテリー残量] オプションが表示されません。
  • チャイムの長さの設定は無視されます。
  • Philips BLE ライトが、デバイスが実際にはオフラインであるにもかかわらず「オンライン」と誤って表示される。

既知の問題

  • Google Nest Learning Thermostat（第 4 世代）の温度単位（摂氏/華氏）を変更できない。
  • ネットワークの安定性とデバイスの応答性が遅れる可能性があります。
  • Google Home For Web のモバイル版では、上部のアイコンと戻るボタンがヘッダーで隠れてしまいます。ユーザーが戻ったり、重要なユーザー インターフェース要素を確認したりできない場合があります。
  • フェデレーション モードの OOBE 後に、ハブが [接続中...] の状態のままになることがあります。
  • Matter デバイスのコミッショニングが失敗することがあります。
  • Android TV ハブで、Matter デバイスがオフラインと誤って報告されることがあります。
  • [Current Camera Device Software version] に正しいソフトウェア バージョンが表示されないことがあります。
  • サーモスタットの UI スライダーに範囲外の温度が表示されます。
  • チャイムの継続時間を設定すると、指定した時間の間、デバイスはチャイムを鳴らしません。

2026-02-13

Home APIs Android サンプルアプリが Home APIs 1.7 リリース用に更新されました。

サンプルアプリ

2026-02-09

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

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

最小バージョン

  • Google Play 開発者サービス: 26.02.34
  • Google Hub ファームウェア、Google Cast、Google Nest Wifi Pro: 3.76.508025
  • Google Hub ファームウェア、Google Cast、その他の Google Cast ベースのハブ: 3.77.510748
  • Google Hub ファームウェア、Fuchsia: 29.20251023.103.2100
  • Google ハブ ファームウェア、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
  • Matter バージョン: 1.5.0 の試験運用サポート

新機能

その他の重要な変更

解決済みの既知の問題

  • 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 Hub ファームウェア、キャスト、Google Nest Wifi Pro: 3.75.479819
  • Google Hub ファームウェア、Cast、その他の Cast ベースのハブ: 3.77.505721
  • Google ハブのファームウェア、Fuchsia: 28.20250723.103.2100300
  • Google ハブ ファームウェア、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

新機能

その他の重要な変更

  • Android サンプルアプリに、カメラ設定、事前定義された自動化、扇風機とスピーカーのサポートが追加されました。

既知の問題

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

2025-10-23

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

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

最小バージョン

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

新機能

その他の重要な変更

  • Android サンプルアプリに、ドアホン デバイスタイプ（オン / オフ、ライブ配信、双方向通話）のサポートと Hub Activation API の実装を追加しました。

解決済みの既知の問題

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

2025-09-26

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

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

最小バージョン

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

新機能

その他の重要な変更

  • Android サンプルアプリに、カメラ、マルチ管理者コミッショニング、事前定義された OnOff 自動化のサポートが追加されました。

解決済みの既知の問題

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

既知の問題

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

2025-08-29

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

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

最小バージョン

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

新機能

解決済みの既知の問題

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

既知の問題

  • 現在アクティブなハブを強制的に削除すると、5 分間は一部のデバイスを操作できなくなります。5 分後、デバイスを操作できるようになります。

2025-07-31

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

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

最小バージョン

  • Google Play 開発者サービス: 25.28.34
  • Google Hub ファームウェア、Cast: 3.76.486931
  • Google ハブのファームウェア、Fuchsia: 27.20250422.103.3600
  • Android SDK: home.android.sdk_1_4_0
  • Google Home アプリ: どのバージョンでも動作します。
  • androidx.core ライブラリ: どのバージョンでも動作します。
  • Matter バージョン: 1.4.0.0

新機能

その他の重要な変更

  • Android サンプルアプリで、Matter 専用デバイスの削除、デバイス名の変更、非推奨の API 呼び出しの置き換えが行われました。

解決済みの既知の問題

  • ドッキングされた掃除機デバイスは、ドッキング状態を登録しません。

既知の問題

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

2025-06-26

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

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

最小バージョン

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

新機能

  • SDK アーティファクトが、Home APIs SDK フレームワーク（play-services-home-17.0.0.aar）と SDK トレイトとデバイスタイプ（play-services-home-types-17.0.0.aar）の 2 つの別々のアーティファクトに分割されました。このリリース以降、デベロッパーはプロジェクトのコンパイル時とランタイムのライブラリ パスに両方のアーティファクトを含める必要があります。

その他の重要な変更

  • Android サンプルアプリの追加: ユーザーがアプリから接続を解除し、権限を取り消せるようになりました。
  • Android サンプルアプリの追加: play-services-home-17.0.0 と play-services-home-types-17.0.0 を含むように SDK アーティファクトを更新しました。

既知の問題

  • ドッキングされた掃除機デバイスは、ドッキング状態を登録しません。

2025-06-05

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

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

最小バージョン

  • Google Play 開発者サービス: 25.19.32
  • Google Hub ファームウェア、Cast: 3.75.468222
  • Google ハブのファームウェア、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 サンプルアプリで、[自動化を作成] ボタンをタップしても、トリガーされないことがあります。

2025-05-12

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

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

最小バージョン

  • Google Play 開発者サービス: 25.16.33
  • Google Hub ファームウェア、Cast: 3.75.468222
  • Google ハブのファームウェア、Fuchsia: 26.20250116.103.2201
  • Android SDK: home.android.sdk_202504_EAP_1_3_RC00
  • Google Home アプリ: どのバージョンでも動作します。
  • androidx.core ライブラリ: どのバージョンでも動作します。
  • Matter バージョン: 1.4.0.0

新機能

解決済みの既知の問題

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