Video Cropping
最終更新日：2025-05-22 15:09:37
動画クロップ機能を使用すると、不要な領域を削除し、特定の関心領域に焦点を当てることができます。この操作は他のメディア処理タスクと単一のAPIコールで組み合わせて実行可能です。
使用方法
リクエストボディ内でfopsパラメータを以下の形式で構成します：
<op>/<format>
/gravity/<value>
/vcrop/<value>
|saveas/<Urlsafe_Base64_Encode(bucket:filekey)>
必須パラメータ
| パラメータ | 説明 |
|---|---|
op |
操作タイプ。動画クロップにはavthumbを指定 |
format |
出力形式（例：flv、mp4、m3u8） |
オプションパラメータ
| パラメータ | 説明 |
|---|---|
gravity |
クロップ開始位置と方向を決定。デフォルト：TOP_LEFT |
vcrop |
幅と高さでクロップ領域の寸法を定義 |
saveas |
出力先とファイル名をURL-safe Base64エンコード形式で指定：Urlsafe_Base64_Encode(bucket:保存ファイル名) |
基準位置リファレンス
gravityパラメータがクロップ開始位置を指定します：
| 値 | 説明 |
|---|---|
TOP_LEFT |
左上隅から開始（デフォルト） |
TOP_CENTER |
上部中央から開始 |
TOP_RIGHT |
右上隅から開始 |
CENTER_LEFT |
左側中央から開始 |
CENTER |
フレーム中心から開始 |
CENTER_RIGHT |
右側中央から開始 |
BOTTOM_LEFT |
左下隅から開始 |
BOTTOM_CENTER |
下部中央から開始 |
BOTTOM_RIGHT |
右下隅から開始 |
クロップ寸法リファレンス
vcropパラメータがクロップ領域の寸法を制御します：
| 形式 | 説明 |
|---|---|
<Width>x |
幅のみ設定（高さは元のまま）。範囲：0-10,000 |
x<Height> |
高さのみ設定（幅は元のまま）。範囲：0-10,000 |
<Width>x<Height> |
幅と高さを同時設定。各次元の範囲：0-10,000 |
{vcropSize}a<dx>a<dy> |
開始点から右にdxピクセル、下にdyピクセル移動して位置調整 |
例
本サンプルでは2種類の方法で動画をクロップし、別々の出力ファイルを生成します：
- 左上隅から400x352ピクセルのm4a形式動画を生成
- 中心点から200x352ピクセルのflv形式動画を生成
擬似コード
curl -v -X POST
-d "bucket=Urlsafe_Base64_Encode(vod-wcs-test001)&key=Urlsafe_Base64_Encode(test.mp4)&fops=Urlsafe_Base64_Encode(avthumb/m4a/gravity/TOP_LEFT/vcrop/400x352|saveas/Urlsafe_Base64_Encode(vod-wcs-test001:test_file.m4a);avthumb/flv/gravity/CENTER/vcrop/200x352|saveas/Urlsafe_Base64_Encode(vod-wcs-test001:test_file.flv))&force=1&separate=1"
-H "Authorization:AccessKey:EncodeSign"
--url "http://mgrDomain/fops"
実際のリクエスト
curl -v -X POST
-d "bucket=dm9kLXdjcy10ZXN0MDAx&key=dGVzdC5tcDQ=&fops=YXZ0aHVtYi9tNGEvZ3Jhdml0eS9UT1BfTEVGVC92Y3JvcC80MDB4MzUyfHNhdmVhcy9kbTlrTFhkamN5MTBaWE4wTURBeE9uUmxjM1JmWm1sc1pTNXROR0VLQ2c9PTthdnRodW1iL2Zsdi9ncmF2aXR5L0NFTlRFUi92Y3JvcC8yMDB4MzUyfHNhdmVhcy9kbTlrTFhkamN5MTBaWE4wTURBeE9uUmxjM1JmWm1sc1pTNW1iSFlLQ2c9PQoK&force=1&separate=1"
-H "Authorization:AccessKey:EncodeSign"
--url "http://mgrDomain/fops"
このドキュメントの内容は役に立ちましたか?
はい
いいえ