41 lines
2.3 KiB
Plaintext
41 lines
2.3 KiB
Plaintext
App 运行页 「连接状态」为「已连接」，「目标」显示 ws://<IP>:<端口>/pose
|
||
App 运行页 服务端返回 welcome 后出现「会话」ID
|
||
App 运行页 「已发送」持续增长，「发送帧率」「识别帧率」大于 0
|
||
App 运行页 「人体识别」为「已识别」，出现骨架叠加（黄点好、红点置信度低）
|
||
Windows 端 显示已连接并收到关键点，VRM 模型随动作实时动起来
|
||
|
||
7) 自检清单
|
||
|
||
./gradlew testDebugUnitTest
|
||
预期：BUILD SUCCESSFUL，全部用例通过
|
||
报告：app/build/reports/tests/testDebugUnitTest/index.html
|
||
|
||
bash build/build-apk.sh all
|
||
预期：debug 与 release 均显示 "OK ... APK"，release 显示
|
||
"已签名（APK Signature Scheme v2）"
|
||
|
||
$ANDROID_HOME/build-tools/34.0.0/apksigner verify app/build/outputs/apk/release/app-release.apk
|
||
预期：退出码 0（无输出即通过）
|
||
|
||
adb install -r app/build/outputs/apk/debug/app-debug.apk
|
||
预期：Success
|
||
|
||
8) 常见问题
|
||
|
||
Q: 相机黑屏 / 一直提示需要相机权限
|
||
A: 权限被拒绝或已被永久拒绝，或相机被其他应用占用。在运行页点
|
||
「授予相机权限」；不再弹窗时到系统「设置 -> 应用 -> OpenDance -> 权限」
|
||
手动开启相机，并关闭占用相机的其它 App。
|
||
|
||
Q: 连不上 Windows 客户端 / 扫描不到主机
|
||
A: 核对 IP 与端口、确认客户端已启动并监听 8765、在 Windows 防火墙放行
|
||
OpenDance 的 TCP 8765 入站、确认手机与电脑同一 WiFi 且路由器未开 AP 隔离。
|
||
|
||
Q: 点「开始推流」闪退（或提示 MediaPipe 初始化失败）
|
||
A: MediaPipe 原生库加载 / 静态初始化失败抛出的是 Error 子类
|
||
（UnsatisfiedLinkError、ExceptionInInitializerError），不是 Exception；
|
||
常见诱因是 ABI 不匹配（例如把只含 arm 的 release 包装到 x86 模拟器）
|
||
或模型资源缺失。处理：改用与设备 ABI 匹配的包（真机用 release、
|
||
模拟器调试用 debug）；确认 APK 内含 assets/pose_landmarker_lite.task。
|
||
仓库已在 PoseDetector.initialize() 中 catch Throwable 兜底并把原因显示在
|
||
运行页；CrashLogger 会把未捕获堆栈写入应用私有目录，并在连接页展示， |