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

Terra Flutter Apple Healthkit

该（非官方）插件集成了一个与Terra的Apple SDK交互的桥接器和接口。这使开发者能够构建React Native应用程序，并将用户的Apple Healthkit连接到Terra生态系统。

安装

首先，安装插件：

dart pub add terra_apple_health

使用方法

你可以参考/example文件夹中的示例来了解如何使用。首先导入插件并创建一个实例：

import 'package:terra_apple_health/terra_apple_health.dart';

...

final terra = TerraAppleHealth(
    // 注意：传递你自己的API密钥和开发ID
    "terraTestDevID",
    "terraTestingAPIKey",
    autoFetch: true
);

在向用户展示小部件会话后，如果确定他们希望使用Apple Health进行认证，可以调用TerraApple.auth，这将对用户进行Terra认证并返回一个Future：

final authResult = await terra.auth();
if (authResult['terra_id'] != null) {
    // 获取响应映射中的userID或状态
}

一旦有了用户ID，就可以通过使用TerraApple.initTerra将设备SDK实例连接到Terra：

terra.initTerra(userId: authResult['terra_id']);

initTerra 将设备连接到Terra。每次用户打开应用时都需要执行此操作（如果SDK未初始化，则无法指示其连接到Terra）。另一方面，auth 仅在首次从您的应用连接用户时需要（在此之后，任何对auth的调用都将返回为该设备生成的相同用户ID）。

如果设置了autoFetch为true，当用户打开应用时，每8小时将数据发送到您的webhook。

活动数据会在用户打开应用时发送到您的webhook。你也可以通过调用getter请求数据发送到您的webhook：

terra.getBody(
   DateTime(2022, 01, 02),
   DateTime.now()
);
terra.getDaily(
  DateTime(2022, 01, 02),
   DateTime.now()
);
terra.getSleep(
  DateTime(2022, 01, 02),
   DateTime.now()
);
terra.getActivity(
  DateTime(2022, 01, 02),
   DateTime.now()
);

最后，你可以使用deauth()函数和调用Terra deauth API取消用户的认证：

terra.deauth();

完整示例代码

以下是完整的示例代码：

import 'package:flutter/material.dart';
import 'package:terra_apple_health/terra_apple_health.dart';
import 'package:terra_apple_health_example/secrets.dart';

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

class MyApp extends StatefulWidget {
  const MyApp({Key? key}) : super(key: key);

  [@override](/user/override)
  State<MyApp> createState() => _MyAppState();
}

class _MyAppState extends State<MyApp> {
  [@override](/user/override)
  void initState() {
    super.initState();
  }

  [@override](/user/override)
  Widget build(BuildContext context) {
    return MaterialApp(
      home: Scaffold(
        floatingActionButton: FloatingActionButton(
            child: const Icon(Icons.medical_services),
            onPressed: () async {
              final terra = TerraAppleHealth(
                // 注意：传递你自己的API密钥和开发ID
                terraTestDevID,
                terraTestingAPIKey,
              );
              final authResult = await terra.auth();
              if (authResult['terra_id'] != null) {
                terra
                    .initTerra(userId: authResult['terra_id'])
                    .then((resultMap) {
                  // 发送示例数据到webhook
                  terra.getDaily(
                      DateTime.now().subtract(const Duration(days: 1)),
                      DateTime.now().add(const Duration(days: 1)));
                });
              }
            }),
        appBar: AppBar(
          title: const Text('Terra Plugin Demo'),
        ),
        body: const Center(
          child: Text('点击按钮以连接'),
        ),
      ),
    );
  }
}