第二章 自定义RenderersFactory注入：Renderer接口、编解码器适配、视频/音频/文本渲染器注册

2.1 原理：Renderer接口与工厂注入模型

ExoPlayer中的每个媒体轨道最终由对应的Renderer实例处理。Renderer接口定义了播放器与渲染器之间的生命周期协定：

• init(…) – 初始化渲染器，绑定播放上下文。
• render(long positionUs, long elapsedRealtimeUs) – 在渲染循环中被周期性调用，输出媒体数据。
• isReady() / isEnded() – 状态查询。
• handleMessage(int messageType, Object message) – 接收播放器下发的事件（如音量、字幕样式）。

RenderersFactory是ExoPlayer.Builder中的一个注入点，负责在Player构建时一次性创建所有Renderer实例。默认实现会注册系统MediaCodec支持的音视频渲染器，以及一个TextViewOutput用于字幕。自定义RenderersFactory允许开发者：

• 替换默认编解码器适配逻辑（例如接入硬件加速、自定义解码器）。
• 添加自定义渲染器（如第三方图像渲染器、自定义字幕解析器）。
• 控制渲染器的优先级/顺序。

2.2 自定义RenderersFactory实现流程

1. 实现RenderersFactory接口，重写createRenderers()方法。
2. 在createRenderers()中创建CodecAdapter实例（封装MediaCodec适配逻辑）。
3. 使用适配器构建MediaCodecVideoRenderer、MediaCodecAudioRenderer等标准渲染器，或注入自定义实现。
4. 注册文本渲染器（如TextRenderer或其子类），用于字幕/章节输出。
5. 返回包含所有渲染器的数组（顺序决定轨道匹配优先级）。

2.3 核心代码：自定义RenderersFactory实例

以下示例展示了如何注入一个自定义渲染器工厂，该工厂注册了视频、音频和文本渲染器，并使用自定义CodecAdapter来调整MediaCodec配置：

public class CustomRenderersFactory implements RenderersFactory {
    @Override
    public Renderer[] createRenderers(
            Handler eventHandler,
            MediaCodecSelector codecSelector,
            int allowedVideoJoiningTimeMs,
            @Nullable DrmSessionManager drmSessionManager,
            boolean playClearSamplesWithoutKeys,
            boolean enableDecoderFallback,
            @Nullable MediaCodecAdapterFactory mediaCodecAdapterFactory) {

        // 1. 自定义CodecAdapter工厂（示例：启用低延迟解码）
        MediaCodecAdapterFactory customAdapterFactory = (format, codecInfo, flags) -> {
            MediaCodecAdapter adapter = new DefaultMediaCodecAdapterFactory()
                    .createAdapter(format, codecInfo, flags);
            // 可在此修改MediaFormat等参数
            return adapter;
        };

        // 2. 创建视频渲染器
        MediaCodecVideoRenderer videoRenderer = new MediaCodecVideoRenderer(
                eventHandler, codecSelector, allowedVideoJoiningTimeMs,
                drmSessionManager, playClearSamplesWithoutKeys, enableDecoderFallback,
                customAdapterFactory, null, 0);

        // 3. 创建音频渲染器
        MediaCodecAudioRenderer audioRenderer = new MediaCodecAudioRenderer(
                eventHandler, codecSelector, drmSessionManager,
                playClearSamplesWithoutKeys, enableDecoderFallback,
                customAdapterFactory, null, null, 0);

        // 4. 创建文本渲染器（使用自定义字幕输出）
        TextRenderer textRenderer = new TextRenderer() {
            @Override
            public void onCues(List<Cue> cues) {
                // 自定义字幕处理逻辑
            }
        };

        return new Renderer[] {
                videoRenderer,   // 0: 视频
                audioRenderer,   // 1: 音频
                textRenderer     // 2: 文本
        };
    }
}

在构建ExoPlayer时注入：

ExoPlayer player = new ExoPlayer.Builder(context)
        .setRenderersFactory(new CustomRenderersFactory())
        .build();

2.4 编解码器适配（CodecAdapter）核心机制

2.5 调试与验证

• 日志验证：在createRenderers()中添加Log.d输出创建的渲染器类型及数量。
• 使用ExoPlayer.getRendererCount()在运行时确认渲染器已正确注入。
• 断点测试：在自定义TextRenderer.onCues()中设断点，确认字幕事件到达。
• 编解码器日志：打开ExoPlayer自带ExoLogging.MediaCodec日志级别，观察MediaCodec创建参数。

2.6 性能与稳定性优化

1. 复用渲染器实例：避免在createRenderers()中创建高开销对象（如线程池），推荐在工厂构造时初始化。
2. 按需注册渲染器：若应用不需要文本渲染，可返回new Renderer[]{videoRenderer, audioRenderer}减少内存。
3. 自定义CodecAdapter的内存池：对MediaCodec的输出缓冲使用BufferPool减少GC。
4. 降级策略：在MediaCodecAdapterFactory内捕获MediaCodec.CodecException，回退到软件解码。
5. 测试不同设备：在低端设备上确保自定义渲染器不产生额外内存抖动。

2.7 常见错误与避坑