Descripción general de la API de Transcoder

En esta página, se proporciona una descripción general técnica de la API de Transcoder, incluidas las características, la terminología y los conceptos útiles. La API de Transcoder implementa una API de REST y RPC que te permite enviar, supervisar y administrar trabajos de transcodificación en Google Cloud. Para enviar trabajos con la API de Transcoder, primero debes subir activos multimedia a Cloud Storage. Después de procesar un trabajo, la API de Transcoder guarda los medios resultantes en Cloud Storage.

Funciones

La API de Transcoder admite las siguientes funciones:

Para obtener más información sobre los estándares MP4 y MPEG-DASH, consulta el sitio web de Moving Picture Experts Group. Para obtener más información sobre el estándar de HLS, consulta HTTP Live Streaming.

Contenedores admitidos para la encriptación de contenido

En la siguiente tabla, se muestran los contenedores compatibles con la encriptación de contenido.

Protocolo de transmisión Contenedor sistema de DRM Esquema de encriptación
HLS TS ClearKey aes128
HLS TS FairPlay sampleAes
HLS fMP4 FairPlay Solo cbcs para mpegCenc
MPEG‐DASH fMP4 Widevine mpegCenc cenc o cbcs
MPEG‐DASH fMP4 PlayReady mpegCenc cenc o cbcs

Control de acceso

El modelo de control de acceso de la API de Transcoder se basa en la administración de identidades y accesos de Google. Los permisos detallados de IAM te brindan control sobre lo que se puede hacer con datos de medios, y quién tiene acceso a ellos.

Límites

En la siguiente tabla, se muestran los límites por trabajo de transcodificación.

Límites de trabajos
Ancho de entrada máximo4096 px
Altura máxima de entrada4096 px
Ancho máximo de salida4096 px
Altura máxima de salida2160 px
Tamaño total de entrada400 GB
Tamaño total de salida400 GB
Duración máxima de EditList24 horas
Cantidad máxima de transmisiones de video por Internet70
Cantidad máxima de transmisiones de audio50
Cantidad máxima de transmisiones de texto50
Cantidad máxima de transmisiones mux100
Cantidad máxima de manifiestos100
Cantidad máxima de hojas de objeto10

Conceptos

En esta sección, se proporcionan conceptos importantes sobre los archivos de video y cómo se usan con la API de Transcoder.

Componentes de un archivo de video

Cada archivo de video tiene un contenedor, que es el wrapper del archivo completo. La API de Transcoder usa MuxStreams para definir el contenedor. Cada contenedor incluye un conjunto de ElementaryStreams para definir la codificación de las pistas de texto de subtítulos, video y audio del archivo. El video y el audio se comprimen con códecs.

En el siguiente ejemplo, se comprime el video con H.264 y el audio se comprime con AAC. Ambas se colocan en un contenedor MP4.

Componentes de un archivo de video y un ejemplo
Figura 1. Componentes de un archivo de video (izquierda) y un archivo MP4 de ejemplo (derecha).

Estructura del protocolo de transmisión

Para los medios de transmisión, los proveedores de contenido codifican el mismo contenido a varias tasas de bits (medidas en kilobits por segundo). Luego, el proveedor genera un archivo de manifiesto que apunta a los diferentes archivos con distintas tasas de bits. El reproductor de transmisión de contenido multimedia usa el archivo de manifiesto para seleccionar el archivo apropiado y, luego, extrae el video unos segundos a la vez. Cada tasa de bits puede ser un solo archivo o varios archivos cortos, según lo que admita el reproductor.

Por lo general, las diferentes resoluciones de contenido multimedia están codificadas para orientarse a distintas tasas de bits. Por ejemplo, las tasas de bits más bajas se codifican en definición estándar (SD) en lugar de alta definición (HD). El conjunto de tasas de bits, resoluciones y códecs se denomina escala de tasa de bits adaptable (ABR). Los proveedores de contenido de transmisión pueden ajustar su propia escalera en función de los costos de CDN, los tipos de dispositivos de los usuarios, el ancho de banda dentro de la región y otros factores.

