このトピックでは、動画再生の問題を特定し、解決する方法について説明します。
トラブルシューティング戦略
動画再生は、さまざまな理由で失敗することがあります。 原因を特定するには、まずエラーにパターンがあるかどうかを確認します。 パターンがある場合は、次の表にある考えられる原因を参考に調査を進めてください。 明確なパターンがない場合は、エンドデバイス、メディアストリーム、ネットワークを確認して問題をトラブルシューティングします。 それでも原因を特定できない場合は、Alibaba Cloud のテクニカルサポートにお問い合わせください。
分布パターンがあるエラー：
エラーパターン
考えられる原因
特定の ISP ネットワークまたは地域のユーザーにおいて、再生が失敗します。
この問題は、地域のローカルキャリアネットワークの問題、または CDN スケジューリングの問題が原因である可能性があります。
特定のオペレーティングシステムを搭載したエンドデバイスにおいて、再生が失敗します。
この問題は、プラットフォーム間の SDK 実装の違いや、システムの互換性の問題が原因である可能性があります。
特定のブランドまたはモデルのエンドデバイスにおいて、再生が失敗します。
この問題は、デバイスの互換性の問題が原因である可能性があります。
特定の音声ファイルまたは動画ファイルで再生が失敗します。
この問題は、メディアファイルのエンコード、CDN プリフェッチ、またはビジネスアクセスポリシーの問題が原因である可能性があります。
明確な分布パターンがないエラー： 原因は複雑である可能性があります。 この場合、コンテンツからユーザーまでのワークフローを追跡して、問題のあるノードを特定し、根本原因を突き止めてください。
ステップ 1：エンドデバイスの確認
エンドデバイスの互換性
まず、メディアストリームプロトコルがオペレーティングシステムとアプリケーション環境でサポートされていることを確認します。 サポートされていない場合は、ストリームをトランスコードする必要があります。 詳細については、「トランスコードの推奨事項」をご参照ください。 次の表に、Player SDK でサポートされている動画プロトコルとコーデックを示します。
ネイティブアプリ
オペレーティングシステム | ビデオコーデック | ビデオプロトコル | オーディオコーデック |
Android |
|
|
|
iOS | |||
Windows | |||
macOS | |||
Linux |
Web
メディアストリームプロトコルが以下の Web 互換性要件を満たしている場合は、SSL 証明書が設定されており、クロスオリジンアクセスが有効になっていることを確認してください。 詳細については、「HTTPS セキュアアクセラレーションの有効化」および「クロスオリジンアクセスの設定」をご参照ください。
オペレーティングシステム | ビデオコーデック | ビデオプロトコル | オーディオコーデック |
Android | H.264 |
|
|
iOS | H.264 |
説明 FLV および MPEG-DASH はサポートされていません。 | |
H.265 |
| ||
Windows | H.264 | ||
macOS | H.264 |
| |
H.265 |
|
Android デバイス上の一部のブラウザーでは、HLS 動画を再生するためにMSE が必要です。 詳細は以下の通りです：
Android デバイス上のブラウザー | HLS サポート |
サポート済み | |
DingTalk | サポート済み |
UC/Quark | サポート済み |
QQ Browser | サポート済み |
Chrome | MSE が必要 |
Huawei Browser | MSE が必要 |
OPPO Browser | サポート済み |
vivo Browser | サポート済み |
Mi Browser | MSE が必要 |
Player SDKの互換性
お使いのデバイスが互換性要件を満たしている場合は、別のプレーヤーを使用して、問題が ApsaraVideo Player SDK の互換性に関連しているかどうかを確認します。
別のプレーヤーで動画が正しく再生される場合、問題は ApsaraVideo Player SDK にある可能性があります。 この場合は、テクニカルサポートにお問い合わせください。
別のプレーヤーでも動画の再生に失敗する場合は、メディアストリームとネットワークを確認する必要があります。
ステップ 2：メディアストリームの確認
上記で説明した原因をすべて除外した後、メディアストリームをトランスコードして、もう一度再生を試してください。 正しく再生される場合、元のストリームのエンコードが不適切であった可能性があります。
moov アトム (メディアデータインデックス) が mdat アトム (メディアデータ) の後に配置されている場合、MP4 ビデオの再生開始が遅くなったり、MOV ビデオの再生に失敗したりすることがあります。ソースビデオをトランスコードして moov アトムを mdat アトムの前に移動させると、再生解析を高速化できます。
次のコマンドを使用して、
moov アトムの位置を確認してください：# ソース動画の URL は、ローカルファイルパスまたはオンライン URL (例: http://pla****.alicdn.com/video/aliyunmedia.mp4) を指定できます ffmpeg -v trace -i "source_video_url" 2>&1 | grep -e type:\'mdat\' -e type:\'moov\'通常のシナリオでは、
moov アトムはmdat アトムの前にあり、これは高速起動が最適化されていることを示します。 出力例を以下に示します。# ffmpeg -v trace -i sample_faststart.mp4 2>&1 | grep -e type:\'mdat\' -e type:\'moov\' [mov,mp4,m4a,3gp,3g2,mj2 @ 0x54d3b80] type:'moov' parent:'root' sz: 603629 40 231901466 [mov,mp4,m4a,3gp,3g2,mj2 @ 0x54d3b80] type:'mdat' parent:'root' sz: 231297797 603677 231901466異常なシナリオでは、
moov アトムはmdat アトムの後にあります。# ffmpeg -v trace -i sample.mp4 2>&1 | grep -e type:"mdat" -e type:"moov" [mov,mp4,m4a,3gp,3g2,mj2 @ 0x59e1b80] type:'mdat' parent:'root' sz: 231297797 48 231901466 [mov,mp4,m4a,3gp,3g2,mj2 @ 0x59e1b80] type:'moov' parent:'root' sz: 603629 231297845 231901466次のコマンドまたは ffprobe コマンドラインツール (ffprobe ツール) を使用して、ソースファイルの音声コーデックや動画コーデックなどの情報を照会してください。これにより、問題のある動画に何らかのパターンがあるかどうかを分析できます：
ffprobe "input.mp4"またはffprobe "source_video_url"Input #0, mov, mp4, m4a, 3gp, 3g2, mj2, from 'input.mp4': Metadata: major_brand : isom minor_version : 512 compatible_brands: isomiso2avc1mp41 encoder : www.aliyun.com - Media Transcoding Duration: 00:00:17.56, start: 0.000000, bitrate: 3088 kb/s Stream #0:0(und): Video: h264 (High) (avc1 / 0x31637661), yuv420p, 1440x2560, 2890 kb/s, 25 fps, 25 tbr, 12800 tbn, 50 tbc (default) Metadata: handler_name : VideoHandler Stream #0:1(und): Audio: aac (LC) (mp4a / 0x6134706D), 44100 Hz, stereo, fltp, 191 kb/s (default) Metadata: handler_name : SoundHandler
トランスコードの推奨事項
トランスコード出力： H.264 MP4 または HLS 動画ストリームにトランスコードすることを推奨します。
トランスコード方法： 次の Alibaba Cloud サービスまたはローカルツールを使用することを推奨します。
カテゴリ
サービスまたはツール
説明
Alibaba Cloud サービス
ApsaraVideo VOD
ApsaraVideo VOD は、包括的なトランスコードおよびトランスマックス機能を提供し、さまざまなメディア形式の変換ニーズに対応します。 標準トランスコード、Narrowband HD 1.0、Narrowband HD 2.0、およびソース品質のトランスコードをサポートします。 詳細については、「オーディオとビデオのトランスコード」をご参照ください。
ApsaraVideo Media Processing (MPS)
ApsaraVideo Media Processing (MPS) は、マルチメディアデータをすべてのプラットフォームでの再生に適した形式にトランスコードします。 標準トランスコード、Narrowband HD 1.0、Narrowband HD 2.0、高速トランスコード、および解像度倍増トランスコードをサポートします。 これは、ソース動画ファイルを独自の OSS バケットに保存するユーザーに最適です。 詳細については、「メディアトランスコード」をご参照ください。
Intelligent Media Services (IMS)
Intelligent Media Services (IMS) は、オンデマンドトランスコードとリアルタイムトランスコード機能を提供します。 OSS または ApsaraVideo VOD に保存されているメディアのトランスコード、およびライブストリームのトランスコードをサポートします。
ローカルツール
FFmpeg Codecs
ダウンロード先： FFmpeg Codecs
ステップ 3：ネットワークの確認
上記の手順で問題が解決しない場合は、ネットワーク伝送を確認し、再生エラーの原因を特定してください。
エンドデバイスが安定したネットワークに接続されていることを確認してください。
Wi-Fi： 現在のネットワークは安定しており、アクセス可能ですか？ 下りネットワーク速度は動画ビットレート以上ですか？
Speedtest.net を使用して、下りネットワーク速度を確認できます。 速度が動画ビットレートよりも低い場合、読み込みの失敗や再生のコマ落ちが発生する可能性があります。
モバイルネットワーク： デバイスは 4G や 5G などの高速ネットワークに接続されていますか？ 信号強度はどのくらいですか？
ネットワーク状態が悪い場合、メディアストリームを読み込むための速度が不十分である可能性があります。
説明DNS ハイジャックが発生した場合は、DNS を Alibaba Cloud Public DNS (223.5.5.5、223.6.6.6) に手動で設定して再生を復元してください。
モバイルデバイスで [設定] > [Wi-Fi] に移動します。
現在のネットワークの右側にある詳細ボタンをタップして、ネットワーク詳細ページを開きます。
DNS を設定します。
ネットワーク設定ページには、[IPアドレス] (サブネット、ゲートウェイ)、[IPv6アドレス] (IPアドレス、ゲートウェイ)、[DNS] の3つのセクションがあります。 [DNS] エントリの横にある矢印をタップして、詳細設定を入力します。
CDN アクセラレーションが有効になっているかどうかを確認してください。
CDN アクセラレーションが有効になっていない場合は、再生エクスペリエンスを向上させるために設定することを推奨します。 詳細については、「アクセラレーションドメイン名の追加」をご参照ください。
CDN アクセラレーションが有効になっている場合：
CDN 設定の問題： メディアコンテンツはプリフェッチされていますか？ コンテンツキャッシュの有効期限が切れていませんか？
プリフェッチされていないコンテンツや期限切れのキャッシュが原因で CDN キャッシュミスが発生すると、読み込みの失敗や再生のコマ落ちにつながる可能性があります。 この問題は、新しくアップロードされた動画でよく発生します。 新しい動画については、コンテンツを積極的にプリフェッチすることを推奨します。 詳細については、「リソースの更新とプリフェッチ」をご参照ください。
その他の問題： 同じエンドデバイスで他のアプリの動画は正常に再生されますか？
CDN が正しく設定されており、他のアプリで問題なく動画が再生される場合、再生エラーはローカルな CDN スケジューリングの問題が原因である可能性があります。
オリジンサーバーとエンドユーザーの場所を確認してください。
オリジンサーバーが中国本土にあり、ユーザーが海外にいる場合、大幅なコマ落ちが発生する可能性があります。 この場合、オリジンサーバーをユーザーに近いリージョンにデプロイしてパフォーマンスを向上させます。
視聴のピーク時間を確認してください。
同時に視聴している人が多すぎると、オリジンサーバーがトラフィックスロットリングを行い、再生がコマ落ちする可能性があります。
アクセラレーションドメイン名を設定した後に再生が失敗する
アクセラレーションドメイン名を設定した後に動画の再生に失敗する場合は、次の項目をトラブルシューティングしてください：
CNAME 解決ステータスの確認
ApsaraVideo VOD コンソールで、**[ドメイン管理]** に移動し、**[CNAME]** 列にドメイン名がアクティブ化されていると表示されているかどうかを確認してください。
または、
nslookupまたはdigコマンドを実行して、ドメイン名が CDN ノードに解決されることを確認してください。
HTTPS 証明書設定の確認
**[ドメイン管理]** ページで、ドメイン設定を開き、HTTPS 証明書のステータスを確認してください。
証明書が設定されていないか、証明書の有効期限が切れている場合、HTTPS 環境のプレーヤーはメディアストリームの読み込みを拒否します。
Referer ベースのホットリンク防止と URL 署名設定の確認
ドメイン設定で Referer のブラックリストとホワイトリストの設定を確認してください。
URL 署名の設定を確認し、署名タイプとパラメーターが再生リクエストと一致していることを確認してください。
CDN プリフェッチステータスの確認
**[更新とプリフェッチ]** に移動し、プリフェッチタスクのステータスを確認してください。
プリフェッチされていない動画の初回再生は、読み込みが遅くなったり、タイムアウトしたりすることがあります。
一時的な復旧策
**[ドメイン管理]** ページでアクセラレーションドメイン名を無効にし、原因が特定された後に再度有効にしてください。
関連ドキュメント
上記の手順を実行しても原因を特定できない場合は、次のドキュメントで同様のケースと解決策を確認してください：
テクニカルサポートへのお問い合わせ
問題が解決しない場合は、チケットを起票してください。 チケットを起票する方法の詳細については、「お問い合わせ」をご参照ください。
問題を効率的に解決するために、チケットに次の情報をご記入ください。
項目 | 例 | 説明 |
オペレーティングシステムとデバイスプラットフォーム | Android 9、Xiaomi | デバイスのブランドとオペレーティングシステムのバージョンを記載してください。例：Android 9 搭載の Xiaomi、iOS 15、Windows 11、または macOS 12。 |
SDK とバージョン | Android SDK 5.4.8.0 | 使用している Player SDK とそのバージョン番号を記載してください。 Player SDK には、Web SDK、Android SDK、iOS SDK、Flutter SDK、Windows SDK が含まれます。 |
動画ソース | https://xxxxxx.m3u8 | 問題が再現する動画ソースの URL または動画ファイルをご提供ください。 |
問題の説明、ログ、画面録画 | 2022年8月29日 16:40 に再生を開始し、17:00 頃にコマ落ちが発生しました。 ログは添付されています。 | 再現手順と観察された症状を、特定のタイムスタンプを含めて詳細にご説明ください。 再現可能な問題については、再現手順の完全なログをご提供ください。 ログの取得方法については、「Androidでのログの取得」または「iOSでのログの取得」をご参照ください。 必要に応じて、画面録画を添付してください。 |
エラーパターン | この問題は Android デバイスでのみ発生し、iOS では発生しません。 常に再現可能です。 | 問題が特定のパターンに従うかどうか、およびその頻度をご説明ください。 たとえば、問題が特定の動画ソース、デバイスプラットフォーム、または SDK バージョンに限定されているかどうか、断続的か常に再現可能かをご指定ください。 |