方法論

M3U8 / HLS パーサーのテスト方法とマニフェスト検証基準

M3U8 / HLS パーサーの検証手順。Master PlaylistとMedia Playlistの判別、Variant解像度、分離された音声・字幕グループ、セグメント到達性、暗号化タグの検査基準を解説します。

更新日
2026-11-16
著者
AnyVidDL content team

M3U8 / HLS パーサーのテストでは、アクセスが許可された `.m3u8` マニフェストを使用し、Master PlaylistとMedia Playlistの判別、Variantストリームの抽出、分離された音声・字幕グループ(`#EXT-X-MEDIA`)の紐付け、セグメントURLの到達性、および暗号化タグ(`#EXT-X-KEY`)の検出を段階的に検証します。DRM保護や認証必須の配信は検証の対象外です。

M3U8 / HLS パーサー検証の目的と前提

HLS(HTTP Live Streaming)の拡張子である .m3u8 ファイルは、動画データそのものではなく、プレイリスト(マニフェスト)を記述したテキストファイルです。そのため、.m3u8 のURLを認識できることと、最終的に再生可能な1本の動画ファイル(MP4やMKV)として出力できることはイコールではありません。

本ページでは、AnyVidDLのM3U8解析機能や関連ワークフローを評価する際に、どの技術要素をどの順番で検査し、どこで処理停止と判断するかの基準を定義します。テストはすべて公開または検証が許可されたサンプルストリームに対してのみ行い、DRMや有料配信の回避は行いません。

マニフェスト構造とパーサーの検査項目

HLSパーサーの挙動を正確に評価するため、以下の5つの技術的観点からマニフェストとストリームを検査します。

検査段階 確認する主なHLSタグ・要素 検証内容と判定ポイント
1. プレイリスト種別の判別 #EXT-X-STREAM-INF / #EXTINF 入力されたURLが複数の画質を束ねる Master Playlist か、単一画質のセグメント一覧である Media Playlist かを正しく識別できるか。
2. Variantストリームの抽出 BANDWIDTH, RESOLUTION, CODECS Master Playlistから各解像度・ビットレートの選択肢を漏れなく抽出し、ユーザーが選択可能な候補として表示できるか。
3. 分離音声・字幕の紐付け #EXT-X-MEDIA:TYPE=AUDIO / SUBTITLES, GROUP-ID 映像ストリームと音声トラックが別ファイルとして配信されている場合、AUDIO グループを認識し、出力時に無音にならないよう結合対象に含められるか。
4. セグメントURLの解決と到達性 相対パス / 絶対パス, #EXT-X-MAP, .ts / .m4s プレイリスト内の相対URLをベースURLと正しく結合できるか。fMP4形式の場合、初期化セグメント(#EXT-X-MAP)を欠落なく取得できるか。
5. 配信形態と暗号化の検出 #EXT-X-PLAYLIST-TYPE, #EXT-X-ENDLIST, #EXT-X-KEY VOD(完結した動画)かライブ配信(進行中)かを区別できるか。また暗号化方式(METHOD=AES-128, SAMPLE-AES など)を検出し、非対応またはDRM保護時に適切に停止できるか。

段階別の検証手順

1. 入力URLの種別確認(直リンクかページURLか)

テストでは、.m3u8 の直接リンクを入力した場合と、動画を埋め込んだWebページのURLを入力した場合を区別します。AnyVidDLに .m3u8 リンクを貼り付けた場合、それがプレイリスト参照のみを返すのか、サーバー側でセグメントを取得・結合して実行可能なMP4/MKVとして準備できるのかを確認します。

2. 相対パスとクエリパラメータの保持検査

多くのCDNでは、マニフェストやセグメントへのアクセスに署名付きクエリトークン(有効期限付きのパラメータ)を使用します。パーサーがMaster PlaylistからMedia Playlist、さらに各 .ts や .m4s セグメントのURLを解決する際、相対パスの階層計算が正しいか、必要な認証トークンが欠落してHTTP 403エラーを引き起こさないかを確認します。

3. 暗号化タグ(#EXT-X-KEY)と停止条件の確認

マニフェスト内に #EXT-X-KEY タグが存在する場合、以下の基準で挙動を分類します。

  • METHOD=NONE またはタグなし: 暗号化されていないストリーム。通常のセグメント取得と結合のテストに進みます。
  • METHOD=AES-128(公開キー): 標準的なAES-128暗号化。アクセス制限のない環境で正当に処理できるか、または未対応として明示的にエラーを返すかを確認します。
  • DRM(Widevine, FairPlay, PlayReady等)および SAMPLE-AES: 権利保護されたストリームです。パーサーは回避を試みず、保護されたコンテンツとして即座に処理を停止するのが正しい動作です。

4. 出力ファイルの整合性チェック

セグメントの取得と結合が完了し、MP4またはMKVファイルが出力された場合、ダウンロード完了表示だけで合格とはしません。生成されたファイルをメディアプレイヤーで開き、以下の点を確認します。

  • 総再生時間がマニフェストの #EXTINF 合計値と一致しているか(途中切れがないか)
  • シークバーを動かして先頭・中間・末尾へ移動できるか(タイムスタンプやインデックスの破損がないか)
  • 映像と音声のズレ(音ズレ)や、別音声トラックの欠落による無音化が起きていないか

テストにおける制限と再現性の注意点

HLSの配信URLは一時的なトークンを含むことが多く、時間が経過すると期限切れ(HTTP 403 / 410)になります。そのため、過去に成功したURLであっても恒久的なテストケースとしては使えません。再検証を行う際は、ブラウザーの開発者ツール(Networkタブ)等から最新のマニフェスト状態を確認した上で実施します。

関連ガイド

FAQ

Master PlaylistとMedia Playlistのどちらを使ってテストすべきですか?

原則として両方を確認しますが、最初はMaster Playlistを使用します。Master Playlistを入力することで、画質一覧(Variant)の抽出と、分離された音声トラック(#EXT-X-MEDIA)の紐付けが正しく機能するかを同時に検証できるためです。

M3U8の解析はできたのに、保存した動画から音が出ないのはなぜですか?

HLS配信では映像と音声が別々のm3u8プレイリストに分かれていることがよくあります。映像側のMedia Playlistだけを取り出して結合すると無音のファイルになるため、Master Playlistから音声グループも含めて処理する必要があります。

DRMやログインが必要なM3U8ストリームもテスト対象になりますか?

いいえ。DRM(#EXT-X-KEYによる商用暗号化など)、有料ペイウォール、ログインCookieが必要な配信は検証の対象外であり、パーサーが回避を行わず適切に停止することのみを確認します。

関連ページ