Elastic Transcoder ジョブの作成時に指定する設定

Elastic Transcoder で変換を行うときに使用するパイプラインの名前。パイプラインによって、いくつかの設定が決まります。それらの設定には、トランスコードするファイルを Elastic Transcoder で取得するための Amazon S3 バケットや、変換結果ファイルを Elastic Transcoder で出力するためのバケットなどがあります。

ジョブで作成されるすべてのファイル (出力ファイル、サムネイル、プレイリストなど) の名前の先頭に、Elastic Transcoder が追加する値 (値が指定されている場合)。値を指定する場合は、最初の文字よりも後の任意の場所に / を含める必要があります。これにより、Amazon S3 でのファイル 管理が簡素化されます。

変換するファイルの名前。ファイルの取得元となる Amazon S3 バケットを判別するため、Elastic Transcoder はジョブに対して指定したパイプラインの [Input Bucket] (入力バケット) フィールドを参照します。

ファイル名にプレフィックスが含まれている場合 (cooking/lasagna.mpg など)、キーにプレフィックスを含めます。指定したバケットにファイルが含まれていない場合、Elastic Transcoder からエラーが返されます。

入力ファイルの復号化に使用される暗号化設定 (存在する場合)。入力ファイルが暗号化されている場合は、Elastic Transcoder によるファイルの復号化で使用されるモードを指定する必要があります。

Elastic Transcoder でファイルの復号化に使用される特定の暗号化モード。

Elastic Transcoder では、以下のオプションがサポートされています。

データ暗号化キーは、メディアファイルの暗号化に使用されます。このキーは base64 でエンコードされますが、base64 でエンコードされる前の時点で、ビット長が、

96(AES-GCM のみ)、128、192、または 256 のいずれかである必要があります。

また、キーはを使用して暗号化する必要があります。 AWS KMS詳細については、「AWS Key Management Service デベロッパーガイド」の「データの暗号化と復号化」を参照してください。

入力ファイルの暗号化に使用するキー。Elastic Transcoder で、キーが転送中に破損していないことを確認するチェックサムとして使用されます。キー MD5 は base64 でエンコードされている必要があり、かつbase64 エンコードの前に正確に 16 バイトである必要があります。

ランダムビットジェネレータによって作成された一連のランダムビット。各暗号化オペレーションに固有であり、入力ファイルの暗号化に使用します。初期化ベクトル は base64 でエンコードされている必要があり、かつbase64 エンコードの前に正確に 16 バイトである必要があります。

詳細については、「初期化ベクトル」を参照してください。

入力ファイルの一部を抜粋して、出力ファイルを作成できます。[Clip Start Time] (クリップのスタート時間) は、クリップを開始する入力ファイル上の位置を示します。形式は、HH:mm:ss.SSS（最大値: 23:59:59.999、SSS は 1000 分の 1 秒部分）または sssss.SSS（最大値: 86399.999）を使用できます。値を指定しない場合、Elastic Transcoder では入力ファイルの先頭がスタート位置と見なされます。

抜粋クリップの再生時間。形式は、HH:mm:ss.SSS（最大値: 23:59:59.999、SSS は 1000 分の 1 秒部分）または sssss.SSS（最大値: 86399.999）を使用できます。値を指定しない場合、Elastic Transcoder では、[Clip Start Time] (クリップのスタート時間) からファイルの終了までのクリップを作成します。

入力ファイルの再生時間よりも長い値を指定した場合、Elastic Transcoder では、[Clip Start Time] (クリップのスタート時間) からファイルの終了までを変換し、警告メッセージを返します。

複数のキャプションが存在する場合の Elastic Transcoder での処理方法を決定するポリシー。

Elastic Transcoder で変換して出力に含めるサイドカーキャプションファイルの名前。

キャプションの言語を示す文字列。次の形式のいずれかで指定します。

ISO 言語コードの詳細については、「ISO 639-1 コードのリスト」を参照してください。

クリップを生成したり、関連するビデオファイルと同時に開始しないキャプションの場合、は Elastic Transcoder TimeOffsetにキャプションを含める前にエンコードするビデオの量を指示します。

は TimeOffset [+-] SS.sss または [+-] HH: MM: ss.ss の形式で指定します。

言語を選択するときにプレーヤーに表示されるキャプションのラベル。ここにはキャプションの言語名を、キャプションを表示する言語で指定することをお勧めします。

この出力に対して使用するプリセット。プリセットによって、変換時に Elastic Transcoder で使用される音声、ビデオ、サムネイルの各設定が決まります。

