サンプルアプリ
Home API の使用中に問題が発生した場合は、ログを収集してデバッグに役立てることができます。モバイル デバイスからログを収集するには、Android Debug Bridge（adb）が必要です。Google のサポートが必要な場合は、Android デバイスとハブの両方からログを収集し、関連情報とログを添付して問題トラッカーでチケットを開いてください。
Android ログを収集する
adb を含むすべての手順で、モバイル デバイスをローカルマシンに接続する必要があります。
adb をインストールする
まだ設定していない場合は、ローカルマシンに Android Debug Bridge を設定します。
- パソコンに「adb」をインストールします。
- Android スマートフォンで開発者向けオプションと USB デバッグをオンにします。
モバイル デバイス ID を取得する
- モバイル デバイスの ID を取得します。
adb devicesList of devices attached device-id device
- この値を
phoneidという変数に格納します。phoneid=device-id
バージョン情報
ログを収集する際は、設定に関連するすべてのバージョン情報を収集することをおすすめします。Google と問題を共有する必要がある場合は、この操作が必要です。
- さまざまなデバイス情報を変数に保存します。
containerinfo=$(adb -s $phoneid shell dumpsys package com.google.android.gms | grep -m 1 "versionName" || true); ghainfo=$(adb -s $phoneid shell dumpsys package com.google.android.apps.chromecast.app | grep -m 1 "versionName" || true); androidversion=$(adb -s $phoneid shell getprop ro.build.version.release || true); androidapiversion=$(adb -s $phoneid shell getprop ro.build.version.sdk || true); chimeradump=$(adb -s $phoneid shell dumpsys activity provider com.google.android.gms.chimera.container.GmsModuleProvider || true); homemoduleinfo=$(echo "$chimeradump" | grep -w "com.google.android.gms.home" || true); optionalhomemoduleinfo=$(echo "$chimeradump" | grep -w "com.google.android.gms.optional_home" || true); threadinfo=$(echo "$chimeradump" | grep -w "com.google.android.gms.threadnetwork" || true); enabledfeatures=$(echo "$chimeradump" | grep "Enabled features" | grep -i "home" | sort -u || true) - すべての変数を
_versions.txtという名前のファイルに保存します。展開して、変数をファイルに保存するコマンドを表示する
ブロック全体をコピーして、ターミナルに一度に貼り付けることができます。
versionfile="_versions.txt" echo "Saving version info to $versionfile" echo "Container version: $containerinfo" > $versionfile echo "Home Module version: $homemoduleinfo" >> $versionfile echo "Optional Home Module version: $optionalhomemoduleinfo" >> $versionfile echo "Thread Module version: $threadinfo" >> $versionfile echo "GHA version: $ghainfo" >> $versionfile echo "Android version: $androidversion" >> $versionfile echo "Android API version: $androidapiversion" >> $versionfile echo "Found enabled features: $enabledfeatures" >> $versionfile
_versions.txtの内容を確認します。cat _versions.txtこのファイルは、必要に応じてトラブルシューティングのために Google に提供できます。開いてサンプル ファイルの出力を表示する
Container version: versionName=26.26.34 (190400-945364269) Home Module version: com.google.android.gms.home [v262634001] Optional Home Module version: com.google.android.gms.optional_home [262634025] ... Thread Module version: com.google.android.gms.threadnetwork [v262634001] GHA version: versionName=4.22.28.0 Android version: 14 Android API version: 34 Found enabled features: Enabled features: appsearch_impl, brella_dynamite, dck_management...
詳細なデバッグ フラグを有効にする
Android デバイスログを収集したり、バグレポートを実行したりする前に、ロガー バッファサイズを構成し、Google Home コンポーネントと GMS コンポーネントの冗長デバッグタグを有効にします。
# Clear existing device logs and expand logger buffer size
adb -s $phoneid logcat -b all -c
adb -s $phoneid logcat -G 8M
# Enable GMS Service ID verbose flags
adb -s $phoneid shell setprop log.tag.gms_svc_id:168 VERBOSE
adb -s $phoneid shell setprop log.tag.gms_svc_id:304 VERBOSE
adb -s $phoneid shell setprop log.tag.gms_svc_id:305 VERBOSE
adb -s $phoneid shell setprop log.tag.gms_svc_id:319 VERBOSE
adb -s $phoneid shell setprop log.tag.gms_svc_id:336 VERBOSE
adb -s $phoneid shell setprop log.tag.gms_svc_id:360 VERBOSE
# Enable GHP and Matter log tags
adb -s $phoneid shell setprop log.tag.CameraCommissioningPlugin VERBOSE
adb -s $phoneid shell setprop log.tag.HomeSdk VERBOSE
adb -s $phoneid shell setprop log.tag.HomeClient VERBOSE
adb -s $phoneid shell setprop log.tag.InteractionApiChimeraService VERBOSE
adb -s $phoneid shell setprop log.tag.MatterCommissioner VERBOSE
adb -s $phoneid shell setprop log.tag.SampleApp VERBOSEスクリプトで Android ログを収集する
デバッグ セッション中に Android デバイスのライブログをキャプチャするには:
- 詳細なデバッグ フラグを有効にするの手順に沿って、既存のログを消去し、バッファサイズを拡大し、詳細なロギングタグを設定します。
- モバイル デバイスで実行中のすべてのアプリケーションを閉じます。
- テストを開始する前に、既存のログバッファのノイズをクリアします。
adb -s $phoneid logcat -c - ターミナル ウィンドウでログ収集プロセスを開始します。
adb -s $phoneid logcat | tee android-logs_$(date +%Y%m%d%H%M%S).txt - アプリを実行し、問題を再現するために必要なすべてのユーザー インターフェース操作を行います。
- 完了したら、ターミナルで Ctrl+C（Mac の場合は Cmd+C）を押して
logcatプロセスを停止します。 - このセッションのログは
android-logs_YYYYMMDDmmss.txtに保存されます。バグレポートにはandroid-logs_YYYYMMDDmmss.txtと_versions.txtの両方を添付してください。
adb bugreport で Android ログを収集する
システムレベルの問題、クラッシュ ダンプ、低レベルのネットワークと Bluetooth のデバッグに関する詳細な診断情報を共有する必要がある場合は、Android の完全なバグレポートをキャプチャします。
- Matter BLE のコミッショニング: BLE に関する Matter のコミッショニングの問題を報告する場合は、問題を再現する前に、[開発者向けオプション]（[設定] > [開発者向けオプション] > [Bluetooth HCI スヌープログを有効にする]）で [Bluetooth HCI スヌープログ] を有効にします。
- テスト前のセットアップ: テストを実行する前に、詳細なデバッグ フラグを有効にするの手順に沿って、デバイスで詳細なデバッグ プロパティを有効にします。
- バグレポートをキャプチャする: テストを実行して問題を再現したら、次のコマンドを実行して完全なバグレポート アーカイブを生成します。
adb -s $phoneid bugreport ./android-bugreport_$(date +%Y%m%d%H%M%S).zip - 高度なデバッグ情報: 生成された
android-bugreport_YYYYMMDDmmss.zipファイルには、システム全体のダンプ、メモリ統計情報、バッテリー診断、低レベルのサブシステム トレースなど、包括的なシステムレベルの診断データが含まれており、デバッグのためのより高度な情報が提供されます。
キャスト ハブ デバイスのログ
この方法で Google Nest Hub のデバイスログを表示できます。この方法は、次のモデルでサポートされています。
- Google Home
- Google Nest Audio
- Google Nest Hub
- Google Nest Mini
ローカルログの取得用に Cast ハブを有効にするには:
- Android Debug Bridge をセットアップします。
ハブの IP アドレスを取得します。
- ハブに画面がある場合:
- 画面を上から下にスワイプします。
- 設定アイコン をタップします
- デバイスの IP アドレスを確認する: Nest Hub (2nd gen) で、[デバイス情報 > 技術情報 > IP アドレス] に移動します。
- スマートフォンの GHA から:
- デバイスをタップして、デバイスの詳細ページを表示します。
- 設定アイコン をタップして設定ページを開きます。
- デバイスの IP アドレスを確認します。[デバイス情報] > [技術情報] > [IP アドレス] に移動します。
- ハブに画面がある場合:
デバイスと同じ Wi-Fi ネットワークに接続されているパソコンの場合:
adb connect ip-addressadb logcatログを他のユーザーに提供するには、失敗しているオペレーションを実行し、出力をテキスト ファイルにパイプします。
adb logcat -d > platform-logs.txt
自動化
エッジ検出
Google Home エコシステムの自動化には、エッジ検出という機能があります。これは、デバイスの以前の状態を繰り返すだけの状態更新ではなく、実際の状態変化があった場合にのみ開始条件が有効になることを確認するロジックです。
たとえば、ライトをオンにするのが開始条件の場合、エッジ検出は、ライト デバイスがオンからオン（変化なし）ではなく、オフからオンに切り替わった場合にのみ開始条件が有効になることを確認します。
自動化が期待どおりに動作しない
エッジ検出を考慮しても自動化が想定どおりに動作しない場合は、次の手順を行います。
各デバイスをチェックして、自動化とは関係なく正しく機能していることを確認します。
自動化の自動化グラフを確認し、自動化 DSL と比較して、潜在的に誤った前提がないか確認します。
自動化の実行中に Google Home アプリでデバイスの状態を確認します。
自動化で参照されているすべてのデバイスが、想定される構造内に存在することを確認します。自動化が依存しているデバイスを削除すると、意図しない結果が生じる可能性があります。デバイスの削除が自動化に与える影響を参照してください。
自動化が実行されるべきでないときに実行される
自動化が実行されるべきでないときに実行された場合は、開始条件を確認します。状態の変化が 1 回だけキャプチャされ、自動化が 1 回だけトリガーされるように、追加のロジックが必要になる場合があります。
自動化がコンパイルされない
アプリに、さまざまなノードタイプに対応する各クラスや参照しているトレイトなど、必要なインポートがすべて含まれていることを確認します。
自動化の作成が検証に失敗する
自動化の作成が検証に合格しない場合、警告またはエラー メッセージに問題に関する情報が表示されます。詳細については、ValidationIssueType リファレンスをご覧ください。
リスト関数が例外をスローする
Automation API の List 関数を呼び出すと、API 機能がないため、読み取りハンドラが例外をスローすることがあります。この問題を軽減するには、影響を受ける自動化を削除します。
手順は次のとおりです。
adbがインストールされていることを確認します。adb をインストールするをご覧ください。次のコマンドを実行して、Android ログから自動化の ID を取得します。
adb logcat -s GhpNativeログの例:
adb logcat -s GhpNative level:debug | grep -A 10 -B 10 AutomationManagerTrait\.ListResponse INTERACTION RESPONSE -> SendCommandsResponse: 1 { 1: "automation@global" 3 { 1: "home.internal.traits.automation.AutomationManagerTrait.ListResponse" 2: 5 { 1: "type.googleapis.com/home.internal.traits.automation.AutomationManagerTrait.ListResponse" 1 { 1: "1111-2222-3333-44444-55555" // Automation ID to delete 2: "structure@2222-3333-4444-5555-6666" ...複数の自動化 ID を削除する必要がある場合は、ターミナル ページャを使用して出力を制御できます。
adb logcat -s GhpNative level:debug | less自動化の ID を使用して自動化を削除します。
structure.deleteAutomation(new object : HasId(id = "1111-2222-3333-44444-55555"))
Discovery API は、特性が登録解除されると警告を記録します
Discovery API が Trait not found の警告をログに記録した場合、これは API がディスカバリ候補のトレイトを使用しようとしているが、初期化中にトレイトが登録されていないため、成功しないことを意味します。次に例を示します。
09-03 17:45:20.578 10646 10646 W AutomationSdk: trait_id: "home.matter.6006.clusters.fc43" and Exception occurred com.google.home.HomeException: 18: Trait not found: home.matter.6006.clusters.fc43
09-03 17:45:20.578 10646 10646 W AutomationSdk: While converting candidate: # com.google.home.platform.traits.AutomationCandidateNode@76f0b582
特性識別子は home.matter.6006.clusters.fc43 で、RelativeHumidityControl に対応します。ID から特性名を判断するには、特性インデックスをご覧ください。
この例から、RelativeHumidityControl はアプリの初期化時に登録する必要があります。トレイトをレジストリに追加するには、トレイトの登録を参照してください。
OAuth
既存の OAuth クライアントがある場合
公開済みアプリの OAuth クライアントがすでに確認済みの場合は、既存の OAuth クライアントを使用して Home API をテストできます。
Home API のテストと使用に Google Home Developer Console の登録は必要ありません。ただし、別の統合で OAuth クライアントが確認済みの場合でも、アプリを公開するには承認済みの Developer Console 登録が必要です。
次のことに注意してください。
既存の OAuth クライアントを使用する場合、ユーザー数の上限は 100 人です。テストユーザーの追加については、OAuth 同意画面を設定します。 OAuth の確認とは別に、アプリに権限を付与できるユーザーの数は、Home APIs によって 100 人に制限されています。この制限は、Developer Console の登録が完了すると解除されます。
Developer Console登録 は、Home API でアプリを更新する準備として、OAuth を介してデバイスタイプの権限付与を制限する準備が整ったときに、承認のために送信する必要があります。
OAuth 検証が保留中の Google Cloud アプリの場合、検証が完了するまでユーザーは OAuth フローを完了できません。権限を付与しようとすると、次のエラーが発生します。
Access blocked: <Project Name> has not completed the Google verification process.