ad_joc.c still asked the stream config for hrtf_sofa_path, hrtf_cache_dir and hrtf_cache_policy, which the kernel no longer has; the same file is compiled by the Windows and the Android build, so both stopped there. The decoder now recognises only the Rosella model -- a JSON file containing a personalized_hrtf object -- and passes its path to personalized_headphone_path. The SOFA magic sniffing, the .jochrtf extension branch, the default cache directory and the disk-cache retry path are gone, the default lookup is HRTF/binaural.personalized_headphone, and the format warning for the frame length uses %zu. The README, the fork docs and the example configs name the model file instead of binaural.sofa.
4.6 KiB
4.6 KiB
Android:把 ad_joc 编进 libmpv.so 的可行性调研
结论:可行,arm64-v8a 是主路径。没有架构性障碍;工作量集中在把 joc_core 用 NDK 编出来、
和把它随 APK 一起分发。
现成的构建体系
mpv-android/mpv-android 的 buildscripts/ 就是为这件事准备的:
-
NDK(clang)交叉编译 ffmpeg、libass、libplacebo、luajit、mpv,目标
android,API 23; -
mpv 用 meson + 生成的 crossfile:
meson setup build --cross-file "$prefix/crossfile.txt" --default-library shared \ -Dlibmpv=true -Dcplayer=false -D{lua,libcurl}=enabled ninja -C build && DESTDIR="$prefix" ninja -C build install -
产物是
prefix/<arch>/lib/libmpv.so,架构可选armv7l / arm64 / x86 / x86_64; -
脚本只支持 Linux/macOS,GitHub Actions 的 ubuntu runner 正好合适。整个 ffmpeg+mpv 构建 约 30–60 分钟,可以缓存。
我们的补丁落在哪里
和 Windows 一样,只是多一个共享库:
- 在 mpv 源码树里跑
tools/apply_edits.py(纯 Python,与平台无关); - 用 NDK 的 CMake toolchain 编
joc_core→libjoc_core.so; - meson 加
-Djoc-core-dir=<prefix>/lib; - 运行时
libjoc_core.so必须和libmpv.so一起进 APK 的jniLibs/<abi>/, 这样libmpv.so的DT_NEEDED才能解析。
joc_core 的可移植性(源码层面)
- CMake 已有
aarch64分支和src/simd/kernels_intrin_neon.cpp,cpu_probe用getauxval(AT_HWCAP)探测;JOC_SIMD=auto|scalar|neon可强制。 - 平台相关代码都有 POSIX 分支(
fs_utf8.cpp、io/process.cpp里的#if defined(_WIN32) ... #else)。 - 依赖只有
Threads::Threads,没有 HDF5 之类的外部库。 - 导出宏
JOC_API在非 Windows 走 visibility,和 Android 默认的-fvisibility=hidden兼容。
需要处理的点
| 点 | 说明 |
|---|---|
| armv7l | JOC_ARCH 只认 x86_64/x86_32/aarch64,armv7 会退回标量内核:能播,慢。首选 arm64 |
std::filesystem |
NDK 的 libc++ 在 API 23 支持;core 里用到的地方(SOFA 缓存、task、io)需要实际编一遍确认 |
| HRTF 路径 | Android 上 exe_dir() 为空,必须由 app 传 --ad-joc-hrtf=/data/user/0/<pkg>/files/binaural.personalized_headphone |
| 缓存目录 | mp_find_user_file(global, "cache", ...) 在 Android 上可能拿不到 → 代码已自动退回内存缓存 |
| 许可 | LGPL:动态链接 libmpv.so + libjoc_core.so 合规;发布需附对应源码/补丁 |
| 未验证 | NDK 编 joc_core 的真实报错、NEON 内核在手机上的数值正确性、实时性能 |
建议的落地顺序
- CI 先只做 arm64 的 joc_core 交叉编译,产出
libjoc_core.so。这一步最快暴露平台问题。 - 再跑 mpv-android 的 buildscripts + 我们的 patch,产出 arm64 的
libmpv.so。 - CI 把
libmpv.so、libjoc_core.so、libc++_shared.so放进 app 的jniLibs/arm64-v8a/,再./gradlew assembleRelease打出可安装的 APK;在 mpv 的 配置文件里加--ad=joc --ad-joc-hrtf=...,用adb logcat -s mpv验证开始渲染。 - 对拍:手机上把输出写成 WAV(
--ao=pcm),拉回 PC 与joc_cli比较,确认 NEON 路径正确。
CI 产物
build-android.yml 的 arm64 任务现在产出两类工件:
mpv-ad-joc-android-arm64-v8a:libmpv.so、libjoc_core.so、libc++_shared.so, 给已经自己编好的 mpv 用;mpv-joc-android-apk:一个app-allstorage-universal-release.apk,由assembleRelease打包并签名,直接可装。包里的libplayer.so由ndk-build现编(app/src/main/jni),libmpv.so和 ffmpeg 的libav*/libsw*一起放进libs/arm64-v8a/;ndk.properties让 AGP 用 NDK 的 strip 处理这些库。mpv-android 本身会出default/allstorage×arm64-v8a/universal四个包,CI 只保留 allstorage 的 universal 版:权限最全, ABI 拆包也不会让工件变多。
签名用的是 CI 现场生成的临时 keystore(-Pandroid.injected.signing.*),只保证可安装,
不代表发布身份;要正式分发就把这段换成仓库 secret 里的 keystore。APK 里仍是原版
mpv-android 界面,--ad=joc、--ad-joc-hrtf= 等参数要在应用能读到的 mpv.conf
里给出,HRTF 文件也要放在应用可访问的目录。
参考
- mpv-android 构建脚本:https://github.com/mpv-android/mpv-android/tree/master/buildscripts
- 交叉编译用的 crossfile 由
buildall.sh生成(system = 'android',cpu_family按架构) - 现成 libmpv Android 发行版可作对照:https://github.com/jarnedemeulemeester/libmpv-android