トランスコーディングジョブは、ビデオストリームの欠落、メタデータの問題、フレームエラー、ファイルヘッダーの欠落など、ソースファイルの問題が原因で失敗することがあります。このトピックでは、一般的なトランスコーディングの問題、サポートされているフォーマット、その他のよくある質問とその解決策について説明します。
トランスコーディングの問題
SubmitJobs API を介して送信されたトランスコーディングジョブが失敗した場合のトラブルシューティング方法
まず、ソースファイルがローカルデバイスで正しく再生されることを確認します。これは重要なステップです。なぜなら、ほとんどのトランスコーディングの失敗は、ビデオストリームの欠落、メタデータの問題、フレームエラー、ファイルヘッダーの欠落など、ソースファイルの問題によって発生するためです。これらの問題は効率監視をトリガーし、ジョブの失敗を引き起こす可能性があります。
ffprobe -show_streams -show_format -of json -i [filePath]コマンドを実行して、ファイルのメタデータに moov アトムの欠落やストリーム例外などの問題がないか確認します。ffprobe -show_packets -i [filePath]コマンドを実行して、データストリームの問題を確認し、ストリームのデュレーションがメタデータのデュレーションと一致することを確認します。説明メタデータ内のデュレーションとストリームの実際のデュレーションが一致しない場合、トランスコーディングジョブが失敗する可能性があります。ファイルにメタデータの問題がある場合は、トランスコーディングのためにアップロードする前に、FFmpeg を使用してローカルで処理してください。
プロトコルがサポートされていません。
エラーコードリストでエラーコードを見つけ、失敗の原因を分析します。
テキストウォーターマークに特殊文字が含まれている場合、ウォーターマークの出力が切り捨てられたり、ジョブが失敗したりする可能性があります。ジョブを送信する前に特殊文字をエスケープするか、Alibaba Cloud に連絡して互換性のサポートを依頼する必要があります。
暗号化トランスコーディングが失敗する一般的な理由は次のとおりです：
カスタムキー
GenerateDataKey を使用して暗号化用のプレーンテキストキーを生成します。カスタム文字列を使用して暗号化キーを生成しないでください。そうしないと、暗号化トランスコーディングジョブは失敗します。
暗号化の失敗
GenerateDataKey から AES_128 以外のキータイプを使用すると、標準の暗号化トランスコーディングジョブが失敗し、暗号化ファイルが生成されません。
復号の失敗
標準の暗号化ファイルの再生が復号後に失敗した場合、復号 API が KMS によって生成されたプレーンテキストキーを Base64 デコードしてからプレーヤーに渡して復号しているか確認してください。そうしないと、再生は失敗します。
繰り返しの生成
標準の暗号化トランスコーディングは常にユーザーによってトリガーされます。暗号化ファイルが繰り返し生成される場合は、SubmitJobs API が複数回呼び出されていないか確認してください。
トランスコーディングのステータスが「送信済み」のまま更新されません。
「送信済み」ステータスは、トランスコーディングジョブが準備段階にあることを示します。これには、ビデオのダウンロードと分析が含まれます。ファイルサイズが大きい、ビットレートが高い、またはテンプレート設定が複雑な場合、この段階が長くなることがあります。ジョブが完了するまでお待ちください。
ソースビデオには 2 つのオーディオストリームがありますが、出力ファイルには 1 つしかありません。これを修正するにはどうすればよいですか？
トランスコーディングジョブを送信する際に、使用するオーディオストリームを指定できます。最初のオーディオストリーム (インデックス 0) をトランスコーディングするには、オーディオストリーム設定 "AudioStreamMap":"0:a:0" を `Output` パラメーターに追加します。
出力ビデオの幅と高さが設定と異なるのはなぜですか？
トランスコーディングテンプレートで、自動回転 (LongShortMode) を有効にできます。自動回転が有効な場合は、幅または高さのいずれか一方のみを設定し、もう一方の値を空のままにします。特定の解像度を出力するには、自動回転を無効にします。たとえば、自動回転を有効にすると、幅を設定して縦長 (垂直) ビデオの短辺を制御したり、高さを設定して横長 (水平) ビデオの長辺を制御したりできます。
MP4 ファイルからトランスコーディングされた M3U8 ファイルがブラックスクリーンで再生されます。トラブルシューティング方法は？
ソースファイル内のビデオストリームが有効かどうかを確認してください。トランスコーディングされた M3U8 ファイルの最初の TS セグメントにビデオデータが含まれていない場合、プレーヤーはブラックスクリーンを表示することがあります。これは、ソースファイルに問題がある場合に発生する可能性があります。この問題を解決するには、まずソースファイルを新しい MP4 ファイルにトランスコーディングして修復し、その後、新しい MP4 ファイルを M3U8 にトランスコーディングします。最終的な出力は正しく再生されるはずです。
ビデオは正常にトランスコーディングされましたが、再生に失敗します。原因は何ですか？
HTTPS 証明書の有効期限が切れているか、設定が間違っている場合、再生が失敗することがあります。この場合は、HTTP 経由でビデオを再生してみてください。
ソースファイルは HDR です。SDR にトランスコーディングした後、出力が露出オーバーになったり、暗すぎたりします。なぜですか？
露出オーバーは、テンプレートがアダプティブトランスコーディング用に設定されていないために発生します。Alibaba Cloud サポートにアダプティブトランスコーディングの設定を依頼することができます。露出アンダーは、非 HDR のソースファイルが HDR 用に設計されたテンプレートを使用してトランスコーディングされた場合に発生します。トランスコーディングの前に、ソースファイルが HDR であるかどうかを特定し、正しいテンプレートを使用するようにしてください。
ApsaraVideo Media Processing は moov ボックスの位置を検出できますか？moov ボックスのないファイルについてはどうですか？
トランスコーディング後、moov ボックスはデフォルトで MP4 ファイルの先頭に配置されます。カスタム設定はサポートされていません。moov ボックスのないファイルは処理できず、トランスコーディングが失敗します。
トランスコーディング後、出力オーディオファイルのデュレーションがソースビデオと異なるのはなぜですか？
ApsaraVideo Media Processing のトランスコーディングロジックでは、入力ファイル内で最も短いオーディオストリームを使用してジョブのデュレーションを決定します。ソースファイルの一部のセグメントのタイムスタンプが連続していない場合、ApsaraVideo Media Processing はビデオストリームからすべてのメディア情報を取得できないことがあります。これにより、デュレーションの見積もりに影響が出て、時間ドリフトが発生する可能性があります。
トランスコーディング中に設定したオーディオビットレートが有効にならなかったのはなぜですか？
オーディオエンコーダーが同じままで、指定された出力オーディオビットレートが入力オーディオビットレートよりも高い場合、オーディオビットレートは元の値にリセットされます。パラメーターの詳細については、「SubmitJobs」をご参照ください。
API が空のデータを返した場合はどうすればよいですか？
API が空のデータまたは「リソースが存在しません」というエラーを返す場合は、UID、リクエストリージョン、およびリソース ID が正しいか確認してください。
ジョブが失敗し続けるのはなぜですか？
ジョブはさまざまな理由で失敗する可能性があります。返されたエラーメッセージを確認してください。たとえば、「前処理に失敗しました」というエラーは、ApsaraVideo Media Processing がソースファイルをデコードできなかったことを示します。
基本的な質問
トランスコーディングリソースとは何ですか？
トランスコーディングリソースは、ApsaraVideo Media Processing がトランスコーディングジョブを実行するために使用するコンピュートノードです。1 つのトランスコーディングリソースは、一度に 1 つのトランスコーディングジョブを実行できます。ApsaraVideo Media Processing は共有トランスコーディングリソースを提供し、各ユーザーにクォータを設定します。ユーザーの最大同時ジョブ数はこのクォータを超えることはできません。システムがビジー状態の場合、同時ジョブ数は共有トランスコーディングリソースのクォータよりも少なくなることがあります。
プリセットトランスコーディングテンプレートとは何ですか？
プリセットテンプレートは、出力ファイルのフォーマット、解像度、コーデックなど、事前に設定された設定を持つ組み込みのトランスコーディングテンプレートです。ApsaraVideo Media Processing はビデオの特徴をインテリジェントに分析し、さまざまな再生デバイスやネットワーク帯域幅の条件に適したプリセットテンプレートを推奨します。ジョブを作成する際に、これらの推奨プリセットテンプレートのいずれかを使用できます。推奨範囲外のプリセットテンプレートでトランスコーディングジョブを送信すると、エラーが返されます。詳細については、「プリセットテンプレートの詳細」をご参照ください。
提供されているプリセットトランスコーディングテンプレートのいずれも自分に適していない場合はどうすればよいですか？
カスタムトランスコーディングテンプレートを作成できます。カスタムトランスコーディングテンプレートの詳細については、「カスタムトランスコーディングテンプレート」をご参照ください。
メディアファイルを OSS にアップロードするにはどうすればよいですか？
ApsaraVideo Media Processing コンソールまたは OSS コンソールを使用してファイルをアップロードできます。詳細な手順については、「ビデオのアップロード」をご参照ください。
ApsaraVideo Media Processing が処理できるメディアファイルの最大サイズはどれくらいですか？
ApsaraVideo Media Processing は最大 100 GB の入力ファイルをサポートしています。より大きなメディアファイルを処理するには、お問い合わせください。
CDN を使用してメディアファイルを配信できますか？
はい。Alibaba Cloud CDN を使用してコンテンツを配信することを推奨します。トランスコーディングされた出力ファイルを保存する OSS バケットを Alibaba Cloud CDN のオリジンとして使用できます。この構成により、レイテンシーが短縮され、応答速度が向上し、ネットワーク帯域幅の不足、高いユーザートラフィック、不均一なネットワーク分散などの問題に対処できます。詳細については、「CDN 製品ページ」をご参照ください。具体的な手順については、「高速化ドメイン名の設定」をご参照ください。
トランスコーディングジョブが完了するまでどのくらい時間がかかりますか？
入力ファイルのデュレーション、解像度、ビットレート、トランスコーディングテンプレートの設定など、多くの要因がトランスコーディング速度に影響します。通常、ジョブの完了には入力ファイルのデュレーションの 0.5 倍から 2 倍の時間がかかります。複数のジョブを送信した場合、それらはキューに入れられ、順番に処理されます。
トランスコーディングの進捗状況をリアルタイムでクエリできますか？
いいえ、ApsaraVideo Media Processing はトランスコーディングジョブのリアルタイムの進捗状況をクエリする API を提供していません。ただし、完了率に基づいて進捗を推定できます：
進捗 0%：トランスコーディングジョブは準備段階です。これには、ビデオのダウンロードと分析が含まれます。
進捗 20%：トランスコーディングジョブが開始されました。完了するまでお待ちください。
進捗 100%：トランスコーディングジョブは完了です。
入力ファイルと出力ファイルは 1 対 1 で対応していますか？1 つのジョブで複数の出力を作成できますか？
各トランスコーディングジョブは、1 つの入力ファイル、1 つのトランスコーディングテンプレート、および 1 つの出力ファイルに対応します。ただし、ApsaraVideo Media Processing では、1 回の送信で複数の出力を指定できます。システムは、各出力に対して個別のジョブを作成します。
ApsaraVideo Media Processing は同時にいくつのジョブを処理できますか？
各ユーザーにはデフォルトのトランスコーディングリソースクォータがあります。トランスコーディングリソースは MPS キューに割り当てられ、各キューは独立しています。キューが処理できる同時ジョブ数は、そのキューに割り当てられたリソースクォータを超えることはできません。詳細については、「制限事項」をご参照ください。
トランスコーディングリソースとは何ですか？
トランスコーディングリソースは、ApsaraVideo Media Processing がトランスコーディングジョブを実行するために使用するコンピュートノードです。各トランスコーディングリソースは、一度に 1 つのトランスコーディングジョブを実行できます。ApsaraVideo Media Processing は共有トランスコーディングリソースを提供し、各ユーザーにクォータを設定します。このクォータは、同時に処理できるジョブの最大数を制限します。システムがビジー状態の場合、同時に処理できるジョブ数はクォータよりも少なくなることがあります。
プリセットトランスコーディングテンプレートとは何ですか？
プリセットテンプレートは、出力ファイルのフォーマット、解像度、コーデックなど、ApsaraVideo Media Processing がトランスコーディング中に適用するさまざまな設定を含む組み込みのトランスコーディングテンプレートです。ApsaraVideo Media Processing はビデオの特徴をインテリジェントに分析し、さまざまな再生デバイスやネットワーク帯域幅の条件に適したプリセットテンプレートを推奨します。ジョブを作成する際に、推奨されるプリセットテンプレートを指定できます。トランスコーディングジョブを送信する際に推奨されていないプリセットテンプレートを指定すると、エラーが返されます。詳細については、「プリセットテンプレートの詳細」をご参照ください。
提供されているプリセットトランスコーディングテンプレートのいずれも自分に適していない場合はどうすればよいですか？
カスタムトランスコーディングテンプレートを作成できます。詳細については、「カスタムトランスコーディングテンプレート」をご参照ください。
専用のトランスコーダーを提供してもらえますか？
ApsaraVideo Media Processing はトランスコーダーのカスタマイズや専用サービスをサポートしていません。
リアルタイムエンコーディングはサポートされていますか？
ApsaraVideo Media Processing は現在、ファイルベースのトランスコーディングサービスであり、リアルタイムトランスコーディングはサポートしていません。
ApsaraVideo Media Processing はどのリージョンで利用できますか？
詳細については、「サービスリージョン」をご参照ください。
ApsaraVideo Media Processing でメッセージトピックを作成すると、「トピックは 1 つしか作成できません！」というエラーが表示されます。なぜですか？
現在、各 ApsaraVideo Media Processing ユーザーは 1 つの MPS キューしか作成できません。これが「トピックは 1 つしか作成できません！」というエラーが発生する理由です。キューの作成方法については、「MPS キューの作成」をご参照ください。
ApsaraVideo Media Processing の AliyunAudioCodec の Profile フィールドの値は何を意味しますか？
ApsaraVideo Media Processing のオーディオコーデック設定は、次の 5 つのプロファイルをサポートしています：
aac_low
aac_he
aac_he_v2
aac_ld
aac_eld
対応フォーマット
対応入力フォーマット
コンテナフォーマット
3GP、AVI、FLV、MP4、M3U8、MPG、ASF、WMV、MKV、MOV、TS、WebM など。
ビデオエンコード形式
H.264/AVC、H.263、H.263+、MPEG-1、MPEG-2、MPEG-4、MJPEG、VP8、VP9、Quicktime、RealVideo、Windows Media Video など。
オーディオエンコード形式
AAC、AC-3、ADPCM、AMR、DSD、MP1、MP2、MP3、PCM、RealAudio、Windows Media Audio など。
対応出力フォーマット
PC には FLV、Android デバイスには MP4、iOS デバイスには TS (M3U8) の出力フォーマットを推奨します。デフォルトのビデオエンコード形式は H.264/AVC、デフォルトのオーディオエンコード形式は AAC です。
対応フォーマットの詳細リスト
ApsaraVideo Media Processing がサポートするフォーマットの完全なリストについては、「対応フォーマット」をご参照ください。
MP4 ファイルを作成する際、プログレッシブダウンロードはサポートされていますか？
MP3 ファイルの先頭に MOOV アトムを配置すると、ファイル全体のダウンロードを待たずに、すぐに再生を開始できます。
ApsaraVideo Media Processing はステレオフォーマットをサポートしていますか？
ApsaraVideo Media Processing は、デュアルチャネルの AAC および MP3 形式でのトランスコーディングされたオーディオ出力をサポートしています。
セキュリティ
メディアファイルは安全ですか？
はい。すべてのメディアリソースは、お客様自身の OSS バケットに保存されます。Resource Access Management (RAM) を使用して、指定したバケット内の特定のファイルへのトランスコーディングアクセス権のみを ApsaraVideo Media Processing に付与できます。
暗号化されたメディアファイルはサポートされていますか？
いいえ。ApsaraVideo Media Processing は暗号化された入力ファイルをサポートしていません。