現在の出力に対して指定したプリセットで、[コンテナ] の値が [ts] (MPEG-TS) または [fmp4] (フラグメント化された MP4) である場合、[Segment Duration] (セグメント再生時間) は各セグメントのターゲット最長再生時間 (秒単位) になります。HLSv3 形式のプレイリストでは、各メディアセグメントは個別の .ts ファイルに保存されます。HLSv4、MPEG-DASH、および Smooth プレイリストでは、出力のメディアセグメントはすべて 1 つのファイルに保存されます。個々のセグメントの長さはそれぞれ異なるとしても、だいだい [Segment Duration] (セグメント再生時間) の長さになります。

有効な値の範囲は 1～60 秒です。動画の再生時間が [Segment Duration] (セグメント再生時間) で割り切ることができない場合、最後のセグメントの再生時間は、次の式の剰余の値になります。

total length/Segment Duration

Elastic Transcoder では、[Output Keys] (出力キー) で指定した各 HLS に対して出力固有のプレイリストを作成します。このジョブのマスタープレイリストに出力を追加するには、Outputs in Master Playlist にその出力を含めます。

Elastic Transcoder では、出力ビデオに関連付けられたすべてのキャプションにこのセグメント化が適用されます。

Elastic Transcoder でトランスコード済みファイルおよびプレイリストに割り当てる名前。Elastic Transcoder によって、Pipeline で指定したパイプラインの[バケット] フィールドによって指定された Amazon S3 バケットに、1 つまたは複数のファイルが保存されます。名前の指定されたファイルがバケットに含まれている場合、出力は失敗します。ただし、同じジョブの別の出力は成功する場合があります。

ファイル名の形式は、コンテナタイプと、セグメントの再生時間が設定されているかどうかによって異なります。コンテナタイプが ts ではない場合や、セグメントの再生時間が指定されていない場合、出力ファイルの名前は [Output Key Prefix] (出力キープレフィックス) と [Output Key] (出力キー) を連結したものになります。

コンテナタイプが ts であり、セグメントの再生時間が指定されている場合、Elastic Transcoder は [Output Key] (出力キー) の値を使用して、出力のプレイリストと .ts ファイルの両方に次のように名前を付けます。

セグメント化された ts 出力がマスタープレイリストに含まれていない場合、Elastic Transcoder はこの出力を HLSv3 として扱います。

出力キープレフィックスによって、ジョブのすべてのファイルが Amazon S3 バケットにまとめられます。ジョブ内の出力ごとにファイルをまとめる場合は、[Output Key] (出力キー) の値にプレフィックスを含めます。次に例を示します。

OutputKeyPrefixアイフォン/キー 00000.ts

OutputKeyPrefixKindleFireHD/キー 00000.ts

出力キーについて入力した値に基づく、最初のセグメントファイルの名前。

Elastic Transcoder でビデオのサムネイルを作成する場合、[はい] を選択し、[Thumbnail Filename Pattern] (サムネイルファイル名パターン) フィールドでファイル名の形式を指定します。

[Thumbnail Filename Pattern] (サムネイルファイル名パターン) で [はい] を選択した場合は、ファイル名の形式を指定します。次の値を任意の順序で指定できます。

[Thumbnail Filename Preview] (サムネイルファイル名パターン) フィールドには、[Thumbnail Filename Pattern] に入力した値に基づいて、サムネイルのファイル名のサンプルが表示されます。

サムネイルを作成すると、Elastic Transcoder では、ファイルが .jpg または .png の形式で自動的に保存され、Preset で指定したプリセットに表示されます。Elastic Transcoder により、該当するファイル名拡張子も追加されます。

右回りの角度の値。Elastic Transcoder で、入力に関連して出力をローテーションさせる角度です。Elastic Transcoder で入力ファイルがローテーションされているかどうかを自動的に検出するには、auto を選択します。ただし、通常 Elastic Transcoder では、変換するファイルにローテーションメタデータが含まれている場合に出力をローテーションさせる必要があるかどうかを検出するだけです。

指定した形式によって、Elastic Transcoder では出力用に埋め込みキャプションを生成するか、サイドカーキャプションを生成するかが決まります。この値を空白にすると、Elastic Transcoder はエラーを返します。

キャプションファイル名のプレフィックス。description-{language} の形式で指定します。

ファイル名パターンに {language} を含めない場合、Elastic Transcoder では、説明で指定した値に「{language}」が自動的に付加されます。Elastic Transcoder ではさらに、セグメントファイルの最後にカウントが自動的に追加されます。

