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

使用 Wear OS 上由健康服务生成的合成数据来测试应用，就像真正运动过一样。

如果您在搭载 Wear OS 3（API 级别 30）或更高版本的模拟器上进行测试，则可以使用模拟器生成的合成数据。请参阅以下指南，详细了解 Wear OS 3 及更高版本在合成数据生成方面的差异。

注意： 本指南不介绍扩展模拟器控件。扩展模拟器控件与 Wear OS 4 或更高版本的健康服务数据生成功能不兼容。

在 Wear OS 4 及更高版本上使用合成数据

如果您在搭载 Wear OS 4（API 级别 33）或更高版本的模拟器上进行测试，可以使用模拟器生成的合成数据来测试应用。与在较低版本的 Wear OS 上生成合成数据的方式相比，这引入了多项改进：

• Wear OS 4 及更高版本上的合成数据生成功能与健康服务 API 生命周期集成在一起。这意味着，无需使用 adb 命令即可开始或停止练习。不过，您可以像用户一样在应用内开始或停止锻炼。

• 扩大了对锻炼事件的支持：您可以模拟接收自动暂停和恢复事件、跌倒事件、睡眠检测和高尔夫击球检测。

注意： 此方法仅适用于模拟器，不能用于在搭载 Wear OS 4 或更高版本的实体设备上进行测试。如需使用这些功能，您必须将模拟器升级到支持 Wear OS 4 或更高版本的版本。

使用健康服务传感器面板

Android Studio Koala 功能更新 (Canary) 包含 Wear OS 健康服务传感器面板。该面板可用于模拟设备是否具有特定传感器功能，这对于在 Wear OS 上构建健身应用时进行测试非常重要。

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

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

1. 创建或打开 Android 虚拟设备 (AVD)，然后在模拟器上运行应用。
2. 在模拟器面板中，选择 Wear 健康服务。 系统会打开 Wear 健康服务面板，其中会显示不同 Android 设备上可用的传感器列表。

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

• 在标准功能和所有功能（默认）之间切换，以选择在下次锻炼期间启用的功能集。您可以通过选中复选框来启用或停用各项功能。选择 Apply 可将当前功能列表发送到模拟设备，选择 Reset 可将功能列表恢复为默认的开启/关闭值。
• 选择触发事件下拉按钮后，触发不同的用户事件。在此处，您可以触发健身活动的自动暂停/恢复、触发用户睡眠事件，以及触发用户在高尔夫球场或迷你高尔夫球场上的高尔夫击球。
• 在模拟器上安装的应用中开始锻炼后，替换传感器值。为不同的锻炼指标输入新值后，选择应用以将这些值与模拟器同步。这有助于测试应用在不同锻炼条件和用户健身倾向下的表现。

使用模拟器生成合成数据

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

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

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

模拟事件

您可以在模拟器中模拟各种事件，例如 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

对于高尔夫击球事件，您应指定高尔夫击球挥杆类型的其他参数，如下表所示：

表 1：事件及其键

高尔夫击球挥杆类型	参数
挥杆推杆类型	推杆推球
Swing 部分类型	部分
Swing Full 类型	全面

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

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