タイムアウトエラー、パラメーター設定、予期しない出力など、MPS のスナップショットジョブにおける一般的な問題と解決策について説明します。
スナップショットジョブの一般的なエラー
スナップショットジョブは、SnapshotTimeOut、InvalidParameter.ResourceNotFound、または InvalidParameter.ResourceContentBad などのエラーコードを返す場合があります。スナップショットジョブが失敗した場合は、QuerySnapshotJobList API を呼び出して失敗の原因を照会してください。
SnapshotTimeOut
同期スナップショットジョブがタイムアウトした場合に返されます。タイムアウト期間は 5 秒です。入力ファイルが大きい場合、この制限を超える可能性があります。タイムアウトが頻繁に発生する場合は、代わりに非同期モードでジョブを送信してください。
InvalidParameter.ResourceNotFound
入力ファイルが見つからない場合に返されます。次の原因を確認してください：
|
原因 |
解決策 |
|
ジョブの送信前に入力ファイルがアップロードされていないか、削除されています。 |
スナップショットジョブを送信する前に入力ファイルをアップロードしてください。 |
|
入力ファイルの OSS パスが無効です。 |
パスのスペルを確認してください。 |
|
入力ファイルの OSS パスが URL エンコードされていません。 |
パスにURL エンコーディングを適用してください。 |
|
OSS バケットが MPS と同じリージョンにありません。 |
リージョンを変更してください。 |
|
入力ファイルはコールドアーカイブ または ディープコールドアーカイブストレージを使用しています。 |
アクセスする前にデータを復元してください。 |
|
入力ファイルはアーカイブストレージを使用しており、リアルタイムアクセスが無効になっているか、ファイルが復元されていません。 |
アーカイブデータのリアルタイムアクセスを有効にするか、アクセスする前にファイルを復元してください。 |
|
OSS バケットで Referer ベースのホットリンク対策が有効になっています。 |
ワークフローでトリガーされるジョブの場合は、OSS バケットに Referer を設定してください。手動で送信されたジョブの場合は、Referer パラメーターを Input パラメーターに追加してください。 |
InvalidParameter.ResourceContentBad
パラメーターに競合がある場合、または入力ファイルが破損している場合に返されます。以下のようにトラブルシューティングを行ってください：
-
入力ファイルが破損していないことを確認してください。
-
スナップショットジョブのパラメーター、特に Time、FrameType、OutputFile を確認してください。
-
エラーが解決しない場合は、リージョン ID とリクエスト ID を添えて Alibaba Cloud テクニカルサポートにお問い合わせください。
M3U8 ファイルにおける同期スナップショットの失敗
M3U8 ファイルの同期スナップショットジョブでは、M3U8 インデックスで参照される TS ファイルは、M3U8 ファイルと同じディレクトリにある必要があります。非同期モードにはこの制限はありません。
スナップショットの失敗：指定時間が動画の長さを超過
エラーコード：InvalidParameter.ResourceContentBad
エラーメッセージ：The resource operated InputFile is bad
|
原因 |
解決策 |
|
単一の通常フレームのスナップショットジョブで、 |
Time を動画の長さより小さい値に設定してください。または、キーフレームモードを使用してください。Time が動画の長さを超えた場合、失敗する代わりに最も近いキーフレームがキャプチャされます。 |
ジョブの失敗：無効な OutputFile Object パラメーター
エラーコード：InvalidParameter.ResourceContentBad
エラーメッセージ：The format of parameter "SnapshotConfig:OutputFile:Object" is invalid
|
原因 |
解決策 |
|
複数スナップショットジョブの場合、OutputFile の Object パラメーターに {Count} プレースホルダーが含まれていません。 |
スナップショットが互いに上書きされるのを防ぐため、OutputFile の Object パラメーターに {Count} を追加してください。 |
|
WebVTT スナップショットのフォーマットが vtt に設定されていますが、OutputFile の Object パラメーターが .vtt 拡張子を使用していません。 |
Object パラメーターのファイル拡張子を .vtt に変更してください。 |
ジョブの失敗：無効な TileOutputFile Object パラメーター
エラーコード：InvalidParameter.ResourceContentBad
エラーメッセージ：The format of parameter "SnapshotConfig:TileOutputFile:Object" is invalid
|
原因 |
解決策 |
|
スプライト生成ジョブの場合、TileOutputFile の Object パラメーターに {TileCount} プレースホルダーが含まれていません。 |
スプライトが互いに上書きされるのを防ぐため、TileOutputFile の Object パラメーターに {TileCount} を追加してください。 |
スナップショット設定に関する FAQ
同期スナップショットモードと非同期スナップショットモードをどのように区別しますか？
SnapshotConfig で Interval または Num パラメーターが指定されている場合、PipelineId が指定されているかどうかに関わらず、ジョブは非同期モードで実行されます。
スナップショットの時間が動画の長さを超えた場合はどうなりますか？
-
単一のスナップショットで、Time が動画の長さを超える場合：
-
通常フレーム：ジョブはエラーコード「InvalidParameter.ResourceContentBad」とメッセージ「The resource operated InputFile is bad」で失敗します。
-
キーフレーム：ジョブは成功します。指定された時間に最も近いキーフレームがキャプチャされます。
-
-
複数スナップショット：Time + Interval × Num が動画の長さを超える場合でも、ジョブは成功します。スナップショットは動画の長さ内の時点でのみキャプチャされます。キャプチャされたスナップショットの総数が返されます。
予期しないスナップショット結果
スナップショット数が設定と一致しない
次の原因を確認してください：
|
原因 |
解決策 |
|
スプライトの出力パスと個々の画像の出力パスが同じであるため、ファイルが互いに上書きされます。 |
OutputFile と TileOutputFile には異なるバケットまたはパスを使用してください。 |
|
Interval と Num の両方が指定されています (サンプリングモード)。動画が短すぎる場合、Num で指定された数より少ないスナップショットしかキャプチャされないことがあります。 |
これは想定される動作です。 |
|
単一スナップショットジョブで黒フレーム検出が有効になっています。フレームが黒としてフィルタリングされた場合、スナップショットはキャプチャされません。 |
BlackLevel および PixelBlackThreshold パラメーターを調整して、黒フレームのフィルタリングを減らしてください。 |
|
キーフレームキャプチャが有効になっています (
|
正確な時間にスナップショットをキャプチャするには、FrameType を通常に設定してください。 |
スナップショットのタイミングが設定と一致しない
|
原因 |
解決策 |
|
FrameType が intra (キーフレームモード) に設定されています。キーフレームは動画内に間隔を置いて出現するため、キャプチャ時間は正確ではありません。代わりに、指定された時間に最も近いキーフレームがキャプチャされます。 |
正確な時間にスナップショットをキャプチャするには、FrameType を通常に設定してください。 |
ぼやけたスナップショット
|
原因 |
解決策 |
|
FrameType が通常に設定されています。通常フレームはキーフレームよりも鮮明ではありません。 |
より鮮明なスナップショットを得るには、FrameType を intra に設定してください。 |
スナップショットの歪みまたはアスペクト比の不一致
次の原因を確認してください：
|
原因 |
解決策 |
|
幅と高さの両方が指定されていますが、アスペクト比が入力動画と異なります。 |
幅または高さのみを指定してください。もう一方の寸法は、元のアスペクト比を維持するために自動的にスケーリングされます。 |
|
|
一方の寸法 (幅または高さ) のみを設定してください。もう一方はアスペクト比を維持するために自動的に調整されます。 |
|
入力動画に互換性のない DAR/SAR 属性があります。 |
リージョン ID とスナップショットジョブ ID を添えて Alibaba Cloud テクニカルサポートにお問い合わせください。 |
縦向き動画から横向きスナップショットの生成
縦向きモードの MP4 動画には回転識別子 (モバイルで撮影された動画で一般的) が含まれているため、スナップショットは横向きで表示されます。
回転識別子を確認するには：
SubmitMediaInfoJob API を呼び出し、Rotate パラメーターを確認してください。-90 または 90 の値は、動画が回転していることを示し、表示の向きが入力と異なる原因となります。
同期スナップショットにおけるスプライトまたは VTT ファイルの未生成
同期モードは 1 つのスナップショットのみをキャプチャし、スプライト生成や WebVTT 出力をサポートしていません。スプライトまたは WebVTT スナップショットを生成するには、ジョブを非同期モードで送信してください。