1. 项目概述为什么选择QtFFmpeg来造轮子做音视频播放器听起来像是播放器软件公司或者流媒体大厂的核心业务离我们普通开发者很远。但如果你深入接触过C客户端开发尤其是需要处理多媒体内容的项目比如视频会议、安防监控、在线教育客户端甚至是游戏内的过场动画播放器你迟早会碰到这个需求如何在自己的C程序里稳定、高效、可控地播放一段视频这时候你可能会去搜现成的库比如VLC的LibVLC或者DirectShow、Media FoundationWindows平台。但很快你会发现要么绑定太重要么跨平台麻烦要么定制化程度不够无法满足你产品里那个独特的进度条、滤镜或者网络流协议。这就是我当初决定自己动手基于Qt和FFmpeg搭建一个播放器核心的原因。Qt提供了顶级的跨平台GUI框架和一套好用的事件循环、线程管理机制让你能专注于业务逻辑而不是陷在Windows消息循环或者Linux的X11事件里。而FFmpeg则是多媒体处理领域的“瑞士军刀”几乎所有的播放、转码、流媒体服务背后都有它的身影它负责最底层的音视频解封装、解码工作。把这两者结合起来Qt做“面子”界面和交互FFmpeg做“里子”音视频处理你就能获得一个完全受控、可深度定制、且能运行在Windows、macOS、Linux三大桌面系统上的播放器核心。这个项目不只是为了播个视频文件。通过剖析源码你能掌握的是一套处理多媒体数据的通用架构思想。你会明白一帧视频数据从文件到屏幕的完整旅程理解音画同步这个经典难题的解决方案学会如何处理各种诡异的媒体格式和网络流。这些知识在你日后面对音频可视化、视频编辑、实时通信等更复杂的场景时会成为你工具箱里最趁手的家伙。下面我就把这个项目的设计思路、关键实现、踩过的坑毫无保留地拆解给你看。2. 整体架构设计与核心模块拆解一个播放器远不止一个play()函数那么简单。它的核心是一个精密的、多线程协作的数据流水线。我们的架构主要分为三层控制层、数据层和渲染层。2.1 核心模块职责划分主线程UI线程/控制层职责运行Qt的事件循环管理用户界面播放/暂停按钮、进度条、音量控制等响应用户交互事件。关键戒律绝对禁止在UI线程中进行任何耗时的FFmpeg操作如读取文件、解码等否则界面会立即卡死。它的任务只是发送控制命令如Play、Seek和更新UI状态。解复用线程Demuxer Thread职责负责“拆快递”。使用FFmpeg的avformat模块打开媒体文件或网络流读取容器格式如MP4、MKV、FLV将交织在一起的音频流和视频流分离解复用出来分别放入音频包队列和视频包队列。关键数据结构AVFormatContext格式上下文、AVPacket编码数据包。视频解码线程职责负责“翻译视频密码”。从视频包队列中取出AVPacket利用FFmpeg的avcodec模块通过视频解码器如H.264、HEVC将其解码成原始的图像数据AVFrame即YUV或RGB像素数据然后放入视频帧队列。关键数据结构AVCodecContext编解码上下文、AVFrame原始帧。音频解码线程职责与视频解码线程类似从音频包队列取包解码成PCM音频采样数据AVFrame放入音频帧队列。关键点音频解码通常比视频快但音频播放有严格的实时性要求所以同步策略至关重要。视频渲染模块职责负责“画画”。从视频帧队列中取出AVFrame将其转换为Qt的QImage或QOpenGLTexture最终通过QWidget的paintEvent或OpenGL在屏幕上绘制出来。性能关键缩放、色彩空间转换YUV到RGB可能很耗CPU考虑使用GPUOpenGL Shader加速。音频播放模块职责负责“发声”。从音频帧队列中取出PCM数据通过Qt的QAudioOutput或更底层的平台音频API如ALSA、Core Audio播放出去。同步核心音频播放的时钟是主时钟视频需要向其同步。队列管理器职责整个架构的“缓冲区和协调器”。管理着音频包队列、视频包队列、音频帧队列、视频帧队列。它需要是线程安全的并且要有容量限制和超时机制防止内存爆掉或因某个环节阻塞导致整个程序卡死。整个数据流就像一条工厂流水线文件→解复用→音频包/视频包→解码→音频帧/视频帧→播放/渲染。多线程让读数据、解码、渲染可以并行极大提升了效率。2.2 线程间通信与同步机制这是项目的难点和精华所在。我们主要使用两种方式生产者-消费者队列这是线程间传递数据AVPacketAVFrame的主要方式。我们通常会实现一个模板化的ThreadSafeQueue。它内部用std::queue或QQueue存储数据用std::mutex或QMutex保护用std::condition_variable或QWaitCondition进行线程等待和唤醒。生产者如解复用线程在队列未满时push数据并notify_one唤醒可能正在等待的消费者。消费者如解码线程在队列不为空时pop数据如果为空则等待wait被生产者唤醒。容量控制必须设置队列最大容量。例如视频帧队列存最多3秒的数据就够了防止用户跳转进度Seek后堆积大量过时的帧导致内存占用过高和同步混乱。信号与槽Qt结合原子标志这是传递控制命令和状态的最佳方式。例如用户点击暂停按钮。UI线程发射一个pauseRequested()信号。解复用、解码线程的槽函数连接到这个信号收到后通过原子布尔变量如std::atomicbool或将标志位存入队列通知数据流暂停。这样做解耦了UI和后台线程符合Qt的设计哲学也安全。注意直接在线程间传递FFmpeg的结构体指针如AVPacket*是危险的因为FFmpeg有很多内部引用计数。我们必须深拷贝或使用FFmpeg提供的av_packet_ref/av_frame_ref来增加引用计数确保在一个线程释放资源时不会影响另一个线程正在使用的数据。更简单的做法是使用AVPacket和AVFrame的智能指针封装类利用RAII机制自动管理生命周期。3. FFmpeg核心API使用详解与封装很多人卡在FFmpeg的第一步安装和链接。这里跳过安装教程重点讲在C项目中如何正确使用。3.1 初始化解封装与解码器// 1. 初始化FFmpeg库网络、编解码器等 avformat_network_init(); // 通常在主程序启动时调用一次即可 // 2. 打开媒体文件获取格式上下文 AVFormatContext* formatCtx nullptr; const char* url your_video.mp4; // 也可以是rtmp://, http:// 等 int ret avformat_open_input(formatCtx, url, nullptr, nullptr); if (ret 0) { // 处理错误av_err2str(ret)可获取错误信息 return; } // 3. 探测流信息 ret avformat_find_stream_info(formatCtx, nullptr); if (ret 0) { // 处理错误 avformat_close_input(formatCtx); return; } // 4. 查找最佳的音频流和视频流索引 int videoStreamIndex -1; int audioStreamIndex -1; for (int i 0; i formatCtx-nb_streams; i) { AVStream* stream formatCtx-streams[i]; if (stream-codecpar-codec_type AVMEDIA_TYPE_VIDEO videoStreamIndex -1) { videoStreamIndex i; } else if (stream-codecpar-codec_type AVMEDIA_TYPE_AUDIO audioStreamIndex -1) { audioStreamIndex i; } } if (videoStreamIndex -1 audioStreamIndex -1) { // 没有可用的音视频流 avformat_close_input(formatCtx); return; } // 5. 为视频流和音频流分别创建解码器上下文并打开解码器 AVCodecContext* createCodecContext(AVFormatContext* fmtCtx, int streamIndex) { if (streamIndex 0) return nullptr; AVStream* stream fmtCtx-streams[streamIndex]; const AVCodec* codec avcodec_find_decoder(stream-codecpar-codec_id); if (!codec) return nullptr; AVCodecContext* codecCtx avcodec_alloc_context3(codec); if (!codecCtx) return nullptr; // 将流中的编解码参数拷贝到解码器上下文 ret avcodec_parameters_to_context(codecCtx, stream-codecpar); if (ret 0) { avcodec_free_context(codecCtx); return nullptr; } // 打开解码器 ret avcodec_open2(codecCtx, codec, nullptr); if (ret 0) { avcodec_free_context(codecCtx); return nullptr; } return codecCtx; } AVCodecContext* videoCodecCtx createCodecContext(formatCtx, videoStreamIndex); AVCodecContext* audioCodecCtx createCodecContext(formatCtx, audioStreamIndex);3.2 封装一个安全的AVFrame管理类直接操作AVFrame容易内存泄漏封装一下让生活更美好。class AVFrameWrapper { public: AVFrameWrapper() : frame(av_frame_alloc()) { if (!frame) throw std::runtime_error(Failed to allocate AVFrame); } // 禁止拷贝允许移动 AVFrameWrapper(const AVFrameWrapper) delete; AVFrameWrapper operator(const AVFrameWrapper) delete; AVFrameWrapper(AVFrameWrapper other) noexcept : frame(other.frame) { other.frame nullptr; } AVFrameWrapper operator(AVFrameWrapper other) noexcept { if (this ! other) { if (frame) av_frame_free(frame); frame other.frame; other.frame nullptr; } return *this; } ~AVFrameWrapper() { if (frame) av_frame_free(frame); } AVFrame* get() const { return frame; } AVFrame* operator-() const { return frame; } // 创建一个深拷贝用于跨线程传递 AVFrameWrapper clone() const { if (!frame) return AVFrameWrapper(); AVFrameWrapper newFrame; if (av_frame_ref(newFrame.frame, frame) 0) { throw std::runtime_error(Failed to ref AVFrame); } return newFrame; } private: AVFrame* frame nullptr; }; // 使用时可以用 std::queueAVFrameWrapper 作为线程安全队列的元素类型。3.3 解码循环示例视频解码线程void VideoDecodeThread::run() { AVPacketWrapper pkt; // 类似AVFrameWrapper的封装 AVFrameWrapper frame; while (!m_stopFlag) { // 1. 从视频包队列取一个包 if (!m_videoPacketQueue.pop(pkt, 100)) { // 超时100ms用于检查停止标志 continue; } // 2. 发送包到解码器 int ret avcodec_send_packet(m_videoCodecCtx, pkt.get()); if (ret 0 ret ! AVERROR(EAGAIN) ret ! AVERROR_EOF) { // 发送失败丢弃这个包记录错误 continue; } // 3. 循环接收解码后的帧 while (ret 0) { ret avcodec_receive_frame(m_videoCodecCtx, frame.get()); if (ret AVERROR(EAGAIN) || ret AVERROR_EOF) { break; // 需要新的输入包或解码结束 } else if (ret 0) { // 解码错误 break; } // 4. 成功解码出一帧 // 计算这一帧的显示时间戳PTS这是同步的关键 double pts frame-pts * av_q2d(m_videoStream-time_base); if (pts AV_NOPTS_VALUE) { // 有些流没有有效PTS需要用帧序号估算 static double frameNum 0; pts frameNum * av_q2d(m_videoStream-avg_frame_rate); frameNum; } // 将pts存入frame的opaque字段或自定义结构随帧一起放入队列 // ... // 5. 将解码后的帧放入视频帧队列 AVFrameWrapper frameToQueue frame.clone(); // 深拷贝因为frame会被复用 if (!m_videoFrameQueue.push(std::move(frameToQueue))) { // 队列已满可以丢弃最老的一帧丢帧策略 m_videoFrameQueue.pop(); // 丢弃队首 m_videoFrameQueue.push(std::move(frameToQueue)); } av_frame_unref(frame.get()); // 准备接收下一帧 } av_packet_unref(pkt.get()); // 释放包资源 } }4. Qt界面集成与音视频渲染实战有了后台的数据流水线前端的任务就是优雅地展示和播放。4.1 自定义视频渲染Widget我们不直接用QMediaPlayer而是用QWidget自己画这样才能获得完全的控制权比如添加自定义滤镜、OSD屏幕显示信息等。class VideoWidget : public QWidget { Q_OBJECT public: explicit VideoWidget(QWidget *parent nullptr) : QWidget(parent) { setAttribute(Qt::WA_OpaquePaintEvent); // 告诉Qt我们处理所有绘制避免背景擦除 setAttribute(Qt::WA_NoSystemBackground); m_image QImage(640, 480, QImage::Format_RGB888); // 初始图像 m_image.fill(Qt::black); } void presentFrame(const AVFrameWrapper frame, double pts) { // 这个函数在渲染线程非UI线程中被调用 // 1. 将AVFrame转换为QImage QImage img convertAVFrameToQImage(frame); // 2. 通过锁保护更新成员变量 { std::lock_guardstd::mutex lock(m_frameMutex); m_image std::move(img); m_currentPts pts; } // 3. 通知UI线程需要重绘 // 使用信号槽因为QWidget的repaint必须在主线程 QMetaObject::invokeMethod(this, [this]() { update(); }, Qt::QueuedConnection); } protected: void paintEvent(QPaintEvent *event) override { QPainter painter(this); painter.setRenderHint(QPainter::SmoothPixmapTransform); std::lock_guardstd::mutex lock(m_frameMutex); // 计算缩放保持宽高比 QRect targetRect m_image.rect(); targetRect.setSize(m_image.size().scaled(size(), Qt::KeepAspectRatio)); targetRect.moveCenter(rect().center()); painter.drawImage(targetRect, m_image); // 可以在这里绘制OSD信息如当前时间码 painter.setPen(Qt::white); painter.drawText(10, 20, QString::number(m_currentPts, f, 2)); } private: QImage convertAVFrameToQImage(const AVFrameWrapper frame) { // 简化版假设frame已经是RGB24格式 // 实际中YUV420P到RGB的转换是性能瓶颈建议用SwScale或OpenGL Shader if (frame-format AV_PIX_FMT_RGB24) { return QImage(frame-data[0], frame-width, frame-height, frame-linesize[0], QImage::Format_RGB888).copy(); } // 否则需要调用sws_scale进行转换... return QImage(); } QImage m_image; double m_currentPts 0.0; std::mutex m_frameMutex; };4.2 音频播放与时钟同步音频播放是同步的主时钟因为人耳对声音的断续异常敏感。class AudioOutput : public QIODevice { Q_OBJECT public: AudioOutput(const QAudioFormat format, QObject *parent nullptr) : QIODevice(parent), m_audioOutput(new QAudioOutput(format, this)) { setOpenMode(QIODevice::ReadOnly); m_audioOutput-start(this); // 将本设备作为音频源 } void writeData(const uint8_t* data, int len) { // 这个函数在音频解码线程中被调用 std::lock_guardstd::mutex lock(m_bufferMutex); int oldSize m_buffer.size(); m_buffer.resize(oldSize len); memcpy(m_buffer.data() oldSize, data, len); m_bytesBuffered len; // 计算当前音频播放器的时钟 // QAudioOutput已播放的字节数 / 每秒字节数 已播放时间 qint64 bytesPlayed m_audioOutput-processedUSecs() / 1000000.0 * m_format.sampleRate() * m_format.bytesPerFrame(); m_audioClock bytesPlayed / (double)(m_format.sampleRate() * m_format.bytesPerFrame()); } qint64 readData(char *data, qint64 maxlen) override { // QAudioOutput会主动调用这个函数来拉取数据 std::lock_guardstd::mutex lock(m_bufferMutex); qint64 bytesToRead qMin(maxlen, (qint64)m_buffer.size()); if (bytesToRead 0) { return 0; // 无数据播放静音或暂停 } memcpy(data, m_buffer.constData(), bytesToRead); m_buffer.remove(0, bytesToRead); return bytesToRead; } qint64 writeData(const char *, qint64) override { return -1; } // 不支持写 double getAudioClock() const { std::lock_guardstd::mutex lock(m_bufferMutex); return m_audioClock m_buffer.size() / (double)(m_format.sampleRate() * m_format.bytesPerFrame()); // 当前时钟 缓冲区中剩余数据的时长 } private: QAudioOutput* m_audioOutput; QAudioFormat m_format; QByteArray m_buffer; mutable std::mutex m_bufferMutex; double m_audioClock 0.0; qint64 m_bytesBuffered 0; };音视频同步策略 在视频渲染前获取当前的音频时钟audio_clock和当前视频帧的显示时间戳video_pts。计算差值diff video_pts - audio_clock。如果diff 0.1视频快了100ms以上则延迟渲染这一帧等待音频追上来。可以通过QThread::usleep(diff * 1000000)实现但更优雅的是调整下一帧的渲染时机。如果diff -0.1视频慢了100ms以上则丢弃当前帧立即渲染下一帧追上音频。这个阈值0.1秒可以调整太小会导致频繁调整观感不佳太大会导致明显音画不同步。5. 关键问题排查与性能优化实录实际开发中你会遇到无数个坑。这里记录几个最典型的。5.1 内存泄漏与资源管理FFmpeg的很多结构体需要手动管理内存。一个黄金法则是每一个av_xxx_alloc都必须对应一个av_xxx_free。AVFormatContextavformat_open_input分配avformat_close_input释放。AVCodecContextavcodec_alloc_context3分配avcodec_free_context释放。AVPacketav_packet_alloc分配av_packet_free释放。在循环中每次解码完一个包必须调用av_packet_unref。AVFrameav_frame_alloc分配av_frame_free释放。同样每次处理完一帧调用av_frame_unref。使用Valgrind或AddressSanitizer定期检查内存泄漏。我强烈建议像前面那样用RAII风格的C类如AVFrameWrapper将它们包装起来利用析构函数自动释放能避免90%的内存泄漏问题。5.2 队列阻塞与死锁多线程队列是死锁的高发区。我的经验是设置超时在队列的pop操作中设置超时比如100ms。这样即使生产者暂时没数据消费者线程也能定期醒来检查退出标志而不是永久阻塞。Seek操作清空队列当用户拖动进度条时必须立即清空所有音视频包和帧队列。因为队列里缓存的是旧位置的数据如果不清理播放器会继续播完旧数据才跳到新位置体验极差。清空队列前要通知解码线程刷新解码器avcodec_flush_buffers。优雅退出停止播放时先通知各线程退出标志然后等待join它们结束。线程的run函数循环中每次从队列pop前都应检查退出标志。5.3 性能瓶颈定位播放高清视频卡顿CPU占用率100%按以下顺序排查解码性能用工具如perf、Intel VTune分析看是视频解码avcodec_receive_frame还是音频解码耗时。H.264 1080P解码对现代CPU压力不大但HEVC 4K软解码可能就很吃力。考虑启用硬件解码如CUDA、DXVA2、VideoToolbox。色彩转换与缩放这是容易被忽视的CPU大户。如果AVFrame是YUV420P而你的QImage需要RGB32用sws_scale进行转换特别是缩放到大窗口时计算量巨大。优化方案使用OpenGL渲染在GPU上用Shader做YUV到RGB的转换和缩放性能提升是数量级的。队列竞争过多的锁竞争会导致线程空转。检查你的线程安全队列锁的粒度是否过大可以考虑使用无锁队列如moodycamel::ConcurrentQueue替代但实现复杂度较高。音频回调QAudioOutput的回调readData必须在极短时间内返回数据否则会听到爆音。确保向音频缓冲区写入数据的操作是快速的如果从队列中取数据太慢考虑预缓冲更多音频数据。5.4 兼容性难题奇怪的媒体文件不是所有MP4文件都能播。你会遇到时间基time_base问题有些视频流的pts不是以秒为单位而是以一个分数AVRational为单位的刻度。必须用av_q2d(stream-time_base) * pts转换成秒。我遇到过time_base为1/90000和1/1000的处理不当会导致同步彻底混乱。没有B帧的流Seek操作会变得简单。有B帧的流因为帧间依赖关系Seek到非关键帧时需要解码器向前寻找关键帧逻辑更复杂。FFmpeg的av_seek_frame函数有AVSEEK_FLAG_BACKWARD等标志来处理这个问题。损坏的文件或网络中断av_read_frame可能返回错误码。需要健壮的错误处理比如网络流中断后尝试重连或者文件损坏时跳到下一个关键帧继续播放而不是直接崩溃。6. 功能扩展与高级特性实现思路基础播放器完成后你可以在此基础上添加更多专业功能这会让你的项目从“玩具”升级为“工具”。6.1 精准Seek跳转这是播放器的核心用户体验。不能简单调用av_seek_frame就完事。用户拖动进度条到target_seconds。清空所有音视频队列。调用av_seek_frame(format_ctx, -1, target_seconds * AV_TIME_BASE, AVSEEK_FLAG_BACKWARD)。AVSEEK_FLAG_BACKWARD表示向后寻找到最近的关键帧这是最安全的方式。刷新解码器上下文avcodec_flush_buffers(video_codec_ctx)和avcodec_flush_buffers(audio_codec_ctx)。解复用线程重新开始读包。因为Seek到的是关键帧通常是I帧视频解码线程从这一帧开始解码但音频可能需要丢弃一些数据直到其时间戳略大于target_seconds再开始播放以避免音画不同步。6.2 倍速播放单纯的快进丢帧或慢放重复帧体验不好。真正的倍速播放需要音频这是难点。不能简单改变采样率播放那会变调。需要使用音频重采样库如libswresample进行“变速不变调”处理或者更现代地使用libsoxr高质量重采样库。原理是通过重采样算法在时间轴上拉伸或压缩音频信号。视频相对简单。根据倍速调整帧的显示间隔。2倍速播放则每帧显示时间减半。注意如果视频帧率本身不高高速播放可能会显得卡顿可以结合智能丢帧策略。6.3 音轨切换与字幕加载音轨切换媒体文件中可能包含多条音频流如多语言。在AVFormatContext中遍历所有流找到codec_type为AVMEDIA_TYPE_AUDIO的流。切换时关闭当前音频解码器。用新的流索引创建新的音频解码器上下文。清空音频相关队列。通知解复用线程开始向新的音频包队列发送数据。字幕加载字幕流AVMEDIA_TYPE_SUBTITLE可以是内嵌的如MKV中的ASS/SSA或外挂的SRT、ASS文件。内嵌字幕通过av_read_frame读取到AVPacket解码后得到文本或图形字幕数据需要在渲染视频时叠加到画面上。外挂字幕需要自己解析SRT/ASS文件格式根据当前播放时间戳找到该显示的字幕行同样叠加渲染。渲染可以用Qt的QPainter在VideoWidget的paintEvent中绘制文字。对于高级的ASS字幕有样式、动画需要实现一个简单的ASS渲染器或者集成libass库。6.4 视频滤镜与硬件解码软件滤镜FFmpeg自带强大的libavfilter库可以链式处理视频帧。比如添加一个“反转颜色”滤镜。你需要创建一个FilterGraph将解码后的AVFrame送入处理后再取出渲染。这会给CPU带来额外负担。硬件解码为了降低CPU占用播放4K、8K视频必须用上。FFmpeg支持多种硬件API。WindowsDXVA2DirectX Video Acceleration或D3D11VA。LinuxVA-API或VDPAU。macOSVideoToolbox。通用CUDANVIDIA显卡。使用方法在打开解码器时通过AVDictionary设置硬件设备类型参数如hwaccel为cuda。硬件解码输出的是GPU显存中的帧可能是特定格式如NV12你需要将其映射到系统内存或直接用OpenGL纹理渲染这涉及到另一个复杂的话题——GPU内存到CPU内存或OpenGL纹理的拷贝。7. 项目构建与部署心得最后说说怎么把这一大摊子代码编译成一个可用的程序。依赖管理Qt用Qt Creator或CMake管理很方便。确保你的.pro文件或CMakeLists.txt正确链接了Qt5CoreQt5GuiQt5WidgetsQt5Multimedia如果用了QAudioOutput。FFmpeg这是最麻烦的。不建议自己编译直接使用官方预编译的共享库如来自BtbN的Windows build。你需要链接avcodecavformatavutilswscaleswresample等库。在CMake中使用find_package(PkgConfig)和pkg_check_modules来查找FFmpeg的路径和库文件。跨平台编译Windows使用MSVC或MinGW。注意FFmpeg库的版本MSVC vs MinGW要匹配你的编译器。运行时需要将FFmpeg的*.dll文件放在可执行文件旁边。Linux在Ubuntu/Debian上可以直接apt install libavcodec-dev libavformat-dev ...。注意版本可能较旧。追求新特性最好自己编译或使用第三方PPA。macOS用Homebrew安装非常方便brew install ffmpeg qt。链接时注意框架路径。打包发布Windows将Qt的运行时DLL在Qt安装目录/bin下、FFmpeg的DLL、以及可能需要的VC运行时合并到一起。可以使用windeployqt工具自动抓取Qt依赖。Linux理论上静态链接最好但FFmpeg的LGPL许可证对静态链接有要求。通常做法是动态链接在打包说明中告知用户安装ffmpeg和qt5相关运行时包如libavcodec58libqt5widgets5。macOS使用macdeployqt工具创建.appbundle它会自动将Qt库复制进去。FFmpeg库也需要复制到app/Contents/Frameworks/目录下并使用install_name_tool修改其加载路径。踩过最大的一个坑是在Linux上系统自带的FFmpeg库可能太旧缺少某些编解码器比如HEVC。而你自己编译的新版FFmpeg其soname如libavcodec.so.59与系统的如libavcodec.so.58不兼容。最终我选择了在项目内附带一个特定版本的FFmpeg动态库并通过设置LD_LIBRARY_PATH或rpath来优先加载它们虽然不够优雅但保证了运行环境的一致性。这个项目从零到能流畅播放本地视频我花了大约两周到能稳定处理网络流和实现精准Seek又花了一周再到性能优化和兼容各种奇怪格式断断续续调试了更久。但整个过程下来你对多媒体流水线、多线程编程、C资源管理、跨平台开发的理解会深刻得多。下次再遇到音视频相关需求你心里就有了一张清晰的蓝图知道问题可能出在哪个环节该怎么去解决。这大概就是“造轮子”最大的意义——不是为了重复发明而是为了彻底理解。
