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:
- Salida en diferentes formatos de contenedor, incluidos MPEG-4 (MP4), transmisión adaptable dinámica a través de HTTP (DASH, también conocida como MPEG-DASH) y transmisión en vivo HTTP (HLS)
- Salida con distintas tasas de bits y resoluciones, incluida la salida de solo audio
- Conversión a un formato de alto rango dinámico (HDR)
- Mejora la salida de video de manera programática, por ejemplo:
- Configura parámetros de codificación de bajo nivel, como la tasa de bits
- Combina contenido multimedia existente con listas de edición completas
- Establecer el modo de trabajo en el modo interactivo de baja latencia o el modo por lotes
- Especifica la normalización del volumen del audio.
- Configura la encriptación del video de salida para admitir la administración de derechos digitales y la protección del contenido.
- Inserta fotogramas clave para que los clientes del reproductor de video inserten anuncios
- Crea miniaturas a partir de una hoja de sprites de fotogramas del video generada.
- Crea plantillas de trabajos para guardar y reutilizar configuraciones personalizadas o complejas de transcodificación de trabajos.
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 DRM | Esquema de encriptación |
|---|---|---|---|
| HLS | TS | ClearKey | aes128 |
| HLS | TS | FairPlay | sampleAes |
| HLS | fMP4 | FairPlay | Solo cbcs 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 máximo de entrada | 4096 px |
| Altura máxima de entrada | 4096 px |
| Ancho máximo de salida | 4096 px |
| Altura máxima de salida | 2160 px |
| Tamaño total de salida | 400 GB |
Duración máxima de EditList | 24 horas |
| Cantidad máxima de transmisiones de video por Internet | 70 |
| Cantidad máxima de transmisiones de audio | 50 |
| Cantidad máxima de flujos de texto | 50 |
| Cantidad máxima de transmisiones mux | 100 |
| Cantidad máxima de manifiestos | 100 |
| Cantidad máxima de hojas de objeto | 10 |
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 de todo el archivo. 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 video, audio y subtítulos 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 con AAC. Ambos se colocan en un contenedor MP4.
Figura 1. Componentes de un archivo de video (izquierda) y un ejemplo de archivo MP4 (derecha)
Estructura del protocolo de transmisión
Para la transmisión de contenido multimedia, los proveedores de contenido codifican el mismo contenido a varias tasas de bits (medido 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 multimedia de transmisión 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 se codifican para alcanzar distintas tasas de bits. Por ejemplo, las tasas de bits más bajas se codifican en la definición estándar (SD) en lugar de la 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 escala en función de los costos de CDN, los tipos de dispositivos del usuario, el ancho de banda dentro de la región y otros factores.
Figura 2. Componentes de una estructura de protocolo de transmisión (arriba) y una implementación de ejemplo de transmisión en vivo HTTP (HLS) (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, especificas el tipo de códec (por ejemplo, H.264) y el perfil (por ejemplo, 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, este se procesa de forma asíncrona en una ubicación geográfica conocida como región. Puedes enumerar y administrar todos los trabajos de una región.
El ciclo de vida de un trabajo incluye tres pasos: preparación, transcodificación y paquete.
- Preparación
- Descarga entradas desde Cloud Storage
- Analizar entradas
- Valida entradas
- Transcodificación
- Cómo ejecutar operaciones de transcodificación en entradas
- Paquete
- Unir entradas
- Entradas multiplex
- Sube los resultados a Cloud Storage
Un trabajo tiene un state actualizado.
El servicio informa sobre errores en 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 qué trabajos se ejecutan primero. En este modo, la cuota de recuento de trabajos simultáneos controla cuántos trabajos se ejecutan al mismo tiempo. Una vez que se alcanza esta cuota, se rechaza cualquier trabajo que intentes iniciar.
Usa el modo por lotes si quieres enviar muchos trabajos para los cuales 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 un trabajo 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 a ejecutarse. En este modo, la cuota de recuento de trabajos pendientes por lotes controla cuántos trabajos se ponen en cola. Una vez que se alcanza esta cuota, se rechazan todos los trabajos que intentas 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 al mismo tiempo.
Puedes usar ambos modos al mismo tiempo. Un modo no tiene prioridad sobre el otro. Para obtener más información sobre cómo configurar el 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 una configuración de trabajo. Esta configuración de trabajo produce los siguientes archivos de salida:
manifest.m3u8: Es la playlist principal de una transmisión de contenido multimedia HLS. Este archivo contiene referencias a playlists para la variante de alta definición (HD) del resultado y la variante de definición estándar (SD) del resultado.media-hd.m3u8: Es la playlist de la variante de alta definición.media-hd0000000000.ts: Archivo de segmentos de video en alta definición
media-sd.m3u8: Es la playlist de la variante de definición estándar.media-sd0000000000.ts: Archivo de segmentos de video en definición estándar
manifest.mpd: Es la lista de reproducción de una transmisión de contenido multimedia MPEG-DASH. Este archivo contiene referencias a archivos de segmentos solo de audio y solo de video.audio-only0000000000.m4s: Archivo de segmentos de solo audiovideo-only-hd0000000000.m4s: Archivo de segmentos solo de video en alta definiciónvideo-only-sd0000000000.m4s: Archivo de segmentos solo de video en definición estándar
sd.mp4: Archivo de video de definición estándar independientehd.mp4: Archivo de video independiente de alta definición
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 los ajustes 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?
- Prueba la quickstart.
- Aprende a completar las tareas de la API de Transcoder específicas.