背景与痛点

Jetpack Compose 作为 Android 的现代 UI 工具包，以其声明式编程和高效渲染著称。然而，当涉及音视频处理（如格式转换、剪辑、滤镜等）时，Compose 本身并不提供底层能力。这时就需要引入 FFmpeg——这个强大的多媒体处理库。但直接将 FFmpeg 集成到 Android 项目并非易事，尤其是处理 JNI 交互和性能优化时，常让开发者头疼。

技术选型对比

1. 预编译静态库：直接使用官方或第三方编译好的 FFmpeg .so 文件，优点是开箱即用，缺点是体积大且可能不兼容所有设备。
2. 动态编译：自行编译 FFmpeg 源码并裁剪功能，灵活性高但配置复杂。
3. 封装 SDK：如使用 mobile-ffmpeg 等封装库，简化调用但可能受限功能。

推荐选择预编译静态库，适合多数场景且社区支持完善。

核心实现细节

1. 添加 FFmpeg 依赖

将编译好的 .so 文件放入 app/src/main/jniLibs/架构目录（如 arm64-v8a），并在 build.gradle 中启用 NDK：

android {
    defaultConfig {
        ndk {
            abiFilters 'armeabi-v7a', 'arm64-v8a'
        }
    }
    sourceSets {
        main {
            jniLibs.srcDirs = ['src/main/jniLibs']
        }
    }
}

2. 配置 CMake

在 CMakeLists.txt 中链接 FFmpeg 库：

add_library(ffmpeg_codec SHARED IMPORTED)
set_target_properties(ffmpeg_codec PROPERTIES IMPORTED_LOCATION
    ${CMAKE_CURRENT_SOURCE_DIR}/../jniLibs/${ANDROID_ABI}/libavcodec.so)
# 类似添加 libavformat, libavutil 等

3. 编写 JNI 接口

创建 NativeLib.kt 定义 native 方法：

class NativeLib {
    external fun executeFFmpegCommand(command: String): Int

    companion object {
        init {
            System.loadLibrary("native-lib")
            // 加载 FFmpeg 子库
            System.loadLibrary("avcodec")
        }
    }
}

对应的 C++ 代码（native-lib.cpp）：

extern "C" JNIEXPORT jint JNICALL
Java_com_example_app_NativeLib_executeFFmpegCommand(JNIEnv *env, jobject, jstring command) {
    const char *cmd = env->GetStringUTFChars(command, nullptr);
    char *args[1024];
    // 解析命令并调用 ffmpeg_exec
    env->ReleaseStringUTFChars(command, cmd);
    return 0;
}

代码示例：视频转码

在 Compose 中调用 FFmpeg 的完整示例：

@Composable
fun VideoConverterScreen() {
    var progress by remember { mutableStateOf(0f) }
    val context = LocalContext.current

    Button(onClick = {
        val cmd = "-i input.mp4 -c:v libx264 output.mp4"
        CoroutineScope(Dispatchers.IO).launch {
            NativeLib().executeFFmpegCommand(cmd)
            withContext(Dispatchers.Main) {
                Toast.makeText(context, "转换完成", Toast.LENGTH_SHORT).show()
            }
        }
    }) {
        Text("开始转换")
    }

    LinearProgressIndicator(progress = progress)
}

性能与安全性

1. 线程管理：FFmpeg 操作需在后台线程执行，避免阻塞 UI。推荐使用 CoroutineScope(Dispatchers.IO)。
2. 内存泄漏：JNI 中及时释放 GetStringUTFChars 获取的指针。
3. 资源释放：通过 avformat_close_input 等函数主动释放 FFmpeg 资源。

避坑指南

• SO 库冲突：若出现 java.lang.UnsatisfiedLinkError，检查 .so 文件架构是否匹配设备。
• API 兼容性：Android 6.0+ 需动态申请存储权限，否则文件操作会失败。
• 命令格式：FFmpeg 参数需以空格分隔为数组，直接传递字符串可能导致解析失败。

延伸思考

FFmpeg 还能与 Jetpack 其他组件深度结合，例如： - 通过 CameraX 捕获实时视频流并用 FFmpeg 处理 - 将处理后的视频通过 Media3 播放 - 结合 WorkManager 实现后台批量处理任务

希望这篇指南能帮你顺利攻克 Compose 中的多媒体处理难题！