たとえば、srt 形式に変換するとします。"Sydney-{language}-sunrise" と入力し、キャプションの言語が英語 (en) である場合、最初のキャプションファイルの名前は Sydney-en-sunrise00000.srt になります。

[Captions Filename Pattern] (キャプションファイル名パターン) に入力した値に基づく、最初のキャプションファイルの名前。プレビューでは、英語を表す ISO コード "en" を使用して、ファイル名で {language} がどのように表示されるかを示します。

Elastic Transcoder で出力ファイルに適用する暗号化設定 (存在する場合)。暗号化の使用を選択した場合は、使用するモードを指定する必要があります。暗号化を使用しない場合、Elastic Transcoder は Amazon S3 バケットに暗号化されていないファイルを書き込みます。

Elastic Transcoder でファイルの復号化に使用される特定の暗号化モード。Elastic Transcoder では次の暗号化モードオプションがサポートされています:

AES 暗号化モードのいずれかを選択した場合は、次の 3 つの値も指定する必要があります (3 つすべてが base64 でエンコードされている必要があります)。

AES 暗号化モードのいずれかを選択し、Elastic Transcoder で 128 ビットの AES 暗号化キーを生成する場合は、暗号化キー、暗号化キー MD5、暗号化初期化ベクトルのいずれの値も指定しないでください。Elastic Transcoder でキーが生成されたら、ReadJob を呼び出してキーを取得できます。このキーは、CreateJobResponse オブジェクトには含まれません。

Elastic Transcoder でキーが生成される場合は、このフィールドを空白にしておく必要があります。Elastic Transcoder でキーが生成されたら、[Read Job] (ジョブの読み取り) を呼び出してキーを取得できます。このキーは、[Create Job Response] (ジョブレスポンスの作成) オブジェクトには含まれません。

独自のキーの使用を選択した場合は、AWS KMS を使用してキーを暗号化する必要があります。このキーは base64 でエンコードされますが、base64 でエンコードされる前の時点で、ビット長が、

96(AES-GCM のみ)、128、192、または 256 のいずれかである必要があります。

Elastic Transcoder でキーが生成されるように設定した場合、Elastic Transcoder では、Create Job (ジョブの作成) レスポンスのこのフィールドが空白のままになります。生成されたデータ暗号化キーを取得するには、Read Job (ジョブの読み取り) リクエストを送信します。

による鍵の暗号化について詳しくは AWS KMS、『開発者ガイド』の「データの暗号化と復号化」を参照してください。AWS Key Management Service

Elastic Transcoder で出力ファイルの暗号化に使用するキーの MD5 ダイジェスト。Elastic Transcoder で、キーが転送中に破損していないことを確認するチェックサムとして使用されます。キー MD5 は base64 でエンコードされている必要があり、かつbase64 エンコードの前に正確に 16 バイトである必要があります。

Elastic Transcoder でキーが生成される場合は、このフィールドを空白にしておく必要があります。

ランダムビットジェネレータによって作成された一連のランダムビット。各暗号化オペレーションに固有であり、Elastic Transcoder で出力ファイルの暗号化に使用します。初期化ベクトル は base64 でエンコードされている必要があり、かつbase64 エンコードの前に正確に 16 バイトである必要があります。

Elastic Transcoder でキーが生成される場合は、このフィールドを空白にしておく必要があります。

詳細については、「Initialization Vector」(初期化ベクトル) を参照してください。

変換時にビデオにウォーターマークを追加するために Elastic Transcoder で使用される、ウォーターマーク設定の ID。設定は、現在の出力の [Presets] (プリセット) で指定したプリセットに含まれています。そのプリセットでは、[Watermarks Id] の値によって、どの設定を使用するかが Elastic Transcoder に伝えられます。

ウォーターマークに使用する .png ファイルまたは .jpg ファイルの名前。指定したファイルが含まれている Amazon S3 バケットを判別するために、Elastic Transcoder では、[パイプライン] で指定されたパイプラインを調べます。そのパイプラインの Input Bucket (入力バケット) オブジェクトによって、バケットが特定されます。

ファイル名にプレフィックスが含まれている場合（logos/128x64.png など）、キーにプレフィックスを含めます。指定したバケットにファイルが含まれていない場合、Elastic Transcoder からエラーが返されます。

Elastic Transcoder でアルバムアートワークファイルが複数存在する場合の処理方法を決定するポリシー。

アルバムアートとして使用されるファイル。音声ファイルに最大 20 個のアートワークを関連付けることができます。

アルバムアートとして使用されるファイルの名前。指定されたファイルがどの Amazon S3 バケットに含まれているかを判断するために、Elastic Transcoder はで指定されたパイプラインをチェックしますPipelineId。InputBucketそのパイプライン内のオブジェクトがバケットを識別します。

