Créer des pistes de texte

Tu peux créer des pistes de texte pour proposer des sous-titres et/ou des légendes à ton audience vidéo. Ignite utilise le format WebVTT pour toutes les pistes de texte. Ce format est utilisé par YouTube, Vimeo et bien d’autres, et il est largement pris en charge par les navigateurs et les lecteurs. Tu peux en savoir plus sur le format WebVTT ici .

Création objet texttracks

Pour créer des pistes de texte, envoie une requête PUT à l’endpoint /videos/:videoId/texttracks avec soit un fichier VTT joint, soit le contenu VTT passé en chaîne.

Option 1 : fournir le contenu VTT en chaîne

CURL


curl -X PUT https://app.ignitevideo.cloud/api/videos/[VIDEO_ID]/texttracks \
-H "Authorization: Bearer YOUR_TOKEN" \
-H "Content-Type: application/json" \
-d '{"language": "en", "type": "captions", "content": "[VTT_CONTENT]"}'

JavaScript / Node.js


const data = {
"language": "en" | "en-US" | "de" | "de-DE" | "it" | "fr" | "...",
"type": "subtitles" | "captions",
"content": "[VTT_CONTENT]"
}
const response = await fetch(`https://app.ignitevideo.cloud/api/videos/[VIDEO_ID]/texttracks`, {
method: 'PUT',
body: JSON.stringify(data),
headers: {
  'Authorization': `Bearer YOUR_TOKEN`,
  'Content-Type': 'application/json'
}
});

PHP


$client = new GuzzleHttp\Client();
$data = [
  "language" => "en" | "en-US" | "de" | "de-DE" | "it" | "fr" | "...",
  "type" => "subtitles" | "captions",
  "content" => "[VTT_CONTENT]"
];
$response = $client->request('PUT', 'https://app.ignitevideo.cloud/api/videos/[VIDEO_ID]/texttracks', [
  'body' => json_encode($data),
  'headers' => [
      'Authorization' => 'Bearer YOUR_TOKEN',
      'Content-Type' => 'application/json'
  ]
]);

Option 2 : fournir un fichier VTT

Le Content-Type doit être multipart/form-data et pas application/json. Le fichier et la langue doivent être envoyés dans les données du formulaire.

CURL


curl -X PUT https://app.ignitevideo.cloud/api/videos/[VIDEO_ID]/texttracks \
-H "Authorization: Bearer YOUR_TOKEN" \
-F "language=en" \
-F "type=captions" \
-F "file=@[PATH_TO_VTT_FILE]"

JavaScript / Node.js


const formData = new FormData();
formData.append('language', 'en');
formData.append('type', 'captions');
formData.append('file', [VTT_FILE]);
 
const response = await fetch(`https://app.ignitevideo.cloud/api/videos/[VIDEO_ID]/texttracks`, {
method: 'PUT',
body: formData,
headers: {
  'Authorization': `Bearer YOUR_TOKEN`,
}
});

PHP


$client = new GuzzleHttp\Client();
$response = $client->request('PUT', 'https://app.ignitevideo.cloud/api/videos/[VIDEO_ID]/texttracks', [
'multipart' => [
  [
    'name' => 'language',
    'contents' => 'en'
  ],
  [
    'name' => 'type',
    'contents' => 'captions'
  ],
  [
    'name' => 'file',
    'contents' => fopen('[PATH_TO_VTT_FILE]', 'r')
  ]
],
'headers' => [
  'Authorization' => 'Bearer YOUR_TOKEN'
]
]);

Réponse

L’objet piste de texte nouvellement créé.


{
  "id": string,
  "language": "en" | "en-US" | "de" | "de-DE" | "it" | "fr" | "...",
  "type": "subtitles" | "captions",
  "filename": string,
  "url": string,
  "content": string
}