サムネイル設定

サムネイル

APIバージョン：V1、V2

親:出力

互換性のあるジョブタイプ:すべて

例：

• 「サムネイル」: [ {} ]
• 「サムネイル」: {}

説明:

出力ごとに、1 つ以上のサムネールを要求できます。

各出力には、固有のサムネイルの独自のセットを含めることができますサイズ、 base_url、 とアクセス制御設定。

配列内で複数のサムネールハッシュを渡すことで、1 つの出力に対して複数のサムネールセットを作成できます。サムネールオプションが配列で渡された場合、ラベルをセットに設定する必要があります。

S3 access_control は、出力ビデオと同じオプションを使用して設定します。

サムネールは1セットあたり100に制限されています。リクエストされたオプションが与えられ、さらにサムネイルが生成される場合、出力に警告が追加され、制限に達するとサムネイルの作成が停止します。

注 :サムネイルのみの仕事というものはありません。サムネイルだけで出力を指定する また作成します デフォルトのトランスコーディング設定で請求可能なフルレングスのmp4を作成し、一時ストレージにアップロードします。

{ "input": "s3://zencodertesting/test.mov", "outputs": [ { "thumbnails": [ { "label": "first", "number": 10 } , { "label": "second", "interval_in_frames": 5000 } ]}]}

参照:ラベル

ラベル

APIバージョン：V1、V2

親:出力 / サムネイル

互換性のあるジョブタイプ:すべて

例:ポスター

説明:

サムネイルセットの名前。配列内のサムネイルセットをリクエストする場合に必要です。

{ "input": "s3://zencodertesting/test.mov", "outputs": [ { "thumbnails": [ { "label": "poster" } , { "label": "clips" } ]}]}

形式

APIバージョン：V1、V2

親:出力 / サムネイル

デフォルト: PNG

有効な値: png または jpg

互換性のあるジョブタイプ:すべて

例: jpg

説明:

サムネイル画像のフォーマット。

{ "input": "s3://zencodertesting/test.mov", "outputs": [ { "thumbnails": { "format": "jpg" } }]}

番号

APIバージョン：V1、V2

親:出力 / サムネイル

有効な値:正の整数

互換性のあるジョブタイプ:すべて

例:3

説明:

キャプチャするサムネイルの数。Zencoder は、ファイルの全期間にわたって等間隔のサムネールを取得します。だから、1つのサムネイルを求めると、それはファイルの真ん中近くになります。8分のビデオで3つのサムネイルを指定すると、約2、4、および6分のサムネイルになります。

{ "input": "s3://zencodertesting/test.mov", "outputs": [ { "thumbnails": { "number": 3 } }]}

start_at_first_frame

APIバージョン：V1、V2

親:出力 / サムネイル

デフォルト:偽

有効な値:真または偽

互換性のあるジョブタイプ:すべて

例:真

説明:

サムネール生成に数値オプションを使用すると、最初のフレームでサムネイルの取得が開始されます。

たとえば、動画の長さが 5 秒で、数字オプションを使用して 5 つのサムネールをリクエストすると、0、1、2、3、4 にサムネイルが作成されます。通常、0.83秒、1.66秒、2.49秒、3.32秒、および4.15秒でサムネイルを取得します。

{ "input": "s3://zencodertesting/test.mov", "outputs": [ { "thumbnails": { "number": 5, "start_at_first_frame": true } }]}

間隔

APIバージョン：V1、V2

親:出力 / サムネイル

互換性のあるジョブタイプ:すべて

例:60

説明:

秒単位で偶数の間隔でサムネイルを取ります。Zencoder は、ファイルの N 秒ごとに 1 つのサムネイルを返します。したがって、60の間隔を選択し、入力ファイルの長さが12分であれば、分ごとに12個のサムネールが戻されます。

{ "input": "s3://zencodertesting/test.mov", "outputs": [ { "thumbnails": { "interval": 60 } }]}

参照:interval_in_frames

interval_in_frames

APIバージョン：V1、V2

親:出力 / サムネイル

互換性のあるジョブタイプ:すべて

例:120

説明:

サムネールをフレーム単位で均等な間隔で撮ります。Zencoder は、ファイルの N フレームごとにサムネイルを 1 つ返します。したがって、120の間隔を選択し、入力ファイルが29.97フレーム/秒の場合、約4秒ごとにサムネイルが返されます。

