Créer des Text tracks

Tu peux créer des Text tracks pour proposer des sous-titres et/ou des légendes à ton audience vidéo. Ignite utilise le format WebVTT pour tous les Text tracks. 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 Text tracks, 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 Text track nouvellement créé.


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