Cette rubrique explique comment modifier les paramètres de la Timeline lors de l'appel de l'opération SubmitMediaProducingJob pour traiter les sous-titres et leurs modèles.
Remarques d'utilisation
La production intelligente prend en charge le montage, le compositing, le rendu des effets et l'utilisation de modèles pour les flux en direct, les fichiers VOD et les éléments provenant d'Object Storage Service (OSS). Pour plus d'informations, consultez la section Présentation de la production intelligente.
Créez une vidéo à partir d'une ou plusieurs vidéos, de fichiers audio, d'images et d'éléments de sous-titrage en configurant les paramètres de Timeline et en appelant l'opération SubmitMediaProducingJob.
Une timeline est créée lorsque vous ajoutez des éléments et configurez des effets pour créer une vidéo. Elle se compose de pistes, d'éléments et d'effets. Pour plus de détails, reportez-vous à la section Configurations de Timeline.
Pour savoir comment utiliser le SDK IMS afin de modifier des fichiers audio et vidéo, consultez la section Premiers pas.
Ajouter des sous-titres à une vidéo
Ajoutez des sous-titres à une vidéo en créant une piste distincte (SubtitleTracks) ou via la configuration des Effects.
Définissez les heures de début et de fin des sous-titres à l'aide des paramètres TimelineIn et TimelineOut. Si ces deux paramètres ne sont pas spécifiés, les sous-titres de la piste sont générés pour couvrir toute la durée de la vidéo. Par défaut, les sous-titres ajoutés via Effects sont générés pour correspondre à la durée du clip vidéo auquel ils sont associés.
Utilisez
\Nou\npour afficher les sous-titres sur plusieurs lignes.
Effet | Exemple de timeline |
|
Configurer la taille de police, la police système, la police personnalisée, le contour, l'ombre et l'angle de rotation des sous-titres
Le paramètre FontSize indique la taille de police des sous-titres. Lors de l'ajout de sous-titres via Effects, il est recommandé d'utiliser FixedFontSize pour définir la taille, afin que celle-ci reste indépendante des dimensions de la vidéo.
Font spécifie la police système, tandis que FontURL indique le chemin vers l'objet OSS contenant les polices personnalisées. Si les deux paramètres sont définis, le système privilégie FontURL pour le rendu des sous-titres.
Des paramètres tels que Outline, OutlineColour, Shadow et BackColour permettent de générer des effets simples de contour et d'ombre sur une seule couche. Pour mettre en œuvre des effets de contour multicouches complexes, inspirez-vous de l'exemple de configuration de word art personnalisé présenté dans l'Exemple 3.
Ajustez l'angle de rotation des sous-titres dans le sens antihoraire à l'aide du paramètre Angle.
Effet | Exemple de timeline |
|
Configurer le word art
Configurez facilement des effets de word art grâce au champ EffectColorStyleId. Pour consulter la liste des effets disponibles, reportez-vous à la section Effets de word art.
Personnalisez l'apparence de vos sous-titres en utilisant le champ SubtitleEffects pour configurer plusieurs couches d'effets de contour et d'ombre. Pour plus de détails, consultez la section SubtitleEffect.
Effet | Exemple de timeline |
|
Configurer des effets pour une partie des sous-titres
Ajoutez un code de substitution dans le champ Content pour appliquer des effets à une portion spécifique du texte. Respectez les consignes suivantes lors de l'insertion de ce code :
Tout code de substitution doit commencer par deux barres obliques inversées (
\\).Encadrez toujours le code de substitution par des accolades
{ }. Plusieurs instructions peuvent figurer entre une paire d'accolades.Le code de substitution s'applique aux sous-titres. Pour rétablir la configuration initiale, insérez le code correspondant permettant d'annuler la substitution.
Le tableau suivant détaille les paramètres utilisables dans le code de substitution.
Paramètre | Description | Exemple de contenu |
|
| "{\\1c&00FF7F&}Green{\\1c} text" |
| bord, xbord et ybord définissent la largeur de la bordure, ainsi que ses largeurs respectives sur les axes x et y. Unité : pixels. | "Text {\\bord3\\3c&EBCE87&} stroke{\\bord\\3c}" |
\\b1 \\b0 | b1 active le gras, tandis que b0 le désactive. | "{\\b1}Bold{\\b0} text", |
\\i1 \\i0 | i1 active l'italique, tandis que i0 le désactive. | "{\\i1}Italicize{\\i0} text" |
\\u1 \\u0 | u1 active le soulignement, tandis que u0 le désactive. | "{\\u1}Underline{\\u0} text" |
\\s1 \\s0 | s1 active le barré, tandis que s0 le désactive. | "{\\s1}Strikethrough{\\s0} text" |
\\fs[Font size] | Taille de police du sous-titre. Unité : pixels. | "Size {\\fs100}100{\\fs} text" |
\\fn[Font] | Police du sous-titre. Les polices personnalisées ne peuvent pas être spécifiées via ce paramètre. | "{\\fnKaiTi}Heiti{\\fn} text" |
Effet | Exemple de timeline |
|
Configurer le retour à la ligne automatique
Afin de garantir l'affichage intégral des sous-titres, définissez AdaptMode sur AutoWrap pour activer le retour à la ligne automatique lorsque le texte dépasse les limites de la fenêtre. Vous pouvez également spécifier TextWidth en pixels absolus ou en pourcentage de la fenêtre de lecture pour contrôler le renvoi à la ligne dans une plage de largeur définie.
La valeur
"AdaptMode": "AutoWrapAtSpaces"empêche les coupures de mots au milieu des termes anglais.
Effet | Exemple de timeline |
|
Configurer l'alignement des sous-titres
-
Le positionnement des sous-titres varie selon le mode d'alignement choisi. Le tableau ci-dessous présente les modes d'alignement ainsi que leurs positions par défaut.
Alignement
Mode d'alignement
Position par défaut
TopLeft
Alignement à gauche
Coin supérieur gauche.
TopCenter
Alignement centré
Centre supérieur.
TopRight
Alignement à droite
Coin supérieur droit.
CenterLeft
Alignement à gauche
Centré horizontalement, avec un alignement du texte à gauche.
CenterCenter
Alignement centré
Centré horizontalement et verticalement.
CenterRight
Alignement à droite
Centré horizontalement, avec un alignement du texte à droite.
BottomLeft
Alignement à gauche
Coin inférieur gauche.
BottomCenter
Alignement centré
Centre inférieur.
BottomRight
Alignement à droite
Coin inférieur droit.
-
Le tableau suivant détaille trois modes d'alignement (Left, Center et Right) permettant un positionnement précis de vos sous-titres.
Alignement
Mode d'alignement
Point de référence de positionnement
Left
Alignement à gauche
Sommet supérieur gauche de la zone de texte du sous-titre.
Center
Alignement centré
Point médian du bord supérieur de la zone de texte du sous-titre.
Right
Alignement à droite
Sommet supérieur droit de la zone de texte du sous-titre.
-
L'illustration suivante met en évidence les différents points de référence de positionnement selon les modes d'alignement.
Effet | Exemple de timeline |
|
Configurer les effets de sous-titres
Spécifiez le moment d'affichage des effets d'entrée et de sortie des sous-titres, ainsi que la vitesse de l'effet en boucle.
L'effet d'entrée/sortie et l'effet en boucle ne peuvent pas être utilisés simultanément.
Effet | Exemple de timeline |
|
Configurer l'arrière-plan des sous-titres
Utilisez le champ Box dans SubtitleEffects pour ajouter un arrière-plan uni à vos sous-titres. Cette configuration permet également d'intégrer du word art, des retours à la ligne et d'autres styles.
Effet | Exemple de timeline |
|
Configurer les bulles de texte
Indiquez l'ID du style de bulle via BubbleStyleId. Pour découvrir les styles disponibles, consultez la section Textes en bulle.
Ajustez la largeur et la hauteur de la bulle de texte à l'aide des paramètres BubbleWidth et BubbleHeight. Les coordonnées X et Y représentent respectivement la position du coin supérieur gauche de la bulle par rapport au coin supérieur gauche de la vidéo.
Le style Box dans SubtitleEffects permet d'ajouter des images pour créer un effet de bulle personnalisé. Dans ce style, spécifiez Width et Height pour indiquer les dimensions de l'image originale de la bulle, et utilisez TextArea pour définir la position et la taille de la zone de texte par rapport à la bulle. Les quatre champs de TextArea indiquent les coordonnées du coin supérieur gauche de la zone de texte par rapport à la bulle, ainsi que sa largeur et sa hauteur relatives.
Lorsque vous utilisez la fonctionnalité de texte en bulle, le texte est automatiquement renvoyé à la ligne et mis à l'échelle à l'intérieur de la bulle.
Effet | Exemple de timeline |
|
Configurer le défilement des sous-titres
Défilement vertical : Si vous laissez
TimelineOutvide, le système estime automatiquement la durée des sous-titres en fonction du cycle de défilement. Vous pouvez spécifier les positions de début (ScrollStartY) et de fin (ScrollEndY) du défilement, les durées de pause au début (ScrollStartFreeze) et à la fin (ScrollEndFreeze), les décalages initiaux (ScrollStartShift) et finaux (ScrollEndShift), ainsi que la vitesse de défilement (ScrollSpeed).Défilement horizontal : Indiquez les positions de début (
ScrollStartX) et de fin (ScrollEndX) du défilement, la vitesse de défilement (ScrollSpeed) et si le défilement doit être répété en boucle (ScrollLoop).Les sous-titres peuvent s'aligner avec d'autres éléments multimédias. Par exemple, lors de la configuration du défilement vertical, attribuez la valeur
ClipIdàScrollSubtitle. Pour aligner une image d'arrière-plan, un fond sonore ou un texte de bannière sur les sous-titres défilants, définissezReferenceClipIdsurScrollSubtitle. L'heure de début du défilement vertical doit correspondre à la durée de l'ouverture de la piste vidéo.
Effet | Exemple de timeline |
|
Utiliser FECanvas pour uniformiser la taille de police des sous-titres dans des vidéos de différentes résolutions
FontSize définit le nombre de pixels occupés par la hauteur du texte d'un sous-titre dans une vidéo. Par défaut, l'application d'une même valeur FontSize à des vidéos de résolutions différentes entraîne souvent des proportions incohérentes. Par exemple, une valeur FontSize de 100 peut paraître grande dans une vidéo 480P, mais relativement petite dans une vidéo 720P. Pour maintenir une taille de police cohérente quelle que soit la résolution de la vidéo, configurez FECanvas dans la Timeline.
Effet | Exemple de timeline |
|