スナップショットキャプチャに関するFAQ - ApsaraVideo Media Processing

このトピックでは、ApsaraVideo Media Processing（MPS）でのスナップショットキャプチャに関するよくある質問（FAQ）への回答を提供します。

スナップショットジョブの一般的なエラー

スナップショットジョブに対して、SnapshotTimeOut、InvalidParameter.ResourceNotFound、InvalidParameter.ResourceContentBad のいずれかのエラーコードが返される場合があります。スナップショットジョブの送信に失敗した場合、QuerySnapshotJobList オペレーションを呼び出して、失敗の原因を問い合わせることができます。詳細については、QuerySnapshotJobList をご参照ください。

エラーコード「SnapshotTimeOut」が返された場合はどうすればよいですか？

このエラーコードは、同期モードのスナップショットジョブがタイムアウトした場合に返されます。同期モードのスナップショットジョブのタイムアウト期間は 5 秒です。入力ファイルのサイズが大きすぎる場合、スナップショットジョブがタイムアウトする可能性があります。スナップショットジョブが頻繁にタイムアウトする場合は、非同期モードでスナップショットジョブを送信することをお勧めします。

エラーコード「InvalidParameter.ResourceNotFound」が返された場合はどうすればよいですか？

このエラーコードは、スナップショットジョブの送信に失敗した場合、または入力ファイルが見つからないためにスナップショットジョブが失敗した場合に返されます。次の表に記載されている原因に基づいてエラーのトラブルシューティングを行ってください。

原因	解決策
スナップショットジョブを送信したときに入力ファイルがアップロードされていないか、入力ファイルが削除されています。	スナップショットジョブを送信する前に入力ファイルがアップロードされていることを確認してください。
入力ファイルのオブジェクトストレージサービス（OSS）パスが無効です。	入力ファイルの OSS パスを確認してください。
入力ファイルの OSS パスで URL エンコードが実行されていません。	詳細については、URL エンコードをご参照ください。
入力ファイルが存在する OSS バケットが MPS と同じリージョンにありません。	OSS バケットと MPS が同じリージョンにあることを確認してください。
入力ファイルは、コールドアーカイブまたはディープコールドアーカイブストレージを使用して OSS に保存されています。	データにアクセスする前に、コールドアーカイブデータをリストアしてください。
入力ファイルは、アーカイブストレージを使用して OSS に保存されており、入力ファイルのリアルタイムアクセス機能が無効になっているか、入力ファイルがリストアされていません。	アーカイブデータのリアルタイムアクセス機能を有効にするか、データにアクセスする前にデータをリストアしてください。
入力ファイルが存在する OSS バケットで、リファラーベースのホットリンク保護機能が有効になっています。	ワークフローを自動的にトリガーするには、入力ファイルが存在する OSS バケットのリファラーを設定する必要があります。別の方法でスナップショットジョブを送信する場合は、Input パラメーターに Referer パラメーターを追加する必要があります。

エラーコード「InvalidParameter.ResourceContentBad」が返された場合はどうすればよいですか？

このエラーコードは、スナップショットジョブの送信に失敗した場合、またはパラメーター設定の競合が発生したか、入力ファイルが破損しているためにスナップショットジョブが失敗した場合に返されます。次の手順を実行して、エラーのトラブルシューティングを行ってください。

入力ファイルが正常かどうかを確認します。
スナップショットジョブのパラメーター、特に Time、FrameType、OutputFile パラメーターが正しく設定されているかどうかを確認します。
エラーが解決しない場合は、Alibaba Cloud テクニカルサポートに連絡し、リージョン ID とリクエスト ID を提供してトラブルシューティングを行ってください。

M3U8 ファイルの同期モードでスナップショットジョブを送信できない場合はどうすればよいですか？

M3U8 ファイルの同期モードでスナップショットジョブを送信する場合は、M3U8 インデックスで参照されているトランスポートストリーム（TS）ファイルが M3U8 ファイルと同じディレクトリにあることを確認してください。M3U8 ファイルの非同期モードでスナップショットジョブを送信する場合は、M3U8 インデックスで参照されている TS ファイルと M3U8 ファイルを異なるディレクトリに配置できます。

スナップショットがキャプチャされる時点がビデオの長さよりも大きいため、単一のスナップショットをキャプチャするためのスナップショットジョブを送信できない場合はどうすればよいですか？

エラーコード：InvalidParameter.ResourceContentBad

エラーメッセージ：操作対象のリソース InputFile が不正です

原因

解決策

単一の通常フレームをキャプチャするためのスナップショットジョブを送信し、Time パラメーターにビデオの長さよりも大きい値を設定すると、スナップショットジョブの送信に失敗します。

