zijunchiang
264786134c
- README.md / README.txt 新增初次部署章节：前置条件（JDK 17 / SDK 34 / Gradle 8.9）、 获取代码与本地配置（local.properties 不入仓）、Debug/Release 构建、装到手机与相机权限、 连接配置（只连 Windows 客户端，默认 8765 / /pose）、第一次跑通、自检清单、常见问题 - 单测数量按实际（30 项）修正 - 三库同源契约：':=' 写法修回、去掉真实 MariaDB 版本串 - 全文去除易被 Gitea 判为「模棱两可 Unicode」的字符 - 本机 JDK 路径与内网示例地址改占位符 / RFC 5737 文档网段
49 lines
1.6 KiB
Markdown
49 lines
1.6 KiB
Markdown
# T-AND-003 MediaPipe Pose 端侧推理
|
||
|
||
- **状态**：done
|
||
- **依赖**：T-AND-002
|
||
|
||
## 目标
|
||
|
||
用 MediaPipe Tasks Vision 在设备本地做姿态推理，输出 33 个归一化关键点。
|
||
|
||
## load
|
||
|
||
```
|
||
DSH.md
|
||
contracts/skeleton-topology.md # 锚点：1 33 点、4 坐标系
|
||
app/src/main/java/com/opendance/studio/pose/PoseDetector.kt
|
||
```
|
||
|
||
## 交付物
|
||
|
||
`pose/PoseDetector.kt` + `app/src/main/assets/pose_landmarker_lite.task`（5.7 MB）。
|
||
|
||
## 关键实现
|
||
|
||
| 项 | 说明 |
|
||
|--|--|
|
||
| 运行模式 | `LIVE_STREAM` + `detectAsync`，不阻塞相机线程 |
|
||
| 模型 | `pose_landmarker_lite.task`（随 APK 分发，`noCompress "task"` 保证可读） |
|
||
| 置信度阈值 | detection / presence / tracking 均 0.5 |
|
||
| 背压 | `busy` 标志：上一帧仍在推理时直接丢弃新帧并计数，不排队 |
|
||
| 时间戳 | 单调递增校正（MediaPipe 要求严格递增） |
|
||
| 缺失点 | 置信度置 0、坐标归零，接收端按契约插值 |
|
||
|
||
## 坐标与镜像语义
|
||
|
||
- 发送**未镜像的原始 MediaPipe 坐标**（契约 4）
|
||
- 是否镜像由帧头 `flags.bit0` 声明，接收端据此决定如何还原
|
||
- 叠加层绘制时才取 `1 - x`，与前置摄像头预览的镜像观感一致
|
||
|
||
这保证了同一份关键点数据在「镜像预览」与「真实左右」两种解释下都不会歧义。
|
||
|
||
## 上半身模式
|
||
|
||
`upperBodyOnly = true` 时，髋部及以下点置信度置 0 并置 `flags.bit2`，
|
||
接收端会插值。用于带宽/算力不足时降级。
|
||
|
||
## 验收
|
||
|
||
`assembleDebug` 通过；运行页在真机上可看到骨架叠加层（见 tasks/009）。
|