Componentes de una estructura de protocolo de transmisión y un ejemplo
Figura 2. Componentes de una estructura de protocolo de transmisión (arriba) y una implementación de transmisión en vivo HTTP (HLS) de ejemplo (abajo).

Terminología

En esta sección, se proporciona un glosario de términos útiles para trabajar con la API de Transcoder.

Pausa publicitaria

Una pausa publicitaria es un anuncio breve que aparece antes de la reproducción de medios o durante ella. La API de Transcoder admite un fotograma clave de pausa publicitaria en la configuración del trabajo. La API de Transcoder no inserta ni reproduce anuncios, ni detiene la reproducción de contenido multimedia, los clientes del reproductor de video son responsables de administrar el fotograma clave.

Átomo

Un átomo es una estructura de datos fundamental para definir los metadatos y la ubicación de un video. Un video puede estar compuesto por una jerarquía anidada compleja de diferentes tipos de átomos, que incluyen audios, ediciones y texto.

Átomo de audio

Un átomo de audio asigna el audio de una transmisión básica a una lista de edición.

Perfil y tipo de códec

Cuando seleccionas el códec para una transmisión de video por Internet, debes especificar el tipo de códec, por ejemplo, H.264, y el perfil, como el perfil high predeterminado.

Contenedor

Un contenedor es un wrapper que describe la relación entre los distintos componentes de una transmisión multiplexada, incluidos los archivos multimedia y los metadatos. La API de Transcoder admite los formatos de contenedor MP4, MPEG-DASH y HLS.

Edita el átomo

Un átomo de edición define las compensaciones de inicio y fin de los segmentos individuales de una transmisión que deseas combinar en una lista de edición.

Editar la lista

Una lista de edición define una secuencia de ediciones como un cronograma para el archivo o manifiesto resultante de un trabajo de transcodificación.

Transmisión básica

Una transmisión básica es una codificación de un archivo de entrada, como una pista de texto, video, audio o subtítulos. Debes empaquetar las transmisiones básicas antes de asignar y compartir la transmisión a diferentes formatos de salida.

Codificación de entropía

La codificación entropía es una forma de compresión sin pérdidas que admite la API de Transcoder. Cuando configuras trabajos, puedes especificar los codificadores de entropía de codificación de longitud variable adaptada al contexto (CAVLC) o de codificación binaria aritmética adaptable al contexto (CABAC).

Job

Un trabajo es la unidad básica para administrar el trabajo con la API de Transcoder. Cuando envías un trabajo a la API de Transcoder, se procesa de forma asíncrona en una ubicación geográfica conocida como región. Puedes enumerar y administrar todos los trabajos para una región.

El ciclo de vida de un trabajo incluye tres pasos: preparar, transcodificar y empaquetar.

  • Preparar
    • Descarga entradas desde Cloud Storage
    • Analiza las entradas
    • Validar entradas
  • Transcodificación
    • Ejecuta operaciones de transcodificación en las entradas
  • Paquete
    • Unir entradas
    • Entradas multiplex
    • Sube resultados a Cloud Storage

Un trabajo tiene un state actualizado. El servicio informa sobre errores mediante el campo error.

Configuración del trabajo

Una configuración de trabajo representa muchas de las diversas opciones de configuración que puedes personalizar cuando creas y envías un trabajo a la API de Transcoder. Puedes especificar ajustes de configuración, como las listas de edición y dónde insertar etiquetas de pausa publicitaria en un manifiesto de salida. Puedes crear configuraciones de trabajo reutilizables como plantillas de trabajo para usarlas en una región de Google Cloud.

Modo de trabajo

La API de Transcoder admite dos modos de trabajo: interactivo y por lotes.

El modo interactivo es el modo de trabajo predeterminado. Usa este modo si deseas que el procesamiento de los trabajos se inicie lo antes posible o si deseas tener un control más detallado sobre los trabajos que se ejecutan primero. En este modo, la cuota de recuento de trabajos simultáneos controla cuántos trabajos se ejecutan en simultáneo. Una vez que se alcanza esta cuota, se rechazan los trabajos que intentas iniciar.

