30、项目实战：构建一个自定义媒体播放器：需求分析、架构设计、编码实现、测试与发布

终于到了最后一章。说实话，写到这里我有点感慨。前面29章我们聊了MediaServer的底层机制、音视频同步、编解码器、DRM……但很多朋友可能一直在想：这些东西到底怎么串起来？

嗯，这一章我们就来干这件事。从头到尾，构建一个真正的自定义媒体播放器。不是Demo，不是玩具，是一个能上线的、有完整架构的播放器。

我会带着你走完四个阶段：需求分析、架构设计、编码实现、测试与发布。每个阶段我都会分享一些我在实际项目中踩过的坑。

30.1 需求分析：别急着写代码

我见过太多人，拿到需求就开始写MediaPlayer的调用代码。结果呢？做到一半发现缺这个缺那个，回头改架构，代码改得面目全非。

先想清楚我们要做什么。

这个播放器的核心需求，我列一下：

• 支持本地和网络播放：本地文件、HTTP/HTTPS流、HLS、DASH
• 基础控制：播放、暂停、seek、停止、循环
• 音视频同步：以音频时钟为基准，视频帧跟随
• 字幕支持：内嵌字幕和外挂字幕文件
• 播放列表：支持队列管理，自动播放下一个
• 状态回调：播放状态、缓冲进度、错误信息
• 性能要求：首帧秒开、低延迟、内存可控

你可能会说：这不就是ExoPlayer的功能吗？对，但我们要做的是自定义实现。为什么？因为在实际项目中，你经常需要定制一些ExoPlayer不提供的功能，比如自定义解码器、特殊的渲染管线、私有协议支持。

30.2 架构设计：分层，还是分层

播放器的架构，说白了就是「数据流」和「控制流」两条线。数据流从源头到渲染，控制流从用户操作到内部状态机。

我个人习惯用三层架构：

• 应用层：UI交互、播放控制API、状态回调
• 核心层：播放引擎、解码器管理、音视频同步、渲染器
• 数据层：数据源读取、解封装、缓存管理

下面这张图，是我在项目中实际使用的架构图。你看一眼就明白了：

你看，数据从底层往上流，控制指令从上层往下传。每一层只做自己的事，不越界。这样做的好处是：哪天你想换解码器，只改核心层；想换UI框架，只改应用层。互不影响。

30.3 编码实现：从数据源到渲染

好，架构定好了，开始写代码。我不会贴全部代码，那太长了。我挑几个关键模块，把核心逻辑讲清楚。

30.3.1 数据源读取

数据源这块，我建议用策略模式。不同的协议（file、http、hls）实现同一个接口。这样上层不用关心数据从哪来。

public interface DataSource {
    long open(String url) throws IOException;
    int read(byte[] buffer, int offset, int length) throws IOException;
    void close() throws IOException;
    long getLength();
}

public class HttpDataSource implements DataSource {
    private HttpURLConnection connection;
    private InputStream inputStream;
    
    @Override
    public long open(String url) throws IOException {
        URL u = new URL(url);
        connection = (HttpURLConnection) u.openConnection();
        connection.setConnectTimeout(5000);
        connection.setReadTimeout(10000);
        inputStream = connection.getInputStream();
        return connection.getContentLengthLong();
    }
    
    @Override
    public int read(byte[] buffer, int offset, int length) throws IOException {
        return inputStream.read(buffer, offset, length);
    }
    
    @Override
    public void close() throws IOException {
        if (inputStream != null) inputStream.close();
        if (connection != null) connection.disconnect();
    }
    
    @Override
    public long getLength() {
        return connection != null ? connection.getContentLengthLong() : -1;
    }
}

这里有个坑：网络流不一定能拿到总长度。所以getLength()返回-1时，上层要做好处理，不能依赖这个值做进度条计算。

30.3.2 解封装与解码

解封装我推荐用MediaExtractor，这是Android官方提供的，支持mp4、mkv、ts等常见格式。解码器用MediaCodec，配合MediaExtractor的轨道信息来配置。

private void setupDecoder(MediaExtractor extractor, int trackIndex) {
    MediaFormat format = extractor.getTrackFormat(trackIndex);
    String mime = format.getString(MediaFormat.KEY_MIME);
    
    // 创建解码器
    MediaCodec decoder = MediaCodec.createDecoderByType(mime);
    decoder.configure(format, surface, null, 0);
    decoder.start();
    
    // 启动解码线程
    new Thread(() -> decodeLoop(extractor, decoder)).start();
}

