Flutter极地相关功能插件polar的使用

Polar 插件概述

polar 是一个用于集成 Polar SDK 的Flutter插件包装器。通过这个插件，开发者可以在Flutter应用中实现与Polar设备（如心率带、运动手表等）的蓝牙连接和数据交互。

注意：这是一个非官方的Polar SDK包装器。有关底层SDK或Polar设备的一般问题，请参阅官方仓库。

开始使用

Android 配置

在 android/app/src/main/AndroidManifest.xml 文件中添加以下权限：

<uses-permission android:name="android.permission.BLUETOOTH_SCAN" android:usesPermissionFlags="neverForLocation" />
<uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" android:maxSdkVersion="30" />
<uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION" android:maxSdkVersion="30" />

• 如果您使用 BLUETOOTH_SCAN 来确定位置，请移除 android:usesPermissionFlags="neverForLocation"。
• 如果您的应用程序使用位置服务，请从位置权限标签中移除 android:maxSdkVersion="30"。

iOS 配置

1. 在Xcode中将部署目标更改为iOS 14+。

2. 修改 Podfile 文件以确保最低支持版本为iOS 14：

   platform :ios, '14.0'
   

3. 更新 Info.plist 文件，添加必要的隐私描述和后台模式：

   <key>NSBluetoothAlwaysUsageDescription</key>
   <string>用于连接到Polar设备</string>
   <key>NSBluetoothPeripheralUsageDescription</key>
   <string>用于连接到Polar设备</string>
   <key>UIBackgroundModes</key>
   <array>
     <string>bluetooth-central</string>
   </array>
   

使用示例

下面是一个完整的Dart代码示例，展示了如何在Flutter项目中使用polar插件来连接Polar设备并接收实时数据流。

import 'package:flutter/material.dart';
import 'package:polar/polar.dart';
import 'package:uuid/uuid.dart';

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

/// 示例应用
class MyApp extends StatefulWidget {
  const MyApp({super.key});

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

class _MyAppState extends State<MyApp> {
  static const identifier = '1C709B20'; // 替换为您自己的设备ID

  final polar = Polar();
  final logs = ['服务已启动'];

  PolarExerciseEntry? exerciseEntry;

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

    // 监听电池电量变化
    polar.batteryLevel.listen((e) => log('电池电量: ${e.level}'));
    // 监听设备连接状态
    polar.deviceConnecting.listen((_) => log('设备正在连接'));
    polar.deviceConnected.listen((_) => log('设备已连接'));
    polar.deviceDisconnected.listen((_) => log('设备已断开连接'));
  }

  @override
  Widget build(BuildContext context) {
    return MaterialApp(
      home: Scaffold(
        appBar: AppBar(
          title: const Text('Polar 示例应用'),
          actions: [
            PopupMenuButton(
              itemBuilder: (context) => RecordingAction.values
                  .map((e) => PopupMenuItem(value: e, child: Text(e.name)))
                  .toList(),
              onSelected: handleRecordingAction,
              child: const IconButton(
                icon: Icon(Icons.fiber_manual_record),
                disabledColor: Colors.white,
                onPressed: null,
              ),
            ),
            IconButton(
              icon: const Icon(Icons.stop),
              onPressed: () {
                log('断开设备连接: $identifier');
                polar.disconnectFromDevice(identifier);
              },
            ),
            IconButton(
              icon: const Icon(Icons.play_arrow),
              onPressed: () async {
                log('连接到设备: $identifier');
                await polar.connectToDevice(identifier);
                await streamWhenReady();
              },
            ),
          ],
        ),
        body: ListView(
          padding: const EdgeInsets.all(10),
          shrinkWrap: true,
          children: logs.reversed.map(Text.new).toList(),
        ),
      ),
    );
  }

  Future<void> streamWhenReady() async {
    await polar.sdkFeatureReady.firstWhere(
      (e) =>
          e.identifier == identifier &&
          e.feature == PolarSdkFeature.onlineStreaming,
    );

    final availableTypes = await polar.getAvailableOnlineStreamDataTypes(identifier);

    debugPrint('可用类型: $availableTypes');

    if (availableTypes.contains(PolarDataType.hr)) {
      polar.startHrStreaming(identifier).listen((event) {
        log('心率: ${event.samples.map((e) => e.hr)}');
      });
    }
    if (availableTypes.contains(PolarDataType.ecg)) {
      polar.startEcgStreaming(identifier).listen((event) {
        log('ECG 数据已接收');
      });
    }
    if (availableTypes.contains(PolarDataType.acc)) {
      polar.startAccStreaming(identifier).listen((event) {
        log('加速度计数据已接收');
      });
    }
  }

  void log(String log) {
    debugPrint(log);
    setState(() {
      logs.add(log);
    });
  }

  Future<void> handleRecordingAction(RecordingAction action) async {
    switch (action) {
      case RecordingAction.start:
        log('开始记录');
        await polar.startRecording(
          identifier,
          exerciseId: const Uuid().v4(),
          interval: RecordingInterval.interval_1s,
          sampleType: SampleType.rr,
        );
        log('记录已开始');
        break;
      case RecordingAction.stop:
        log('停止记录');
        await polar.stopRecording(identifier);
        log('记录已停止');
        break;
      case RecordingAction.status:
        log('获取记录状态');
        final status = await polar.requestRecordingStatus(identifier);
        log('记录状态: $status');
        break;
      case RecordingAction.list:
        log('列出所有记录');
        final entries = await polar.listExercises(identifier);
        log('记录列表: $entries');
        exerciseEntry = entries.first;
        break;
      case RecordingAction.fetch:
        log('获取记录');
        if (exerciseEntry == null) {
          log('尚未列出练习。请先调用list方法');
          await handleRecordingAction(RecordingAction.list);
        }
        final entry = await polar.fetchExercise(identifier, exerciseEntry!);
        log('获取到的记录: $entry');
        break;
      case RecordingAction.remove:
        log('移除记录');
        if (exerciseEntry == null) {
          log('没有可移除的练习。请先调用list方法');
          return;
        }
        await polar.removeExercise(identifier, exerciseEntry!);
        log('记录已移除');
        break;
    }
  }
}

enum RecordingAction {
  start,
  stop,
  status,
  list,
  fetch,
  remove,
}

此示例包括了一个简单的用户界面，允许用户连接到指定的Polar设备，并根据设备支持的功能（如心率、ECG、加速度计等）接收相应的数据流。此外，还实现了对训练数据的录制、查询和管理功能。您可以根据实际需求调整这些功能。

希望这份指南能帮助您更好地理解和使用polar插件！如果有任何问题或需要进一步的帮助，请随时提问。