HLS トラブルシューティング マップ
| Problem | 考えられる原因 | 最高の次のページ |
|---|---|---|
| M3U8 リンクは再生されません | マニフェスト、CORS、セグメント、コーデック、または DRM にわたる広範な再生エラー。 | M3U8 リンクが再生されない |
| ブラウザでCORSエラーが発生しました | オリジンでは、ブラウザーによるマニフェスト、キー、またはセグメントへのアクセスが許可されていません。 | HLS CORS エラー |
| 403 禁止 | 署名された URL の有効期限が切れているか、サーバーがリクエスト シェイプを拒否します。 | M3U8403 禁止 |
| Referer またはカスタムヘッダーが必要です | ホットリンク保護は、元のページまたは通常のブラウザ クライアントを想定しています。 | カスタム Referer M3U8 プレーヤー |
| AES-128 キーが失敗する | キー URI がブロックされているか、期限切れであるか、CORS が欠落しているか、Referer が必要です。 | M3U8 キーがロードされない |
| 再生が開始されてから停止する | 1 つ以上のメディア セグメントが無効になっているか、過負荷になっているか、または別の方法で保護されています。 | HLS ストリームテスター |
| IPTV プレイリストが失敗する | M3U ファイルの形式が正しくないか、解析後に空であるか、無効なチャネル URL がいっぱいです。 | IPTV プレイリストが機能しない |
| DRM で保護されたストリーム | Widevine、FairPlay、または PlayReady には、ライセンスされた再生パスが必要です。 | 暗号化されたM3U8プレーヤー |
HLS または M3U8 ストリームのトラブルシューティング方法
- 1URL が本物の HLS マニフェストであることを確認するURL を開くか、プレーヤーに貼り付けます。有効な HLS マニフェストは通常、#EXTM3U で始まり、#EXT-X-STREAM-INF、#EXTINF、#EXT-X-KEY、または #EXT-X-ENDLIST などのタグが含まれます。
- 2失敗したリクエストを特定する最初の失敗がマスター マニフェスト、メディア プレイリスト、AES-128 キー、または .ts/.m4s メディア セグメントであるかどうかを確認します。修正はその場所によって異なります。
- 3ダイレクト再生とプロキシ再生を比較するまずURL を直接テストしてください。ストリームが VLC またはプロキシ経由では機能するが、ブラウザーでは機能しない場合、問題は通常、デッド ストリームではなく、CORS またはリクエスト ヘッダーにあります。
- 4必要な場合にのみ Referer または User-Agent を追加しますアクセスを許可されているホットリンクで保護されたストリームの場合は、元のページを Referer に設定し、通常のブラウザ User-Agent を使用します。オリジンで必要な場合を除き、カスタム ヘッダーを追加しないでください。
- 5ヘルスレポートを実行するバリデーターを使用して、バリアント、ビットレート、暗号化、ライブ/VOD ステータス、およびサンプリングされたセグメントの失敗をリストします。これにより、実際の CDN またはプレイリストの問題とブラウザ アクセスの問題が区別されます。
- 6コーデックと DRM の制限で停止するリクエストに到達できるにもかかわらず再生が失敗する場合は、コーデックと保護を確認してください。ブラウザ プレーヤーはすべてのコーデックをデコードできるわけではありません。また、このツールは Widevine、FairPlay、PlayReady、ペイウォール、ライセンス サーバーをバイパスしません。
最初の URL だけでなく、リクエスト チェーンを使用します。
HLS セッションはリクエストのチェーンです。最初の M3U8 ファイルは、子プレイリスト、AES-128 キー、またはそれ以降のセグメントが失敗してもロードできます。キーの CORS エラー、1 つのセグメントの 403、期限切れのマスター マニフェストには異なる修正が必要なため、適切なトラブルシューティングはチェーンを順番にたどります。
このハブがキーワードの重複を回避する方法
このページは、HLS のトラブルシューティング、M3U8 のトラブルシューティング、HLS の再生エラーの修正など、幅広いクエリを対象としています。リンクされたスポーク ページは、正確な原因をターゲットにしています: CORS、403 禁止、Referer、キーの読み込み、デッド セグメント、IPTV プレイリストの解析、字幕、暗号化された HLS、およびアップロードなしの変換。
プレーヤー、バリデーター、コンバーターをいつ使用するか
プレーヤーを使用して基本的な再生を確認し、プロキシと Referer コントロールを使用してブラウザのアクセス問題をテストし、バリデータを使用してバリアントとサンプリングされたセグメントを検査し、コンバータを使用できるのはストリームに到達した後でのみです。変換では、期限切れ、アクセス不能、または DRM で保護されたストリームを修復することはできません。
スポークのトラブルシューティング
- M3U8 リンクが再生されない これは、障害が CORS、Referer、デッド セグメント、コーデック、または DRM のいずれであるかがわからない場合に最初に行うべき手段です。
- HLS CORS エラー VLC ではストリームを再生できるのに、Chrome、Edge、Safari、または Firefox では再生できない理由を説明します。
- M3U8403 禁止 期限切れの署名、ホットリンク保護、User-Agent フィルター、セグメント レベルの 403 をカバーします。
- カスタム Referer M3U8 プレーヤー は、元のページからのリクエストを予期するストリームをテストする方法を示しています。
- M3U8 キーがロードされない AES-128 キー URI の失敗、ブロックされたキー、および暗号化された HLS デバッグに焦点を当てています。
- HLS ストリームテスター ヘルス レポートを使用して、バリアント、ビットレート、ライブ/VOD ステータス、サンプリングされたデッド セグメントを検査します。
- IPTV プレイリストが機能しない 不正な M3U ファイル、空のチャンネル リスト、無効な IPTV URL、およびタグの問題を診断します。
- 暗号化されたM3U8プレーヤー テストできる AES-128 HLS とバイパスできない DRM の間の境界を設定します。
よくある質問
M3U8 ストリームをデバッグする最速の方法は何ですか?
まず、マスター マニフェスト、メディア プレイリスト、AES-128 キー、またはセグメントのうち、どの HLS リクエストが失敗したかを見つけます。次に、直接再生とプロキシ再生を比較し、健全性レポートを実行して、CORS、403、Referer、デッドセグメント、コーデック、および DRM の問題を分離します。
HLS は VLC では再生されるのに、ブラウザでは再生されないのはなぜですか?
VLC はブラウザの CORS ルールによって制限されず、ほとんどのブラウザよりも多くのコーデックをサポートします。 VLC は機能するがブラウザが失敗する場合は、まず CORS プロキシでテストし、次にオリジンでこれらのヘッダーが必要な場合にのみ Referer または User-Agent を追加します。
M3U8 リンクが無効かどうかを確認するにはどうすればよいですか?
無効な M3U8 リンクは通常、ブラウザーとデスクトップ プレーヤーの両方で失敗するか、マニフェストをロードしても後のセグメントで 404、403、タイムアウト、または空の応答が返されます。ヘルス レポートは、最初のマニフェストだけをチェックするのではなく、メディア セグメント URL をサンプリングすることで役立ちます。
プロキシはすべてのHLS 再生エラーを修正できますか?
いいえ。プロキシは、ブラウザ CORS および一部の許可された Referer/User-Agent のテストには役立ちますが、期限切れのトークン、IP 制限、利用できないセグメント、サポートされていないコーデック、ペイウォール、DRM、またはライセンス サーバーの要件を修正することはできません。
これは DRM で保護されたストリームのトラブルシューティングを行いますか?
DRM 境界を識別できますが、 Widevine、FairPlay、PlayReady、ペイウォール、またはライセンス システムをバイパスすることはありません。 DRM で保護されたストリームの場合は、承認されたアプリ、プレーヤー、またはライセンス フローを使用します。