Ajout de sous-titres fermés aux rendus MP4
En plus d'ajouter des pistes de texte à vos rendus HLS et/ou DASH, vous pouvez ajouter 608 sous-titres codés à des rendus MP4 progressifs en incluant le "embed_closed_caption": true drapeau dans votre demande d'ingestion WebVTT.
Pour intégrer des sous-titres codés à une vidéo que vous incorporez, assurez-vous d'utiliser un profil d'incorporation qui inclut un ou plusieurs rendus MP4. Si vous ajoutez des pistes de texte ou des sous-titres à une vidéo existante, assurez-vous qu'elle possède au moins un rendu MP4, ou recodez-la avec un profil d'acquisition qui inclura le MP4.
Si vous utilisez Cloud Playout, notez que vous pouvez désormais importer ces sous-titres dans votre chaîne pour les fournir à vos téléspectateurs.
Remarques
- Les langues actuellement prises en charge pour les 608 sous-titres intégrés sont les suivantes : Anglais, espagnol, français, portugais, italien, allemand et néerlandais.
- Pour les sous-titres 608 intégrés , seuls les caractères européens (latins) sont pris en charge. Les langues à deux octets telles que le chinois et le japonais ne sont pas prises en charge.
- Si le fichier source contient déjà 608 sous-titres codés, ceux-ci ne seront conservés dans aucun rendu MP4. Au lieu de cela, de nouveaux sous-titres codés seront intégrés à partir du contenu des sous-titres ingérés.
- Actuellement, il n'est pas possible d'ajouter des sous-titres codés pendant le retranscodage de la vidéo - vous devez être en train d'ingérer ou de remplacer la vidéo. Les travaux de retranscodage prendront en charge cette fonctionnalité dans une prochaine version.
- Cette fonction ne peut pas être utilisée lorsque vous demandez des sous-titres automatiques.
- Si votre compte est activé pour la diffusion dans le nuage, vous pouvez vérifier que les sous-titres codés ont été ajoutés en incluant la vidéo dans un canal (les canaux de diffusion dans le nuage utilisent toujours des rendus MP4).
Configuration
La configuration des requêtes d'acquisition dynamique est la même, qu'il s'agisse d'une vidéo, d'images, d'un fichier WebVTT ou de tous ces éléments. Pour plus de détails sur les champs du corps de la demande, voir la référence de l'API.
- URL de demande
-
https://ingest.api.brightcove.com/v1/accounts/account_id/videos/video_id/ingest-requests - Authentification
- L'authentification nécessite un jeton d'accès transmis en tant que
Bearerjeton dans unAuthorizationentête:Authorization: Bearer {access_token}
Remarque sur S3
Si votre WebVTT doit être extrait d'un compartiment S3 protégé, vous devrez définir une stratégie de compartiment pour permettre à Video Cloud d'accéder aux fichiers. Voir Utilisation de l'ingestion dynamique avec S3 pour les détails.
Ingérer des fichiers WebVTT
Vous pouvez également ajouter des sous-titres WebVTT à votre vidéo ou les télécharger pour une vidéo existante à l'aide de Dynamic Ingest :
Ajouter des pistes de texte lors de l'ingestion vidéo
URL de demande
https://ingest.api.brightcove.com/v1/accounts/account_id/videos/video_id/ingest-requests
Méthode
POST
Exemple de corps de requête
{
"master": {
"url": "https://support.brightcove.com/test-assets/videos/Great_Blue_Heron.mp4"
},
"text_tracks": [
{
"url": "https://support.brightcove.com/test-assets/captions/herons.vtt",
"srclang": "en",
"kind": "captions",
"label": "EN",
"default": true,
"status" : "published",
"embed_closed_caption": true
}
]
}Ajout/conversion de SRT ou DFXP
Pour Vidéos de diffusion dynamique uniquement , vous pouvez ingérer des fichiers SRT ou DFXP de la même manière. Le système d'ingestion de Video Cloud les convertira automatiquement au format WebVTT et les ajoutera à la vidéo.
{
"text_tracks": [
{
"url": "https://media.brightcove.com/captions/Water.dfxp",
"srclang": "fr",
"kind": "captions",
"label": "français",
"default": true,
"status" : "published",
"embed_closed_caption": true
}
]
}
Ajouter des pistes de texte aux vidéos existantes
L'ajout de pistes de texte à des vidéos existantes se fait exactement de la même manière, sauf que vous n'avez pas besoin des informations vidéo ou du profil dans le corps de la requête. Sauf si vous demandez l'ajout de sous-titres codés à des rendus MP4 - dans ce cas, vous devrez remplacer la vidéo
URL de demande
https://ingest.api.brightcove.com/v1/accounts/account_id/videos/video_id/ingest-requests
Méthode
POST
Exemple de corps de requête - pas de sous-titres codés demandés
{
"text_tracks": [
{
"url": "https://some.site.com/captions/for_video/Water-in-Motion.vtt",
"srclang": "es",
"kind": "captions",
"label": "Español",
"default": true,
"status" : "published",
"embed_closed_caption": false
}
]
}
Exemple de corps de requête - sous-titres codés demandés
{
"master": {
"url": "https://support.brightcove.com/test-assets/videos/Great_Blue_Heron.mp4"
},
"text_tracks": [
{
"url": "https://support.brightcove.com/test-assets/captions/herons.vtt",
"srclang": "en",
"kind": "captions",
"label": "EN",
"default": true,
"status" : "published",
"embed_closed_caption": true
}
]
}