Tworzenie Text tracks

Możesz tworzyć Text tracks, żeby zapewnić widzom napisy i/lub napisy zamknięte (captions). Ignite używa formatu WebVTT dla wszystkich Text tracks. WebVTT stosują m.in. YouTube i Vimeo i jest szeroko obsługiwany w przeglądarkach i odtwarzaczach. Więcej o WebVTT przeczytasz tutaj .

language musi być obsługiwanym locale z regionem, na przykład en-US lub de-DE. Sam tag języka, taki jak en, jest odrzucany z 400 { "error": "unsupported_language" }. type to subtitles albo captions.

Wideo musi być już zakodowane. Brakujące wideo albo wideo, którego status nie jest COMPLETE, zwraca 400.

Utworzenie obiektu Text tracks

Tworzenie Text tracks wykonujesz przez wysłanie żądania PUT do endpointu /videos/:videoId/texttracks — albo z załączonym plikiem VTT, albo przekazując treść VTT jako ciąg.

Opcja 1: treść VTT jako ciąg

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-US", "type": "captions", "content": "[VTT_CONTENT]"}'

JavaScript / Node.js


const data = {
"language": "en-US" | "de-DE" | "fr-FR" | "es-ES" | "it-IT" | "...",
"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-US" | "de-DE" | "fr-FR" | "es-ES" | "it-IT" | "...",
  "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'
]
]);

Opcja 2: plik VTT

Content-Type musi być multipart/form-data, a nie application/json. Plik i język muszą być częścią danych formularza.

CURL


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

JavaScript / Node.js


const formData = new FormData();
formData.append('language', 'en-US');
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-US'
  ],
  [
    'name' => 'type',
    'contents' => 'captions'
  ],
  [
    'name' => 'file',
    'contents' => fopen('[PATH_TO_VTT_FILE]', 'r')
  ]
],
'headers' => [
  'Authorization' => 'Bearer YOUR_TOKEN'
]
]);

Odpowiedź

Nowo utworzony obiekt Text track. content w tej odpowiedzi to przestarzały placeholder zakodowany URL-em, a nie przesłany WebVTT. Pobierz Text track, żeby odczytać plik.


{
  "id": string,
  "language": "en-US" | "de-DE" | "fr-FR" | "es-ES" | "it-IT" | "...",
  "type": "subtitles" | "captions",
  "filename": string,
  "url": string,
  "content": string // URL-encoded placeholder, not the WebVTT
}