系列文章目录

前言

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

bash 复制代码

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

设置环境变量

bash 复制代码

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

运行脚本

bash 复制代码

./ffmpeg-android-maker.sh

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

bash 复制代码

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 目录下。当然你也可以选择其他地方，这只是我个人的选择。

bash 复制代码

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

kotlin 复制代码

external fun stringFromFFMPEG(): String

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

c 复制代码

#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 中的字符串内容修改为这个函数的返回值即可：

kotlin 复制代码

binding.sampleText.text = stringFromFFMPEG()

最终呈现的效果如下图：

总结

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

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

系列文章目录

前言

FFmpeg Android 编译

FFmpeg so 导入 Android 项目

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

写 CMake 将 FFmpeg so 引入项目

写 Kotlin 和 JNI 调用 FFmpeg API

总结

参考