本文へスキップ
高度なWeb再生

M3U8ストリームをChromecastにキャストする方法

WebベースのM3U8プレーヤーからChromecastへ送るには、送信側アプリから受信側アプリへストリームの情報を渡します。CORS、別オリジンの認証、複数画質への対応などを含め、HLSをテレビで再生する実装上の要点を説明します。

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を使います。