Visión general: API de ingesta dinámica

Funcionalidad API

La API Dynamic Ingest (DI) de Brightcove se basa en la funcionalidad en la que los archivos de origen de video se descargan desde la ubicación de almacenamiento del cliente y se crean representaciones específicas de los archivos de origen. (También hay una opción para sube tus archivos fuente a una ubicación temporal donde Dynamic Ingest pueda acceder a ellos). La plataforma está centrada en la nube, distribuida globalmente y basada en prácticas modernas para ofrecer la mejor consistencia y velocidad de su clase.

Descripción general del flujo de trabajo

Se utilizan varios sistemas / tecnologías en la transcodificación y almacenamiento generales de medios. Ellos son:

API del sistema de gestión de contenido (CMS): Crea un objeto de video para usar en la API de DI
Zencoder: Transcodifica el video creando múltiples versiones.
Amazon S3: Mueve el maestro y las representaciones al almacenamiento, según la configuración del perfil
Catalogar: Almacena la información necesaria asociada con el video.

Después de la transcodificación inicial, tiene las siguientes acciones que puede realizar en los medios:

Volver a transcodificar: Crear nuevas representaciones cuando el maestro está presente (error si el maestro no está presente)
Reemplazar: Apunta a un nuevo maestro o reemplaza un maestro existente

Operaciones

Cuando utilice la API de DI, realizará diferentes operaciones, como leer un perfil de ingesta y escribir información de ingesta en su cuenta. La siguiente es una lista completa de las operaciones necesarias para las tareas de DI:

video-nube / video / crear
video-nube / video / lectura
video-nube / video / actualización
video-cloud / ingest-profiles / profile / read
video-cloud / ingest-profiles / account / read
video-cloud / ingest-profiles / account / write
video-nube / ingest-profiles / profile / write
video-cloud / upload-urls / read

Para obtener las credenciales del cliente, use Studio herramientas de administración o vea uno de los siguientes documentos:

Mejores prácticas

Un límite de 20 solicitudes por segundo en cada cuenta para el total de solicitudes en DI y el CMS API (CMS API o solicitudes de API de ingesta)
Un límite de 100 trabajos DI simultáneos por cuenta (hay opciones adicionales para grandes lotes de solicitudes de cuentas convertidas a Entrega dinámica)
Ingesta contenido de menos de 100 GB por archivo (si necesitas ingerir archivos más grandes, comunícate con tu administrador de cuentas)
Si está ingiriendo archivos en lotes, limite los trabajos de prioridad normal concurrentes a 100 y espere a que un trabajo complete el procesamiento antes de agregar otro
Valide los cambios en el perfil de ingesta antes de ingerir lotes completos
Debería no tener procesamiento de trabajos duplicados para el mismo activo. Un activo en este caso se define como un objeto de video, una pista de audio en un idioma específico, una pista de texto en un idioma específico o un tipo de imagen específico. Aquí hay algunos ejemplos para ilustrar el punto:
- INACEPTABLE: Envíe una solicitud de ingesta para un archivo de video y luego envíe otra solicitud de ingesta de video con la misma ID de video antes de que se complete el primer trabajo de ingesta.
- ACEPTABLE: Envíe una solicitud de ingesta para un archivo de video, luego envíe una solicitud de ingesta para una pista de texto en inglés asociada con la misma ID de video y luego envíe una solicitud de ingesta para una imagen en miniatura con la misma ID de video
- ACEPTABLE: Envíe un trabajo de ingesta para una pista de texto en inglés y luego envíe una solicitud de ingesta para una pista de texto en español en paralelo
- INACEPTABLE: Envíe una solicitud para ingerir una pista de audio en español y luego envíe inmediatamente una solicitud para ingerir otra pista de audio en español en la misma ID de video
La profile El campo para solicitudes de ingesta es Opcional. Evite codificar el profile en aplicaciones e integraciones; en su lugar, establezca el perfil más utilizado como el defecto para la cuenta y omita el campo, o buscar los perfiles disponibles para la cuenta y obligar al usuario a elegir uno.

Ubicaciones de origen válidas

Dynamic Ingest puede extraer archivos de video de origen de: HTTP / HTTPS o S3: con o sin autenticación

Ejemplos:

http://example.com/path/to/input.avi
https://dl.dropboxusercontent.com/u/3641457/Bird_Titmouse.mp4
s3: //my-bucket/video.mp4

Notas sobre S3

Si sus videos están en un bucket de S3 protegido, consulte Uso de Dynamic Ingest con S3 para obtener detalles sobre cómo configurar permisos para Dynamic Ingest para acceder a sus archivos.

Las ventajas de usar la ingesta basada en extracción incluyen un flujo de trabajo más simple y tener un repositorio de sus propios maestros digitales. Sin embargo, si esta no es una opción para usted, también puede usar Carga del archivo de origen para cargar sus videos y otros activos en una ubicación temporal desde la cual Dynamic Ingest puede acceder a ellos.

Nombres de archivos de origen

Todas las URL de entrada deben codificarse correctamente de acuerdo con RFC 3986 cuando se envía a Brightcove. Esto significa que cualquier personajes reservados que se encuentran en la ruta de la URL están codificados en porcentaje (los espacios se codifican para %20), y todos los caracteres reservados que se encuentran en la consulta de la URL están codificados en porcentaje (los espacios se codifican en + o %20 , y + siendo codificado a %2B).