ファイル名にプレフィックスが含まれている場合（cooking/pie.jpg など）、キーにプレフィックスを含めます。ファイルが指定したバケットに含まれていない場合、Elastic Transcoder はエラーを返します。

アルバムアートの形式 (ある場合)。有効な形式は、jpg と png です。

出力アルバムアートの最大幅 (ピクセル単位)。auto を指定すると、Elastic Transcoder ではデフォルト値として 600 が使用されます。数値を指定する場合は、32 以上 4096 以下の偶数を入力します。

出力アルバムアートの最大の高さ (ピクセル単位)。auto を指定すると、Elastic Transcoder ではデフォルト値として 600 が使用されます。数値を指定する場合は、32 以上 3072 以下の偶数を入力します。

出力アルバムアートのスケーリングを制御する値。

以下の表は、SizingPolicy出力アルバムアートに設定が及ぼす可能性のある影響を示しています。

PaddingPolicyに設定するとPad、出力アートの合計サイズがおよびに指定した値と一致するように、Elastic Transcoder が出力アルバムアートの上下または左右に白いバーを追加することがあります。MaxWidthMaxHeight詳細については、「AlbumArt:Art:SizingPolicy」の表を参照してください。

出力ファイルとともに返されるメタデータ key/value ペアのキー。各キーは 1-128 文字の一意の文字列でなければならず、各キーには以下のリストに記載されている文字しか使用できません。

メタデータの整理や、メタデータの追加の 128 文字の保存、[値] に保存されたメタデータのラベリングを行う場合に、キーを番号方式として使用できます。値のメタデータのみを使用する場合は、key1 などのキーにスローアウェイ文字列を入れることができ、Elastic Transcoder からメタデータを取得するときにはそのキーを無視できます。

ジョブとともに返されるメタデータ key/value ペアの値。各値は 0-256 文字の文字列でなければならず、各値には以下のリストに記載されている文字しか使用できません。

Elastic Transcoder でマスタープレイリストに割り当てる名前。名前に / 文字が含まれている場合、名前の最後の / より前の部分はすべてのプレイリスト名で同じである必要があります。複数のマスタープレイリストを作成する場合、各プレイリストには一意の名前を付ける必要があります。

セグメントの再生時間、クリップ、およびキャプションの各設定はいずれも、プレイリストのすべての出力で同じにする必要があります。[Smooth] プレイリストの場合、[Audio:Profile]、[Video:Profile]、および [Maximum Number of Frames Between keyframes] (キーフレーム間の最大フレーム数) に対する [Frame Rate] (フレームレート) の比率をすべての出力で同じにする必要があります。

プレイリストの形式。有効な形式は、[HLSv3]、[HLSv4]、[MPEG-DASH]、[Smooth] です。

マスタープレイリストに含めるこのジョブの各出力に対する、[Output Key] フィールドの値。プレイリストに複数の出力を含める場合、すべての出力に対する [Segment Duration] の値は同じにする必要があります。

HLSv4 マスタープレイリストについては、出力プレイリスト内でリンクする音声入力とビデオ入力の組み合わせが Elastic Transcoder によって選択されます。デフォルトの再生操作として、最初の音声入と動画入力がリンクおよびレンダリングされます。このため、優先するデフォルトの再生操作を選択することができます。マスタープレイリストに含まれるその他の個々のプレイリストについては、最適な再生のための音声とビットレートの組み合わせが Elastic Transcoder によって選択されます。

出力のコンテンツ保護方法。唯一の有効な値:

aes-128.

この値は、出力プレイリストの EXT-X-KEY メタデータタグの method 属性に書き込まれます。

Elastic Transcoder でキーが生成される場合は、このフィールドを空白にしておく必要があります。Elastic Transcoder でキーが生成されたら、ReadJob を呼び出してキーを取得できます。このキーは、CreateJobResponse オブジェクトには含まれません。

独自のキーの使用を選択した場合は、AWS KMS を使用してキーを暗号化する必要があります。このキーは base64 でエンコードされますが、base64 でエンコードされる前の時点で、ビット長が、

96(AES-GCM のみ)、128、192、または 256 のいずれかである必要があります。

Elastic Transcoder でキーが生成されるように設定した場合、Elastic Transcoder では、CreateJob レスポンスのこのフィールドが空白のままになります。生成されたデータ暗号化キーを取得するには、ReadJob リクエストを送信します。

