Home APIs Android SDK リリースノート

2025-03-14

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

このリリースでは、バグの修正と、Home APIs Android SDK の一般提供（GA）の品質の向上が行われています。

最小バージョン

  • Google Play 開発者サービスの最低バージョン: 25.06.32
  • Google Hub のファームウェアの最小バージョン:
    • キャスト バージョン: 3.75.456944
    • Fuchsia の最小バージョン: 24.20241009.103.1900601
  • Android SDK: home.android.sdk_202412_EAP_1_2_RC01
  • Google Home アプリの最低バージョン: すべてのバージョンに対応
  • androidx.core ライブラリの最小バージョン: 1.10.0
  • Matter のバージョン: 1.3.0.0
    • 注: 暫定的な Matter デバイスタイプとクラスタはサポートされていません。

新機能

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

既知の問題

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

解決済みの既知の問題

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

2025-01-29

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

このリリースでは、バグの修正と、Home APIs Android SDK の一般提供（GA）の品質の向上が行われています。

最小バージョン

  • 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 の初期化に関するガイダンスを更新しました。

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

2025-01-07

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

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

このリリースでは、バグの修正が行われ、Google Nest Audio デバイスと Google TV デバイスのサポートが強化されるなど、Home APIs Android SDK の一般提供（GA）の品質が向上しています。

最小バージョン

  • 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 ハブのみを含む構造の場合:
    • Google Home アプリ（GHA）に Matter デバイスがオフラインと表示されることがあります。
    • Google アシスタントでは Matter デバイスを操作できません。
    • スマートディスプレイでは、Matter デバイスを操作したり、Matter デバイスの状態を表示したりすることはできません。
  • デバイスによっては、アプリが正確な状態を反映していない場合があります。また、アプリが Google Home アプリ（GHA）などの Google アプリが報告する状態と異なる状態を報告することもあります。これは通常、デバイスが Google に状態を報告していないことが原因です。
    • 回避策: Google アプリでステータスを確認すると、不一致が解消されます。

解決済みの既知の問題

  • プロセス中にアプリが最小化されると、構成が失敗することがあります。
  • サーバーサイドの問題により、自動化で OkGoogle 開始条件が機能しないことがあります。
  • Fuchsia を搭載したハブを使用していて、そのハブのストラクチャに Matter デバイスがない場合、ハブが 3 時間以上アイドル状態になると、最初の Matter デバイスをセットアップすると、その Matter デバイスがオフラインになります。
  • ハブを出荷時の設定にリセットすると、デバイスがオンラインと報告されているにもかかわらず、新しく設定されたデバイスへのコマンドが失敗することがあります。