本文へ移動
再生トラブル対処ガイド

ブラウザーでHLSのバッファリングとカクつきを調べる方法

再生がたびたび止まったりフレームが飛んだりすると、視聴は困難になります。原因を特定するには、ネットワーク状態、セグメントの長さ、キーフレームを確認し、ブラウザーの診断ツールを正しく読み取る必要があります。

バッファリングによる停止とカクつきは別の現象ですが、原因は重なることがあります。停止は通常、再生に必要な速さでセグメントをダウンロードできず、バッファーが空になると発生します。一方、カクつきはセグメントが間に合っていても、キーフレームのずれ、CPU負荷、メディアのパッケージ化の問題でブラウザーが滑らかにデコードできないときに起こります。

このガイドでは、Webの診断ツールで問題を切り分け、.m3u8プレイリストの構造を調べ、HTTP Live Streaming(HLS)の配信経路を確認する方法を説明します。

バッファリングによる停止か、カクつきか?

コマンドを実行する前に、まず症状を特定します。

  • バッファリングによる停止:動画が止まり、読み込み表示が出て、音声も止まります。多くの場合、配信経路や回線速度、利用可能な帯域を過大評価した適応ビットレート(ABR)の判断が原因です。
  • カクつき:再生は続くものの映像の動きがぎこちなく、音声は正常でも映像のフレームが飛ぶことがあります。デコードの問題、可変フレームレート、セグメント境界のIDRキーフレーム不足が疑われます。

ネットワークと帯域幅の問題を調べる

まず、現在の画質のセグメントを取得する帯域が視聴端末にあるか確認します。有線の高速回線では正常で4Gでは止まるなら、ABRまたは帯域推定の問題が考えられます。

マスタープレイリストを確認

#EXT-X-STREAM-INFのBANDWIDTHが正確か確認します。1080pの映像が2,000,000 bps(2 Mbps)と宣言されていても、動きの多い場面で実際には8 Mbpsに達するなら、プレーヤーは画質切り替えを誤り、再生が止まります。

ネットワークタブを分析

Chrome DevTools(F12)の[Network]を開き、.tsまたは.m4sで絞り込んでセグメントのリクエストを見ます。最初の1バイトを受け取るまでの時間(TTFB)が長すぎる場合(例:500ms超)、CDNのキャッシュ不足や配信元サーバーの負荷が考えられます。

セグメントの取得時間が再生時間を超える場合(例:6秒分の取得に8秒かかる場合)、再生は止まります。低い画質への切り替え、回線の改善、CDNキャッシュの最適化を検討してください。

セグメントの長さとEXTINFの不一致

HLS仕様では、#EXTINFタグに直後のメディアセグメントの長さを記載します。整数での指定も認められてきましたが、精度が必要な場合は小数で記載します。

メディアプレイリストでは、#EXTINF:6.006,のように小数で長さを記載してください。#EXTINF:6,のような整数では、セグメントごとの数ミリ秒の差が累積し、プレーヤーの内部時間と実際の映像がずれて、細かなカクつきや音ずれにつながる場合があります。

さらに#EXT-X-TARGETDURATIONを確認します。これはプレイリスト内のセグメントの最大長を示します。#EXTINF:8.000,のセグメントがあるのに#EXT-X-TARGETDURATION:6だと、AppleのAVPlayerなど厳格なプレーヤーは再生を拒否したり、不安定になったりします。

キーフレームとコーデックの不一致

HLSでは各映像セグメントをIDRキーフレームから始める必要があります。PフレームやBフレームで始まると、次のキーフレームまでデコーダーが映像を復元できず、セグメントの冒頭でカクつき、映像の乱れ、停止が起こります。

キーフレームの位置を確認する

FFmpegとFFprobeでセグメント内のフレームを調べ、先頭にIDRフレームがあるか確認できます。

ffprobe -show_frames -select_streams v:0 -print_format json segment-001.ts | grep -E 'pict_type|key_frame'

出力の最初のフレームで"key_frame": 1と"pict_type": "I"を探します。キーフレームでなければエンコーダーを調整し、セグメントの長さがキーフレーム間隔(GOPサイズ)の整数倍になるようにします。例えば30fpsで6秒のセグメントなら、180フレームごとにキーフレームを設定します。

CORSと配信の問題に対処する

読み込み表示が出ても、バッファー不足とは限りません。次のセグメントや暗号鍵の取得時にCORS(オリジン間リソース共有)エラーが起きると、プレーヤーは停止し、読み込み表示だけが残ることがあります。

ブラウザーのコンソール(DevTools > Console)でCORSエラーを確認してください。CDNまたは配信元は、プレイリストとセグメントの両方で適切なヘッダーを返す必要があります。

  • Access-Control-Allow-Origin: * (または許可するドメイン)
  • Access-Control-Allow-Methods: GET, HEAD, OPTIONS

Webサーバーがセグメントを正しいMIMEタイプ(.tsにはvideo/MP2T、.m4sにはvideo/iso.segment)で配信しているかも確認します。誤ったタイプではブラウザーが内容の判定処理を行い、遅延が増える場合があります。

Chromeのメディア診断ツールを使う

Chromeにはメディア再生専用の診断画面があります。chrome://media-internalsを開くか、DevToolsでEscを押してメニューから[Media]パネルを選びます。

このツールではHTML5の<video>要素の内部処理を確認できます。

  • プレーヤーイベント:kBufferingStateChangedやkVideoErrorを確認します。
  • バッファー量:メモリに保持された音声・映像の量を確認します。
  • ドロップしたフレーム:数が多ければ、ネットワークによる停止よりもデコード処理やCPU・ハードウェアの性能不足によるカクつきが疑われます。

HLS.jsのイベントを活用する

Safari以外のブラウザーでHLS再生にHLS.jsを使っているなら、イベントを監視してバッファリングやエラーをプログラムから追跡できます。

Hls.Events.ERRORを監視し、data.detailsを確認します。停止につながる主なエラーは次のとおりです。

  • bufferStalledError: 再生用のバッファーデータがなくなりました。
  • bufferAppendError: コーデックの不一致やファイルの破損などで、ブラウザーがMediaSourceのバッファーにセグメントを追加できませんでした。
  • fragLoadTimeout: セグメントの取得に時間がかかりすぎています。ネットワークの混雑が考えられます。

これらのイベントを監視すれば、代替処理や手動でのビットレート引き下げを実装し、再生状況をログで分析できます。