Flutter插件smfit_fl_plugin的介绍与使用方法

Flutter插件smfit_fl_plugin简介

smfit_fl_plugin 是一个用于与 SMFit 设备进行交互的 Flutter 插件。它允许开发者通过 Flutter 应用程序访问和控制 SMFit 的运动检测功能。

Flutter插件smfit_fl_plugin使用步骤

以下是使用 smfit_fl_plugin 的完整示例代码和说明。

1. 添加依赖

在项目的 pubspec.yaml 文件中添加以下依赖：

dependencies:
  smfit_fl_plugin: ^1.0.0  # 请根据实际版本号替换

然后运行以下命令以安装依赖：

flutter pub get

2. 初始化插件

首先，确保初始化插件并配置密钥。以下是初始化逻辑的代码示例：

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

import 'package:flutter/services.dart';
import 'package:smfit_fl_plugin/smfit_fl_plugin_delegate.dart';
import 'package:smfit_fl_plugin/smfit_fl_plugin.dart';
import 'package:smfit_fl_plugin/smfit_camera_widget.dart';

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

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

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

class _MyAppState extends State<MyApp> implements SMFitFlPluginDelegate {
  bool _didSuccess = false;
  final _smfitFlPlugin = SMFitFlPlugin();

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

  Future<void> initPlatformState() async {
    bool didSuccess;

    // 设置委托以接收运动数据
    _smfitFlPlugin.delegate = this;

    // 在调用任何函数之前，必须先配置密钥
    var result = await _smfitFlPlugin.configSMFit("YOUR_KEY");
    didSuccess = result.$1;

    if (!mounted) return;

    setState(() {
      _didSuccess = didSuccess;
    });
  }
}

3. 配置 UI 和功能按钮

接下来，在应用程序的 UI 中添加功能按钮，例如启动会话、开始检测等。

[@override](/user/override)
Widget build(BuildContext context) {
  return MaterialApp(
    home: Scaffold(
      appBar: AppBar(
        title: const Text('SMFit 示例应用'),
      ),
      body: Center(
        child: Column(
          children: [
          // 显示认证状态
          Text('认证成功: $_didSuccess\n'),

          // 显示摄像头预览
          SizedBox(
            height: 500,
            child: CameraWidget(),
          ),

          // 启动会话按钮
          TextButton(onPressed: startSession, child: const Text("启动会话")),

          // 开始检测按钮
          TextButton(onPressed: startDetection, child: const Text("开始检测")),

          // 停止检测按钮
          TextButton(onPressed: stopDetection, child: const Text("停止检测")),

          // 停止会话按钮
          TextButton(onPressed: stopSession, child: const Text("停止会话"))
        ],
      ),
    ),
  );
}

4. 实现功能逻辑

以下是各个功能的具体实现逻辑：

启动会话

void startSession() async {
  // 调用此函数以启动会话
  String? error = await _smfitFlPlugin.startSession();
  print("启动检测错误: ${error ?? "无"}");
}

开始检测

void startDetection() async {
  // 调用此函数以开始检测
  // 支持的运动选项包括：HighKnees、Burpees 等
  String? error = await _smfitFlPlugin.startDetection("HighKnees");
  print("开始检测错误: ${error ?? "无"}");
}

停止检测

void stopDetection() async {
  var result = await _smfitFlPlugin.stopDetection();
  String? error = result.$1;
  Map<String, Object?> data = result.$2;
  print("停止检测错误: ${error ?? "无"} 数据: $data");
}

停止会话

void stopSession() async {
  var result = await _smfitFlPlugin.stopSession();
  String? error = result.$1;
  Map<String, Object?> data = result.$2;
  print("停止会话错误: ${error ?? "无"} 数据: $data");
}

5. 处理回调事件

插件提供了多个回调函数，用于处理不同的事件，例如运动数据、姿态数据等。

接收运动数据

[@override](/user/override)
void didReceiveMovementData(MovementData movementData) {
  // 每帧都会调用此函数
  print(movementData);
}

接收姿态数据

[@override](/user/override)
void didReceivePoseData(List<PoseData> poseData) {
  // 每帧都会调用此函数
  print(poseData);
}

会话开始和停止回调

[@override](/user/override)
void captureSessionStart() {
  // 当摄像头数据可用时调用
}

[@override](/user/override)
void captureSessionStop() {
  // 当会话停止且摄像头不可用时调用
}

6. 完整示例代码

以下是完整的示例代码：

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

import 'package:flutter/services.dart';
import 'package:smfit_fl_plugin/smfit_fl_plugin_delegate.dart';
import 'package:smfit_fl_plugin/smfit_fl_plugin.dart';
import 'package:smfit_fl_plugin/smfit_camera_widget.dart';

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

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

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

class _MyAppState extends State<MyApp> implements SMFitFlPluginDelegate {
  bool _didSuccess = false;
  final _smfitFlPlugin = SMFitFlPlugin();

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

  Future<void> initPlatformState() async {
    bool didSuccess;

    // 设置委托以接收运动数据
    _smfitFlPlugin.delegate = this;

    // 在调用任何函数之前，必须先配置密钥
    var result = await _smfitFlPlugin.configSMFit("YOUR_KEY");
    didSuccess = result.$1;

    if (!mounted) return;

    setState(() {
      _didSuccess = didSuccess;
    });
  }

  [@override](/user/override)
  Widget build(BuildContext context) {
    return MaterialApp(
      home: Scaffold(
        appBar: AppBar(
          title: const Text('SMFit 示例应用'),
        ),
        body: Center(
          child: Column(
            children: [
              Text('认证成功: $_didSuccess\n'),
              SizedBox(
                height: 500,
                child: CameraWidget(),
              ),
              TextButton(onPressed: startSession, child: const Text("启动会话")),
              TextButton(onPressed: startDetection, child: const Text("开始检测")),
              TextButton(onPressed: stopDetection, child: const Text("停止检测")),
              TextButton(onPressed: stopSession, child: const Text("停止会话"))
            ],
          ),
        ),
      ),
    );
  }

  void startSession() async {
    String? error = await _smfitFlPlugin.startSession();
    print("启动检测错误: ${error ?? "无"}");
  }

  void startDetection() async {
    String? error = await _smfitFlPlugin.startDetection("HighKnees");
    print("开始检测错误: ${error ?? "无"}");
  }

  void stopDetection() async {
    var result = await _smfitFlPlugin.stopDetection();
    String? error = result.$1;
    Map<String, Object?> data = result.$2;
    print("停止检测错误: ${error ?? "无"} 数据: $data");
  }

  void stopSession() async {
    var result = await _smfitFlPlugin.stopSession();
    String? error = result.$1;
    Map<String, Object?> data = result.$2;
    print("停止会话错误: ${error ?? "无"} 数据: $data");
  }

  [@override](/user/override)
  void captureSessionStop() {
    print("会话已停止");
  }

  [@override](/user/override)
  void didReceiveError(String? error) {
    print("错误: $error");
  }

  [@override](/user/override)
  void didReceiveMovementData(MovementData movementData) {
    print("运动数据: $movementData");
  }

  [@override](/user/override)
  void didReceivePoseData(List<PoseData> poseData) {
    print("姿态数据: $poseData");
  }

  [@override](/user/override)
  void captureSessionStart() {
    print("会话已开始");
  }
}