You need to enable JavaScript to run this app. 如何通过通信消息在谷歌Cast Styled Media Receiver上显示字幕
优惠活动
大模型
产品
解决方案
定价
更多

如何通过通信消息在谷歌Cast Styled Media Receiver上显示字幕

正确的Payload配置说明

你之前的配置错误是将字幕参数放在了customData字段中,Chromecast标准接收端不会读取该自定义字段下的字幕配置,需要按照官方标准协议调整结构:

  1. 字幕轨道定义放在media下的tracks数组中
  2. 在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

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.10.10 11:18:02