Flutter健康数据访问插件health_ios12的使用

Health 插件简介

Health 插件允许从 Apple Health、Google Fit 和 Health Connect 读取和写入健康数据。

注意：Google Fitness API 正在被弃用，该插件将逐步过渡到 Health Connect API。

插件支持的功能：

• 权限管理：通过 hasPermissions、requestAuthorization 和 revokePermissions 方法处理权限。
• 读取健康数据：使用 getHealthDataFromTypes 方法读取健康数据。
• 写入健康数据：使用 writeHealthData 方法写入健康数据。
• 写入运动数据：使用 writeWorkout 方法写入运动数据。
• 写入音频图：在 iOS 上使用 writeAudiogram 方法写入音频图。
• 写入血压数据：使用 writeBloodPressure 方法写入血压数据。
• 获取总步数：使用 getTotalStepsInInterval 方法获取步数。
• 清理重复数据点：使用 removeDuplicates 方法清理重复数据。
• 删除指定类型的数据：使用 delete 方法删除指定时间段内的数据。
• 支持未来的 Android API Health Connect。

注意：对于 Android 用户，目标设备需要安装 Google Fit 或 Health Connect（目前处于测试阶段），并且需要互联网连接，否则该插件无法正常工作。

数据类型

以下为支持的数据类型及其单位：

…

安装与配置

Apple Health (iOS)

第一步：修改 Info.plist

添加以下两个条目以描述健康数据用途：

<key>NSHealthShareUsageDescription</key>
<string>我们需要同步您的数据到 Apple Health 应用以提供更好的洞察。</string>
<key>NSHealthUpdateUsageDescription</key>
<string>我们需要同步您的数据到 Apple Health 应用以提供更好的洞察。</string>

第二步：启用 HealthKit

在 Xcode 中打开项目，并在 Runner 的设置中启用 HealthKit 能力。

Google Fit (Android 选项 1)

按照以下步骤生成 OAuth2 客户端 ID 并添加 SHA1 指纹：

1. 在终端进入密钥库目录：

   cd ~/.android/
   

2. 获取密钥库的 SHA1 指纹：

   keytool -list -v -keystore ~/.android/debug.keystore -alias androiddebugkey -storepass android -keypass android
   

3. 将 SHA1 指纹添加到 OAuth2 凭据中，并生成客户端 ID，例如：

   YOUR_CLIENT_ID.apps.googleusercontent.com
   

Health Connect (Android 选项 2)

在 AndroidManifest.xml 中添加以下内容：

<queries>
    <package android:name="com.google.android.apps.healthdata" />
</queries>

Android 权限

从 Android 9.0 开始，访问某些健身数据（如步数）需要特殊权限。在 AndroidManifest.xml 中添加以下行：

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

对于 Health Connect，还需添加以下权限：

<uses-permission android:name="android.permission.health.READ_HEART_RATE"/>
<uses-permission android:name="android.permission.health.WRITE_HEART_RATE"/>

此外，如果请求运动距离，则需要位置权限：

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

使用 permission_handler 插件提示用户授予这些权限：

await Permission.activityRecognition.request();
await Permission.location.request();

使用示例

以下是一个完整的示例代码，展示如何使用 health_ios12 插件访问健康数据。

import 'dart:async';

import 'package:flutter/material.dart';
import 'package:health_ios12/health.dart';
import 'package:health_example/util.dart';
import 'package:permission_handler/permission_handler.dart';

void main() => runApp(HealthApp());

class HealthApp extends StatefulWidget {
  [@override](/user/override)
  _HealthAppState createState() => _HealthAppState();
}

enum AppState {
  DATA_NOT_FETCHED,
  FETCHING_DATA,
  DATA_READY,
  NO_DATA,
  AUTHORIZED,
  AUTH_NOT_GRANTED,
  DATA_ADDED,
  DATA_DELETED,
  DATA_NOT_ADDED,
  DATA_NOT_DELETED,
  STEPS_READY,
}

class _HealthAppState extends State<HealthApp> {
  List<HealthDataPoint> _healthDataList = [];
  AppState _state = AppState.DATA_NOT_FETCHED;
  int _nofSteps = 0;

  // 定义要获取的数据类型
  static final types = dataTypesAndroid;
  final permissions = types.map((e) => HealthDataAccess.READ_WRITE).toList();

  HealthFactory health = HealthFactory(useHealthConnectIfAvailable: true);

  Future authorize() async {
    await Permission.activityRecognition.request();
    await Permission.location.request();

    bool authorized = false;
    try {
      authorized = await health.requestAuthorization(types, permissions: permissions);
    } catch (error) {
      print("授权异常: $error");
    }
    setState(() => _state = authorized ? AppState.AUTHORIZED : AppState.AUTH_NOT_GRANTED);
  }

  Future fetchData() async {
    setState(() => _state = AppState.FETCHING_DATA);

    final now = DateTime.now();
    final yesterday = now.subtract(Duration(hours: 24));

    _healthDataList.clear();
    try {
      List<HealthDataPoint> healthData = await health.getHealthDataFromTypes(yesterday, now, types);
      _healthDataList.addAll(HealthFactory.removeDuplicates(healthData));
    } catch (error) {
      print("获取数据异常: $error");
    }

    setState(() {
      _state = _healthDataList.isEmpty ? AppState.NO_DATA : AppState.DATA_READY;
    });
  }

  Future addData() async {
    bool success = true;
    final now = DateTime.now();
    final earlier = now.subtract(Duration(minutes: 20));

    success &= await health.writeHealthData(10, HealthDataType.BODY_FAT_PERCENTAGE, earlier, now);
    success &= await health.writeHealthData(1.925, HealthDataType.HEIGHT, earlier, now);
    success &= await health.writeHealthData(90, HealthDataType.WEIGHT, earlier, now);
    success &= await health.writeHealthData(90, HealthDataType.HEART_RATE, earlier, now);
    success &= await health.writeHealthData(90, HealthDataType.STEPS, earlier, now);
    success &= await health.writeHealthData(200, HealthDataType.ACTIVE_ENERGY_BURNED, earlier, now);
    success &= await health.writeHealthData(70, HealthDataType.HEART_RATE, earlier, now);
    success &= await health.writeHealthData(37, HealthDataType.BODY_TEMPERATURE, earlier, now);
    success &= await health.writeBloodOxygen(98, earlier, now, flowRate: 1.0);
    success &= await health.writeHealthData(105, HealthDataType.BLOOD_GLUCOSE, earlier, now);
    success &= await health.writeHealthData(1.8, HealthDataType.WATER, earlier, now);
    success &= await health.writeWorkoutData(
        HealthWorkoutActivityType.AMERICAN_FOOTBALL, earlier, now,
        totalDistance: 2430, totalEnergyBurned: 400);
    success &= await health.writeBloodPressure(90, 80, earlier, now);

    setState(() {
      _state = success ? AppState.DATA_ADDED : AppState.DATA_NOT_ADDED;
    });
  }

  [@override](/user/override)
  Widget build(BuildContext context) {
    return MaterialApp(
      home: Scaffold(
        appBar: AppBar(title: Text('Health Example')),
        body: Column(
          children: [
            ElevatedButton(onPressed: authorize, child: Text('授权')),
            ElevatedButton(onPressed: fetchData, child: Text('获取数据')),
            ElevatedButton(onPressed: addData, child: Text('添加数据')),
            Text('当前状态: $_state'),
          ],
        ),
      ),
    );
  }
}