ExoPlayer 2.18.2中HLS文本轨道缺失问题求助

问题排查与解决思路 #

1. 文本渲染器索引获取逻辑错误

你写的getTextRenderIndex()方法里，循环条件用了0..count，但rendererCount是渲染器总数，索引范围应该是0 until count（即0到count-1）。比如有3个渲染器时，索引是0、1、2，0..count会循环到3，调用getRendererType(3)会触发索引越界异常——虽然你说返回值始终是2，但这个逻辑本身存在隐患，可能干扰后续轨道处理。

修改后的代码：

private fun getTextRenderIndex(): Int {
    val count = contentPlayer?.rendererCount ?: 0
    for (i: Int in 0 until count) { // 替换为until避免越界
        if (contentPlayer?.getRendererType(i) == C.TRACK_TYPE_TEXT) {
            return i
        }
    }
    return -1
}

2. 过早获取轨道信息（媒体源未加载完成）

如果在prepare()后立刻调用currentMappedTrackInfo，此时媒体源还没完成解析，轨道信息自然为空。需要监听播放器的轨道变化回调，在回调内再获取轨道数据：

contentPlayer?.addListener(object : Player.Listener {
    override fun onTracksChanged(tracks: Tracks) {
        super.onTracksChanged(tracks)
        // 此时再获取轨道信息才有效
        val mappedTrackInfo = trackSelector?.currentMappedTrackInfo
        // 这里检查文本轨道是否存在
    }
})

3. DefaultTrackSelector默认禁用文本轨道

DefaultTrackSelector的默认参数可能根据设备策略禁用文本轨道，你可以显式开启支持：

// 初始化trackSelector时配置参数
val trackSelectorParams = DefaultTrackSelector.Parameters.Builder(requireContext())
    .setRendererEnabled(C.TRACK_TYPE_TEXT, true)
    .build()
trackSelector = DefaultTrackSelector(requireContext()).apply {
    parameters = trackSelectorParams
}

4. 特殊字幕格式未被默认渲染器支持

如果你的HLS内嵌字幕是TTML等特殊格式，需要给DefaultRenderersFactory开启扩展渲染器支持（记得先引入对应的扩展库，比如exoplayer-text-ttml）：

val renderersFactory = DefaultRenderersFactory(requireContext())
    .setExtensionRendererMode(DefaultRenderersFactory.EXTENSION_RENDERER_MODE_ON)

5. 媒体源本身的字幕轨道未正确解析

可以先检查MediaItem的轨道列表，确认字幕是否存在：

contentPlayer?.addListener(object : Player.Listener {
    override fun onMediaItemTransition(mediaItem: MediaItem?, reason: Int) {
        super.onMediaItemTransition(mediaItem, reason)
        mediaItem?.tracks?.forEach { trackGroup ->
            trackGroup.mediaTracks.forEach { track ->
                if (track.type == C.TRACK_TYPE_TEXT) {
                    Log.d("Subtitle", "找到文本轨道: ${track.name}")
                }
            }
        }
    }
})

如果这里也找不到文本轨道，大概率是m3u8文件本身的问题——比如字幕轨道标签错误、未正确内嵌到流中。

内容的提问来源于stack exchange，提问作者Eric