Time パラメーターにビデオの長さよりも小さい値を設定します。または、単一のキーフレームをキャプチャするためのスナップショットジョブを送信することもできます。Time パラメーターにビデオの長さよりも大きい値を設定すると、指定した時点に最も近いキーフレームがキャプチャされます。

スナップショットジョブを送信できず、エラーメッセージに OutputFile パラメーターの Object パラメーターの形式が無効であることが示されている場合はどうすればよいですか？

エラーコード：InvalidParameter.ResourceContentBad

エラーメッセージ：パラメーター "SnapshotConfig:OutputFile:Object" の形式が無効です

原因	解決策
複数スナップショットをキャプチャするためのスナップショットジョブを送信するときに、OutputFile パラメーターの Object パラメーターの値に {count} プレースホルダーが含まれていません。この場合、無効なパラメーター設定が原因で、スナップショットジョブの送信に失敗します。	同じパスにある複数のスナップショットが互いに上書きされないように、OutputFile パラメーターの Object パラメーターの値に {Count} を追加します。
Format パラメーターが vtt に設定されて Web ビデオテキストトラックフォーマット（WebVTT）スナップショットがキャプチャされますが、OutputFile パラメーターの Object パラメーターの値のファイル名拡張子が .vtt ではありません。この場合、無効なパラメーター設定が原因で、スナップショットジョブの送信に失敗します。	OutputFile パラメーターの Object パラメーターの値のファイル名拡張子を .vtt に変更します。

スナップショットジョブを送信できず、エラーメッセージに TileOutputFile パラメーターの Object パラメーターの形式が無効であることが示されている場合はどうすればよいですか？

エラーコード：InvalidParameter.ResourceContentBad

エラーメッセージ：パラメーター "SnapshotConfig:TileOutputFile:Object" の形式が無効です

原因	解決策
スプライトを生成するためのスナップショットジョブを送信するときに、OutputFile パラメーターの Object パラメーターの値に {TileCount} プレースホルダーが含まれていません。この場合、無効なパラメーター設定が原因で、スナップショットジョブの送信に失敗します。	同じパスにあるスプライトが互いに上書きされないように、TileOutputFile パラメーターの Object パラメーターの値に {TileCount} を追加します。

スナップショットジョブの設定に関するFAQ

同期モードのスナップショットジョブと非同期モードのスナップショットジョブを区別するにはどうすればよいですか？

スナップショットジョブの SnapshotConfig パラメーターで Interval パラメーターまたは Num パラメーターが指定されている場合、PiplineId パラメーターが指定されているかどうかに関係なく、スナップショットジョブは非同期モードになります。

スナップショットがキャプチャされる時点にビデオの長さよりも大きい値を設定するとどうなりますか？

単一のスナップショットをキャプチャするためのスナップショットジョブを送信し、Time パラメーターにビデオの長さよりも大きい値を設定すると、キャプチャするフレームのタイプに基づいて次の結果が返されます。
- 通常フレーム：スナップショットジョブは失敗します。エラーコード「InvalidParameter.ResourceContentBad」とエラーメッセージ「操作対象のリソース InputFile が不正です」が返されます。
- キーフレーム：スナップショットジョブは成功します。指定した時点に最も近いキーフレームがキャプチャされます。
複数スナップショットをキャプチャするためのスナップショットジョブを送信し、Time パラメーターの値に Interval パラメーターの値と Num パラメーターの値の積を加えた値がビデオの長さよりも大きい場合、スナップショットジョブは成功します。スナップショットがキャプチャされる時点がビデオの長さ以下の場合、スナップショットはキャプチャされます。スナップショットがキャプチャされる時点がビデオの長さよりも大きい場合、スナップショットはキャプチャされません。スナップショットジョブの完了後、キャプチャされたスナップショットの数が返されます。

要件を満たしていないスナップショットに関するFAQ

スナップショットの数が Num パラメーターの値と異なる場合はどうすればよいですか？

次の表に記載されている原因に基づいてエラーのトラブルシューティングを行ってください。

