更新记录

1.0.0（2026-06-20） 下载此版本

初始化

平台兼容性

uni-app(4.0)

rd-mediapipe

Android 原生 UTS 组件，基于 CameraX 预览和 MediaPipe Pose Landmarker 做人体姿态识别。

功能

• 相机预览
• 人体姿态关键点检测
• 骨架覆盖层绘制
• 动作 .pose 数据加载
• 动作相似度对比和次数统计

结构

index.vue（UTS 组件入口）
  -> PoseLandmarkerView（原生视图）
     -> CameraManager（相机绑定和切换）
     -> PoseLandmarkerManager（MediaPipe 检测器生命周期）
     -> PoseFrameAnalyzer（相机帧分析）
     -> PoseFrameConverter（CameraX 帧转 MediaPipe 输入）
     -> PoseResultMapper（检测结果转 JSON）
     -> SkeletonCanvasOverlayView（骨架绘制层）
     -> PoseCameraAnalyzer（CameraX Analyzer 代理）
     -> PoseConfig（运行配置）
     -> PoseEventListener（事件回调）
     -> CompositePoseEventListener（组合回调）

模型文件

Android 插件使用内置的 MediaPipe 模型：

uni_modules/rd-mediapipe/utssdk/app-android/assets/pose_landmarker_full.task

使用示例

<rd-mediapipe
  ref="pose"
  class="pose-view"
  cameraPosition="back"
  :detectEnabled="true"
  :resultIntervalMs="100"
  :inferenceIntervalMs="33"
  :maxPoses="1"
  :includeWorldLandmarks="true"
  :minPoseDetectionConfidence="0.5"
  :minPosePresenceConfidence="0.5"
  :minTrackingConfidence="0.5"
  @onReady="onReady"
  @onPoseResult="onPoseResult"
  @onError="onError"
/>

事件

• onReady：相机和检测器已就绪
• onPoseResult：姿态识别结果
• onError：原生错误信息

方法

• startCamera()：启动相机
• stopCamera()：停止相机
• switchCamera()：切换前后摄像头
• updateDetectEnabled(enabled)：开启或关闭检测
• prepareForUnload()：页面卸载前释放资源
• getActionList()：获取动作列表
• loadAction(actionId, angleName)：加载指定动作和角度
• startCompare()：开始动作对比
• stopCompare()：停止动作对比
• getCompareStatus()：获取当前对比状态