Flutter集成Spike平台插件spike_flutter_sdk的使用

Flutter集成Spike平台插件spike_flutter_sdk的使用

示例代码

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

// Your API credentials
const authToken = '{YOUR_AUTH_TOKEN}';
const appId = '{YOUR_APP_ID}';
const customerEndUserId = '{YOUR_CUSTOMER_END_USER_ID}';

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

class MyApp extends StatefulWidget {
  const MyApp({super.key});

  @override
  State<MyApp> createState() => _MyAppState();
}

class _MyAppState extends State<MyApp> {
  SpikeConnection? _connection;
  SpikeHeartData? _lastData;

  @override
  void initState() {
    super.initState();
  }

  @override
  Widget build(BuildContext context) {
    return MaterialApp(
      home: Scaffold(
        appBar: AppBar(
          title: const Text('Health Kit Api'),
        ),
        body: SingleChildScrollView(
          child: Column(
            crossAxisAlignment: CrossAxisAlignment.start,
            children: [
              const Text(
                'Actions',
                style: TextStyle(
                  fontSize: 16.0,
                  fontWeight: FontWeight.bold,
                ),
              ),
              const Divider(),
              SingleChildScrollView(
                scrollDirection: Axis.horizontal,
                child: IntrinsicHeight(
                  child: Row(
                    mainAxisAlignment: MainAxisAlignment.spaceBetween,
                    children: [
                      TextButton(
                        onPressed: _createConnection,
                        child: const Text('Create connection'),
                      ),
                      const VerticalDivider(),
                      TextButton(
                        onPressed: _readData,
                        child: const Text('Read data'),
                      ),
                    ],
                  ),
                ),
              ),
              const Divider(),
              const Text(
                'Authorization data',
                style: TextStyle(
                  fontSize: 16.0,
                  fontWeight: FontWeight.bold,
                ),
              ),
              const Divider(),
              Row(
                mainAxisAlignment: MainAxisAlignment.spaceBetween,
                children: [
                  const Text(
                    'Authorized',
                    style: TextStyle(
                      fontWeight: FontWeight.bold,
                    ),
                  ),
                  Text(_connection != null ? 'Yes' : 'No'),
                ],
              ),
              Row(
                mainAxisAlignment: MainAxisAlignment.spaceBetween,
                children: [
                  const Text(
                    'Integration user ID',
                    style: TextStyle(
                      fontWeight: FontWeight.bold,
                    ),
                  ),
                  Text(_connection?.customerEndUserId ?? 'Not integrated, yet'),
                ],
              ),
              const Divider(),
              const Text(
                'Activity data',
                style: TextStyle(
                  fontSize: 16.0,
                  fontWeight: FontWeight.bold,
                ),
              ),
              const Divider(),
              if (_lastData?.entries?.isEmpty == true)
                const Text('No heart data read.'),
              if (_lastData?.entries != null)
                ..._lastData!.entries!
                    .map((record) =&gt; _getHeartDataCard(record)),
              const Divider(),
              const Text(
                'Last send data response',
                style: TextStyle(
                  fontSize: 16.0,
                  fontWeight: FontWeight.bold,
                ),
              ),
              const Divider(),
            ],
          ),
        ),
      ),
    );
  }

  Widget _getHeartDataCard(SpikeHeartDataEntry data) {
    return Container(
      color: Colors.amber,
      margin: const EdgeInsets.all(4.0),
      child: Column(
        crossAxisAlignment: CrossAxisAlignment.start,
        children: [
          Row(
            mainAxisAlignment: MainAxisAlignment.spaceBetween,
            children: [
              const Text(
                'Date',
                style: TextStyle(
                  fontWeight: FontWeight.bold,
                ),
              ),
              Text(data.date ?? 'Unset'),
            ],
          ),
          Row(
            mainAxisAlignment: MainAxisAlignment.spaceBetween,
            children: [
              const Text(
                'Average HR',
                style: TextStyle(
                  fontWeight: FontWeight.bold,
                ),
              ),
              Text(data.averageHeartRate.toString()),
            ],
          ),
        ],
      ),
    );
  }

  Future&lt;void&gt; _createConnection() async {
    _connection = await SpikeSDK.createConnection(
      appId: appId,
      authToken: authToken,
      customerEndUserId: customerEndUserId,
    );

    await _connection!.ensurePermissionsAreGranted(
      types: [SpikeDataType.heart],
    );

    setState(() {});
  }

  Future&lt;void&gt; _readData() async {
    if (_connection == null) {
      return;
    }

    final data = await _connection!.extractData(SpikeDataType.heart);
    _lastData = data;

    setState(() {});
  }
}

解释

1

• 初始化：首先，获取正确的凭证以使用此包。在示例中，我们假设您已经获得了这些凭证。

• 创建连接：使用收到的凭证创建连接。这可以通过以下方式完成：

  final connection = await SpikeSDK.createConnection(
    appId: appId,
    authToken: authToken,
    customerEndUserId: customerEndUserId,
  );
  

• 请求权限：为了正确使用连接，必须首先请求所需的权限。例如，如果您想获取心率数据，则需要请求心率数据权限：

  connection.ensurePermissionsAreGrantedV2(types: [SpikeDataType.heart]);
  

• 读取数据：使用连接读取数据。以下是两种情况的示例：

  final data = await connection.extractData(SpikeDataType.heart);
  

• 配置背景交付（仅限WebHook连接和iOS）：在您的项目“Signing & Capabilities”部分启用Background Delivery for HealthKit。在每个应用启动时调用Spike.configure()方法触发背景交付任务。将Spike初始化代码添加到ios/Runner/AppDelegate.swift文件中。代码应如下所示：

  import UIKit
  import Flutter
  import SpikeSDK
  
  @UIApplicationMain
  @objc class AppDelegate: FlutterAppDelegate {
    override func application(
      _ application: UIApplication,
      didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]?
    ) -> Bool {
      GeneratedPluginRegistrant.register(with: self)
      Spike.configure()
  
      return super.application(application, didFinishLaunchingWithOptions: launchOptions)
    }
  }
  

• 检查背景交付类型：有时您可能想要检查连接注册了哪些类型的背景交付。您可以使用以下示例接收背景交付类型的列表：

  final types = await connection.getBackgroundDeliveryTypes();
  

• 获取Spike End User ID：使用以下代码：

  final result = await connection.getSpikeEndUserId();