{ "input": "s3://zencodertesting/test.mov", "outputs": [ { "thumbnails": { "interval_in_frames": 120 } }]}

参照:間隔

タイムズ

APIバージョン：V1、V2

親:出力 / サムネイル

互換性のあるジョブタイプ:すべて

例: [0, 30, 60, 90]

説明:

サムネイルを取得するための時間の配列（秒単位）。小数点は有効です。したがって、時間を [12.5, 25] に設定すると、12.5 秒に、もう 1 つは 25 秒に 2 つのサムネールを取得します。この値は、負でない数の配列である必要があります。

{ "input": "s3://zencodertesting/test.mov", "outputs": [ { "thumbnails": { "times": [0, 30, 60, 90] } }]}

aspect_mode

APIバージョン：V1、V2

親:出力 / サムネイル

デフォルト:保持

有効な値:保持、ストレッチ、トリミング、またはパディング

互換性のあるジョブタイプ:すべて

例:パッド

説明:

サムネイルを作成するときに使用するアスペクトモードです。

• 保持 :デフォルトでは、Zencoder は出力ビデオファイルの縦横比を維持するため、ワイドスクリーンコンテンツを送信して標準解像度を要求すると、サムネイルファイルはワイドスクリーンの縦横比を維持し、要求されたサイズに収まります。
• ストレッチ :アスペクトモードが「ストレッチ」の場合、画像が歪んだ場合でも、サムネイルは要求された幅と高さに正確に一致します。
• 作物 :このオプションは、Zencoder に対して、上/下または左/右からピクセルをトリミングして、要求されたサイズに一致するようにサムネイルを「ズーム」します。
• パッド :pad オプションは、要求されたフレームサイズに合わせてサムネイルをレターボックス化するよう Zencoder に指示します。このオプションを使用して、出力ビデオのアスペクト比を維持しながら、常に同じサイズのサムネイルを取得します。

注:ビデオスケーリングアルゴリズムの制約により、サムネイルのサイズは偶数になります。たとえば、100x75のサムネイルをリクエストすると、100x74のサムネイルが表示されます。

{ "input": "s3://zencodertesting/test.mov", "outputs": [ { "thumbnails": { "aspect_mode": "pad", "width": 200, "height": 200 } }]}

参照:サイズ、幅、高さ

size

APIバージョン：V1、V2

親:出力 / サムネイル

互換性のあるジョブタイプ:すべて

例:400x300

説明:

サムネイルのターゲット解像度 (「160×120」など)。サイズを指定しない場合、サムネイルは出力ビデオと同じサイズになります。デフォルトでは、アスペクト比が保持されるため、このサイズパラメーターのアスペクト比がムービーのアスペクト比と一致しない場合、結果のファイルはこのサイズに正確に一致しない可能性があります。対応する出力ファイルのストレッチがtrueに設定されている場合、このサムネイルも解像度を満たすようにストレッチされます。

{ "input": "s3://zencodertesting/test.mov", "outputs": [ { "thumbnails": { "size": "400x300" } }]}

参照:幅、高さ、および aspect_mode

幅

APIバージョン：V1、V2

親:出力 / サムネイル

有効な値:正の整数

互換性のあるジョブタイプ:すべて

例:640

説明:

サムネイルの幅。幅が指定されていない場合は、出力ファイルの幅、またはサイズまたは高さの設定にスケールを使用します。

サイズは幅と高さよりも優先されることに注意してください。

{ "input": "s3://zencodertesting/test.mov", "outputs": [ { "thumbnails": { "width": 640 } }]}

参照:サイズ、高さ、および aspect_mode

高さ

APIバージョン：V1、V2

親:出力 / サムネイル

有効な値:正の整数

互換性のあるジョブタイプ:すべて

例:480

説明:

サムネイルの高さ。高さが指定されていない場合は、出力ファイルの高さ、またはサイズまたは幅に合わせてスケール設定を使用します。

サイズは幅と高さよりも優先されることに注意してください。

{ "input": "s3://zencodertesting/test.mov", "outputs": [ { "thumbnails": { "height": 480 } }]}

