将 M3U8 播放列表投放到 Chromecast,与在浏览器中播放并不相同。用户点击“投屏”图标时,网页应用不会从笔记本电脑向电视传送视频数据,而是将 M3U8 URL 和相关元数据发送给 Chromecast 设备;设备再直接从 CDN 获取清单和媒体分片。
为什么 HLS 投屏到 Chromecast 容易出问题
核心难点在于,Chromecast 设备运行在与浏览器不同的网络环境中。它不会共享浏览器的 Cookie、会话存储或本地存储。任何认证或授权信息都必须明确传递给接收端。
Cast 应用框架(CAF)的作用
投放视频需要使用 Cast 应用框架(CAF),它由两部分组成:
- 发送端应用:运行在 Chrome 中的网页播放器,负责界面、发现 Chromecast 设备和启动投屏会话。
- 接收端应用:运行在 Chromecast 设备上的 HTML5/JavaScript 应用,接收媒体 URL,并管理电视上的实际播放、缓冲和画面呈现。
默认媒体接收端与自定义接收端
Google 提供的默认媒体接收端可以直接处理基础 M3U8 URL。但在多数生产环境中,若需要处理 DRM(数字版权管理)、自定义认证令牌、广告插入或电视端品牌界面,则需要自定义接收端或样式化媒体接收端。
处理 Chromecast 的 CORS 请求
由于 Chromecast 会直接获取视频流,CDN 必须配置跨源资源共享(CORS),允许来自 Chromecast 接收端源站的请求。自定义接收端通常托管在自己的域名上,而默认媒体接收端运行在 Google 域名上。
如果视频流在浏览器中能播放,却无法在 Chromecast 上播放,最可能的原因是 Chromecast 请求缺少对应的 Access-Control-Allow-Origin 响应头。
所需的 CORS 响应头
确保服务器返回 Access-Control-Allow-Origin: *(或指定接收端域名),以及 Access-Control-Allow-Headers: Content-Type, Origin, Accept。
检查预检请求(OPTIONS)
Chromecast 会在获取 M3U8 前发送 HTTP OPTIONS 请求。服务器必须返回 2xx 状态码。
常见问题与排查方法
视频流无法在电视上加载
如果 Chromecast 已连接并显示加载画面,却又退回待机画面,请使用 Chrome 远程调试工具检查接收端。在 Chrome 中打开 chrome://inspect/#devices,查看自定义接收端的控制台,就能找到具体的网络错误(例如 403 Forbidden 或 CORS 错误)。
字幕与隐藏式字幕缺失
HLS 视频流通常通过 #EXT-X-MEDIA 标签嵌入 WebVTT 字幕。默认接收端支持基础 WebVTT,但复杂配置可能要求在启动投屏会话时,通过 MediaInfo 对象明确传递字幕轨道。如果字幕独立于 M3U8,还必须配置接收端加载字幕。
认证与令牌传递
Chromecast 无法获取浏览器的 Cookie,因此必须手动传递认证令牌。通常可以把令牌附加到 M3U8 URL(如 stream.m3u8?token=xyz),或者使用自定义接收端拦截请求,通过 cast.framework.PlaybackConfig#manifestRequestHandler 注入授权请求头。
代码示例:基础发送端实现
下面展示如何在网页播放器中配置发送端,使用 CAF Sender API 投放 M3U8 视频流:
// Initialize the Cast Context
cast.framework.CastContext.getInstance().setOptions({
receiverApplicationId: chrome.cast.media.DEFAULT_MEDIA_RECEIVER_APP_ID,
autoJoinPolicy: chrome.cast.AutoJoinPolicy.ORIGIN_SCOPED
});
function castM3U8(url, title) {
const castSession = cast.framework.CastContext.getInstance().getCurrentSession();
if (!castSession) {
console.error("No active cast session");
return;
}
// Set up the media info
const mediaInfo = new chrome.cast.media.MediaInfo(url, 'application/x-mpegurl');
mediaInfo.metadata = new chrome.cast.media.GenericMediaMetadata();
mediaInfo.metadata.title = title;
// Explicitly define stream type as LIVE or BUFFERED (VOD)
mediaInfo.streamType = chrome.cast.media.StreamType.BUFFERED;
const request = new chrome.cast.media.LoadRequest(mediaInfo);
castSession.loadMedia(request).then(
function() { console.log('Cast loaded successfully'); },
function(errorCode) { console.error('Cast error: ' + errorCode); }
);
}
测试 Chromecast 投屏实现
- 网络隔离:测试时让发送端和接收端处于同一局域网,因为 mDNS 设备发现需要这一条件。
- 远程调试:始终使用
chrome://inspect查看接收端控制台。这是可靠查看电视端 HLS 解析错误或分片 404 错误的方法。 - HTTPS 要求:CAF 要求发送端应用和接收端应用均托管在 HTTPS 上(开发时可使用 localhost)。
总结
为 M3U8 视频流实现 Chromecast 投屏,不只是添加一个按钮。还要确保电视所在网络能访问 HLS 清单和分片,正确处理 CORS,并传递必要的认证信息。可以先用默认媒体接收端测试原始视频流的访问;需要高级请求头处理或 DRM 时,再改用自定义接收端。