トラブルシューティング
再生エラーはさまざまな原因で発生する可能性があります。エラーのトラブルシューティングを行う前に、次の表に示すように、エラーが特定のパターンで発生するかどうかを最初に確認します。エラーがランダムに発生する場合は、ユーザーデバイス、メディアストリーム、およびネットワーク接続を確認して、エラーの原因を特定します。エラーの原因を特定できない場合は、Alibaba Cloud テクニカルサポートに連絡し、エラー情報を提供してください。

手順 1:デバイスの互換性を確認する
デバイスの互換性
メディアストリームで使用されているプロトコルが、デバイスのオペレーティングシステムとアプリケーション環境でサポートされているかどうかを確認します。プロトコルがサポートされていない場合は、メディアストリームをトランスコードします。トランスコードの詳細については、「推奨される出力フォーマットとツール」をご参照ください。次の表は、ApsaraVideo Player SDK でサポートされているオーディオおよびビデオのプロトコルとコーデックを示しています。
ネイティブ アプリ
オペレーティングシステム | ビデオコーデック | ビデオプロトコル | オーディオコーデック |
オペレーティングシステム | ビデオコーデック | ビデオプロトコル | オーディオコーデック |
Android | | | |
iOS |
Windows |
macOS |
Linux |
Web
説明
メディアストリームで使用されているプロトコルが、次の表に示す Web 用 ApsaraVideo Player SDK の互換性要件を満たしている場合は、SSL 証明書を構成し、オリジン間リソース共有 (CORS) を有効にしているかどうかを確認します。詳細については、「HTTPS セキュリティアクセラレーション」および「CORS の構成」をご参照ください。
オペレーティングシステム | ビデオコーデック | ビデオプロトコル | オーディオコーデック |
オペレーティングシステム | ビデオコーデック | ビデオプロトコル | オーディオコーデック |
Android | H.264 | MP4 HLS (特定のブラウザでは MSE が必要) FLV (MSE が必要)
| |
iOS | H.264 | 説明 FLV および MPEG-DASH プロトコルはサポートされていません。 |
H.265 | MP4 HLS (fMP4 セグメントのみサポート)
|
Windows | H.264 | |
macOS | H.264 | |
H.265 | MP4 HLS (fMP4 セグメントのみサポート)
|
Android デバイスの特定のブラウザでは、HLS で暗号化されたビデオを再生するために Media Source Extensions (MSE) が必要です。次の表は、HLS で暗号化されたビデオを再生できるブラウザを示しています。
Android デバイスのブラウザ | HLS で暗号化されたビデオのサポート |
Android デバイスのブラウザ | HLS で暗号化されたビデオのサポート |
WeChat | はい |
DingTalk ID | はい |
UC ブラウザまたは Quark ブラウザ | はい |
QQ ブラウザ | はい |
Chrome | MSE がインストールされている場合のみサポート |
Huawei ブラウザ | MSE がインストールされている場合のみサポート |
OPPO ブラウザ | はい |
Vivo ブラウザ | はい |
Mi ブラウザ | MSE がインストールされている場合のみサポート |
ApsaraVideo Player SDK の互換性
デバイスが前のセクションで説明されている互換性要件を満たしている場合は、サードパーティ製のプレーヤーを使用して、ApsaraVideo Player SDK がシステムと互換性があるかどうかを確認します。
トラブルシューティングには、次のプレーヤーとブラウザを使用することをお勧めします。
サードパーティ製プレーヤー:VLC メディアプレーヤー
組み込みプレーヤー:ExoPlayer (Android) および AVPlayer (iOS)
Web ページのシステムブラウザ:Chrome (Android および Windows) および Safari (iOS および macOS)
手順 2:メディアストリームを確認する
デバイスでエラーが見つからない場合は、メディアストリームをトランスコードして再度再生します。メディアストリームを再生できる場合は、エンコードエラーが原因で再生に失敗しました。
説明
MP4 ビデオの再生時に起動時間が長いなどの再生エラーが発生した場合、または MOV ビデオの再生に失敗した場合は、ビデオファイルのフォーマットが原因である可能性があります。データ解析を高速化するには、moov アトムを mdat アトムの前に配置します。 mdat アトムにはメディアデータが含まれ、moov アトムはメディアデータのインデックスとして機能します。メディアファイルをトランスコードして、moov アトムを mdat アトムの前に移動できます。
moov アトムの場所を確認するには、次のコマンドを実行します。
# ビデオソースアドレスは、ローカルファイルのパスまたはオンラインビデオの URL にすることができます。例:http:
ffmpeg -v trace -i "ビデオソースアドレス" 2>&1 | grep -e type:\'mdat\' -e type:\'moov\'
次の図では、moov アトムは mdat アトムの前に配置されています。この場合、ビデオは想定どおりに再生できます。
次の図では、mdat アトムは moov アトムの前に配置されています。この場合、再生エラーが発生する可能性があります。
オーディオコーデックやビデオコーデックなどのソースファイルに関する情報をクエリするには、ffprobe ツール をダウンロードするか、次のコマンドを実行します。この情報を使用して、再生エラーが特定の方法で発生するかどうかを確認できます。
ffprobe "input.mp4"
または ffprobe "ビデオソースアドレス"

