Chromecastへのキャストは、ブラウザー内での再生とは異なります。「Cast」アイコンを押しても、PCが動画データをテレビへ送るわけではありません。WebアプリがM3U8 URLと関連情報をChromecastに渡し、ChromecastがCDNからマニフェストとセグメントを直接取得します。
HLSのChromecast再生が難しい理由
Chromecastはブラウザーとは別のネットワーク環境で動作し、Cookie、セッションストレージ、ローカルストレージを共有しません。認証情報は受信側に明示的に渡す必要があります。
Cast Application Framework(CAF)の役割
動画のキャストには、次の2つから成るCast Application Framework(CAF)を使います。
- 送信側アプリ:Chromeで動くWebプレーヤーです。UI、Chromecastの検出、セッションの開始を担当します。
- 受信側アプリ:Chromecast上で動くHTML5/JavaScriptアプリです。メディアURLを受け取り、テレビでの再生、バッファリング、表示を担当します。
デフォルトとカスタムのレシーバー
GoogleのDefault Media Receiverは基本的なM3U8 URLに対応します。ただし、DRM、独自の認証トークン、広告挿入、テレビ画面の独自UIが必要なら、Custom ReceiverやStyled Media Receiverを使います。
Chromecast向けのCORS設定
Chromecastがストリームを直接取得するため、CDNはレシーバーのオリジンからのリクエストをCORSで許可する必要があります。Custom Receiverは通常自分のドメインで、Default Media Receiverは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://inspect/#devicesを開き、Custom Receiverのコンソールで403 ForbiddenやCORSエラーなどを確認します。
字幕が表示されない
HLSでは#EXT-X-MEDIAタグでWebVTT字幕を指定することがあります。デフォルトのレシーバーは基本的なWebVTTに対応しますが、構成によってはキャスト開始時にMediaInfoへ字幕トラックを明示する必要があります。字幕がM3U8と別にある場合は、レシーバーで読み込みを設定します。
認証とトークンの受け渡し
ChromecastにはブラウザーのCookieがないため、認証トークンを別途渡します。M3U8 URLに付ける方法(例:stream.m3u8?token=xyz)や、Custom Receiverでリクエストを処理し、cast.framework.PlaybackConfig#manifestRequestHandlerで認証ヘッダーを付ける方法があります。
コード例:送信側の基本実装
CAF Sender APIを使ってWebプレーヤーの送信側から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も利用できます)。
まとめ
ChromecastへのM3U8配信には、テレビからHLSマニフェストとセグメントにアクセスできること、CORS設定、認証情報の受け渡しが必要です。まずDefault Media Receiverで接続を確認し、ヘッダーの操作やDRMが必要になったらCustom Receiverを使います。