FFmpeg中使用Android Content协议打开文件设备

news2025/5/26 0:00:44

引言

随着Android 10引入的Scoped Storage（分区存储）机制，传统的文件访问方式发生了重大变化。FFmpeg作为强大的多媒体处理工具，也在不断适应Android平台的演进。本文将介绍如何在FFmpeg 7.0+版本中使用Android content协议直接访问文件，为开发者提供更便捷的多媒体处理方案。

需要说明的是，本文记录的是我个人的实践经验，并非官方文档。由于相关技术较新，网络上的参考资料有限，如有错误疏漏，还请大家指点。

背景：Scoped Storage与文件访问挑战

自Android 10（API 29）起，Google实施了Scoped Storage策略，即使应用拥有READ_EXTERNAL_STORAGE权限，也无法直接通过/sdcard/路径访问文件。开发者必须使用Storage Access Framework (SAF)获取用户选择文件的content URI。这给多媒体处理带来了新的挑战。

传统方案：文件描述符(fd)协议

在FFmpeg支持content协议之前，开发者通常采用以下工作流程：

通过SAF获取文件URI
转换为文件描述符(fd)
通过FFmpeg的fd协议处理文件

// Java端实现
private int getFileDescriptor(Uri uri) {
    try (ParcelFileDescriptor pfd = getContentResolver()
            .openFileDescriptor(uri, "r")) {
        return pfd != null ? pfd.detachFd() : -1;
    } catch (IOException e) {
        Log.e(TAG, "Error opening file descriptor", e);
        return -1;
    }
}

这种方案存在以下局限性：

需要额外的Java层转换代码
文件描述符管理复杂
不支持直接URI访问
跨进程传递文件描述符存在兼容性问题

现代化方案：Content协议支持

2024年2月，FFmpeg正式合并了对Android content协议的支持（提交记录：6567516a5ef），开发者现在可以直接使用content URI进行多媒体处理。

环境配置

1. 初始化JNI环境

在JNI加载时设置Java虚拟机：

#include <jni.h>

extern "C" JNIEXPORT jint JNI_OnLoad(JavaVM* vm, void* reserved) {
    av_jni_set_java_vm(vm, nullptr);
    return JNI_VERSION_1_6;  // 建议使用较新的JNI版本
}

2. 传递应用上下文

// MainActivity.java
public native void initFFmpeg(Context context);

// 在Activity初始化时调用
initFFmpeg(getApplicationContext());

对应的JNI实现：

extern "C" JNIEXPORT void JNICALL
Java_com_example_media_MainActivity_initFFmpeg(
    JNIEnv* env,
    jobject thiz,
    jobject context) {
  
    // 创建全局引用防止被GC回收
    jobject global_ctx = env->NewGlobalRef(context);
    av_jni_set_android_app_ctx(global_ctx, nullptr);
}

使用Content协议

配置完成后，可以直接将SAF获取的URI传递给FFmpeg：

@Override
protected void onActivityResult(int requestCode, int resultCode, Intent data) {
    if (requestCode == REQUEST_PICK_VIDEO 
            && resultCode == RESULT_OK
            && data != null) {
        Uri uri = data.getData();
        String ffmpegUrl = uri.toString();
        // 传递给FFmpeg处理
        processMediaWithFFmpeg(ffmpegUrl);
    }
}