Flutter健康监测插件healthy_ios的使用

Flutter健康监测插件healthy_ios的使用

介绍

healthy_ios 是一个小型封装库，用于在 HealthKit 上进行样本和统计查询。它受到 CACHET 的 health 库的启发。

使用方法

1. 在 pubspec.yaml 中添加 healthy_ios。
2. 在 plist.info 文件中添加以下条目：

<key>NSHealthShareUsageDescription</key>
<string>请说明你需要这个权限的原因。</string>
<key>NSHealthUpdateUsageDescription</key>
<string>请说明你需要这个权限的原因。</string>

1. 在 Xcode 中打开你的项目，并将 “HealthKit” 添加为功能。

设置完成后的操作

现在你可以实例化一个 HealthStore 对象：

final store = HealthStore();

在查询数据之前，请确保通过调用以下方法请求用户的权限：

final stepType = HKQuantityType.StepCount.identifier();
final permissionsGranted = await store.requestTypes([stepType]);

现在你可以查询样本。如果你查询的是数量类型，需要提供类型和单位的元组。这里有一个扩展函数可以使用：

final now = DateTime.now();
final samples = await store.getHealthSamplesForQuantityType(
  start: now.subtract(Duration(days: 2)), // 查询过去两天的数据
  end: now,
  types: [ 
    // 手动构造元组
    HKQuantityTypeUnitTuple(HKQuantityType.StepCount, 'count'),
    // 使用扩展函数
    HKQuantityType.HeartRate.withUnit('count/min'),
  ]);

如果你查询的是类别类型，则不需要传递单位，因此结果值属性包含子类型的枚举值。

获取统计数据也很容易。你还需要传递一个间隔时间（用于累积统计数据）和一个锚定日期（用于确定间隔的起始点）。目前，StatisticsInterval 只能处理天、小时和分钟间隔。

final now = DateTime.now();
final start = DateTime(now.year, now.month, now.day, 0, 0);
final samples = await store.getHealthStatisticsForType(
  start: start,
  end: now,
  interval: StatisticsInterval(hour: 1), // 每小时间隔
  anchor: start,
  types: [
    HKQuantityType.StepCount.withUnit('count'),
  ]);

生成的统计数据对象有四个值字段（sum, avg, min, max）。如果 HKQuantityType 是累计类型，只有 sum 字段会有值。如果是离散类型，avg, min 和 max 字段都会有值。

额外信息

• 关于有效单位，请参阅相关文档。

支持的数据类型

定量类型：

• ActiveEnergyBurned
• BasalEnergyBurned
• BloodGlucose
• OxygenSaturation
• BloodPressureDiastolic
• BloodPressureSystolic
• BodyFatPercentage
• BodyMassIndex
• BodyTemperature
• HeartRate
• Height
• RestingHeartRate
• StepCount
• WaistCircumference
• WalkingHeartRateAverage
• BodyMass
• FlightsClimbed
• DistanceWalkingRunning
• DietaryWater
• HeartRateVariabilitySDNN
• EnvironmentalAudioExposure
• HeadphoneAudioExposure

类别类型：

• MindfulSession
• SleepAnalysis

完整示例 Demo

import 'package:flutter/material.dart';
import 'package:healthy_ios/healthy_ios.dart';

void main() {
  runApp(MyApp());
}

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

class _MyAppState extends State<MyApp> {
  var isLoading = false;
  var _result = '';
  final store = HealthStore();

  [@override](/user/override)
  void initState() {
    super.initState();
  }

  // 获取分类样本
  void _fetchCategoricalSamples() async {
    final types = [HKCategoryType.SleepAnalysis, HKCategoryType.MindfulSession];
    final granted = await store.requestTypes(types.map((e) => e.identifier));

    setState(() {
      isLoading = true;
    });

    try {
      if (granted) {
        final now = DateTime.now();
        final samples = await store.getHealthSamplesForCategroyType(
            start: now.subtract(Duration(days: 5)), end: now, types: types);
        setState(() {
          _result = samples.map((e) => e.toString()).join('\n');
        });
      }
    } on HealthyException catch (e) {
      setState(() {
        _result = e.code;
      });
    } finally {
      setState(() {
        isLoading = false;
      });
    }
  }

  // 获取数量样本
  void _fetchQuantitySamples() async {
    final types = [HKQuantityType.StepCount, HKQuantityType.ActiveEnergyBurned]
        .map((e) => e.identifier);
    final granted = await store.requestTypes(types);

    setState(() {
      isLoading = true;
    });

    try {
      if (granted) {
        final now = DateTime.now();
        final samples = await store.getHealthSamplesForQuantityType(
            start: now.subtract(Duration(days: 2)),
            end: now,
            types: [
              HKQuantityTypeUnitTuple(HKQuantityType.StepCount, 'count'),
            ]);

        setState(() {
          _result = samples.map((e) => e.toString()).join('\n');
        });
      }
    } on HealthyException catch (e) {
      setState(() {
        _result = e.code;
      });
    } finally {
      setState(() {
        isLoading = false;
      });
    }
  }

  // 获取统计数据
  void _fetchStatisticalData() async {
    final types = [HKQuantityType.StepCount, HKQuantityType.HeartRate]
        .map((e) => e.identifier);
    final granted = await store.requestTypes(types);

    setState(() {
      isLoading = true;
    });

    try {
      if (granted) {
        final now = DateTime.now();
        final start = DateTime(now.year, now.month, now.day, 0, 0);
        final samples = await store.getHealthStatisticsForType(
          start: start,
          end: now,
          interval: StatisticsInterval(hour: 1),
          anchor: start,
          types: [
            HKQuantityType.StepCount.withUnit('count'),
            HKQuantityType.HeartRate.withUnit('count/min'),
          ],
        );

        setState(() {
          _result = samples.map((e) => e.toString()).join('\n');
        });
      }
    } on HealthyException catch (e) {
      setState(() {
        _result = e.code;
      });
    } finally {
      setState(() {
        isLoading = false;
      });
    }
  }

  [@override](/user/override)
  Widget build(BuildContext context) {
    return MaterialApp(
      home: Scaffold(
        appBar: AppBar(
          title: const Text('插件示例应用'),
        ),
        body: isLoading
            ? const CircularProgressIndicator()
            : Center(
                child: SingleChildScrollView(
                    child: Column(
                  mainAxisSize: MainAxisSize.min,
                  mainAxisAlignment: MainAxisAlignment.start,
                  crossAxisAlignment: CrossAxisAlignment.start,
                  children: [
                    Row(
                      mainAxisAlignment: MainAxisAlignment.spaceEvenly,
                      children: [
                        ElevatedButton(
                            onPressed: _fetchQuantitySamples,
                            child: Text('样本')),
                        ElevatedButton(
                            onPressed: _fetchCategoricalSamples,
                            child: Text('分类')),
                        ElevatedButton(
                            onPressed: _fetchStatisticalData,
                            child: Text('统计')),
                      ],
                    ),
                    Text(_result),
                  ],
                )),
              ),
      ),
    );
  }
}