Cette rubrique présente des exemples de configuration courants de Timeline pour divers scénarios de traitement audio lors du montage vidéo via l'OpenAPI. Ces scénarios incluent la mise en sourdine d'une vidéo entière ou d'un segment spécifique, l'extraction audio, la mise en sourdine d'une vidéo combinée à une piste audio complète ou à un segment audio spécifique, l'ajustement du volume vidéo et audio, la concaténation audio, le mixage de plusieurs pistes audio ainsi que le doublage avancé.
Opérations API associées
Exemples de Timeline
Mise en sourdine totale
La mise en sourdine d'une vidéo entière supprime tout le son de la ressource vidéo. L'exemple suivant utilise l'effet Volume pour l'audio. Le paramètre Gain représente le gain de volume. Une valeur de 0 indique un silence total.
{
"VideoTracks": [
{
"VideoTrackClips": [
{
"MediaId": "3f7e62d41a334dec9ac802b0f165****",
"Effects": [
{
"Type": "Volume",
"Gain": "0"
}
]
}
]
}
]
}Mise en sourdine d'un segment spécifique
Cette opération diffère de la mise en sourdine d'une vidéo entière car elle ajoute les paramètres In et Out à l'effet Volume. L'exemple suivant met en sourdine la vidéo entre la 8e et la 60e seconde. Le volume des autres parties de la vidéo reste inchangé :
{
"VideoTracks": [
{
"VideoTrackClips": [
{
"MediaId": "3f7e62d41a334dec9ac802b0f165****",
"Effects": [
{
"Type": "Volume",
"Gain": "0",
"In": 8,
"Out": "60"
}
]
}
]
}
]
}Extraction audio
Dans certains scénarios, il peut être nécessaire d'extraire l'audio d'une vidéo sous forme de ressource audio distincte. Pour ce faire, créez un objet AudioTracks et transmettez la ressource vidéo en tant qu'AudioTrackClip. Dans l'exemple suivant, b3f37e05512043f49f697f7425b9**** est l'ID d'une ressource vidéo contenant de l'audio.
{
"AudioTracks": [
{
"AudioTrackClips": [
{
"MediaId": "b3f37e05512043f49f697f7425b9****"
}
]
}
]
}Mise en sourdine d'une vidéo et mixage avec une piste audio complète
Il s'agit d'un scénario de doublage typique où vous coupez le son de la vidéo originale puis ajoutez une nouvelle piste audio pour créer une nouvelle vidéo. Voici un exemple :
Placez tous les clips liés au traitement audio dans un AudioTrack.
Définissez
TimelineInsur 5. Cela signifie que l'audio est superposé à la vidéo de sortie à partir de la 5e seconde.Si
TimelineOutn'est pas défini, le segment audio entier est mixé par défaut. Si l'audio dépasse la durée totale de la piste vidéo, il est tronqué pour correspondre à la fin de la piste vidéo.
Un AudioTrackClip peut être une ressource audio uniquement ou une ressource vidéo avec audio.
{
"VideoTracks": [
{
"VideoTrackClips": [
{
"MediaId": "3f7e62d41a334dec9ac802b0f165****",
"Effects": [
{
"Type": "Volume",
"Gain": "0"
}
]
}
]
}
],
"AudioTracks": [
{
"AudioTrackClips": [
{
"MediaId": "4a71744998414cbe8ea1976435a7****",
"TimelineIn":5
}
]
}
]
}Mise en sourdine d'une vidéo et mixage avec un segment audio spécifique
Contrairement au mixage avec une piste audio complète, cette opération ajoute des paramètres pour les points In et Out du clip audio. L'exemple suivant extrait le segment audio entre la 10e et la 20e seconde (un clip audio de 10 secondes) et le superpose à la vidéo de sortie à partir de la 5e seconde :
Un AudioTrackClip peut être une ressource audio uniquement ou une ressource vidéo avec audio.
{
"VideoTracks": [
{
"VideoTrackClips": [
{
"MediaId": "3f7e62d41a334dec9ac802b0f165****",
"Effects": [
{
"Type": "Volume",
"Gain": "0"
}
]
}
]
}
],
"AudioTracks": [
{
"AudioTrackClips": [
{
"MediaId": "4a71744998414cbe8ea1976435a7****",
"In":10,
"Out":20,
"TimelineIn":5
}
]
}
]
}Ajustement du volume vidéo et audio
Utilisez l'effet Volume pour régler le niveau sonore. Le paramètre Gain représente le niveau de volume.
Le paramètre Gain fonctionne comme suit :
0 : Coupe le son.
1 : Conserve le volume original.
Une valeur comprise entre 0 et 1 réduit le volume. Plus la valeur est faible, plus le volume est bas.
Une valeur supérieure à 1 augmente le volume. Plus la valeur est élevée, plus le volume est fort.
Un AudioTrackClip peut être une ressource audio uniquement ou une ressource vidéo avec audio.
{
"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"
}
]
}
]
}
]
}Concaténation audio
Les exemples précédents incluaient tous une piste vidéo. Cependant, l'édition en ligne prend également en charge le traitement des pistes audio seules. L'exemple suivant extrait des segments spécifiques de deux ressources audio sur la même piste audio, les connecte séquentiellement et crée une ressource audio de 30 secondes :
Un AudioTrackClip peut être une ressource audio uniquement ou une ressource vidéo avec audio.
{
"AudioTracks": [
{
"AudioTrackClips": [
{
"MediaId": "b3f37e05512043f49f697f7425b9****",
"In": 100,
"Out": 120
},
{
"MediaId": "ab654a04ce554e4f806b5f9e5a34****",
"In": 50,
"Out": 60
}
]
}
]
}Mixage de plusieurs pistes audio
En plus de la concaténation audio sur une même piste, l'édition en ligne permet de mixer des ressources audio provenant de plusieurs pistes. L'exemple suivant mixe l'audio de plusieurs pistes pour créer une ressource audio de 20 secondes :
Un AudioTrackClip peut être une ressource audio uniquement ou une ressource vidéo avec audio.
{
"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"
}
]
}
]
}
]
}Doublage avancé
Le doublage avancé implique le mixage d'une vidéo avec plusieurs pistes audio. Voici un exemple complet de traitement audio qui inclut la mise en sourdine d'un segment vidéo spécifique, l'ajustement du volume d'un autre segment et l'intégration de plusieurs pistes audio. Les opérations spécifiques sont les suivantes :
Coupez le son de la vidéo 3f7e62d41a334dec9ac802b0f165** entre la 50e et la 75e seconde. Pendant cette période, activez deux pistes audio pour le mixage. Pour la première piste audio, extrayez le segment entre la 100e et la 120e seconde de la ressource multimédia b3f37e05512043f49f697f7425b9. Insérez ce clip pour qu'il commence à la 50e seconde et se termine à la 70e seconde de la timeline, et augmentez le volume à 2. Pour la deuxième piste audio, extrayez le segment entre la 150e et la 160e seconde de la ressource multimédia ab654a04ce554e4f806b5f9e5a34**. Insérez ce clip pour qu'il commence à la 65e seconde et se termine à la 75e seconde.
Pour la vidéo 3f7e62d41a334dec9ac802b0f165****, le volume reste normal pour tous les segments sauf celui compris entre la 50e et la 75e seconde, ainsi que celui compris entre la 120e et la 125e seconde.
Un AudioTrackClip peut être une ressource audio uniquement ou une ressource vidéo avec audio.
Voici un exemple :
{
"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"
}
]
}
]
}
]
}Configuration des fondus entrants et sortants audio
Ajoutez le champ "Type": "AFade" pour créer un effet de fondu audio entrant et sortant. Par exemple, vous pouvez configurer un fondu entrant de 3 secondes et un fondu sortant de 4 secondes pour une ressource multimédia sur une piste audio. Le volume augmente et diminue linéairement.
{
"AudioTracks": [
{
"AudioTrackClips": [
{
"MediaId": "f044b3adc7967ba8f5cdf044b059****",
"Effects": [
{
"Type": "AFade",
"SubType": "In",
"Duration": 3,
"Curve": "tri"
},
{
"Type": "AFade",
"SubType": "Out",
"Duration": 4,
"Curve": "tri"
}
]
}
]
}
]
}Champs de paramètre | Type | Obligatoire | Description |
SubType | string | Oui | Le sous-type de l'effet de fondu audio. Valeurs possibles :
|
Duration | float | Non | La durée de l'effet de fondu entrant ou sortant, en secondes. L'effet de fondu entrant s'applique au début du segment de la ressource multimédia, et l'effet de fondu sortant s'applique à la fin. La valeur par défaut est 0, ce qui signifie qu'aucun effet de fondu n'est appliqué. |
Curve | string | Non | La courbe de volume pour l'effet de fondu audio. Valeurs possibles :
|
Configuration des fondus entrants et sortants audio pour une vidéo
De manière similaire à la configuration des effets de fondu pour une piste audio, vous pouvez également configurer des effets de fondu entrant et sortant pour l'audio d'une vidéo. Par exemple, vous pouvez configurer un fondu entrant de 3 secondes et un fondu sortant de 4 secondes pour une ressource multimédia avec audio sur une piste vidéo. Le volume augmente et diminue linéairement.
{
"VideoTracks": [
{
"VideoTrackClips": [
{
"MediaId": "f044b3adc7967ba8f5cdf044b059****",
"Effects": [
{
"Type": "AFade",
"SubType": "In",
"Curve": "tri",
"Duration": 3
},
{
"Type": "AFade",
"SubType": "Out",
"Duration": 4,
"Curve": "tri"
}
]
}
]
}
]
}