ヘルスサービスでセンサーデータをシミュレートする

Wear OS のヘルスサービスから生成された合成データを使用して、次のようにアプリをテストする 実践しました。

Wear OS 3(API レベル 30)以降を搭載しているエミュレータでテストする場合は、 エミュレータによって生成された合成データを使用できます。以下を参照してください。 の合成データ生成の違いについて詳しくは、このモジュールの Wear OS 3 以降。

Wear OS 4 以降で合成データを使用する

Wear OS 4(API レベル 33)以降を搭載しているエミュレータでテストする場合は、 エミュレータによって生成された合成データを使用してアプリをテストできます。この では、Google Cloud での合成データの生成方法に 以前のバージョンの Wear OS:

で確認できます。

ヘルスサービス センサーパネルを使用する

Android Studio Koala Feature Drop(Canary)には、 Wear OS センサーパネルのヘルスサービス。このパネルを使用して 特定のセンサー機能が搭載されているかどうか Wear OS でフィットネス アプリを作成する際にテストできます。

また、このパネルを使用して指標の値を変更し、 調整できます。

パネルを開いて使用するには、次の操作を行います。

  1. Android Virtual Device(AVD)を作成または開く エミュレータでアプリを実行します。
  2. エミュレータ パネルで [Wear ヘルスサービス] を選択します。 Wear ヘルスサービス パネルを開く [Wear ヘルスサービス] パネル すると、さまざまな環境で使用可能なセンサーのリストが表示されます。 Android デバイス。

パネルが開いたら、次の操作を行うことができます。

  • 標準機能、 [すべての機能](デフォルト)または [カスタム]。[適用] を選択して、 エミュレートされたデバイスに現在の機能リストを追加し、[Reset] を選択して、 機能のリストをデフォルトのオンオフ値に戻します。
  • [トリガー イベント] を選択して、さまざまなユーザー イベントをトリガーする 選択します。ここから、フィットネスの自動一時停止/再開をトリガーできます。 アクティビティ、ユーザーによる睡眠イベントをトリガーするゴルフショットをトリガーする ゴルフの場を求めるとします
  • インストールされたアプリでエクササイズを開始した後にセンサー値をオーバーライドする ダウンロードします。エクササイズの指標ごとに新しい値を入力すると、 [Apply] を選択して、これらの値をエミュレータと同期します。これは アプリがさまざまな運動状態やユーザーのフィットネス 学習します

エミュレータで合成データを生成する

また、センサーパネルなしでアプリを実行し、データを 自動的に生成されます。

アプリ内コントロールを使用して、合成データの生成を開始、一時停止、終了します。

また、エミュレータはエクササイズごとに同じデータ値を生成します。

イベントをシミュレートする

エミュレータで、AUTO_PAUSE_DETECTED などのさまざまなイベントをシミュレートできます。 これらのイベントをトリガーするには、次のコマンドを使用します。

adb shell am broadcast -a "whs.event-key" com.google.android.wearable.healthservices

合成イベント

イベント

キー

自動一時停止が検出されました

whs.AUTO_PAUSE_DETECTED

自動再開が検出されました

whs.AUTO_RESUME_DETECTED

転倒検出

whs.FALL_OVER

睡眠を検出

whs.START_SLEEPING

睡眠/停止の検出

whs.STOP_SLEEPING

ゴルフショットが検出されました

whs.GOLF_SHOT

たとえば、自動一時停止イベントをトリガーするには、次のコマンドを使用します。

​​adb shell am broadcast -a "whs.AUTO_PAUSE_DETECTED" com.google.android.wearable.healthservices

ゴルフのショット イベントでは、ゴルフのショットのスイングタイプ、 その概要を以下に示します。

ゴルフショットのスイングタイプ

パラメータ

パットの種類

パット

部分スイングタイプ

一部

スイングフルタイプ

100%

ゴルフショット イベントを指定してから、ゴルフショットのスイング タイプを追加します。

adb shell am broadcast -a "whs.GOLF_SHOT" --es golf_shot_swing_type \
  "golf-swing-type-parameter" com.google.android.wearable.healthservices

たとえば、次のコマンドは部分的なゴルフショットをトリガーします。

adb shell am broadcast -a "whs.GOLF_SHOT" --es golf_shot_swing_type "partial" \
  com.google.android.wearable.healthservices

Wear OS 3 で合成データを使用する

Wear OS 3 を搭載したエミュレータでテストする場合は、合成を使用して アプリをテストします。

合成データ生成を有効にする

Wear OS 3 で合成データの生成を有効にするには、次の手順を行います。

  1. 開発者向けオプションを有効にします。
  2. 次の adb コマンドを実行して、合成モードを有効にします。

    adb shell am broadcast \
    -a "whs.USE_SYNTHETIC_PROVIDERS" \
    com.google.android.wearable.healthservices
    

