タイムラインは、トラック上に素材を配置し、効果を適用してビデオを制作するものです。サンプルタイムラインの詳細については、「ユースケース」をご参照ください。
パラメーター | タイプ | 必須 | 説明 |
VideoTracks | いいえ (ビデオトラックが存在しない場合は、オーディオトラックが必須です。) | ビデオトラックです。ビデオトラックは、`MediaId` 配列要素のシーケンスに基づいて重ね合わせられます。たとえば、最初の `MediaId` 配列要素に対応するトラックは、2 番目の `MediaId` 配列要素に対応するトラックの下に配置されます。 | |
AudioTracks | いいえ (オーディオトラックが存在しない場合は、ビデオトラックが必須です。) | オーディオトラックです。 | |
ImageTracks (イメージトラック機能はビデオトラック機能に統合されたため、イテレーションやメンテナンスは行われなくなりました。) | いいえ (イメージトラックが存在する場合は、ビデオトラックが必須です。) | イメージトラックです。注意事項: 1. イメージトラックはビデオトラックの上に配置する必要があります。画像と動画の制作シナリオで、画像を素材として動画と合成する場合は、ビデオトラックを使用してください。 2. イメージトラックは、`MediaId` 配列要素のシーケンスに基づいて重ね合わせられます。たとえば、最初の `MediaId` 配列要素に対応するトラックは、2 番目の `MediaId` 配列要素に対応するトラックの下に配置されます。 | |
SubtitleTracks | いいえ | 字幕トラックです。 | |
EffectTracks | いいえ | エフェクトトラックです。 |
VideoTrack
動画素材と画像素材を配置します。
パラメーター | タイプ | 必須 | 説明 |
Type | String | いいえ | ビデオトラックのタイプです。デフォルトでは、通常のビデオトラックが使用されます。 `Type` を `Effect` に設定すると、ビデオトラックをエフェクトに使用できます。この場合、`VideoTrackClips` で EffectTrackItem オブジェクトを指定できます。 |
MainTrack | Boolean | いいえ | 現在のビデオトラックがメイントラックであるかどうかを指定します。デフォルト値:False。詳細については、「メイントラックの設定」をご参照ください。 |
TrackShortenMode | String | いいえ | 現在のビデオトラックの長さがメイントラックの長さより長い場合、現在のトラックの長さは、メイントラックの長さに合わせて適応的に短縮されます。このパラメーターは、トラックを短縮するモードを指定します。有効値:
|
TrackExpandMode | String | いいえ | 現在のビデオトラックの長さがメイントラックの長さより短い場合、現在のトラックの長さは、メイントラックの長さに合わせて適応的に延長されます。このパラメーターは、トラックを延長するモードを指定します。有効値:
|
VideoTrackClips | はい | ビデオトラック内の素材です。 |
AudioTrack
音声のみの素材と、オーディオストリームを含む動画素材を配置します。
パラメーター | タイプ | 必須 | 説明 |
MainTrack | Boolean | いいえ | 現在のオーディオトラックがメイントラックであるかどうかを指定します。デフォルト値:False。詳細については、「メイントラックの設定」をご参照ください。 |
TrackShortenMode | String | いいえ | 現在のオーディオトラックの長さがメイントラックの長さより長い場合、現在のトラックの長さは、メイントラックの長さに合わせて適応的に短縮されます。このパラメーターは、トラックを短縮するモードを指定します。有効値:
|
TrackExpandMode | String | いいえ | 現在のオーディオトラックの長さがメイントラックの長さより短い場合、現在のトラックの長さは、メイントラックの長さに合わせて適応的に延長されます。このパラメーターは、トラックを延長するモードを指定します。有効値:
|
AudioTrackClips | はい | オーディオトラック内の素材です。 |
ImageTrack
イメージトラック機能はビデオトラック機能に統合されたため、イテレーションやメンテナンスは行われなくなりました。
画像素材を配置します。
パラメーター | タイプ | 必須 | 説明 |
ImageTrackClips (イメージトラック機能はビデオトラック機能に統合されたため、イテレーションやメンテナンスは行われなくなりました。) | はい | イメージトラック内の素材です。 |
SubtitleTrack
バナーテキストや外部字幕などの字幕を配置します。
パラメーター | タイプ | 必須 | 説明 |
SubtitleTrackClips | はい | 字幕トラック内の素材です。 |
EffectTrack
ビデオにフィルターや視覚効果を追加します。
パラメーター | タイプ | 必須 | 説明 |
EffectTrackItems | はい | エフェクトトラックに追加されるフィルターとエフェクトです。 |
VideoTrackClip
ビデオトラックに動画または画像素材を追加できます。
`In`、`Out`、`TimelineIn`、`TimelineOut` パラメーターを使用して、素材をカットしてタイムラインに追加する位置を指定できます。たとえば、`In` を 5、`Out` を 10、`TimelineIn` を 15、`TimelineOut` を 20 に設定すると、素材の 5 秒目から 10 秒目がカットされ、タイムラインの 15 秒目から 20 秒目に再生されます。
パラメーター | タイプ | 必須 | 説明 |
MediaId | String | いいえ | ビデオトラック内の素材が対応する Intelligent Media Services (IMS) または ApsaraVideo VOD メディアアセットの ID です。 注意:`MediaId` と `MediaURL` のいずれか一方のみを指定する必要があります。 |
MediaURL | String | いいえ | ビデオトラック内の素材の Object Storage Service (OSS) URL です。OSS URL の形式は次のとおりです: https://your-bucket.oss-cn-shanghai.aliyuncs.com/your-object.mp4 注意事項:
詳細については、「画像とビデオの編集」をご参照ください。 |
Type | String | いいえ | 素材のタイプです。デフォルト値:Video。 有効値:
|
X | Float | いいえ | 素材の左上隅と出力ビデオの左上隅との間の水平距離です。値はパーセンテージまたはピクセル数で設定できます。値の範囲が 0 から 0.9999 の場合、値はパーセンテージを示します。値が 2 以上の整数の場合、値はピクセル数を示します。 |
Y | Float | いいえ | 素材の左上隅と出力ビデオの左上隅との間の垂直距離です。値はパーセンテージまたはピクセル数で設定できます。値の範囲が 0 から 0.9999 の場合、値はパーセンテージを示します。値が 2 以上の整数の場合、値はピクセル数を示します。 |
Width | Float | いいえ | 出力ビデオ内の素材の幅です。値はパーセンテージまたはピクセル数で設定できます。値の範囲が 0 から 0.9999 の場合、値はパーセンテージを示します。値が 2 以上の整数の場合、値はピクセル数を示します。 |
Height | Float | いいえ | 出力ビデオ内の素材の高さです。値はパーセンテージまたはピクセル数で設定できます。値の範囲が 0 から 0.9999 の場合、値はパーセンテージを示します。値が 2 以上の整数の場合、値はピクセル数を示します。 |
AdaptMode | String | いいえ | 素材が自動的にサイズ変更されるモードです。このパラメーターは、ビューの幅と高さを指定した場合にのみ有効になります。素材は、ビューの幅と高さに基づいてスケーリングされます。有効値:
|
In | Float | いいえ | ソースファイル内の素材の開始時間です。ソースファイルは、オーディオまたはビデオファイルである必要があります。単位:秒。値は小数点以下 4 桁まで正確です。`In` を指定しない場合、0 が使用されます。 |
Out | Float | いいえ | ソースファイル内の素材の終了時間です。ソースファイルは、オーディオまたはビデオファイルである必要があります。単位:秒。値は小数点以下 4 桁まで正確です。`Out` を指定しない場合、素材はソースファイルの終了時に終了します。 |
MaxOut | Float | いいえ | 素材の最大終了時間です。このパラメーターを指定すると、素材の終了時間は、ソースファイルの長さと `MaxOut` の値の小さい方になります。このパラメーターは、ソースファイルがオーディオまたはビデオファイルの場合にのみ有効です。単位:秒。値は小数点以下 4 桁まで正確です。`Out` を指定すると、`MaxOut` は無効になります。詳細については、「複数のビデオセグメントのトリミングとマージ」をご参照ください。 |
Duration | Float | いいえ | 素材の長さです。ほとんどの場合、このパラメーターは画像に使用されます。単位:秒。値は小数点以下 4 桁まで正確です。 |
DyncFrames | Int | いいえ | アニメーションスタンプのフレーム数です。このパラメーターは、ソースファイルがアニメーション画像の場合にのみ有効です。詳細については、「GIF スタンプの追加」をご参照ください。 |
TimelineIn | Float | いいえ | タイムライン内の素材の開始時間です。単位:秒。値は小数点以下 4 桁まで正確です。`TimelineIn` を指定しない場合、素材はタイムライン内の前の素材の再生が終了したときに再生を開始します。 |
TimelineOut | Float | いいえ | タイムライン内の素材の終了時間です。単位:秒。値は小数点以下 4 桁まで正確です。`TimelineOut` を指定しない場合、素材はタイムライン内の次の素材の再生が開始したときに再生を停止します。 |
Speed | Float | いいえ | 素材の再生速度です。有効値:0.1 から 100。たとえば、このパラメーターを 2 に設定すると、素材は出力ビデオで元の速度の 2 倍で再生されます。この場合、素材の長さは半分に短縮されます。 詳細については、「オーディオとビデオの速度変更」をご参照ください。 |
Opacity | Float | いいえ | ビデオの不透明度です。有効値:0 から 1。値 0 はビデオが完全に透明であることを示します。値 1 はビデオが完全に不透明であることを示します。 |
MaskVideoUrl | String | いいえ | マスクファイルの URL です。ほとんどの場合、マスクファイルはアルファチャンネルを含むビデオです。アルファチャンネルを使用して、元のビデオに透明度情報を追加できます。
|
ClipId | String | いいえ | トラックアライメント値です。他のオーディオまたはビデオトラックの素材に同じ `ReferenceClipId` の値が設定されている場合、他のトラックの素材のタイムライン上の開始時間と終了時間は、現在の素材の開始時間と終了時間に揃えられます。 詳細については、「素材と素材の長さの自動アライメント」をご参照ください。 |
ReferenceClipId | String | いいえ | トラックアライメント値です。他のオーディオまたはビデオトラックの素材に同じ `ClipId` の値が設定されている場合、現在の素材のタイムライン上の開始時間と終了時間は、他のトラックの素材の開始時間と終了時間に揃えられます。 詳細については、「https://icms.alibaba-inc.com/content/ice/ims?l=1&m=65087&n=4406040」をご参照ください。 |
Effects | Effect[] | いいえ | 素材に使用されるエフェクトです。 |
デジタルヒューマンビデオ
`VideoTrackClip` で `Type` を `AI_Avatar` に設定すると、編集用のデジタルヒューマンビデオを直接生成できます。詳細については、「インテリジェントタイムラインタスクの並列処理」をご参照ください。
この機能は、中国 (北京)、中国 (上海)、および中国 (杭州) リージョンでのみ利用可能です。
パラメーター | タイプ | 必須 | 説明 | 備考 |
Type | String | はい | 素材のタイプです。 |
|
MediaId | String | いいえ | デジタルヒューマンをレンダリングするために使用されるオーディオの ID です。 |
|
MediaURL | String | いいえ | デジタルヒューマンをレンダリングするために使用されるオーディオファイルの URL です。 |
|
Content | String | いいえ | デジタルヒューマンをレンダリングするために使用されるテキストコンテンツです。 |
|
AvatarId | String | いいえ | デジタルヒューマン画像の ID です。 |
|
Voice | String | いいえ | 音声のタイプです。 |
|
CustomizedVoice | String | いいえ | パーソナライズされた人間の声です。 |
|
LoopMotion | Boolean | いいえ | ビデオの最初と最後のフレームが同じであるかどうかを指定します。 |
|
SpeechRate | Integer | いいえ | 話速です。 |
説明 次の例は、話速の計算方法を示しています:
速度が 1x 未満の場合は、係数 0.002 を使用します。 速度が 1x より大きい場合は、係数 0.001 を使用します。 実際の計算結果は、最も近い整数に丸められます。 |
PitchRate | Integer | いいえ | イントネーションです。 |
|
デジタルヒューマンビデオの他のタイムラインパラメーターは、`VideoTrackClip` のタイムラインパラメーターと同じです。詳細については、このトピックの「VideoTrackClip」セクションをご参照ください。
AudioTrackClip
オーディオトラックには、音声のみの素材、オーディオストリームを含む動画素材、テキストから変換されたオーディオ素材を追加できます。
`In`、`Out`、`TimelineIn`、`TimelineOut` パラメーターを使用して、素材をカットしてタイムラインに追加する位置を指定できます。たとえば、`In` を 5、`Out` を 10、`TimelineIn` を 15、`TimelineOut` を 20 に設定すると、素材の 5 秒目から 10 秒目がカットされ、タイムラインの 15 秒目から 20 秒目に再生されます。
同じオーディオトラック内のオーディオ素材の再生時間は、タイムライン上で重複できません。重複した場合、オーディオエラーが発生する可能性があります。
音声のみの素材またはオーディオストリームを含む動画素材
パラメーター | タイプ | 必須 | 説明 |
MediaId | String | いいえ | オーディオトラック内の素材が対応する IMS または ApsaraVideo VOD メディアアセットの ID です。 注意:`MediaId` と `MediaURL` のいずれか一方のみを指定する必要があります。 |
MediaURL | String | いいえ | オーディオトラック内の素材の OSS URL です。OSS URL の形式は次のとおりです: https://your-bucket.oss-cn-shanghai.aliyuncs.com/your-object.mp4 注意事項:
詳細については、「画像とビデオの編集」をご参照ください。 |
In | Float | いいえ | ソースファイル内の素材の開始時間です。単位:秒。値は小数点以下 4 桁まで正確です。`In` を指定しない場合、0 が使用されます。 |
Out | Float | いいえ | ソースファイル内の素材の終了時間です。単位:秒。値は小数点以下 4 桁まで正確です。`Out` を指定しない場合、素材はソースファイルの終了時に終了します。 |
TimelineIn | Float | いいえ | タイムライン内の素材の開始時間です。単位:秒。値は小数点以下 4 桁まで正確です。`TimelineIn` を指定しない場合、素材はタイムライン内の前の素材の再生が終了したときに再生を開始します。 |
TimelineOut | Float | いいえ | タイムライン内の素材の終了時間です。単位:秒。値は小数点以下 4 桁まで正確です。`TimelineOut` を指定しない場合、素材はタイムライン内の次の素材の再生が開始したときに再生を停止します。 |
Speed | Float | いいえ | 素材の再生速度です。有効値:0.1 から 100。たとえば、このパラメーターを 2 に設定すると、素材は出力オーディオで元の速度の 2 倍で再生されます。この場合、素材の長さは半分に短縮されます。 詳細については、「オーディオとビデオの速度変更」をご参照ください。 |
Effects | Effect[] | いいえ | 素材に使用されるエフェクトです。 |
LoopMode | Boolean | いいえ | タイムライン内の素材のループ再生を有効にするかどうかを指定します。True:ループ再生を有効にします。False (デフォルト):ループ再生を無効にします。 詳細については、「オーディオループ再生の設定」をご参照ください。 |
ClipId | String | いいえ | トラックアライメント値です。他のオーディオまたはビデオトラックの素材に同じ `ReferenceClipId` の値が設定されている場合、他のトラックの素材のタイムライン上の開始時間と終了時間は、現在の素材の開始時間と終了時間に揃えられます。 詳細については、「素材と素材の長さの自動アライメント」をご参照ください。 |
ReferenceClipId | String | いいえ | トラックアライメント値です。他のオーディオまたはビデオトラックの素材に同じ `ClipId` の値が設定されている場合、現在の素材のタイムライン上の開始時間と終了時間は、他のトラックの素材の開始時間と終了時間に揃えられます。 詳細については、「素材と素材の長さの自動アライメント」をご参照ください。 |
テキストから変換されたオーディオ素材
タイムラインのサンプルに関する詳細については、「テキストをオーディオに変換してビデオに追加」をご参照ください。この機能は、中国 (北京)、中国 (上海)、および中国 (杭州) リージョンでのみ利用可能です。
パラメーター | タイプ | 必須 | 説明 |
Type | String | はい | 素材のタイプです。値を `AI_TTS` に設定します。 |
Content | String | はい | テキストコンテンツです。 |
Voice | String | いいえ | 音声のタイプです。詳細については、「インテリジェント音声デモ」をご参照ください。 |
CustomizedVoice | String | いいえ |
|
Format | String | いいえ | ファイルの形式です。有効値:pcm、wav、mp3。デフォルト値:mp3。
|
SpeechRate | Int | いいえ | 話速です。有効値:-500 から 500。デフォルト値:0。
説明 次の例は、話速の計算方法を示しています:
速度が 1x 未満の場合は、係数 0.002 を使用します。 速度が 1x より大きい場合は、係数 0.001 を使用します。 実際の計算結果は、最も近い整数に丸められます。 |
PitchRate | Int | いいえ | イントネーションです。有効値:-500 から 500。デフォルト値:0。 |
TimelineIn | Float | いいえ | タイムライン内の素材の開始時間です。単位:秒。値は小数点以下 4 桁まで正確です。`TimelineIn` を指定しない場合、素材はタイムライン内の前の素材の再生が終了したときに再生を開始します。 |
TimelineOut | Float | いいえ | タイムライン内の素材の終了時間です。単位:秒。値は小数点以下 4 桁まで正確です。`TimelineOut` を指定しない場合、素材はタイムライン内の次の素材の再生が開始したときに再生を停止します。 |
Effects | Effect[] | いいえ | 素材に使用されるエフェクトです。 |
ClipId | String | いいえ | トラックアライメント値です。他のオーディオまたはビデオトラックの素材に同じ `ReferenceClipId` の値が設定されている場合、他のトラックの素材のタイムライン上の開始時間と終了時間は、現在の素材の開始時間と終了時間に揃えられます。 詳細については、「素材と素材の長さの自動アライメント」をご参照ください。 |
ReferenceClipId | String | いいえ | トラックアライメント値です。他のオーディオまたはビデオトラックの素材に同じ `ClipId` の値が設定されている場合、現在の素材のタイムライン上の開始時間と終了時間は、他のトラックの素材の開始時間と終了時間に揃えられます。 詳細については、「素材と素材の長さの自動アライメント」をご参照ください。 |
ImageTrackClip
イメージトラック機能はビデオトラック機能に統合されたため、イテレーションやメンテナンスは行われなくなりました。
イメージトラックに画像素材を追加できます。
パラメーター | タイプ | 必須 | 説明 |
MediaId | String | いいえ | イメージトラック内の素材が対応する IMS または ApsaraVideo VOD メディアアセットの ID です。 注意:`MediaId` と `MediaURL` のいずれか一方のみを指定する必要があります。 |
MediaURL | String | いいえ | イメージトラック内の素材の OSS URL です。OSS URL の形式は https://your-bucket.oss-cn-shanghai.aliyuncs.com/your-object.mp4 です。 注意事項:
詳細については、「オーディオとビデオの速度変更」をご参照ください。 |
X | Float | いいえ | 素材の左上隅と出力ビデオの左上隅との間の水平距離です。値はパーセンテージまたはピクセル数で設定できます。値の範囲が 0 から 0.9999 の場合、値はパーセンテージを示します。値が 2 以上の整数の場合、値はピクセル数を示します。 |
Y | Float | いいえ | 素材の左上隅と出力ビデオの左上隅との間の垂直距離です。値はパーセンテージまたはピクセル数で設定できます。値の範囲が 0 から 0.9999 の場合、値はパーセンテージを示します。値が 2 以上の整数の場合、値はピクセル数を示します。 |
Width | Float | いいえ | 出力ビデオ内の素材の幅です。値はパーセンテージまたはピクセル数で設定できます。値の範囲が 0 から 0.9999 の場合、値はパーセンテージを示します。値が 2 以上の整数の場合、値はピクセル数を示します。 |
Height | Float | いいえ | 出力ビデオ内の素材の高さです。値はパーセンテージまたはピクセル数で設定できます。値の範囲が 0 から 0.9999 の場合、値はパーセンテージを示します。値が 2 以上の整数の場合、値はピクセル数を示します。 |
TimelineIn | Float | いいえ | タイムライン内の画像の開始時間です。単位:秒。値は小数点以下 4 桁まで正確です。`TimelineIn` を指定しない場合、0 が使用されます。 |
TimelineOut | Float | いいえ | タイムライン内の画像の終了時間です。単位:秒。値は小数点以下 4 桁まで正確です。`TimelineOut` を指定しない場合、ビデオトラックの最大長が使用されます。 |
DyncFrames | Int | いいえ | アニメーションスタンプのフレーム数です。ソースファイルがアニメーション画像の場合、このパラメーターは必須です。詳細については、「ウォーターマーク、スタンプ、または GIF スタンプの追加」をご参照ください。 |
Effects | Effect[] | いいえ | 素材に使用されるエフェクトです。 |
SubtitleTrackClip
字幕トラックに字幕素材を追加できます。
同じ字幕トラック内の字幕素材の再生時間は、タイムライン上で重複できません。重複した場合、字幕エラーなどの問題が発生する可能性があります。
パラメーター | タイプ | 必須 | 説明 |
Type | String | はい | 字幕素材のタイプです。有効値:
|
SubType | String | いいえ | 字幕素材のサブタイプです。有効値:
`Type` を `Text` に設定した場合は、このパラメーターを無視してください。 |
FileURL | String | いいえ | 字幕ファイルの OSS URL です。`Type` を `Subtitle` に設定した場合、このパラメーターは必須です。OSS URL の形式は次のとおりです: https://your-bucket.oss-cn-shanghai.aliyuncs.com/your-object.srt 注意事項:
詳細については、「字幕と字幕テンプレート」をご参照ください。 |
X | Float | いいえ | バナーテキストの左上隅と出力ビデオの左上隅との間の水平距離です。このパラメーターは、`Type` を `Text` に設定した場合に有効になります。値はパーセンテージまたはピクセル数で設定できます。値の範囲が 0 から 0.9999 の場合、値はパーセンテージを示します。値が 2 以上の整数の場合、値はピクセル数を示します。 |
Y | Float | いいえ | バナーテキストの左上隅と出力ビデオの左上隅との間の垂直距離です。このパラメーターは、`Type` を `Text` に設定した場合に有効になります。値はパーセンテージまたはピクセル数で設定できます。値の範囲が 0 から 0.9999 の場合、値はパーセンテージを示します。値が 2 以上の整数の場合、値はピクセル数を示します。 |
TimelineIn | Float | いいえ | タイムライン内のバナーテキストの開始時間です。このパラメーターは、`Type` を `Text` に設定した場合に有効になります。単位:秒。値は小数点以下 4 桁まで正確です。`TimelineIn` を指定しない場合、素材はタイムライン内の前の素材の表示が終了したときに表示を開始します。 |
TimelineOut | Float | いいえ | タイムライン内のバナーテキストの終了時間です。このパラメーターは、`Type` を `Text` に設定した場合に有効になります。単位:秒。値は小数点以下 4 桁まで正確です。`TimelineOut` を指定しない場合、素材はタイムライン内の次の素材の表示が開始したときに表示を停止します。 |
ClipId | Float | いいえ | このパラメーターはトラックの配置に使用されます。別のトラックの素材の `ReferenceClipId` が同じ値に設定されている場合、その素材の開始時間と終了時間は現在のクリップに揃えられます。 このパラメーターを指定する場合は、現在のクリップに `TimelineIn` と `TimelineOut` を指定するか、適応的なスクロール時間を有効にする必要があります。 |
ReferenceClipId | String | いいえ | このパラメーターはトラックの配置に使用されます。別のトラックの素材の `ClipId` が同じ値に設定されている場合、現在のクリップの開始時間と終了時間はその素材に揃えられます。 |
Content | String | いいえ | バナーテキストです。`Type` を `Text` に設定した場合、このパラメーターは必須です。 |
Font | String | いいえ | バナーテキストのフォントです。このパラメーターは、`Type` を `Text` に設定した場合に有効になります。デフォルト値:SimSun。サポートされているフォントの詳細については、「フォントリスト」をご参照ください。 |
FontSize | Int | いいえ | バナーテキストのフォントサイズです。このパラメーターは、`Type` を `Text` に設定した場合に有効になります。デフォルト値:0。最大値:5000。 |
SizeRequestType | String | いいえ | バナーテキストのレンダリングされたフォントのサイズの計算方法です。このパラメーターは、`Type` を `Text` に設定した場合に有効になります。デフォルト値:RealDim。
|
FontColor | String | いいえ | バナーテキストの色です。このパラメーターは、`Type` を `Text` に設定した場合に有効になります。値は、シャープ記号 (#) と 16 進数値の形式です。例:#ffffff。 |
FontColorOpacity | Float | いいえ | バナーテキストの不透明度です。このパラメーターは、`Type` を `Text` に設定した場合に有効になります。有効値:0 から 1。デフォルト値:1。値 1 はテキストが完全に不透明であることを示します。値 0 はテキストが完全に透明であることを示します。 |
FontFace | いいえ | バナーテキストの外観です。このパラメーターは、`Type` を `Text` に設定した場合に有効になります。 | |
Spacing | Int | いいえ | バナーテキストの単語間隔です。このパラメーターは、`Type` を `Text` に設定した場合に有効になります。単位:ピクセル。デフォルト値:0。 |
LineSpacing | Int | いいえ | バナーテキストの行間です。このパラメーターは、`Type` を `Text` に設定した場合に有効になります。単位:ピクセル。デフォルト値:0。 |
Angle | Float | いいえ | バナーテキストの反時計回りの回転角度です。このパラメーターは、`Type` を `Text` に設定した場合に有効になります。単位:度。デフォルト値:0。 |
BorderStyle | Int | いいえ | バナーテキストの境界線スタイルです。有効値:1 および 3。値 1 はテキストに境界線と影があることを示します。値 3 はテキストに背景があることを示します。デフォルト値:1。 |
Outline | Int | いいえ | バナーテキストの輪郭の幅です。このパラメーターは、`Type` を `Text` に設定した場合に有効になります。単位:ピクセル。デフォルト値:0。 |
OutlineColour | String | いいえ | バナーテキストの輪郭の色です。このパラメーターは、`Type` を `Text` に設定した場合に有効になります。値は、シャープ記号 (#) と 16 進数値の形式です。例:#ffffff。 |
Shadow | Int | いいえ | バナーテキストの影のサイズです。このパラメーターは、`Type` を `Text` に設定した場合に有効になります。単位:ピクセル。デフォルト値:0。 |
BackColour | String | いいえ | バナーテキストの影の色です。このパラメーターは、`Type` を `Text` に設定した場合に有効になります。値は、シャープ記号 (#) と 16 進数値の形式です。例:#ffffff。 |
Alignment | String | いいえ | テキスト配置モードです。このパラメーターは、`Type` を `Text` に設定した場合に有効になります。デフォルト値:TopLeft。有効値:
異なる配置モードで字幕の正確な位置を指定したい場合は、次のようにテキスト配置を設定することを推奨します:
|
AdaptMode | String | いいえ | バナーテキストがビデオ幅または指定されたテキストボックス幅を超えた場合に、自動改行または自動スケーリングを有効にするかどうかを指定します。有効値:
|
TextWidth | Float | いいえ | テキストボックスの幅です。このパラメーターは `AdaptMode` を指定した場合に有効になります。このパラメーターは、自動改行または自動スケーリングを有効にする場合に使用されます。このパラメーターを指定しない場合、自動改行または自動スケーリングにはビデオ幅が使用されます。値が 0 より大きく 1 以下の場合、値は出力ビデオの幅に対するテキストボックスの幅のパーセンテージを示します。値が 1 より大きい場合、値はピクセル数を示します。 |
FontUrl | String | いいえ | フォントファイルの OSS URL です。このパラメーターは、`Type` を `Text` に設定した場合に有効になります。サポートされているフォントファイルの形式は、TTF、OTF、WOFF です。例:https://your-bucket.oss-cn-shanghai.aliyuncs.com/example-font.ttf。 |
EffectColorStyle | String | いいえ | バナーテキストのワードアート効果です。このパラメーターは、`Type` を `Text` に設定した場合に有効になります。ワードアート効果の詳細については、「ワードアート」をご参照ください。 |
SubtitleEffects | いいえ | バナーテキストの多層エフェクトです。このパラメーターは、`Type` を `Text` に設定した場合に有効になります。多層輪郭、多層の影、ガウスぼかし、字幕背景エフェクトを設定できます。ガウスぼかしは、字幕テキストに影が設定されている場合にのみサポートされます。 注意事項:
| |
EnableLocalStyleAutoScale | Boolean | いいえ | 字幕のローカルスタイルを設定する際に、ローカルスタイルのフォントサイズ、ストロークサイズ、影のサイズを出力ビデオサイズと FECanvas サイズに合わせてスケーリングするかどうか。デフォルト値は False で、ローカルスタイルはスケーリングされません。 |
SupportBidi | Boolean | いいえ | 双方向テキストレンダリングを有効にするかどうか。字幕テキストに左から右へのテキスト (LTR、英語、数字、ラテン文字など) と右から左へのテキスト (RTL) の両方が含まれている場合に有効にすることを推奨します。デフォルトでは無効です。 |
ScrollStartY | Float | いいえ | 字幕を上下にスクロールする開始点の y 座標値です。このパラメーターは、字幕スクロール効果が設定されている場合に有効になります。単位:ピクセル。値が 1 未満の場合は、出力ビデオの高さに対する相対的な尺度を表します。 |
ScrollEndY | Float | いいえ | 字幕を上下にスクロールする終了点の y 座標値です。このパラメーターは、字幕スクロール効果が設定されている場合に有効になります。単位:ピクセル。値が 1 未満の場合は、出力ビデオの高さに対する相対的な尺度を表します。 |
ScrollSpeed | Float | いいえ | 字幕が上下にスクロールする速度です。このパラメーターは、字幕スクロール効果が設定されている場合に有効になります。単位:ピクセル/秒。 |
ScrollStartShift | Float | いいえ | 開始点に対する垂直スクロール位置のオフセットです。単位:ピクセル。値が 1 未満の場合は、出力ビデオの高さに対する相対的な尺度を表します。 |
ScrollEndShift | Float | いいえ | 終了点に対する垂直スクロール位置のオフセットです。単位:ピクセル。値が 1 未満の場合は、出力ビデオの高さに対する相対的な尺度を表します。 |
ScrollStartFreeze | Float | いいえ | 垂直スクロールの開始点での一時停止時間です。単位:秒。 |
ScrollEndFreeze | Float | いいえ | 垂直スクロールの終了点での一時停止時間です。単位:秒。 |
ScrollDirection | String | いいえ | 水平スクロールの方向です。有効値:
|
ScrollStartX | Float | いいえ | 水平スクロールの開始点の x 座標値です。単位:ピクセル。値が 1 未満の場合は、出力ビデオの高さに対する相対的な尺度を表します。 |
ScrollEndX | Float | いいえ | 水平スクロールの終了点の x 座標値です。単位:ピクセル。値が 1 未満の場合は、出力ビデオの高さに対する相対的な尺度を表します。 |
ScrollLoop | Boolean | いいえ | 水平スクロール効果をループさせるかどうかを指定します。 |
AaiMotionInEffect | String | いいえ | バナーテキストの開始エフェクトです。このパラメーターは、`Type` を `Text` に設定した場合に有効になります。字幕の開始エフェクトの詳細については、「字幕エフェクトの例」をご参照ください。 |
AaiMotionIn | Float | いいえ | バナーテキストの開始エフェクトの長さです。このパラメーターは、`Type` を `Text` に設定した場合に有効になります。単位:秒。値は小数点以下 4 桁まで正確です。`AaiMotionIn` を指定しない場合、デフォルトの長さ 0.5 秒が使用されます。テキストの表示時間が 0.5 秒未満の場合、開始エフェクトの長さはテキストの全長から終了エフェクトの長さを引いたものになります。 |
AaiMotionOutEffect | String | いいえ | バナーテキストの終了エフェクトです。このパラメーターは、`Type` を `Text` に設定した場合に有効になります。字幕の終了エフェクトの詳細については、「字幕エフェクトの例」をご参照ください。 |
AaiMotionOut | Float | いいえ | バナーテキストの終了エフェクトの長さです。このパラメーターは、`Type` を `Text` に設定した場合に有効になります。単位:秒。値は小数点以下 4 桁まで正確です。`AaiMotionOut` を指定しない場合、デフォルトの長さ 0.5 秒が使用されます。テキストの表示時間が 0.5 秒未満の場合、終了エフェクトの長さはテキストの全長になります。 |
AaiMotionLoopEffect | String | いいえ | バナーテキストのループエフェクトです。このパラメーターは、`Type` を `Text` に設定した場合に有効になります。ループエフェクトは、開始エフェクトまたは終了エフェクトと同時に有効にすることはできません。テキストのループエフェクトの詳細については、「字幕エフェクトの例」をご参照ください。 |
Ratio | Float | いいえ | バナーテキストのループエフェクトの速度です。このパラメーターは、`Type` を `Text` に設定した場合に有効になります。値は小数点以下 4 桁まで正確です。このパラメーターを指定しない場合、1 が使用されます。1 より大きい値は速度が速いことを示し、1 未満の値は速度が遅いことを示します。 |
TextureURL | String | いいえ | バナーテキストのテクスチャの URL です。このパラメーターは、`Type` を `Text` に設定した場合に有効になります。PNG、JPG、JPEG、または BMP 形式の OSS オブジェクトのみがサポートされています。例:https://your-bucket.oss-cn-shanghai.aliyuncs.com/your-image.png。 |
BubbleStyleId | String | いいえ | バナーテキストのバブルエフェクト ID です。このパラメーターは、`Type` を `Text` に設定した場合に有効になります。バブルエフェクトの詳細については、「テキストバブルエフェクトの例」をご参照ください。 |
BubbleWidth | Float | いいえ | 出力ビデオに対するバブルベースマップの幅です。このパラメーターは、バブル字幕を使用する場合にのみ有効になります。1 より大きい値はピクセル数を示します。1 以下の値はパーセンテージを示します。 |
BubbleHeight | Float | いいえ | 出力ビデオに対するバブルベースマップの高さです。このパラメーターは、バブル字幕を使用する場合にのみ有効になります。1 より大きい値はピクセル数を示します。1 以下の値はパーセンテージを示します。 |
EffectTrackItem
エフェクトトラックに視覚効果とフィルターを追加できます。
パラメーター | タイプ | 必須 | 説明 |
Type | String | はい | エフェクトのタイプです。有効値:VFX および Filter。 |
SubType | String | はい | エフェクトのサブタイプです。 |
TimelineIn | Float | いいえ | タイムライン内のエフェクトの開始時間です。単位:秒。値は小数点以下 4 桁まで正確です。`TimelineIn` を指定しない場合、0 が使用されます。 |
TimelineOut | Float | いいえ | タイムライン内のエフェクトの終了時間です。単位:秒。値は小数点以下 4 桁まで正確です。`TimelineOut` を指定しない場合、エフェクトはビデオの終了時に終了します。 |
Duration | Float | いいえ | タイムライン内のエフェクトの長さです。単位:秒。値は小数点以下 4 桁まで正確です。`Duration` を指定しない場合、ビデオの長さが使用されます。 `Duration` と `TimelineOut` を同時に指定することはできません。 |
X | Float | いいえ | このパラメーターは、`SubType` を `mosaic_rect/blur` に設定した場合にのみ有効になります。エフェクトエリアの左上隅と出力ビデオの左上隅との間の水平距離です。 値はパーセンテージまたはピクセル数で設定できます。値の範囲が 0 から 0.9999 の場合、値はパーセンテージを示します。値が 2 以上の整数の場合、値はピクセル数を示します。 |
Y | Float | いいえ | このパラメーターは、`SubType` を `mosaic_rect/blur` に設定した場合にのみ有効になります。 エフェクトエリアの左上隅と出力ビデオの左上隅との間の垂直距離です。値はパーセンテージまたはピクセル数で設定できます。値の範囲が 0 から 0.9999 の場合、値はパーセンテージを示します。値が 2 以上の整数の場合、値はピクセル数を示します。 |
Width | Float | いいえ | このパラメーターは、`SubType` を `mosaic_rect/blur` に設定した場合にのみ有効になります。出力ビデオ内のエフェクトエリアの幅です。値はパーセンテージまたはピクセル数で設定できます。値の範囲が 0 から 0.9999 の場合、値はパーセンテージを示します。値が 2 以上の整数の場合、値はピクセル数を示します。 |
Height | Float | いいえ | このパラメーターは、`SubType` を `mosaic_rect/blur` に設定した場合にのみ有効になります。出力ビデオ内のエフェクトエリアの高さです。値はパーセンテージまたはピクセル数で設定できます。値の範囲が 0 から 0.9999 の場合、値はパーセンテージを示します。値が 2 以上の整数の場合、値はピクセル数を示します。 |
SubtitleEffect
字幕トラックに輪郭や影を追加できます。
パラメーター | タイプ | 必須 | 説明 |
Type | String | はい | エフェクトのタイプです。有効値:Outline、Shadow、Box。
|
Bord | Float | いいえ | 輪郭または影の幅または高さです。1 より大きい値はピクセル数を示します。0 より大きく 1 未満の値は、テキストサイズに対する相対的な幅または高さを示します。 |
XBord | Float | いいえ | 輪郭または影の幅です。1 より大きい値はピクセル数を示します。0 より大きく 1 未満の値は、テキストサイズに対する相対的な幅を示します。このパラメーターの優先度は `Bord` より低いです。 |
YBord | Float | いいえ | 輪郭または影の高さです。1 より大きい値はピクセル数を示します。0 より大きく 1 未満の値は、テキストサイズに対する相対的な高さを示します。このパラメーターの優先度は `Bord` より低いです。 |
Shift | Float | いいえ | 輪郭または影の水平または垂直オフセットです。絶対値が 1 より大きい場合はピクセル数を示します。絶対値が 0 より大きく 1 未満の場合は、テキストサイズに対する相対的なオフセットを示します。このパラメーターには負の数を設定でき、負の数は上または左へのオフセットを示します。 |
XShift | Float | いいえ | 輪郭または影の水平オフセットです。絶対値が 1 より大きい場合はピクセル数を示します。絶対値が 0 より大きく 1 未満の場合は、テキストサイズに対する相対的な水平オフセットを示します。このパラメーターの優先度は `Shift` より低いです。 |
YShift | Float | いいえ | 輪郭または影の垂直オフセットです。絶対値が 1 より大きい場合はピクセル数を示します。絶対値が 0 より大きく 1 未満の場合は、テキストサイズに対する相対的な垂直オフセットを示します。このパラメーターの優先度は `Shift` より低いです。 |
Color | String | いいえ | RGB カラーです。値は、シャープ記号 (#) と 16 進数値の形式です。例:#ffffff。 |
Opacity | String | いいえ | 字幕の不透明度です。値 1 は字幕が完全に不透明であることを示します。値 0 は字幕が完全に透明であることを示します。 |
Blur | Float | いいえ | ピクセル単位のガウスぼかし範囲です。このパラメーターは、`Type` を `Shadow` に設定した場合にのみ有効になります。このパラメーターを設定すると、字幕の輪郭がグローします。 |
Radius | Float | いいえ | テキストの単色背景の角丸半径です。このパラメーターは、`Type` を `Box` に設定した場合にのみ有効になります。このパラメーターを設定すると、字幕の背景が角丸になります。 |
ImageUrl | String | いいえ | カスタム字幕背景画像の URL です。このパラメーターは、`Type` を `Box` に設定した場合にのみ有効になります。このパラメーターを設定すると、カスタムバブル効果を実装できます。`BubbleWidth` または `BubbleHeight` を使用して字幕のサイズを変更できます。PNG、JPG、JPEG、または BMP 形式の OSS オブジェクトのみがサポートされています。例:https://your-bucket.oss-cn-shanghai.aliyuncs.com/your-image.png。 |
Width | Float | いいえ | ソースバブルベースマップの幅です。カスタムバブル字幕を使用する場合、このパラメーターは必須です。 |
Height | Float | いいえ | ソースバブルベースマップの高さです。カスタムバブル字幕を使用する場合、このパラメーターは必須です。 |
TextArea | String | いいえ | バブルベースマップ内のテキストエリアです。カスタムバブル字幕を使用する場合、このパラメーターは必須です。テキストエリアには、値が 0 から 1 の範囲の 4 つの浮動小数点数が含まれ、浮動小数点数はカンマ (,) で区切られます。たとえば、`0.1,0.2,0.8,0.6` と指定した場合、バブルに対するテキストボックスの左上隅の座標は 0.1 と 0.2 で、バブルに対するテキストボックスの幅と高さは 0.8 と 0.6 になります。 |
FontFace
次の表に、フォントスタイルパラメーターを示します。
パラメーター | タイプ | 必須 | 説明 |
Bold | Boolean | いいえ | フォントが太字であるかどうかを指定します。 |
Italic | Boolean | いいえ | フォントが斜体であるかどうかを指定します。 |
Underline | Boolean | いいえ | フォントに下線が付いているかどうかを指定します。 |
Effect
素材エフェクト
次のパラメーターを設定してエフェクトを定義します。一部のパラメーターは複数のエフェクトタイプで共有されます。
エフェクトパラメーターの詳細については、「エフェクト設定」をご参照ください。
次の表に、エフェクトの共通パラメーターを示します。
パラメーター | タイプ | 必須 | 説明 |
Type | String | はい | エフェクトのタイプです。有効値:
|
SubType | String | いいえ | エフェクトのサブタイプです。
|