ApsaraVideo VOD:トランスコーディングに関するよくある質問

トランスコーディング失敗のトラブルシューティング

• ソースファイルがローカルデバイスで再生できることを確認します。これは重要な最初のステップです。なぜなら、ほとんどのトランスコーディングの失敗はソースファイル自体の問題に起因するためです。一般的な問題には、ビデオストリームの欠落、無効なメタデータ、フレームエラー、ビデオヘッダーの欠落などがあります。これらの問題は、トランスコーディング効率のモニタリングをトリガーし、トランスコーディングジョブの失敗を引き起こす可能性があります。

  • ffprobe -show_streams -show_format -of json -i [filePath] コマンドを実行して、ファイルのメタデータを検査し、moov atom の欠落やストリームの異常などの問題がないか確認します。

  • ffprobe -show_packets -i [filePath] コマンドを実行して、データストリームの問題をチェックし、ストリームの尺がメタデータで指定された尺と一致することを確認します。

    説明

    メタデータで指定された尺と実際のストリームの尺が一致しない場合、トランスコーディングが失敗することがあります。ファイルに無効なメタデータがある場合は、FFmpeg などのツールを使用してローカルでファイルを修正してから、トランスコーディングのためにアップロードしてください。

• エラーコード リストで対応するエラーコードを見つけ、失敗の具体的な原因を特定します。

• 切り捨てやジョブの失敗を防ぐために、テキストウォーターマークで使用される特殊文字をエスケープしてください。

• 暗号化トランスコーディングジョブが失敗した場合は、「動画暗号化に関するよくある質問」をご参照ください。HLS 標準暗号化に関連する一般的なエラーについて説明しています。

「トランスコードなし」テンプレートでの再生問題

複数音声ストリームの単一ストリームへの削減

現在、トランスコーディングでは 1 つの音声ストリームのみが保持されます。これは、Output パラメーターの audioMap=0 設定によって制御されます。ユースケースで複数の音声ストリームが必要な場合は、してください。

出力解像度と設定の不一致

ApsaraVideo VOD のトランスコーディングテンプレートでは、画面の自動回転機能 (LongShortMode) がデフォルトで有効になっています。この機能が有効な場合、`width` は長辺に、`height` は短辺に対応します。これらの値の一方のみを設定し、もう一方は空のままにしておくだけで十分です。特定の出力解像度を強制したい場合は、画面の自動回転機能を無効にする必要があります。この機能を無効にすると、出力動画が引き伸ばされたり歪んだりして表示されることがあります。

トランスコーディング後の動画の向きの誤り

ffprobe -show_streams -show_format -of json -i  [filepath]

トランスコーディング後の M3U8 ファイルのブラックスクリーン

まず、ソースファイルのビデオストリームが有効かどうかを確認します。ソースファイルの最初の Transport Stream (TS) セグメントに動画データが含まれていない場合、プレーヤーが動画を表示できないことがあります。この問題が発生した場合は、まずソースファイルを MP4 にトランスコーディングし、次にその結果の MP4 ファイルを M3U8 にトランスコーディングしてみてください。これにより、再生の問題が解決するはずです。

HDR から SDR への変換後の露出問題

ソース動画が HDR の場合は、トランスコーディングテンプレートのダイナミックレンジ設定で [SDR マッピング] を選択します。 例：

SDR Mapping はパブリックプレビュー中です。この機能は、パブリックプレビューの終了後に課金対象となります。詳細については、「オーディオおよびビデオ拡張機能の料金」をご参照ください。問題が解決しない場合は、チケットを送信してください。

トランスコーディングにおける moov ボックスの処理

トランスコーディング後、ApsaraVideo VOD はデフォルトで moov ボックスを MP4 ファイルの先頭に配置します。この動作はカスタマイズできません。moov ボックスがないファイルは処理できず、トランスコーディングジョブが失敗します。

動画から音声への変換における尺の不一致

尺の一貫性を確保するため、ApsaraVideo VOD のトランスコーディングロジックは、入力ファイル内の最も短い音声ストリームをタイミングの基準として使用します。ソースファイルの一部のセグメントのタイムスタンプが連続していない場合、サービスがビデオストリームからメディア情報を取得できないことがあります。これは尺の見積もりに影響し、不一致を引き起こす可能性があります。