参照:サイズ、幅、および aspect_mode

base_url

APIバージョン：V1、V2

親:出力 / サムネイル

有効な値:有効な S3、クラウドファイル、GCS、FTP、FTPS、または SFTP URL からファイル名を除いたもの。フォーマット:s3://[バケット名]/[パス] または ftp://[user]:[password]@[ftp.url]/[path]

互換性のあるジョブタイプ:すべて

例:

• s3: //my-output-bucket/
• cf: //ユーザー名api_key @container /path/
• ftp://user:password@ftp.example.com/path/to

説明:

サムネイルの出力先。base_url が空白の場合は、Zencoder S3 バケットにサムネイルを保存します。Zencoder S3 バケットに保存されたファイルは、24 時間後に利用可能になります。ファイル名は出力間で一意ではないことに注意してください (例:frame_0000.png)。そのため、ファイルが上書きされないように、宛先は一意のディレクトリまたはキープレフィックスを指定する必要があります。

FTPユーザー：サーバーのルートから書き込もうとしているので、URLの絶対パスを使用して、サーバーに正常に書き込めるようにします。

クレデンシャルに関する注意事項:

base_url 経由で資格情報を提供すると、ジョブの詳細、出力の詳細などへのリクエストに表示される URL に表示されます。認証情報がZencoderで保存されている場合、それらのレスポンスのURLには表示されません。

{ "input": "s3://zencodertesting/test.mov", "outputs": [ { "thumbnails": { "base_url": "s3://my-output-bucket/" } }]}

参照:接頭辞とファイル名

プレフィックス

APIバージョン：V1、V2

親:出力 / サムネイル

デフォルト:フレーム

互換性のあるジョブタイプ:すべて

例:

• 親指
• thumbnails

説明:

サムネイルファイルは、連続したファイル名で書き出されます。ただし、サムネイルファイルのカスタムプレフィックスを指定できます。接頭辞が指定されていない場合は、フレームを使用します。たとえば、「カスタム」というプレフィックスを使用すると、エクスポートされるファイルには custom_0000.png、custom_0001.png などの名前が付けられます。カスタムプレフィックスがないと、frame_0000.png、frame_0001.pngなどの名前になります。

{ "input": "s3://zencodertesting/test.mov", "outputs": [ { "thumbnails": { "prefix": "thumbs" } }]}

参照:base_url とファイル名

filename

APIバージョン：V1、V2

親:出力 / サムネイル

デフォルト:フレーム

互換性のあるジョブタイプ:すべて

例：

• サムネール_ {{number}}
• {{number}} _ {{width}} x {{height}} -サムネイル

説明:

サムネイルファイルには、いくつかの属性に基づいてファイル名を付けることができます。属性には、数値、パディング番号、幅、高さ、サイズが含まれます。Zencoder が「format」オプションに基づいて追加するため、ファイル拡張子を追加する必要はありません。

番号またはパディング番号を使用する必要があります。その他はすべてオプションです。パディング番号は4つのスポット（0000、0001など）を使用します。

高さ、幅、サイズは、生成されたサムネイルの実際のサイズに基づきます。

例： _ x -サムネイル

有効な文字には、文字、数字、ダッシュ、アンダースコア、および補間された値が含まれます。

注:ファイル名を指定すると、指定した接頭辞は無視されます。