合成データの生成を有効にしたら、ここで説明するコマンドを発行します。 「合成ユーザー」の動作を制御します。

合成データ生成を無効にする

実際のセンサーを使用するように戻すには、次のコマンドを実行します。

adb shell am broadcast \
-a "whs.USE_SENSOR_PROVIDERS" \
com.google.android.wearable.healthservices

合成エクササイズ

ヘルスサービスは次のエクササイズの種類をサポートしています。

  • ウォーキング: whs.synthetic.user.START_WALKING
  • ランニング: whs.synthetic.user.START_RUNNING
  • ハイキング: whs.synthetic.user.START_HIKING
  • 水泳: whs.synthetic.user.START_SWIMMING
  • トレッドミル ランニング: whs.synthetic.user.START_RUNNING_TREADMILL

エクササイズでは、次のデータ型について現実的な合成データが生成されます。

  • 心拍数
  • 1 分あたりの歩数
  • GPS 位置情報(単一のデフォルト ルートを使用)
  • アクティビティの期間
  • 高度と階数

さらに、以下の状態を生成できます。

  • 睡眠状態 - 睡眠または覚醒
  • 転倒検出

開始する

エクササイズのシミュレーションを開始するには、com.google.android.wearable.healthservices に対して適切なブロードキャストを発行します。

# start the "walking" synthetic exercise
$ adb shell am broadcast \
-a "whs.synthetic.user.START_WALKING" \
com.google.android.wearable.healthservices

各アクティビティには、サポートされている指標のプリセットがあります。

アクティビティ 心拍数 平均速度 高度の変化 位置情報の使用
ウォーキング 120 bpm 1.4 m/sec 20.0 m/min
ランニング 170 bpm 2.3 m/sec 20.0 m/min
ハイキング 150 bpm 1.3 m/sec 20.0 m/min
水泳 150 bpm 1.6 m/sec 0.0 m/min
トレッドミル ランニング 160 bpm 2.3 m/sec 20.0 m/min ×

停止する

合成アクティビティを停止するには、次のコマンドを使用します。

adb shell am broadcast \
-a "whs.synthetic.user.STOP_EXERCISE" \
com.google.android.wearable.healthservices

カスタム

生成される指標をきめ細かく制御するには、アクション文字列 whs.synthetic.user.START_EXERCISE を使用してカスタム エクササイズ アクティビティを開始します。以下のフラグを自由に組み合わせて指定できます。

  • --ei exercise_options_duration_secs <int>: エクササイズの継続期間(秒)。デフォルト: 0
  • --ei exercise_options_heart_rate <int>: 1 分あたりの心拍数。平均: 70
  • --ef exercise_options_average_speed <float>: 平均速度(メートル/秒)。これは 1 分あたりの歩数(ケイデンス)にも影響します。デフォルト: 0
  • --ez exercise_options_use_location <boolean>: エクササイズ中に位置情報を出力するかどうか(デフォルト ルートを使用)。デフォルト: false
  • --ef exercise_options_max_elevation_rate <float>: 1 分あたりの最大高度変化率(メートル/分)。デフォルト: 0

たとえば、エクササイズ オプションを次のように設定します。

adb shell am broadcast \
-a "whs.synthetic.user.START_EXERCISE" \
--ei exercise_options_heart_rate 90 \
--ef exercise_options_average_speed 1.2 \
--ez exercise_options_use_location true \
com.google.android.wearable.healthservices

実際のハードウェアまたはエミュレートしたハードウェアが特定のデータ型をサポートしているかどうかにかかわらず、使用可能なデータ型を変更することもできます。たとえば、次のスニペットに示すように、絶対高度を有効または無効にできます。

# enable synthetic mode and enable absolute elevation
$ adb shell am broadcast \
-a "whs.CONFIGURE_SYNTHETIC_DEVICE" \
--ez absolute_elevation true \
com.google.android.wearable.healthservices

# enable synthetic mode and disable absolute elevation
$ adb shell am broadcast \
-a "whs.CONFIGURE_SYNTHETIC_DEVICE" \
--ez absolute_elevation false \
com.google.android.wearable.healthservices

その他の状態とイベント

睡眠状態

合成ユーザーの睡眠状態をトリガーすることもできます。睡眠と覚醒の 2 つの状態がサポートされています。

睡眠状態に入るには、次のコマンドを実行します。

adb shell am broadcast \
-a "whs.synthetic.user.START_SLEEPING" \
com.google.android.wearable.healthservices

覚醒状態に入るには、次のコマンドを実行します。

adb shell am broadcast \
-a "whs.synthetic.user.STOP_SLEEPING" \
com.google.android.wearable.healthservices

転倒検出

転倒をシミュレートするには、次のコマンドを実行します。

adb shell am broadcast \
-a "whs.synthetic.user.FALL_OVER" \
com.google.android.wearable.healthservices

ヘルスサービスが転倒イベントを送信するまでに最大 1 分かかる場合があります。