A pre-firmado S3 (v2 contiene Firma, Expira y AWSAccessKeyId, y v4 contiene Algoritmo X-Amz, Credencial X-Amz, X-Amz-Date, X-Amz-Caduca, Encabezados firmados por X-Amz, y X-Amz-Signature) o GCS (contiene Firma, Expira, y GoogleAccessId) url ya debería estar codificada correctamente y se puede usar tal cual.

Ingestión de videos

Se requieren dos llamadas a la API para ingerir videos:

Llama a CMS API para crear un objeto de video en el sistema Video Cloud y obtener su identificación
Llame a la API de DI para proporcionar la URL del archivo de origen del video y especifique el perfil de ingesta para ser utilizado

Un conjunto de muestra de solicitudes básicas tendría el siguiente aspecto:

Solicitud de CMS API

Método HTTP

CORREO

Solicitar URL

https://cms.api.brightcove.com/v1/accounts/{account_id} videos

Cuerpo de la solicitud

    {
    "name": "My new video"
    }

Los datos de respuesta incluirán el video. id , que se utiliza en la siguiente solicitud.

Solicitud de API de ingesta

Método HTTP

CORREO

Solicitar URL

https://ingest.api.brightcove.com/v1/accounts/{account_id} videos /{video_id} solicitudes-de-ingesta

Cuerpo de la solicitud

    {
    "master": {
    "url": "http://host/master.mp4"
    },
    "profile": "high-resolution"
    }

Ver el Inicio rápido para obtener detalles de las llamadas a la API, y también puede ver un muestra de trabajo.

Para CMS API llamar para crear el vídeo en el sistema Video Cloud, consulte la Descripción general de la CMS API. Tenga en cuenta que el video name es obligatorio, y que el nombre y cualquier otra cadena incluida para los metadatos de video (como el description ) debe estar codificado en URI.

Activos de muestra

Brightcove Learning Services proporciona algunos activos de muestra que puede utilizar para experimentar y comenzar con Dynamic Ingest. Estos activos incluyen videos cortos, imágenes y subtítulos WebVTT en varios idiomas:

Reemplazar un video

Para reemplazar un video con una nueva versión o un nuevo conjunto de representaciones, el API de ingesta dinámica la llamada es exactamente la misma que sería para ingiriendo nuevos videos - la única diferencia es que no es necesario realizar una llamada previa al CMS API para crear el objeto de video en el sistema Video Cloud y obtener una identificación para él. Si el archivo de video de origen en la URL especificada es el mismo que se ingirió originalmente, simplemente obtendrá un nuevo conjunto de representaciones. Si el archivo de origen es nuevo, reemplazará el video existente. Todos los videos se seguirán reproduciendo con las interpretaciones existentes hasta que se complete la retranscodificación.

Ver el muestra de trabajo aquí.

Retranscodificar un video

Si eliges archivar un maestro cuando ingeriste el video a través del API de ingesta dinámica o el módulo de carga de Studio, entonces también puede retranscodificar el video desde el maestro. Nuevamente, la URL para la solicitud de ingesta será la misma, pero el cuerpo de la solicitud tendrá lo siguiente:

    // request
    POST /v1/accounts/{account_id}/videos/{video_id}/ingest-requests
    // request body
    {
    "master": { "use_archived_master": true },
    "profile": "videocloud-default-v1"
    }

Notas:

Si el maestro no se archivó o el video fue no ingerido utilizando el API de ingesta dinámica o el módulo de carga, recibirá un error
Los perfiles de ingesta estándar recomendados (videocloud-default-v1, screencast-1280, alta resolución, transición de reproductor inteligente, estándar de tasa de bits única y tasa de bits única alta) archivarán todos el maestro. Si está utilizando un perfil de ingesta personalizado, debe especificar que el maestro debe archivarse si desea volver a codificar desde el maestro más adelante.
El maestro es Nunca modificado durante la retranscodificación
Los ajustes para archivar y distribuir masters son Nunca modificado durante la retranscodificación
Problema conocido: cuando retranscodifica un video mediante la ingestión dinámica, la fecha de activación del video se actualiza a la fecha actual. Si usa listas de reproducción inteligentes ordenadas por fecha de activación, esto afectará el orden de los videos en la lista de reproducción.

Imagenes

Puedes usar el API de ingesta dinámica para capturar imágenes en miniatura y póster de su video, o para agregar sus propias imágenes. Para obtener más detalles, consulte Imágenes y API de ingesta dinámica.

Ingestión de subtítulos

También puede agregar subtítulos WebVTT a su video o cargarlos para un video existente usando Dynamic Ingest. Para obtener más detalles, consulte Ingesta de archivos WebVTT.

DRM y HLSe

Dynamic Ingest maneja videos que usan cualquiera de los tipos de DRM admitidos por Brightcove. HLSe también es compatible.

Archivado de copias

De forma predeterminada, todas las representaciones de imágenes y vídeos se archivan automáticamente. Si desea desactivar el archivo de interpretaciones, póngase en contacto con el soporte de Brightcove. Tenga en cuenta que maestros digitales se archivan si se especifica en el perfil de ingesta.

Notificaciones

Puede especificar una o más URL de devolución de llamada para recibir notificaciones de los resultados del proceso de ingesta. Las URL que especifique deben ser para aplicaciones que puedan aceptar solicitudes POST. Las notificaciones se enviarán en formato JSON.

Los detalles sobre la recepción e interpretación de notificaciones se pueden encontrar en Notificaciones: CMS API e ingesta dinámica