このトピックでは、OpenAPI を使用して動画を編集する際のオーディオ処理シナリオにおける一般的なタイムライン構成例を紹介します。これらのシナリオには、動画全体のミュート、指定セグメントのミュート、オーディオ抽出、動画をミュートして完全なオーディオトラックとミキシング、動画をミュートして指定されたオーディオセグメントとミキシング、動画およびオーディオのボリューム調整、オーディオの連結、複数のオーディオトラックのミキシング、高度なダビングが含まれます。
関連 API
タイムライン例
すべてミュート
動画全体をミュートすると、動画リソースからすべての音声が削除されます。次の例では、オーディオに対して Volume 効果を使用しています。Gain はボリュームゲインを表します。値が 0 の場合、無音になります。
{
"VideoTracks": [
{
"VideoTrackClips": [
{
"MediaId": "3f7e62d41a334dec9ac802b0f165****",
"Effects": [
{
"Type": "Volume",
"Gain": "0"
}
]
}
]
}
]
}指定セグメントのミュート
この操作は動画全体のミュートとは異なり、Volume 効果に In パラメーターおよび Out パラメーターが追加されます。次の例では、動画の 8 秒目から 60 秒目までをミュートします。動画の他の部分のボリュームは変更されません。
{
"VideoTracks": [
{
"VideoTrackClips": [
{
"MediaId": "3f7e62d41a334dec9ac802b0f165****",
"Effects": [
{
"Type": "Volume",
"Gain": "0",
"In": 8,
"Out": "60"
}
]
}
]
}
]
}オーディオ抽出
一部のシナリオでは、動画からオーディオを別個のオーディオリソースとして抽出する必要があります。これを行うには、AudioTracks オブジェクトを作成し、動画リソースを AudioTrackClip として渡します。次の例では、b3f37e05512043f49f697f7425b9**** はオーディオを含む動画リソースの ID です。
{
"AudioTracks": [
{
"AudioTrackClips": [
{
"MediaId": "b3f37e05512043f49f697f7425b9****"
}
]
}
]
}動画をミュートして完全なオーディオトラックとミキシング
これは典型的なダビングシナリオであり、元の動画をミュートした後、新しいオーディオトラックを追加して新しい動画を作成します。以下の例を参照してください。
オーディオ処理に関連するすべてのクリップを AudioTrack に配置します。
TimelineInを 5 に設定します。これは、オーディオが出力動画の 5 秒目からオーバーレイされることを示します。TimelineOutが設定されていない場合、デフォルトでオーディオセグメント全体がミキシングされます。オーディオが動画トラックの合計再生時間より長くなる場合は、動画トラックの終了位置に合わせて切り捨てられます。
AudioTrackClip は、オーディオのみのリソースまたはオーディオを含む動画リソースのいずれでもかまいません。
{
"VideoTracks": [
{
"VideoTrackClips": [
{
"MediaId": "3f7e62d41a334dec9ac802b0f165****",
"Effects": [
{
"Type": "Volume",
"Gain": "0"
}
]
}
]
}
],
"AudioTracks": [
{
"AudioTrackClips": [
{
"MediaId": "4a71744998414cbe8ea1976435a7****",
"TimelineIn":5
}
]
}
]
}動画をミュートして指定されたオーディオセグメントとミキシング
完全なオーディオトラックとのミキシングとは異なり、この操作ではオーディオクリップの In ポイントおよび Out ポイントの設定が追加されます。次の例では、オーディオセグメントを 10 秒目から 20 秒目（10 秒間のオーディオクリップ）まで切り取り、出力動画の 5 秒目からオーバーレイします。
AudioTrackClip は、オーディオのみのリソースまたはオーディオを含む動画リソースのいずれでもかまいません。
{
"VideoTracks": [
{
"VideoTrackClips": [
{
"MediaId": "3f7e62d41a334dec9ac802b0f165****",
"Effects": [
{
"Type": "Volume",
"Gain": "0"
}
]
}
]
}
],
"AudioTracks": [
{
"AudioTrackClips": [
{
"MediaId": "4a71744998414cbe8ea1976435a7****",
"In":10,
"Out":20,
"TimelineIn":5
}
]
}
]
}動画およびオーディオのボリューム調整
Volume 効果を使用してボリュームを設定できます。Gain パラメーターはボリュームレベルを表します。
Gain パラメーターの説明は以下のとおりです。
0：オーディオをミュートします。
1：元のボリュームを維持します。
0 ～ 1 の値：ボリュームを下げます。値が小さいほど、ボリュームは低くなります。
1 より大きい値：ボリュームを上げます。値が大きいほど、ボリュームは高くなります。
AudioTrackClip は、オーディオのみのリソースまたはオーディオを含む動画リソースのいずれでもかまいません。
{
"VideoTracks": [
{
"VideoTrackClips": [
{
"MediaId": "3f7e62d41a334dec9ac802b0f165****",
"Effects": [
{
"Type": "Volume",
"Gain": "0.5"
}
]
}
]
}
],
"AudioTracks": [
{
"AudioTrackClips": [
{
"MediaId": "4a71744998414cbe8ea1976435a7****",
"In":10,
"Out":20,
"TimelineIn":5,
"Effects": [
{
"Type": "Volume",
"Gain": "2"
}
]
}
]
}
]
}オーディオの連結
これまでの例ではすべて動画トラックを含んでいましたが、オンライン編集ではオーディオのみのトラック処理もサポートしています。次の例では、同じオーディオトラック上の 2 つのオーディオリソースから指定されたセグメントを切り取り、順番に接続して 30 秒間のオーディオリソースを作成します。
AudioTrackClip は、オーディオのみのリソースまたはオーディオを含む動画リソースのいずれでもかまいません。
{
"AudioTracks": [
{
"AudioTrackClips": [
{
"MediaId": "b3f37e05512043f49f697f7425b9****",
"In": 100,
"Out": 120
},
{
"MediaId": "ab654a04ce554e4f806b5f9e5a34****",
"In": 50,
"Out": 60
}
]
}
]
}複数のオーディオトラックのミキシング
同一トラックでのオーディオ連結に加えて、オンライン編集では複数のオーディオトラックからのオーディオリソースのミキシングもサポートしています。次の例では、複数のトラックからオーディオをミキシングして 20 秒間のオーディオリソースを作成します。
AudioTrackClip は、オーディオのみのリソースまたはオーディオを含む動画リソースのいずれでもかまいません。
{
"AudioTracks": [
{
"AudioTrackClips": [
{
"MediaId": "b3f37e05512043f49f697f7425b9****",
"In": 100,
"Out": 120,
"Effects": [
{
"Type": "Volume",
"Gain": "2"
}
]
}
]
},
{
"AudioTrackClips": [
{
"MediaId": "ab654a04ce554e4f806b5f9e5a34****",
"In": 50,
"Out": 60,
"Effects": [
{
"Type": "Volume",
"Gain": "1"
}
]
}
]
}
]
}高度なダビング
高度なダビングでは、動画と複数のオーディオトラックをミキシングします。次の例は、指定された動画セグメントのミュート、別のセグメントのボリューム調整、複数のオーディオトラックのミキシングを含む包括的なオーディオ処理の例です。具体的な操作は以下のとおりです。
動画 3f7e62d41a334dec9ac802b0f165**** の 50 秒目から 75 秒目までをミュートします。この期間中、2 つのオーディオトラックを有効にしてミキシングを行います。最初のオーディオトラックでは、メディアアセット b3f37e05512043f49f697f7425b9**** の 100 秒目から 120 秒目までのセグメントを切り取り、タイムラインの 50 秒目から 70 秒目まで挿入し、ボリュームを 2 倍にします。2 番目のオーディオトラックでは、メディアアセット ab654a04ce554e4f806b5f9e5a34**** の 150 秒目から 160 秒目までのセグメントを切り取り、タイムラインの 65 秒目から 75 秒目まで挿入します。
動画 3f7e62d41a334dec9ac802b0f165**** について、50 秒目から 75 秒目および 120 秒目から 125 秒目のセグメントを除き、他のすべてのセグメントでは通常のボリュームを維持します。
AudioTrackClip は、オーディオのみのリソースまたはオーディオを含む動画リソースのいずれでもかまいません。
以下の例を参照してください。
{
"VideoTracks": [
{
"VideoTrackClips": [
{
"MediaId": "3f7e62d41a334dec9ac802b0f165****",
"Effects": [
{
"Type": "Volume",
"Gain": "0",
"In": 50,
"Out": "75"
},
{
"Type": "Volume",
"Gain": "0.8",
"In": 120,
"Out": "125"
},
]
}
]
}
],
"AudioTracks": [
{
"AudioTrackClips": [
{
"MediaId": "b3f37e05512043f49f697f7425b9****",
"In": 100,
"Out": 120,
"TimelineIn":50,
"Effects": [
{
"Type": "Volume",
"Gain": "2"
}
]
}
]
},
{
"AudioTrackClips": [
{
"MediaId": "ab654a04ce554e4f806b5f9e5a34****",
"In": 150,
"Out": 160,
"TimelineIn":65,
"Effects": [
{
"Type": "Volume",
"Gain": "1"
}
]
}
]
}
]
}オーディオのフェードインおよびフェードアウトの設定
"Type": "AFade" フィールドを追加することで、オーディオのフェードインおよびフェードアウト効果を作成できます。たとえば、オーディオトラック上のメディアアセットに対して 3 秒間のフェードインと 4 秒間のフェードアウトを設定できます。この場合、ボリュームは線形に増減します。
{
"AudioTracks": [
{
"AudioTrackClips": [
{
"MediaId": "f044b3adc7967ba8f5cdf044b059****",
"Effects": [
{
"Type": "AFade",
"SubType": "In",
"Duration": 3,
"Curve": "tri"
},
{
"Type": "AFade",
"SubType": "Out",
"Duration": 4,
"Curve": "tri"
}
]
}
]
}
]
}パラメーターフィールド | Type | 必須 | 説明 |
SubType | string | Yes | オーディオフェード効果のサブタイプ。有効な値：
|
Duration | float | No | フェードインまたはフェードアウト効果の継続時間（秒）。フェードイン効果はメディアアセットセグメントの先頭に、フェードアウト効果は末尾に適用されます。デフォルト値は 0 で、フェード効果が適用されないことを意味します。 |
Curve | string | No | オーディオフェード効果のボリューム曲線。有効な値：
|
動画に対するオーディオのフェードインおよびフェードアウトの設定
オーディオトラックに対するフェード効果の設定と同様に、動画内のオーディオに対してもフェードインおよびフェードアウト効果を設定できます。たとえば、動画トラック上のオーディオを含むメディアアセットに対して 3 秒間のフェードインと 4 秒間のフェードアウトを設定できます。この場合、ボリュームは線形に増減します。
{
"VideoTracks": [
{
"VideoTrackClips": [
{
"MediaId": "f044b3adc7967ba8f5cdf044b059****",
"Effects": [
{
"Type": "AFade",
"SubType": "In",
"Curve": "tri",
"Duration": 3
},
{
"Type": "AFade",
"SubType": "Out",
"Duration": 4,
"Curve": "tri"
}
]
}
]
}
]
}