视频点播字幕异常排查指南

步骤一：验证字幕文件格式

视频点播字幕功能仅支持WebVTT(.vtt)格式，非标准文件将导致解析失败。使用前请确认.vtt文件符合以下规范。

1. 文件头：首行必须为WEBVTT，无多余字符或BOM头。

2. 编码格式：必须使用UTF-8编码。

3. 时间戳格式：格式必须为HH:MM:SS.mmm --> HH:MM:SS.mmm或MM:SS.mmm --> MM:SS.mmm，注意-->两侧有空格。

4. 内容分隔：字幕块间（时间戳和字幕内容）需有空行间隔。

示例：

WEBVTT
00:00:01.000 --> 00:00:05.000
第一条字幕内容
00:00:06.000 --> 00:00:10.000
第二条字幕内容
NOTE This is a comment and will not be displayed in the video
00:00:11.000 --> 00:00:13.000
第三条字幕内容

步骤二：验证字幕上传流程

API上传字幕文件需完成获取凭证和上传文件两个步骤：

1. 获取凭证：调用CreateUploadAttachedMedia - 获取辅助媒资上传地址和凭证接口获取上传凭证和地址。

2. 上传文件：使用上传凭证和地址上传本地.vtt字幕文件至点播存储，详情可参考通过视频点播API上传媒体文件。

步骤三：验证字幕存储地址公网访问

将字幕打包模板中填写的字幕存储地址复制到浏览器，应能直接显示字幕文件内容，或提示下载该.vtt文件，否则请检查并修正字幕地址。

步骤四：验证字幕成功打包

视频点播字幕打包功能仅支持HLS自适应码流（.m3u8格式）地址。使用前请确认播放地址为自适应地址，MP4等原始文件地址无法加载打包字幕。

登录视频点播控制台，进入媒资库>音/视频，点击操作列的管理，进入视频地址页签。视频地址列表内应包含自适应且格式为.m3u8的码流地址，否则请检查并修正字幕打包配置，详情请参考点播多码率自适应配置。

步骤五：验证播放器正确设置

确保播放器支持HLS协议WebVTT字幕，阿里云播放器SDK默认支持。

1. 播放后点击右下角字幕设置按钮。

2. 检查菜单中应显示设置的字幕名称。

   

3. 点击选项开启字幕显示。

若无选项或显示关闭，请检查播放器设置。