ApsaraVideo VOD:再生エラーのトラブルシューティング

プロトコルとコーデックのサポート

ご利用のメディアストリームのプロトコルとコーデックが、ターゲットデバイスでサポートされていることを確認します。フォーマットがサポートされていない場合は、ストリームを互換性のあるフォーマットにトランスコードします。「推奨される出力フォーマットとトランスコードツール」をご参照ください。

以下の表は、ApsaraVideo Player SDK がサポートするプロトコルとコーデックの一覧です。

ネイティブアプリ

Web

Android ブラウザでの HLS 暗号化動画のサポート

一部の Android ブラウザでは、HLS 暗号化動画を再生するために Media Source Extensions (MSE) が必要です。次の表は、HLS 暗号化動画の再生をサポートしているブラウザを示しています。

サードパーティ製プレーヤーでのテスト

ご利用のデバイスが上記の互換性要件を満たしている場合は、サードパーティ製プレーヤーでテストして、問題が ApsaraVideo Player SDK に固有のものであるかどうかを判断します。

• サードパーティ製プレーヤーでストリームが正常に再生される場合：問題は ApsaraVideo Player SDK の互換性の問題である可能性があります。Alibaba Cloud のテクニカルサポートにお問い合わせください。

• サードパーティ製プレーヤーでも失敗する場合：問題はメディアストリームまたはネットワークにあります。ステップ 2 に進みます。

テストに推奨されるサードパーティ製プレーヤーとブラウザ：

moov アトムの配置の確認 (MP4 および MOV)

MP4 および MOV ファイルの場合、起動が遅い、または再生に失敗する原因は、多くの場合アトムの順序が正しくないことです。プレーヤーがファイル全体をダウンロードせずにメタデータを解析できるように、moov アトム (メタデータインデックス) は mdat アトム (メディアデータ) の前に配置する必要があります。

次のコマンドを実行して、アトムの順序を確認します：

# ローカルファイルパスまたはオンライン動画 URL に置き換えます
ffmpeg -v trace -i "<video-source>" 2>&1 | grep -e type:\'mdat\' -e type:\'moov\'

• mdat の前に moov：正しい順序です。動画は期待どおりに再生されます。

  

• moov の前に mdat：正しくない順序です。ファイルをトランスコードして、moov アトムを先頭に移動します。

  

ソースファイルのプロパティの検査

ffprobe を使用して、ソースファイルのコーデックやその他のプロパティを調べます。これにより、エラーがコーデック固有またはフォーマット固有のパターンに従っているかどうかを判断するのに役立ちます。

ffprobe "<video-source>"

ffprobe は FFmpeg ダウンロードからダウンロードしてください。

推奨される出力フォーマットとトランスコードツール

最大限の互換性を確保するために、メディアストリームを MP4 または HLS コンテナーの H.264 ビデオにトランスコードすることを推奨します。

1. デバイスのネットワーク接続の確認

• Wi-Fi：接続が安定しており、ダウンストリーム帯域幅がメディアビットレートを超えていることを確認します。SpeedTest を使用してダウンストリーム速度を測定します。ダウンストリーム速度がビデオビットレートより低い場合、バッファリングや読み込みの失敗が発生します。

• モバイルネットワーク：安定した信号を持つ 4G または 5G 接続を確認します。モバイル接続が悪いと、再生が失敗したりカクついたりすることがあります。

2. Alibaba Cloud CDN 設定の確認

• CDN が有効化されていない場合：CDN を有効化してビデオ配信を高速化します。詳細については、「CDN のドメイン名を追加」をご参照ください。

• CDN が有効化されている場合：次の項目を確認します：

  • キャッシュミス：メディアコンテンツがプリフェッチされており、キャッシュされたコンテンツの有効期限が切れていないことを確認します。キャッシュミスは、特に新しくアップロードされたビデオで、読み込みの失敗やカクつきを引き起こします。新しいビデオにはプリフェッチを設定してください。詳細については、「更新とプリフェッチ」をご参照ください。

  • CDN スケジューリング：設定エラーがなく、同じデバイスの他のプレーヤーでストリームが再生される場合、問題は CDN スケジューリングの問題である可能性があります。

3. オリジンサーバーとユーザーの近接性の確認

オリジンサーバーが中国本土にデプロイされており、ユーザーが中国本土以外から接続している場合、遅延やカクつきが発生することがあります。配信遅延を減らすために、ユーザーと同じリージョンにオリジンサーバーをデプロイしてください。

4. トラフィックスパイクの確認

トラフィックスパイク時には、オリジンサーバーへのリクエストがスロットリングされ、再生のカクつきを引き起こすことがあります。