Tarjetas con bloques de subtítulos alineadas con una línea de tiempo de video, junto a 2 hojas de documentos de subtítulos.
Conserve los tiempos de los bloques y pruebe el archivo guardado durante la reproducción.

Un bloque de subtítulos es un bloque de texto con un tiempo de inicio y un tiempo de fin de visualización. SRT (SubRip Text) usa comas antes de los milisegundos. VTT (WebVTT) comienza con un encabezado `WEBVTT` y usa puntos antes de los milisegundos. UTF-8 es una codificación de texto estándar que conserva los caracteres especiales. Un Actor es un programa que recopila datos de la web, y una Task es una configuración de entrada guardada para un Actor.

Para extraer subtítulos, use el Actor YouTube Transcript Scraper. Solicite JSON junto con los formatos SRT y VTT. La salida JSON sin procesar incluye campos específicos de cada segmento: `startSeconds`, `endSeconds`, `durationSeconds` y `text`. Guarde únicamente la cadena de subtítulos sin procesar como un archivo de texto UTF-8. No exporte todo el conjunto de datos como CSV ni conserve cadenas JSON con secuencias de escape `\n`. Las entradas que fallan aparecen en OUTPUT de la ejecución, en lugar de aparecer como filas del conjunto de datos. Una ejecución de prueba con una pista guardó 61 bloques de subtítulos para validar la obtención, pero aún debe comprobar la reproducción en su propio reproductor.

Si no hay ningún subtítulo con tiempos, consulte la guía de extracción de subtítulos de YouTube antes de validar sus archivos.

Método completo de conversión y validación

  1. Confirme la identidad y el idioma del video: Compruebe la URL del video y el idioma seleccionado. Conserve los bloques originales en JSON y la URL de origen.
  2. Solicite los formatos de salida: Solicite JSON, SRT y VTT. Compruebe que haya una fila con un resultado correcto y segmentos que no estén vacíos. Si falla la obtención de subtítulos, use la guía de obtención enlazada. No invente tiempos de fin a partir de texto sin tiempos.
  3. Guarde el archivo: Copie todo el contenido del campo `srt` en `lesson.srt` o del campo `vtt` en `lesson.vtt`. Use un editor de texto plano con codificación UTF-8. No conserve las comillas de JSON, los caracteres literales `\n`, las celdas de CSV ni una extensión `.txt` agregada al nombre del archivo.
  4. Compruebe la sintaxis: SRT usa números de bloque y comas antes de los milisegundos. VTT comienza con `WEBVTT`, seguido de una línea en blanco, y usa puntos antes de los milisegundos. Ambos formatos separan los bloques con líneas en blanco y usan `-->` entre los tiempos. Confirme que los tiempos de fin sean posteriores a los de inicio y compruebe que los tiempos de inicio de los bloques no disminuyan. Las superposiciones pueden ser válidas; revíselas durante la reproducción en lugar de eliminarlas automáticamente.
  5. Compruebe la reproducción del video: Compare el primer bloque, uno del medio y el último con el video en su reproductor. Revise las tildes, los saltos de línea y las líneas largas. Un archivo puede pasar los controles de formato y aun así mostrar tiempos o texto incorrectos en pantalla.
  6. Corrija los desfases de tiempo: Si todos los bloques aparecen tarde por el mismo intervalo fijo, compruebe si se eliminó una introducción de su copia local del video. Desplace tanto los tiempos de inicio como los de fin por ese desfase exacto, solo para esa copia específica. Si el error de sincronización aumenta con el tiempo, un desplazamiento fijo no funcionará. Cuando aumente la desincronización progresiva, vuelva a la fuente correcta con tiempos en lugar de aplicar una conversión de velocidad de fotogramas que no haya probado.
  7. Guarde los archivos finales: Guarde los bloques de origen y una nota de cualquier cambio de tiempo aprobado.

Archivos de ejemplo ficticios

Este es un ejemplo simple con 3 bloques cuyos tiempos se expresan en segundos:

  • Bloque 1: de `0.250` a `2.750` segundos — “Abra la configuración.”
  • Bloque 2: de `3.000` a `5.500` segundos — “Elija Français.”
  • Bloque 3: de `6.000` a `8.125` segundos — “Guarde el cambio.”

Archivo SRT completo

srt
1
00:00:00,250 --> 00:00:02,750
Open the settings.

2
00:00:03,000 --> 00:00:05,500
Choose Français.

3
00:00:06,000 --> 00:00:08,125
Save the change.
Archivos de ejemplo ficticios

Archivo VTT completo

vtt
WEBVTT

00:00:00.250 --> 00:00:02.750
Open the settings.

00:00:03.000 --> 00:00:05.500
Choose Français.

00:00:06.000 --> 00:00:08.125
Save the change.
Archivos de ejemplo ficticios

Observe que SRT usa comas (`00:00:00,250`), mientras que VTT usa puntos (`00:00:00.250`) como separador de milisegundos en todos los tiempos.

Detalle de los cálculos

Para convertir fracciones de segundo a milisegundos, multiplique por 1.000. Por ejemplo, `0.250` segundos se convierten en `250` milisegundos, y `8.125` segundos se convierten en `00:00:08.125`.

  • Las duraciones de los bloques son 2,500 segundos, 2,500 segundos y 2,125 segundos.
  • La duración total durante la cual se muestran los bloques es de 7,125 segundos (`2.500 + 2.500 + 2.125`).
  • El intervalo total de los subtítulos es de 7,875 segundos (`8.125 - 0.250`), lo que incluye las pausas entre bloques.

Ninguna de estas sumas mide la exactitud del texto ni la velocidad de lectura.

Ejemplo independiente de desfase de tiempo

Imagine una segunda copia independiente del video a la que se le haya eliminado una introducción de 1,000 segundo. Un par de tiempos de inicio y fin de un bloque de ese video, originalmente en `10.250–12.750` segundos, pasa a `9.250–11.750` segundos después de restar 1,000 segundo (`10.250 - 1 = 9.250` y `12.750 - 1 = 11.750`).

Nunca aplique este desplazamiento al primer archivo de ejemplo de tres bloques. Restar 1,000 segundo al tiempo de inicio del primer bloque (`0.250`) generaría un tiempo de inicio negativo no válido (`-0.750`). Conserve los archivos originales sin cambios y compruebe los archivos con tiempos desplazados en un reproductor de video antes de usarlos.

Fuentes y lecturas adicionales

Por Chronometrica · Actualizado

Volver arriba ↑