音声のみのファイルの再生エラー

トランスコーディングテンプレートで動画処理が無効になっていることを確認してください。音声のみのファイルの場合、動画処理を無効にする必要があります。これはテンプレートの設定で行うことができます。

ビットレート設定が適用されない問題

トランスコーディングテンプレートでビットレートチェックメカニズムを有効にしているかどうかを確認してください。ApsaraVideo VOD コンソールでは、この機能は 通常トランスコーディング テンプレートの [条件付きトランスコーディングパラメーター] の下に [ビデオビットレートをチェック] または [オーディオビットレートをチェック] として表示されます。このメカニズムが有効な場合、テンプレートで設定したビットレートが特定の条件下で有効にならないことがあります。具体的には、出力エンコーダーがソースエンコーダーと同じで、ターゲットビットレートがソースビットレートより高い場合、サービスは構成に応じて出力ビットレートをソースビットレートに合わせてリセットするか、ストリームのトランスコーディングをスキップします。

トランスコーディングジョブの所要時間

H.264 720P への典型的なトランスコーディングシナリオの場合、異なるトランスコーディングアルゴリズムの処理速度は次のとおりです：

速度倍率 = 処理時間単位あたりに処理される動画の尺

例：
3倍速とは、1分間の処理時間で約3分間の動画コンテンツを処理できることを意味します。
したがって、キューイング時間を除けば、30分の動画は理論的には約10分で処理されます。

トランスコーディング進捗のクエリ

ApsaraVideo VOD は、トランスコーディングジョブのリアルタイムの進捗をクエリする API を提供していません。代わりに、イベント通知を設定して、ジョブのステータスに関する通知を受け取ることができます。

バッチトランスコーディングの可否

ApsaraVideo VOD は、既存のメディアに対する直接のバッチトランスコーディング操作をサポートしていません。システムは、アップロードプロセス中にトランスコーディングテンプレートまたはワークフローを使用して動画を自動的にトランスコーディングします。ただし、メディアを独自の Object Storage Service (OSS) バケットに保存している場合、Intelligent Media Management (IMM) と連携することでバッチトランスコーディングを実現できます。IMM プロジェクトを作成し、プレフィックス一致などの基準を使用してバッチ処理ジョブを定義することで、複数の動画を効率的にトランスコーディングできます。詳細については、「OSS でのバッチ処理」をご参照ください。

トランスコーディングジョブが失敗し続ける原因

ジョブが失敗する原因はさまざまです。常に返されたエラーメッセージを確認してください。前処理失敗エラーが表示された場合、サービスがソースファイルをデコードできなかったことを意味します。この場合、チケットを送信し、問題の診断に役立つ次の情報を提供してください：お客様の Alibaba Cloud アカウント ID とビデオ ID。

ApsaraVideo VOD のリアルタイムトランスコーディング対応

ApsaraVideo VOD はファイルベースのトランスコーディングサービスであり、リアルタイムトランスコーディングはサポートしていません。

既存動画のバッチトランスコーディング

ApsaraVideo VOD は、すでにアップロードされた動画のバッチトランスコーディングをサポートしていません。

トランスコーディング後にウォーターマークが表示されない問題

トランスコーディングに使用したウォーターマークテンプレートのパラメーター、例えばディメンション (幅 × 高さ) やオフセットなどを確認してください。これらの設定が、ウォーターマークを動画の解像度の範囲内に配置していることを確認します。ウォーターマークの設定が動画フレームの外側に配置されている場合、トランスコーディングジョブが正常に完了しても表示されません。

トランスコーディング失敗時のコールバックの欠落

トランスコーディングのイベント通知を設定する際、単一解像度トランスコーディング完了 (StreamTranscodeComplete) イベントのみをサブスクライブし、TranscodeComplete イベントをサブスクライブしていない場合、特定のシナリオで失敗通知を受け取れないことがあります。例えば、破損したソースファイルをアップロードしてすべての出力ストリームが失敗した場合、ApsaraVideo VOD は TranscodeComplete イベントに対して失敗コールバックを送信します。このイベントをサブスクライブしていないため、トランスコーディングの失敗通知を受け取ることはありません。