原因	解決策
スナップショットとスプライトの両方を生成するためのスナップショットジョブを送信するときに、OSS バケットの同じパスがスナップショットとスプライトに指定されています。その結果、スナップショットとスプライトが互いに上書きされます。	スプライトとスナップショットに異なる OSS バケットまたはパスを指定します。
サンプリングモードでスナップショットをキャプチャするために、Interval パラメーターと Num パラメーターの両方が指定されています。ビデオの長さが十分でない場合、キャプチャされたスナップショットの数が Num パラメーターの値と異なる場合があります。	結果は正常です。
単一のスナップショットをキャプチャするためのスナップショットジョブを送信するときに、黒フレーム検出機能が有効になっています。黒フレームが除外されている場合、スナップショットはキャプチャされません。	黒フレームを除外したくない場合は、BlackLevel パラメーターと PixelBlackThreshold パラメーターの値を変更できます。
FrameType パラメーターが intra に設定されて I フレームがキャプチャされます。次の原因により、キャプチャされたスナップショットの数が Num パラメーターの値と異なる場合があります。入力ビデオの I フレームの数が Num パラメーターの値よりも少ない。入力ビデオのグループオブピクチャ（GOP）サイズが固定されていません。その結果、I フレームが入力ビデオに均等に分散されていません。連続する 2 つの I フレームがキャプチャされる間隔は、次の式に基づいて計算されます。連続する 2 つの I フレームがキャプチャされる間隔 = ビデオの全長 / キャプチャされるスナップショットの数。I フレームが均等に分散されていない場合、特定の間隔に 2 つの I フレームが存在し、特定の間隔に I フレームが存在しない場合があります。スナップショットをキャプチャする時点の近くに I フレームが見つかりません。この場合、スナップショットはキャプチャされません。	正確な時点でスナップショットをキャプチャする場合は、FrameType パラメーターを normal に設定します。

スナップショットがキャプチャされる時点が Time パラメーターの値と異なる場合はどうすればよいですか？

原因	解決策
FrameType パラメーターが intra に設定されて I フレームがキャプチャされます。キーフレームはビデオ内で一定の間隔で表示されます。したがって、スナップショットがキャプチャされる時点は正確ではありません。時点に最も近いキーフレームがキャプチャされます。	正確な時点でスナップショットをキャプチャする場合は、FrameType パラメーターを normal に設定します。

スナップショットがぼやけている場合はどうすればよいですか？

原因	解決策
FrameType パラメーターが normal に設定されて通常フレームがキャプチャされます。通常フレームはキーフレームほど鮮明ではありません。	より鮮明なスナップショットをキャプチャする場合は、FrameType パラメーターを intra に設定します。

スナップショットが歪んでいる場合、またはスナップショットのアスペクト比がパラメーター設定で指定されたアスペクト比と異なる場合はどうすればよいですか？

次の表に記載されている原因に基づいてエラーのトラブルシューティングを行ってください。

原因	解決策
スナップショットの幅と高さの両方が指定されていますが、アスペクト比が入力ビデオのアスペクト比と異なります。	スナップショットの幅または高さのみを指定することをお勧めします。アスペクト比は入力ビデオの解像度に基づいて変更されません。これにより、画像の歪みが防止されます。
スプライトのセルの幅と高さの両方が指定されていますが、アスペクト比が入力ビデオのアスペクト比と異なります。その結果、スプライトのスナップショットが歪みます。	スプライトのセルの幅または高さのみを指定することをお勧めします。アスペクト比は入力ビデオの解像度に基づいて変更されません。これにより、画像の歪みが防止されます。
MPS が入力ビデオの表示アスペクト比（DAR）またはサンプルアスペクト比（SAR）と互換性がありません。	Alibaba Cloud テクニカルサポートに連絡し、リージョン ID とスナップショットジョブ ID を提供してトラブルシューティングを行ってください。

入力ビデオが縦向きモードなのにスナップショットが横向きモードの場合はどうすればよいですか？

縦向きモードの入力 MP4 ビデオには回転識別子が付いています。したがって、スナップショットは横向きモードになります。ほとんどの場合、モバイルデバイスでキャプチャされたビデオには回転識別子が付いています。

入力ビデオに回転識別子が付いているかどうかを確認するには、次の操作を実行します。

SubmitMediaInfoJob オペレーションを呼び出して、Rotate パラメーターの値を表示します。値が -90 または 90 の場合、ビデオは左または右に 90 度回転します。その結果、スナップショットの表示モードが入力ビデオの表示モードと異なります。

同期モードでスナップショットジョブを送信したときにスプライトが生成されない場合、または WebVTT スナップショットがキャプチャされない場合はどうすればよいですか？

単一のスナップショットをキャプチャするために同期モードでスナップショットジョブを送信したときに、スプライトまたは WebVTT スナップショットに関連するパラメーターが指定されています。同期モードでは、1 つの I フレームのみをキャプチャするためのスナップショットジョブを送信できます。スナップショットジョブでは、スプライトを生成したり、WebVTT スナップショットをキャプチャしたりすることはできません。スプライトを生成したり、WebVTT スナップショットをキャプチャしたりするには、非同期モードでスナップショットジョブを送信します。