推奨される出力フォーマットとトランスコードツール
手順 3:ネットワーク接続を確認する
デバイスまたはメディアストリームでエラーが見つからない場合は、ネットワークにアクセスできるかどうかを確認します。
デバイスのネットワークにアクセスできるかどうかを確認します。
Wi-Fi 接続が安定しているかどうか、およびダウンストリームネットワーク速度がメディアビットレートと一致しているかどうかを確認します。
SpeedTest を使用して、ダウンストリームネットワーク速度を取得できます。ダウンストリームネットワーク速度がビデオビットレートと一致しない場合は、途切れが発生し、メディアストリームの読み込みに失敗します。
4G や 5G などの高速ネットワークを使用しているかどうか、およびネットワークが安定しているかどうかを確認します。
ネットワークの状態が悪いと、メディアストリームの読み込みに失敗する可能性があります。
説明
ユーザーネットワークで DNS ハイジャックが発生した場合は、DNS を Alibaba Cloud パブリック DNS (223.5.5.5 または 223.6.6.6) に手動で構成して、再生を迅速に再開できます。
[設定] > [Wi-Fi] に移動します。
現在のネットワークの右側にある情報アイコンをクリックします。

ドメインネームシステム (DNS) 設定を構成します。

Alibaba Cloud CDN がアクティブになっているかどうかを確認します。
オリジンサーバーとユーザーが同じリージョンにあるかどうかを確認します。
オリジンサーバーが中国本土にデプロイされていて、ユーザーが中国本土以外のリージョンからサーバーにアクセスする場合、途切れが発生する可能性があります。この場合は、コンテンツ配信を高速化するために、ユーザーと同じリージョンにオリジンサーバーをデプロイすることをお勧めします。
特定の時間帯にトラフィックの急増が発生しているかどうかを確認します。
トラフィックの急増が発生した場合、オリジンサーバーに送信されたリクエストがスロットルされる可能性があります。これにより、再生の途切れが発生します。
関連情報
次のトピックでは、ApsaraVideo Player についてよくある質問への回答を提供しています。原因を特定できない場合は、これらのトピックを参照してトラブルシューティングを容易にしてください。
テクニカルサポートへの問い合わせ
上記の操作を実行しても問題が解決しない場合は、チケットを送信してテクニカルサポートにお問い合わせください。チケットの送信方法の詳細については、「お問い合わせ」をご参照ください。
チケットには次の情報を含めることをお勧めします。
情報 | 例 | 説明 |
オペレーティングシステムとデバイスモデル | Android 9、Xiaomi | エラーが発生したデバイスのブランドとオペレーティングシステムを記述します。たとえば、Android、iOS、Windows、Mac、または Linux を指定します。 |
SDK の種類とバージョン | Android SDK 5.4.8.0 | ApsaraVideo Player SDK の種類とバージョン番号を記述します。たとえば、Web 用 ApsaraVideo Player SDK、Android 用 ApsaraVideo Player SDK、iOS 用 ApsaraVideo Player SDK、Flutter 用 ApsaraVideo Player SDK、および Windows 用 ApsaraVideo Player SDK です。 |
ビデオソース | https://xxxxxx.m3u8 | エラーが発生した再生 URL またはビデオファイルを指定します。 |
問題の説明、ログ、および画面録画 | 2022 年 8 月 29 日 16:40 にビデオ再生が開始され、同日 17:00 頃に途切れが発生しました。ログが提供されています。 | 実行した操作と問題の症状を記述します。正確な時刻を含めることをお勧めします。エラーを再現できる場合は、Android または iOS での異常な操作の完全なログを提供してください。画面録画を含めることもできます。エラーログの取得方法の詳細については、「Android 用 ApsaraVideo Player SDK でエラーログを取得する方法」および「iOS 用 ApsaraVideo Player SDK でエラーログを取得する方法」をご参照ください。 |
エラーの分布 | このエラーは、Android デバイスでのみ毎回発生します。 | エラーが特定のパターンで発生するかどうか、およびエラー発生の頻度を記述します。たとえば、エラーが特定のビデオソース、プラットフォーム、または SDK バージョンで発生するかどうか、およびエラーがランダムに発生するか、毎回発生するかを記述します。 |