Características: Dynamic Ingest API

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 cargue sus archivos fuente a una ubicación temporal donde Dynamic Ingest puede 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.

Visión general del flujo de trabajo

Se utilizan varios sistemas / tecnologías en la transcodificación y el almacenamiento general de los medios. Son:

API de Content Management System (CMS): Crea un objeto de video para usar en la API DI
Zencoder: Transcodifica el video creando múltiples interpretaciones
Amazon S3: Mueve el maestro y las entregas al almacenamiento, según la configuración del perfil
Catálogo: Almacena la información requerida asociada con el video

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

Re-transcodificar: Crea nuevas representaciones cuando el maestro está presente (error si el maestro no está presente)
reemplazar: Apunte a un nuevo maestro o reemplace un maestro existente

Operaciones

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

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

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

Las Mejores Prácticas

Una solicitud 20 por segundo límite en cada cuenta para el total de solicitudes a través de DI y el CMS API (CMS API o Ingest API API)
Un límite de 100 empleos DI simultáneos por cuenta (hay opciones adicionales para grandes lotes de solicitudes de cuentas convertidas a Entrega dinámica)
Ingerir contenido más pequeño que 100GB por archivo (si necesita ingerir archivos más grandes, póngase en contacto con su administrador de cuentas)
Si está ingiriendo archivos en lotes, limite los trabajos de prioridad normal simultáneos a 100 y espere a que un trabajo complete el procesamiento antes de agregar otro
Valide cambios de perfil de ingesta antes de ingerir lotes completos
Debes no tener trabajos duplicados procesando para el mismo activo. Un activo en esta instancia 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 ingestión de un archivo de video y luego envíe otra solicitud de ingreso de video con la misma identificación de video antes de que se complete el primer trabajo de ingesta.
- ACEPTABLE: envíe una solicitud de ingreso de un archivo de video, luego envíe una solicitud de ingreso de una pista de texto en inglés asociada con la misma identificación de video y luego envíe una solicitud de ingreso para una imagen en miniatura con la misma identificación de video
- ACEPTABLE: envíe un trabajo de ingreso para una pista de texto en inglés y luego envíe una solicitud de ingreso para una pista de texto en español en paralelo
- INACEPTABLE: Presente 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 con la misma identificación de video
El profile campo para solicitudes de ingesta es opcional. Evite codificar el código profile en aplicaciones e integraciones; en su lugar, establezca el perfil más comúnmente utilizado como Por 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 fuente 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 contenedor 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 utilizar la ingesta basada en el arrastre incluyen un flujo de trabajo más simple y un repositorio de sus propios maestros digitales. Si esta no es una opción para usted, también puede usar Carga de archivo de origen para subir sus videos y otros activos a 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 adecuadamente según la URL RFC 3986 cuando lo envían a Brightcove. Esto significa que cualquier personajes reservados que se encuentran en la ruta de la url están codificados en porcentaje (los espacios están codificados para %20), y los caracteres reservados encontrados en la consulta de la url están codificados en porcentaje (espacios codificados para + or %20 y + siendo codificado para %2B).

A pre-firmado S3 (v2 contiene Firma , Expira y AWSAccessKeyId y v4 contiene X-Amz-Algoritmo, Credencial X-Amz, X-Amz-Date, X-Amz-Expires, X-Amz-SignedHeaders y X-Amz-Signature) o GCS (contiene Firma , Expira y GoogleAccessId) url ya debería estar codificado correctamente y puede ser utilizado como es.

Ingerir videos

Se requieren dos llamadas API para la ingestión de videos:

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

Un conjunto de muestra de solicitudes básicas se vería así:

CMS API solicitar

Método HTTP

PUBLICAR

URL de solicitud

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

Solicitar cuerpo

    {
    "name": "My new video"
    }

Los datos de respuesta incluirán el video id , que se usa en la próxima solicitud.

Solicitud API de ingestión

Método HTTP

PUBLICAR

URL de solicitud

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

Solicitar cuerpo

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

ver el Empieza para obtener detalles de las llamadas API, y también puede ver un muestra de trabajo.

Para los CMS API llama para crear el video en el Video Cloud sistema, ver el CMS API Resumen. Tenga en cuenta que el video name es necesario, y que el nombre y otras cadenas incluidas para metadatos de video (como description ) debe estar codificado por URI.

Activos de muestra

Brightcove Learning Services proporciona algunos recursos de muestra que puede usar para experimentar al comenzar con Dynamic Ingest. Estos recursos 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 copias, el Dynamic Ingest API La llamada es exactamente la misma que para Ingerir 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 Video Cloud Sistema y obtener una identificación para ello. Si el archivo de video de origen en la URL especificada es el mismo que se ingirió originalmente, simplemente obtendrá un nuevo conjunto de copias. Si el archivo fuente es nuevo, reemplazará el video existente. Todos los videos se podrán reproducir con las copias existentes hasta que se complete la retranscodificación.

ver el muestra de trabajo aquí.

Retranscodificar un video

Si eliges archivar un maestro cuando ingieres el video a través de Dynamic Ingest API o el módulo de carga de Studio, entonces también puede volver a codificar el video desde el master. 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 usando el Dynamic Ingest API o el módulo de carga, recibirá un error
Los perfiles de ingesta estándar recomendados (videocloud-default-v1, screencast-1280, alta resolución, inteligente-player-transition, single-bitrate-standard y single-bitrate-high) archivarán el maestro. Si está utilizando un perfil de ingesta personalizado, debe especificar que el maestro debe archivarse si desea poder volver a codificar desde el maestro más adelante.
El maestro es nunca modificado durante la retranscodificación
Las configuraciones para archivar y distribuir maestros 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.

Imágenes

Puede utilizar el Dynamic Ingest API para capturar imágenes de póster y miniaturas de su video, o para agregar sus propias imágenes. Para más detalles, ver Imágenes y el Dynamic Ingest API.

Ingerir leyendas

También puede agregar subtítulos WebVTT a su video o subirlos a un video existente utilizando Dynamic Ingest. Para más detalles, ver Ingestión 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.

Archivando Rendiciones

Por defecto, todas las representaciones de video e imagen se archivan automáticamente. Si desea desactivar el almacenamiento de las entregas, póngase en contacto con el servicio de asistencia de Brightcove. Tenga en cuenta que maestros digitales se archivan si eso 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 de recibir e interpretar notificaciones se pueden encontrar en Notificaciones: Dynamic Ingest y CMS APIs