如何通过通信消息在谷歌Cast Styled Media Receiver上显示字幕
正确的Payload配置说明
你之前的配置错误是将字幕参数放在了customData字段中,Chromecast标准接收端不会读取该自定义字段下的字幕配置,需要按照官方标准协议调整结构:
- 字幕轨道定义放在
media下的tracks数组中 - 在LOAD消息根节点添加
activeTrackIds数组,指定需要激活的字幕轨道ID
完整正确配置示例:
{ "type": "LOAD", "autoPlay": true, "currentTime": currentTime, "activeTrackIds": [1], // 对应下方trackId为1的字幕轨道 "media": { "contentId": url, "contentType": "video/mp4", "streamType": "BUFFERED", "metadata": { "type": 0, "metadataType": 0, "title": title, "images": [ { "url": posterUrl } ] }, // 标准字幕轨道定义位置 "tracks": [ { "trackId": 1, // 唯一数字ID,需和activeTrackIds对应 "type": "TEXT", // 固定值表示文本轨道 "subtype": "SUBTITLES", // 可选值为SUBTITLES/CAPTIONS "name": "示例字幕", // 字幕选择菜单显示的名称 "language": "en", // 字幕对应的语言码 "contentId": "https://gist.githubusercontent.com/samdutton/ca37f3adaf4e23679957b8083e061177/raw/e19399fbccbc069a2af4266e5120ae6bad62699a/sample.vtt", // 字幕文件地址 "contentType": "text/vtt" // VTT格式字幕固定填该值 } ] } }
额外注意事项
- 确保VTT文件所在的服务器配置了正确的CORS规则,允许Chromecast接收端的跨域请求
- 需要切换字幕时,发送
EDIT_TRACKS_INFO类型的消息修改activeTrackIds字段即可,无需重新加载整个媒体资源 - 如果使用自定义接收端,需要确认已开启字幕渲染相关配置,使用官方默认样式接收端无需额外修改
内容的提问来源于stack exchange,提问作者vanlooverenkoen
相关产品推荐
相关产品推荐

