使用健康服务模拟传感器数据

使用由 Wear OS 上的健康服务生成的合成数据来测试您的应用，就好像运动在进行中一样。

如果您在搭载 Wear OS 4 (API 33) 或 Wear OS 3 (API 30) 的模拟器上进行测试，则可以使用模拟器生成的合成数据。请参阅以下指南，详细了解适用于 Wear OS 3 和 Wear OS 4 的合成数据生成功能之间的区别。

在 Wear OS 4 上使用合成数据

如果您在搭载 Wear OS 4 (API 33) 的模拟器上进行测试，则可以使用模拟器生成的合成数据来测试应用。这针对 Wear OS 3 上合成数据的生成方式引入了多项改进：

使用健康服务传感器面板

Android Studio Koala Feature Drop (Canary) 在 Wear OS 传感器面板上添加了健康服务。该面板可用于模拟设备是否具有特定传感器功能，这在 Wear OS 上构建健身应用时必须进行测试。

您还可以使用该面板更改指标值，并观察应用的调整情况。

如需打开并使用该面板，请执行以下操作：

  1. 创建或打开 Android 虚拟设备 (AVD)，然后在模拟器上运行您的应用。
  2. 在模拟器面板中，选择 Wear Health Services。打开 Wear Health Services 面板：系统会打开 Wear Health Services 面板，其中列出了适用于不同 Android 设备的传感器。

该面板打开后，您可以执行以下操作：

  • 在标准功能、所有功能（默认）或自定义之间切换。选择 Apply 以将当前功能列表发送给模拟设备，然后选择 Reset 将功能列表恢复为其默认的开/关值。
  • 选择触发事件下拉按钮后，触发不同的用户事件。在此处，您可以触发健身活动的自动暂停/恢复、用户触发睡眠事件，以及用户在高尔夫球场或迷你高尔夫球场触发高尔夫球。
  • 在安装在模拟器上的应用中开始一项运动后，替换传感器值。为不同的运动指标输入新值后，选择 Apply 以将这些值与模拟器同步。这对于测试应用如何处理不同运动条件和用户健身倾向非常有用。

使用模拟器生成合成数据

您还可以在不使用传感器面板的情况下运行应用，让模拟器自动生成数据。

使用应用内控件开始、暂停和结束合成数据生成。

另请注意，模拟器会为每个运动生成相同的数据值。

模拟事件

您可以在模拟器中模拟各种事件，如 AUTO_PAUSE_DETECTED。以下命令可用于触发这些事件：

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

合成事件

活动

Key

检测到自动暂停

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

对于高尔夫球拍事件，您应该为“高尔夫球挥杆类型”指定其他参数，如下所述：

高尔夫挥杆类型

参数

秋千推杆类型

推杆推球

部分秋千类型

部分

秋千式

最亮

在指定高尔夫击球事件后添加高尔夫球挥杆类型：

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

这些运动会生成以下数据类型的实际合成数据：

  • 心率
  • 每分钟步数
  • 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 米/秒 20.0 米/分钟 是
执行中 170 bpm 2.3 米/秒 20.0 米/分钟 是
远足 150 bpm 1.3 米/秒 20.0 米/分钟 是
游泳 150 bpm 1.6 米/秒 0.0 米/分钟 是
跑台跑步 160 bpm 2.3 米/秒 20.0 米/分钟 否

停止

如需停止综合活动，请使用以下命令：

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>：心率（每分钟心跳次数）。平均值：70。
  • --ef exercise_options_average_speed <float>：平均速度（米/秒）。还会影响每分钟步数或迈步频率。默认值：0。
  • --ez exercise_options_use_location <boolean>：是否在运动期间发出位置数据（使用默认路线）。默认值：false。
  • --ef exercise_options_max_elevation_rate <float>：可能的最大海拔变化速度（米/分钟）。默认值：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

其他状态和事件

睡眠状态

您还可以为合成用户触发睡眠状态。支持两种状态：睡眠和清醒。

如需进入睡眠状态，请运行以下命令：

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 分钟才能提供跌倒事件数据。