当前位置：首页 > news >正文

基于 FFmpeg 的跨平台视频播放器简明教程（十）：在 Android 运行 FFmpeg

news 2026/1/13 19:04:10

系列文章目录

基于 FFmpeg 的跨平台视频播放器简明教程（一）：FFMPEG + Conan 环境集成
基于 FFmpeg 的跨平台视频播放器简明教程（二）：基础知识和解封装（demux）
基于 FFmpeg 的跨平台视频播放器简明教程（三）：视频解码
基于 FFmpeg 的跨平台视频播放器简明教程（四）：像素格式与格式转换
基于 FFmpeg 的跨平台视频播放器简明教程（五）：使用 SDL 播放视频
基于 FFmpeg 的跨平台视频播放器简明教程（六）：使用 SDL 播放音频和视频
基于 FFmpeg 的跨平台视频播放器简明教程（七）：使用多线程解码视频和音频
基于 FFmpeg 的跨平台视频播放器简明教程（八）：音画同步
基于 FFmpeg 的跨平台视频播放器简明教程（九）：Seek 策略

前言

在前九章的学习中，我们已经成功地实现了一个基础的播放器，它拥有视频播放、音画同步、快进/快退等基本功能。当然，这个简易的示例还有许多可以优化的地方，比如添加更美观的用户界面，或者增加字幕功能等。然而，这并不是本教程的主要关注点。本系列文章更关注于跨平台播放器框架的构建，特别是在移动端。因此，从本章开始，我们将把重点转向 Android 端播放器的开发。

前置知识包括一些 Android 的基本开发，以及 JNI 开发等。这些前置知识默认你有所了解，本文不会涉及。关于 JNI 可以参考笔者之前写的 JNI 简明教程之手把手教你入门

本文代码在 android/tutorial01。

FFmpeg Android 编译

FFmpeg 的跨端编译也是老生常谈的话题了，本文不去讨论那些细节问题，只想提供一种最便捷的编译方法。在 CompilationGuide/Android 中给出了一些指导意见，例如直接使用已经编译好的 so，或者使用别人写好的脚本。对比了这几个方法，ffmpeg-android-maker 比较合适，优势包括：

网上那些已经编译好的 ffmpeg so，ffmepg 版本可能太老了。ffmpeg-android-maker 则是从源码直接编译
ffmpeg-android-maker 能够自动拉取 ffmpeg 源码，只需要设置少量的变量就能开始编译
ffmpeg-android-maker 功能、文档写的比较清楚，用起来没有卡点。

那么基于 ffmpeg-android-maker 要如何编译 android ffmpeg 呢？非常简单，步骤如下。

下载 ffmpeg-android-marker 仓库

git clone git@github.com:Javernaut/ffmpeg-android-maker.git
cd ffmpeg-android-maker

设置环境变量

export ANDROID_SDK_HOME=/Users/user/Library/Android/sdk
export ANDROID_NDK_HOME=/Users/user/Library/Android/sdk/ndk/25.2.9519653

运行脚本

./ffmpeg-android-maker.sh

编译成功后，你可以在当前文件夹的 build 目录下找到各个架构的 ffmpeg 库：

build
└── ffmpeg├── arm64-v8a│   ├── bin│   ├── include│   ├── lib│   └── share├── armeabi-v7a│   ├── bin│   ├── include│   ├── lib│   └── share├── x86│   ├── bin│   ├── include│   ├── lib│   └── share└── x86_64├── bin├── include├── lib└── share

其中 include 和 lib 是我们需要的。

FFmpeg so 导入 Android 项目

将 so 文件放置在正确的位置

第一步当然是将编译好的 ffmpeg so 文件和头文件拷贝到我们的项目中。在编译产物中，我们只需要 include 和 lib 文件夹即可，将它们拷贝至 3rdparty/ffmpeg/android 目录下。当然你也可以选择其他地方，这只是我个人的选择。

android
├── arm64-v8a
│   ├── include
│   └── lib
├── armeabi-v7a
│   ├── include
│   └── lib
├── x86
│   ├── include
│   └── lib
└── x86_64├── include└── lib

写 CMake 将 FFmpeg so 引入项目

ffmpeg 有多个 so 文件，在编译项目的过程中，如果一个一个地去写 link 命令有点麻烦。通常的做法是，创建一个新的 library，例如叫 ffmpeg_libs，让 ffmpeg_libs 去 link 这些 so 文件，然后其他模块 link ffmpeg_libs 就能够链式地将所有依赖都带上了。

这部分属于 CMake 的知识范畴，不细说了，可以参考笔者之前写的现代 CMake 简明教程（一）- CMake 基础。具体 CMake 源码在 CMakeLists.txt 大家自己看。

写 Kotlin 和 JNI 调用 FFmpeg API

Android app 想要调用 C/C++ 的接口就必须通过 JNI 接口来实现。首先，在应用层定义一个 native method 叫 stringFromFFMPEG

external fun stringFromFFMPEG(): String

接着定义 JNI 层接口，新建 src/cpp/native-lib.cpp 文件，并完成 JNI 层代码：

#include <jni.h>
#include <string>
extern "C"
{
#include <libavutil/avutil.h>
}extern "C" JNIEXPORT jstring JNICALL
Java_com_test_tutorial01_MainActivity_stringFromFFMPEG(JNIEnv* env,jobject /* this */) {std::string hello = "Hello from ffmpeg: " + std::string(av_version_info());return env->NewStringUTF(hello.c_str());
}

最后，我们将 UI 上的 TextView 中的字符串内容修改为这个函数的返回值即可：

binding.sampleText.text = stringFromFFMPEG()

最终呈现的效果如下图：
在这里插入图片描述

总结

本文介绍了一种非常便捷的编译 android ffmpeg 的方法：ffmpeg-android-maker。说明如何将 ffmpeg so 库导入至 android 项目中，并提供了实例代码（代码地址：这里）

参考

JNI 简明教程之手把手教你入门
CompilationGuide/Android
现代 CMake 简明教程（一）- CMake 基础