によるキーの暗号化について詳しくは AWS KMS、『開発者ガイド』の「データの暗号化と復号化」を参照してください。AWS Key Management Service

aes-128 の HLS コンテンツ保護方法を選択した場合、キーは 128 ビットでなければなりません。relativeKeyStoragePolicyセットがある場合、Elastic Transcoder は Amazon S3 サーバー側の暗号化を使用して Amazon S3 バケットにキーを書き込みます。

Elastic Transcoder で出力ファイルの暗号化に使用するキーの MD5 ダイジェスト。Elastic Transcoder で、キーが転送中に破損していないことを確認するチェックサムとして使用されます。キー MD5 は base64 でエンコードされている必要があり、かつbase64 エンコードの前に正確に 16 バイトである必要があります。

Elastic Transcoder でキーが生成される場合は、このフィールドを空白にしておく必要があります。

ランダムビットジェネレータによって作成された一連のランダムビット。各暗号化オペレーションに固有であり、Elastic Transcoder で出力ファイルの暗号化に使用します。初期化ベクトル は base64 でエンコードされている必要があり、かつbase64 エンコードの前に正確に 16 バイトである必要があります。

Elastic Transcoder でキーが生成される場合は、このフィールドを空白にしておく必要があります。

詳細については、「初期化ベクトル」を参照してください。

HLS プレイリストの復号化に必要なライセンスキーの場所。この URL は絶対パスでなければならず、プレイリストファイルの EXT-X-キー メタデータタグの URI 属性で参照されます。例:

https://www.example.com/exampleKey/

Elastic Transcoder で HLS ライセンスキーが Amazon S3 バケットに書き込まれるようにするかどうかを指定します。[WithVariantPlaylists] を選択すると、Elastic Transcoder により、関連付けられたプレイリストと同じ Amazon S3 バケットに暗号化されたキーが書き込まれます。

ファイルを視聴できるユーザーを制限するために使用する DRM 設定。これは、出力プレイリストに PlayReady DRM ヘッダーを含めることで実現されます。アートワーク、キャプション、サムネイル、ウォーターマークには使用できません。 PlayReady DRM は暗号化を使用してメディアファイルを暗号化します。aes-ctr

HLSv3 プレイリストに DRM を使用する場合、出力にはマスタープレイリストが必要です。

詳細については、「デジタル著作権管理」を参照してください。

出力プレイリストの DRM 形式。有効な形式は、discretix-3.0 と microsoft です。

Smooth タイプのプレイリストの場合は、microsoft を指定します。HLSv3 タイプのプレイリストの場合は、discretix-3.0 を指定します。

DRM ライセンスプロバイダからそのファイル用として提供される DRM キー。このキーは base64 でエンコードされますが、base64 でエンコードされる前の時点で、ビット長が、

128、192、256

キーはを使用して暗号化する必要もあります。 AWS KMS詳細については、「AWS Key Management Service デベロッパーガイド」の「データの暗号化と復号化」を参照してください。

DRM キーの ID。提供すべきキーを DRM ライセンスプロバイダが認識できるようにするものです。

キー ID はビッグエンディアンで指定する必要があります。Elastic Transcoder は DRM ヘッダーに挿入する前にリトルエンディアンに変換します。 PlayReady キー ID がライセンスサーバーからビッグエンディアンとリトルエンディアンのどちらで提供されているのか分からない場合は、DRM プロバイダに確認してください。

ファイルの DRM に使用するキーの MD5 ダイジェスト。Elastic Transcoder で、キーが転送中に破損していないことを確認するチェックサムとして使用されます。キー MD5 は base64 でエンコードされている必要があり、かつbase64 エンコードの前に正確に 16 バイトである必要があります。

ランダムビットジェネレータによって作成された一連のランダムビット。各暗号化オペレーションに固有であり、Elastic Transcoder でファイルの暗号化に使用します。初期化ベクトル は base64 でエンコードされている必要があり、かつbase64 エンコードの前に正確に 8 バイト長である必要があります。初期化ベクトルが提供されていない場合は、Elastic Transcoder により生成されます。

詳細については、「Initialization Vector」(初期化ベクトル) を参照してください。

DRM コンテンツの再生に必要なライセンスキーの場所。URL は絶対パスでなければならず、ヘッダーによって参照されます。 PlayReady PlayReady このヘッダーは、スムーズストリーミング出力の場合はクライアントマニフェストの保護ヘッダーで、HLS プレイリスト出力の場合は EXT-X-DXDRM および EXT-XDXDRMINFO メタデータタグで参照されます。URL の例はこのようになります:

https://www.example.com/exampleKey/