{「入力」:「s3: //zencodertesting/test.mov」,「出力」: [{「サムネイル」: {「ファイル名」: "  _  x  -サムネイル」}]}

参照:base_url と接頭辞

公開

APIバージョン：V1、V2

親:出力 / サムネイル

デフォルト:偽

有効な値:真または偽

互換性のあるジョブタイプ:すべて

説明:

出力ファイルの publicと同じです。見る公衆このオプションの完全なドキュメントについては。

{ "input": "s3://zencodertesting/test.mov", "outputs": [ { "thumbnails": { "number": 10, "public": true } }]}

参照:access_control

アクセス制御

APIバージョン：V1、V2

親:出力 / サムネイル

有効な値:付与者と権限の 2 つの設定を含むハッシュの配列。

互換性のあるジョブタイプ:すべて

説明:

出力ファイルの access_control と同じです。このオプションの完全なドキュメントについては access_controlを参照してください。

{ "input": "s3://zencodertesting/test.mov", "outputs": [ { "thumbnails": { "access_control": [ { "permission": "READ", "grantee": "someone@example.com" } ]}}]}

参照:パブリック、被付与者、パーミッション

被付与者

APIバージョン：V1、V2

親:出力 / サムネイル / access_control

有効な値:有効な S3 被付与者 (電子メール、ID、または URI)

互換性のあるジョブタイプ:すべて

説明:

出力ファイルの被付与者と同じです。このオプションの完全なドキュメントについては、被付与者を参照してください。

{ "input": "s3://zencodertesting/test.mov", "outputs": [ { "thumbnails": { "access_control": [ { "permission": "FULL_CONTROL", "grantee": "cdc7931a9574b1055d5b76112021d0e9" } ]}}]}

参照:アクセスコントロールとパーミッション

許可

APIバージョン：V1、V2

親:出力 / サムネイル / access_control

有効な値:次のものを含む文字列または文字列の配列。読み取り、読み取り_ACP、書き込み_ACP、またはフルコントロール

互換性のあるジョブタイプ:すべて

説明:

出力ファイルのパーミッションと同じです。このオプションの完全なドキュメントについては、権限を参照してください。

{ "input": "s3://zencodertesting/test.mov", "outputs": [ { "thumbnails": { "access_control": [ { "permission": "FULL_CONTROL", "grantee": "cdc7931a9574b1055d5b76112021d0e9" } ]}}]}

参照:アクセスコントロールと被付与者

rss

APIバージョン：V1、V2

親:出力 / サムネイル

デフォルト:偽

有効な値:真または偽

互換性のあるジョブタイプ:すべて

説明:

と同じrrs出力ファイル用。見るrrsこのオプションの完全なドキュメントについては。

{ "input": "s3://zencodertesting/test.mov", "outputs": [ { "thumbnails": { "rrs": true } }]}

ヘッダー

APIバージョン：V1、V2

親:出力またはサムネイル

互換性のあるジョブタイプ:すべて

例:{ "Content-Type": "binary/octet-stream" }

説明:

アップロード時にサムネイルと一緒に送信する HTTP ヘッダー。この機能は、S3 ファイルおよびクラウドファイルを使用する場合に現在サポートされています。

Zencoder は、これらのヘッダーの限られたサブセットの設定をサポートしています。キャッシュ制御、コンテンツディスポジション、コンテンツエンコーディング、コンテンツタイプ、有効期限、x-amz-acl、x-amz-ストレージクラス、x-amz-サーバ側の暗号化、および x-amz-meta-*

出力場所が指定されていない場合、ヘッダーは無視されます。

{ "input": "s3://zencodertesting/test.mov", "outputs": [ { "thumbnails": { "headers": { "Content-Type": "binary/octet-stream", "x-amz-acl": "public-read-write" } }}]}

資格情報

APIバージョン：V2

親:出力 / サムネイル

互換性のあるジョブタイプ:すべて

例: ftp_dev_server

説明:

転送に使用する、保存された認証情報のニックネームを参照します。これらは、[ アカウント認証情報]セクションで管理されます。

注:シンジケーションサービスの資格情報は、出力ビデオ専用です。

{ "input": "s3://zencodertesting/test.mov", "outputs": [ { "thumbnails": { "base_url": "ftp://ftp.example.com/thumbnails/", "credentials": "ftp_dev_server" } }]}

参照:base_url

parallel_upload_limit

APIバージョン：V1、V2

デフォルト:S3 の場合は 30、その他すべての宛先は 10。

有効な値:1 から 30 までの整数

互換性のあるジョブタイプ:すべて

例:5

説明:

サムネイルのアップロード時に行われる同時アップロードの最大数。

これにより、リモートサーバーの帯域幅によっては、転送時間が短縮されます。接続数が多くなると、サーバーの負荷が重くなる可能性があることに注意してください。アップロードのタイムアウトに問題がある場合、またはファイルのアップロード時にZencoderが帯域幅を使いすぎないようにする場合は、これを1に設定します。

{ "input": "s3://zencodertesting/test.mov", "outputs": [ { "thumbnails": { "base_url": "ftp://ftp.example.com/thumbnails/", "parallel_upload_limit": 5 } }]}