Usa el modo por lotes si quieres enviar muchos trabajos para los que la latencia de procesamiento no es tan crítica como los trabajos enviados en el modo interactivo predeterminado. Puedes especificar la prioridad de procesamiento de los trabajos para un trabajo en este modo. Los trabajos enviados en modo por lotes con el mismo valor de prioridad se colocan en una cola de "primero en entrar, primero en salir" y tienen un estado de trabajo de PENDING mientras esperan su ejecución. En este modo, la cuota de recuento de trabajos pendientes por lotes controla cuántos trabajos hay en cola. Una vez que se alcanza esta cuota, se rechazan los trabajos que intentes iniciar. Un trabajo pasa al estado RUNNING cuando se ejecuta. La cuota de recuento de trabajos simultáneos por lotes controla cuántos trabajos se ejecutan en simultáneo.

Puedes usar ambos modos al mismo tiempo. Un modo no tiene prioridad sobre el otro. Para obtener más información sobre la configuración del modo de trabajo, consulta Crea trabajos en modo por lotes.

Plantillas de trabajo

De forma predeterminada, la API de Transcoder aplica una plantilla predeterminada llamada preset/web-hd para propagar la configuración de un trabajo. Esta configuración de trabajo produce los siguientes archivos de salida:

  • manifest.m3u8: Es la playlist principal de una transmisión multimedia de HLS. Este archivo contiene referencias a las playlists de la variante de alta definición (HD) del resultado y la de la definición estándar (SD) del resultado.
    • media-hd.m3u8: Playlist de la variante de alta definición
      • media-hd0000000000.ts: Archivo de segmento de video en alta definición
    • media-sd.m3u8: playlist de la variante de definición estándar
      • media-sd0000000000.ts: Archivo de segmento de video de definición estándar
  • manifest.mpd: Es la playlist para una transmisión multimedia de MPEG-DASH. Este archivo contiene referencias a archivos de segmentos solo de video y audio.
    • audio-only0000000000.m4s: Archivo de segmentos solo de audio
    • video-only-hd0000000000.m4s: Archivo de segmentos solo de video en alta definición
    • video-only-sd0000000000.m4s: Archivo de segmento de solo video de definición estándar
  • sd.mp4: Archivo de video de definición estándar independiente
  • hd.mp4: Archivo de video de alta definición independiente

Puedes crear y administrar tus propias plantillas de trabajo personalizadas y especificarlas cuando crees trabajos.

Procesamiento previo:

El procesamiento previo es la etapa de un trabajo que se lleva a cabo antes de la transcodificación principal.

Configuración del procesamiento previo

Una configuración de procesamiento previo representa la configuración que puedes aplicar a un video antes de la etapa de transcodificación de un trabajo. Puedes aplicar recortes o padding como parte de esta configuración.

Modo de control de velocidad

El modo de control de velocidad indica si se debe procesar un trabajo con los modos de factor de velocidad constante (CRF) o tasa de bits variable (VBR). CRF garantiza una calidad constante en todos los elementos multimedia procesados. VBR optimiza el proceso de codificación para reducir el tamaño de los archivos multimedia procesados. Para casos de uso de transmisión, selecciona el modo de control de tasa VBR. Con el objetivo de archivado, selecciona el modo de control de tasa de CRF.

Manifiesto

Un manifiesto es una descripción del contenido y los metadatos disponibles de una transmisión multimedia adaptativa a un cliente. En la API de Transcoder, puedes configurar un trabajo para mostrar un manifiesto con un nombre de archivo, una lista de transmisiones multiplexadas, y el tipo de manifiesto, que debe ser HLS o MPEG-DASH.

Átomo de texto

Un átomo de texto asigna el texto de una transmisión básica a una lista de edición.

Transmisión de texto

Una transmisión de texto codifica los datos de texto asociados con un video, como los subtítulos.

¿Qué sigue?