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 アプリでステータスを確認すると、不一致が解消されます。
解決済みの既知の問題
- プロセス中にアプリが最小化されると、構成が失敗することがあります。
- 回避策: アプリで Commissioning API を使用している場合は、
suppressHalfSheetNotification()
API を使用してハーフシート通知を抑制します。
- 回避策: アプリで Commissioning API を使用している場合は、
- サーバーサイドの問題により、自動化で OkGoogle 開始条件が機能しないことがあります。
- Fuchsia を搭載したハブを使用していて、そのハブのストラクチャに Matter デバイスがない場合、ハブが 3 時間以上アイドル状態になると、最初の Matter デバイスをセットアップすると、その Matter デバイスがオフラインになります。
- ハブを出荷時の設定にリセットすると、デバイスがオンラインと報告されているにもかかわらず、新しく設定されたデバイスへのコマンドが失敗することがあります。