后台监控数据

被动数据更新适用于需要在后台监控健康服务数据的应用。它们适用于持续数小时、数天甚至更长时间的用例。如果您需要在应用未运行且用户未明确参与运动时存储或处理健康数据，请使用健康服务的被动客户端。

有关被动数据用法的示例，请参阅 GitHub 上的 被动数据 和 被动目标 示例。

添加依赖项

要添加对健康服务的依赖项，您必须将 Google Maven 存储库添加到您的项目中。有关更多信息，请参阅 Google 的 Maven 存储库。

在您的模块级 build.gradle 文件中，添加以下依赖项

Groovy

dependencies {
    implementation "androidx.health:health-services-client:1.1.0-alpha04"
}

Kotlin

dependencies {
    implementation("androidx.health:health-services-client:1.1.0-alpha04")
}

检查功能

在注册数据更新之前，请检查设备是否可以提供您的应用所需的数据类型。检查功能使您能够启用或禁用某些功能，或修改应用的 UI 以补偿不可用的功能。

val healthClient = HealthServices.getClient(this /*context*/)
val passiveMonitoringClient = healthClient.passiveMonitoringClient
lifecycleScope.launchWhenCreated {
    val capabilities = passiveMonitoringClient.capabilities.await()
    // Supported types for passive data collection
    supportsHeartRate =
        DataType.HEART_RATE_BPM in capabilities.supportedDataTypesPassiveMonitoring
    // Supported types for PassiveGoals
    supportsStepsGoal =
        DataType.STEPS_DAILY in capabilities.supportedDataTypesPassiveGoals
}

注册被动数据

您可以通过服务、回调或两者兼而接收被动数据。服务允许您的应用在没有应用的任何部分在前台可见时在后台接收数据。当您在后台接收数据时，数据会分批次传递。回调接收数据的速度稍快，但仅在应用正在运行且回调已成功通知时才有效。

无论您使用哪种方法，首先创建一个PassiveListenerConfig，用于确定要接收的数据类型，如下例所示

val passiveListenerConfig = PassiveListenerConfig.builder()
    .setDataTypes(setOf(DataType.HEART_RATE_BPM))
    .build()

要使用回调接收数据，请定义并注册回调，如下例所示

val passiveListenerCallback: PassiveListenerCallback = object : PassiveListenerCallback {
    override fun onNewDataPointsReceived(dataPoints: DataPointContainer) {
        // TODO: Do something with dataPoints
    }
}

passiveMonitoringClient.setPassiveListenerCallback(
    passiveListenerConfig,
    passiveListenerCallback
)

// To remove the listener
passiveMonitoringClient.clearPassiveListenerCallbackAsync()

使用服务类似，但不是创建从PassiveListenerCallback派生的类，而是从PassiveListenerService派生，如下例所示

class PassiveDataService : PassiveListenerService() {
    override fun onNewDataPointsReceived(dataPoints: DataPointContainer) {
        // TODO: Do something with dataPoints
    }
}

passiveMonitoringClient.setPassiveListenerServiceAsync(
    PassiveDataService::class.java,
    passiveListenerConfig
)

接下来，在您的AndroidManifest.xml文件中声明服务。需要 Health Services 权限，以确保只有 Health Services 才能绑定到该服务

<service android:name=".PassiveDataService"
    android:permission="com.google.android.wearable.healthservices.permission.PASSIVE_DATA_BINDING"
    android:exported="true" />

解释时间

您从 Health Services 收到的数据是分批的，因此您可能在同一批次中收到不同类型的数据点或同一类型的多个数据点。使用这些对象中包含的时间戳，而不是应用接收它们的时间，来确定事件的正确顺序。

通过首先计算启动时间戳来获取每个DataPoint的时间戳，如下例所示

val bootInstant =
    Instant.ofEpochMilli(System.currentTimeMillis() - SystemClock.elapsedRealtime())

然后，可以将此值传递给getStartInstant()或getEndInstant()。

重启后恢复注册

被动数据注册不会在重启后持久化。要在设备重启后接收数据，请使用侦听ACTION_BOOT_COMPLETED系统广播的BroadcastReceiver重新创建您的注册。

在接收器中，不要尝试直接恢复注册。相反，将此功能委托给WorkManager工作器。当设备启动时，Health Services 可能需要 10 秒或更长时间才能确认被动数据注册请求，这可能超过BroadcastReceiver允许的执行时间。相比之下，WorkManager工作器具有10 分钟的执行限制。

以下代码片段显示了BroadcastReceiver可能是什么样子

class StartupReceiver : BroadcastReceiver() {

   override fun onReceive(context: Context, intent: Intent) {
       if (intent.action != Intent.ACTION_BOOT_COMPLETED) return


       // TODO: Check permissions first
       WorkManager.getInstance(context).enqueue(
           OneTimeWorkRequestBuilder<RegisterForPassiveDataWorker>().build()
       )
   }
}

class RegisterForPassiveDataWorker(
   private val appContext: Context,
   workerParams: WorkerParameters
) : Worker(appContext, workerParams) {

   override fun doWork(): Result {
       runBlocking {
           HealthServices.getClient(appContext)
                .passiveMonitoringClient
                .setPassiveListenerCallback(...)
       }
       return Result.success()
   }
}

要安排系统在设备启动时执行此代码，请对AndroidManifest.xml文件进行两次更改。

首先，将以下权限作为<manifest>的子元素添加

<uses-permission android:name="android.permission.RECEIVE_BOOT_COMPLETED" />

其次，将以下接收器意图过滤器作为<application>的子元素添加

<receiver
    android:name=".StartupReceiver"
    android:exported="true">
    <intent-filter>
        <action android:name="android.intent.action.BOOT_COMPLETED" />
    </intent-filter>
</receiver>

活动状态

被动客户端还可以提供有关用户状态的高级信息，例如用户是否正在睡觉。要接收这些更新，请按照以下步骤操作

  1. 请求ACTIVITY_RECOGNITION权限。
  2. 在PassiveListenerConfig构建器中调用setShouldUserActivityInfoBeRequested(true)。

覆盖回调或服务中的onUserActivityInfoReceived()方法，并使用返回的UserActivityInfo，如下例所示

override fun onUserActivityInfoReceived(info: UserActivityInfo) {
    val stateChangeTime: Instant = info.stateChangeTime // may be in the past!
    val userActivityState: UserActivityState = info.userActivityState
    if (userActivityState == UserActivityState.USER_ACTIVITY_ASLEEP) {
        // ...
    }
}

被动目标

您可以配置被动客户端，以便在达到被动目标时通知应用，例如用户一天内完成 10,000 步。

为此，请创建一个目标，如下例所示

val dailyStepsGoal by lazy {
    val condition = DataTypeCondition(
        dataType = DataType.STEPS_DAILY,
        threshold = 10_000, // Trigger every 10000 steps
        comparisonType = ComparisonType.GREATER_THAN_OR_EQUAL
    )
    PassiveGoal(condition)
}

将此目标添加到您的PassiveListenerConfig中，如下例所示

val passiveListenerConfig = PassiveListenerConfig.builder()
    .setDailyGoals(setOf(dailyStepsGoal))
    .build()

覆盖回调或服务中的onGoalCompleted()方法，并使用返回的PassiveGoal，如下例所示

override fun onGoalCompleted(goal: PassiveGoal) {
    when (goal.dataTypeCondition.dataType) {
        DataType.STEPS_DAILY -> {
            // ...
        }
    }
}