private void decodeLoop(MediaExtractor extractor, MediaCodec decoder) {
    MediaCodec.BufferInfo info = new MediaCodec.BufferInfo();
    boolean inputDone = false;
    boolean outputDone = false;
    
    while (!outputDone) {
        if (!inputDone) {
            int inputIndex = decoder.dequeueInputBuffer(10000);
            if (inputIndex >= 0) {
                ByteBuffer inputBuffer = decoder.getInputBuffer(inputIndex);
                int sampleSize = extractor.readSampleData(inputBuffer, 0);
                if (sampleSize < 0) {
                    decoder.queueInputBuffer(inputIndex, 0, 0, 0, MediaCodec.BUFFER_FLAG_END_OF_STREAM);
                    inputDone = true;
                } else {
                    decoder.queueInputBuffer(inputIndex, 0, sampleSize, extractor.getSampleTime(), 0);
                    extractor.advance();
                }
            }
        }
        
        int outputIndex = decoder.dequeueOutputBuffer(info, 10000);
        if (outputIndex >= 0) {
            // 这里做音视频同步
            boolean render = syncManager.shouldRender(info.presentationTimeUs);
            decoder.releaseOutputBuffer(outputIndex, render);
            if ((info.flags & MediaCodec.BUFFER_FLAG_END_OF_STREAM) != 0) {
                outputDone = true;
            }
        }
    }
}

嗯，这里要注意：dequeueOutputBuffer返回的info里，presentationTimeUs是解码后的时间戳。音视频同步就是靠这个时间戳来对齐的。

30.3.3 音视频同步

同步这块，我用的方法是「音频时钟为主，视频帧跟随」。说白了，就是音频播放到哪里，视频就渲染到哪里。

public class AVSyncManager {
    private long audioClockUs = 0;
    private static final long THRESHOLD_US = 30000; // 30ms的阈值
    
    public void updateAudioClock(long presentationTimeUs) {
        this.audioClockUs = presentationTimeUs;
    }
    
    public boolean shouldRender(long videoPresentationTimeUs) {
        long diff = videoPresentationTimeUs - audioClockUs;
        if (Math.abs(diff) < THRESHOLD_US) {
            return true; // 在阈值内，直接渲染
        } else if (diff > 0) {
            // 视频快了，等一等
            try {
                Thread.sleep(diff / 1000);
            } catch (InterruptedException e) {
                // 忽略
            }
            return true;
        } else {
            // 视频慢了，丢帧
            return false;
        }
    }
}

30.4 测试与发布：别让用户当小白鼠

代码写完了，但工作才完成一半。测试环节，我建议分三步走：

1. 单元测试：每个模块单独测。比如DataSource的各种协议、状态机的状态转换、同步算法的边界情况。
2. 集成测试：把模块拼起来，测完整的播放流程。重点测：网络切换、seek准确性、播放列表切换、异常恢复。
3. 压力测试：连续播放24小时，看内存会不会涨、会不会卡死。我习惯用MonkeyRunner做自动化压力测试。

发布前，还有几件事要做：

• 混淆配置：MediaCodec相关的类不要混淆，否则运行时找不到解码器。
• 权限声明：网络权限、存储权限（Android 13以上用分媒体权限）。
• 兼容性测试：不同Android版本、不同芯片（高通、联发科、麒麟）的解码器行为不一样。我建议至少覆盖Android 10到14。

30.5 总结

这一章，我们从零开始构建了一个自定义媒体播放器。需求分析阶段，我们明确了核心功能；架构设计阶段，我们用了三层架构，让各层职责清晰；编码实现阶段，我们实现了数据源、解码器、音视频同步；测试与发布阶段，我们强调了测试的重要性和发布前的检查项。

说实话，做一个播放器不难，难的是做好。音视频同步的精度、内存的管控、异常的处理……这些细节决定了播放器的质量。我希望你通过这一章的实战，能真正理解MediaServer的运作方式，而不仅仅是会调API。

好了，课程到这里就结束了。感谢你一路跟下来。如果你在实战中遇到问题，欢迎交流。记住，做多媒体开发，耐心和细心比技术本身更重要。

---

公众号:蓝海资料掘金营，微信deep3321