Flutter集成Kinestex SDK插件kinestex_sdk_flutter的使用

精确运动跟踪和分析SDK

保持领先——Kinestex AI运动跟踪

可用集成选项

集成选项

配置

权限

AndroidManifest.xml

在<manifest>标签内添加以下权限：

<!-- 添加此行 -->
<uses-permission android:name="android.permission.CAMERA" />
<uses-permission android:name="android.permission.INTERNET"/>
<uses-feature android:name="android.hardware.camera" android:required="false" />

Info.plist

添加以下键用于相机和麦克风使用：

<key>NSCameraUsageDescription</key>
<string>请授予相机访问权限以开始AI锻炼</string>

安装库

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

dependencies:
   kinestex_sdk_flutter: @latest
   permission_handler: ^11.3.1

使用

初始设置

1. 前提条件：确保已在AndroidManifest.xml和Info.plist中添加了必要的权限。
2. 启动视图：初始化必要的小部件，检查并请求相机权限再启动Kinestex。

在你的Podfile中添加以下内容：

post_install do |installer|
  installer.pods_project.targets.each do |target|
    flutter_additional_ios_build_settings(target)

    target.build_configurations.each do |config|
      # 可以在这里删除未使用的权限
      # 更多信息：https://github.com/BaseflowIT/flutter-permission-handler/blob/master/permission_handler/ios/Classes/PermissionHandlerEnums.h
      # 例如，如果不需要相机权限，只需添加 'PERMISSION_CAMERA=0'
      config.build_settings['GCC_PREPROCESSOR_DEFINITIONS'] ||= [
        '$(inherited)',
        ## dart: PermissionGroup.camera
        'PERMISSION_CAMERA=1',
      ]
    end
  end
end

请求相机权限后再启动Kinestex：

void _checkCameraPermission() async {
   if (await Permission.camera.request() != PermissionStatus.granted) {
      _showCameraAccessDeniedAlert();
   }
}

void _showCameraAccessDeniedAlert() {
   showDialog(
      context: context,
      builder: (BuildContext context) {
         return AlertDialog(
            title: const Text("相机权限被拒绝"),
            content: const Text("相机访问权限对于应用正常运行是必需的。"),
            actions: <Widget>[
               TextButton(
                  child: const Text("确定"),
                  onPressed: () {
                     Navigator.of(context).pop();
                  },
               ),
            ],
         );
      },
   );
}

集成选项

集成步骤

1. 识别适合你需求的集成选项。
2. 创建一个处理来自Kinestex SDK消息的消息处理函数：

ValueNotifier<bool> showKinesteX = ValueNotifier<bool>(false);

void handleWebViewMessage(WebViewMessage message) {
  if (message is ExitKinestex) {
    // 处理ExitKinestex消息
    setState(() {
      showKinesteX.value = false;
    });
  }  else {
    // 处理其他消息类型
    print("收到其他消息: ${message.data}");
  }
}

1. 自定义并显示每个集成选项：

主要集成选项

可用的计划分类

显示主视图：

KinesteXAIFramework.createMainView(
  apiKey: apiKey,
  companyName: company,
  isShowKinestex: showKinesteX,
  userId: userId,
  planCategory: PlanCategory.Cardio,  // 计划类别
  data: <String, dynamic>{ 'isHideHeaderMain': false }, // 可选自定义参数
  isLoading: ValueNotifier<bool>(false),
  onMessageReceived: (message) {
    handleWebViewMessage(message);
  },
);

计划集成选项

KinesteXAIFramework.createPlanView(
  apiKey: apiKey,
  companyName: company,
  userId: userId,
  isShowKinestex: showKinesteX,
  planName: "Circuit Training", // 指定计划名称
  isLoading: ValueNotifier<bool>(false),
  onMessageReceived: (message) {
    handleWebViewMessage(message);
  }
);

锻炼集成选项

KinesteXAIFramework.createWorkoutView(
      apiKey: apiKey,
      isShowKinestex: showKinesteX,
      companyName: company,
      userId: userId,
      workoutName: "Fitness Lite", // 指定锻炼名称
      isLoading: ValueNotifier<bool>(false),
      onMessageReceived: (message) {
        handleWebViewMessage(message);
      }
);

挑战集成选项

KinesteXAIFramework.createChallengeView(
    apiKey: apiKey,
    companyName: company,
    isShowKinestex: showKinesteX,
    userId: userId,
    exercise: "Squats", // 练习标题
    countdown: 100,
    isLoading: ValueNotifier<bool>(false),
    onMessageReceived: (message) {
      handleWebViewMessage(message);
    }
);

体验集成选项

KinesteXAIFramework.createExperienceView(
    apiKey: apiKey,
    companyName: company,
    isShowKinestex: showKinesteX,
    userId: userId,
    experience: "box",
    isLoading: ValueNotifier<bool>(false),
    onMessageReceived: (message) {
    handleWebViewMessage(message);
  }
);

相机集成选项

1. 显示KinestexSDK:

ValueListenableBuilder<String?>(
  valueListenable: updateExercise,
  builder: (context, value, _) {
    return KinesteXAIFramework.createCameraComponent(
      apiKey: apiKey,
      companyName: company,
      isShowKinestex: showKinesteX,
      userId: userId,
      exercises: ["Squats", "Jumping Jack"],
      currentExercise: "Squats",
      updatedExercise: value,
      isLoading: ValueNotifier<bool>(false),
      onMessageReceived: (message) {
        handleWebViewMessage(message);
      },
    );
  },
),

1. 更新当前练习通过更改通知器的值:

updateExercise.value = 'Jumping Jack';

1. 处理用户完成的重复次数和错误消息:

ValueNotifier<int> reps = ValueNotifier<int>(0);
ValueNotifier<String> mistake = ValueNotifier<String>("--");

void handleWebViewMessage(WebViewMessage message) {
  if (message is ExitKinestex) {
    // 处理ExitKinestex消息
    setState(() {
      showKinesteX.value = false;
    });
  } else if (message is Reps) {
    setState(() {
      reps.value = message.data['value'] ?? 0;
    });
  } else if (message is Mistake) {
    setState(() {
      mistake.value = message.data['value'] ?? '--';
    });
  } else {
    // 处理其他消息类型
    print("收到其他消息: ${message.data}");
  }
}