Resumen: Dynamic Ingest API

Funcionalidad API

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

Descripción general del flujo

Una serie de sistemas/tecnologías se utilizan en la transcodificación general y el almacenamiento de medios. A saber:

API del Sistema de Gestión de Contenido (CMS): Crea un objeto de vídeo para su uso en la API DI
Zencoder: Transcodifica el vídeo creando varias copias
Amazon S3: Mueve el maestro y las copias al almacenamiento, en función de la configuración del perfil
Catálogo: Almacena la información necesaria asociada con el vídeo

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

Re-transcodificación: Crear nuevas copias cuando el patrón está presente (error si el patrón no está presente)
Reemplazar: Apunte a un patrón nuevo o reemplace un patrón existente

Operaciones

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

nube de vídeo/vídeo/crear
nube de vídeo/vídeo/lectura
video-nube/vídeo/actualización
nube de vídeo/perfiles de ingeste/perfil/leer
nube de vídeo/perfiles de ingeste/cuenta/leer
nube de vídeo/perfiles de ingeste/cuenta/escritura
nube de vídeo/perfiles de ingeste/perfil/escritura
nube de vídeo/subir URLs/leer

Para obtener credenciales de cliente, utilice las herramientas de administración de Studio o consulte 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 CMS API (solicitudes de API de CMS o API de ingesta)
Límite de 100 trabajos de DI simultáneos por cuenta (hay opciones adicionales para grandes lotes de solicitudes de cuentas convertidas a Entrega dinámica)
Ingiere contenido inferior a 100 GBs 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 normales simultáneos a 100 y espere a que un trabajo finalice el procesamiento antes de agregar otro
Validar los cambios de perfil de ingesta antes de ingerir lotes completos
No debe tener trabajos duplicados procesados para el mismo activo. Un recurso en esta instancia se define como un objeto de vídeo, 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: Enviar una solicitud de ingesta para un archivo de vídeo y, a continuación, enviar otra solicitud de ingesta de vídeo con el mismo ID de vídeo antes de que finalice el primer trabajo de ingesta
- ACEPTABLE: Enviar una solicitud de ingesta para un archivo de vídeo, luego enviar una solicitud de ingesta para una pista de texto en inglés asociada con el mismo ID de vídeo y, a continuación, enviar una solicitud de ingesta para una imagen en miniatura con el mismo ID de vídeo
- ACEPTABLE: Enviar un trabajo de ingesta para una pista de texto en inglés y luego enviar una solicitud de ingesta para una pista de texto en español en paralelo
- INACEPTABLE: Enviar una solicitud para ingerir una pista de audio española y luego enviar inmediatamente una solicitud para ingerir otra pista de audio española en el mismo ID de vídeo
El campo para las solicitudes de ingesta es opcional.profile Evite codificar profile en aplicaciones e integraciones - en su lugar, establezca el perfil más utilizado como predeterminado para la cuenta, y omita el campo, o busque los perfiles disponibles para la cuenta y obliga al usuario a elegir uno.

Ubicaciones de origen válidas

La ingesta dinámica puede extraer archivos de vídeo 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 los vídeos están en un depósito protegido de S3, consulte Uso de ingesta dinámica con S3 para obtener información detallada sobre cómo configurar permisos para la ingesta dinámica para acceder a los archivos.

Las ventajas de utilizar la ingesta basada en extracción incluyen un flujo de trabajo más sencillo y tener un repositorio de sus propios maestros digitales. Sin embargo, si esta no es una opción para usted, también puede usar Cargar archivos de origen para cargar sus vídeos y otros recursos en una ubicación temporal desde la que Dynamic Ingest pueda acceder a ellos.

Nombres de archivo de origen

Todas las URL de entrada deben codificarse correctamente según RFC 3986 cuando se envíen a Brightcove. Esto significa que los caracteres reservados que se encuentren en la ruta de acceso de la url están codificados por ciento (espacios a los que se codifican), y los caracteres reservados encontrados en la consulta de la url están codificados por ciento (espacios que se codifican en o, y se codifican en).%20+%20+%2B

Un S3 prefirmado (v2 contiene firma , caduca y AWSAccessKeyID , y v4 contiene el algoritmo X-Amz, X-Amz-Credential, X-Amz-Date, X-Amz-Expires, X-AMZ-SignedHeaders y X-AMZ-Signature) o GCS(contiene firma, caduca y GoogleAccessid) url ya debe estar codificada correctamente y se puede utilizar tal cual.

Vídeos de ingestión

Hay dos llamadas API necesarias para ingerir vídeos:

Llame CMS API al para crear un objeto de vídeo en el sistema de Video Cloud y obtener su id
Llame a la API DI para proporcionar la URL del archivo fuente de vídeo y especificar el perfil de ingesta que se va a utilizar

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

Solicitud de API de CMS

HTTP (método)

PUBLICAR

URL de solicitud

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

Cuerpo de solicitud

    {
    "name": "My new video"
    }

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

Solicitud de API de ingesta

HTTP (método)

PUBLICAR

URL de solicitud

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

Cuerpo de solicitud

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

Consulte Inicio rápido para obtener detalles sobre las llamadas a la API y también puede ver una muestra de trabajo.

Para ver una CMS API llamada para crear el vídeo en el sistema de Video Cloud, consulte la descripción general de la API de CMS. Tenga en cuenta que el vídeo es obligatorio y que el nombre y cualquier otra cadena incluida para los metadatos de vídeo (como el) deben estar codificados con URI.name description

Activos de muestra

Brightcove Learning Services proporciona algunos recursos de ejemplo con los que puede experimentar al comenzar a utilizar la ingesta dinámica. Estos activos incluyen vídeos cortos, imágenes y subtítulos de WebVTT en varios idiomas:

Reemplazar un vídeo

Para reemplazar un vídeo con una nueva versión o un nuevo conjunto de copias, la llamada es exactamente la misma que sería para ingerir vídeos nuevos: la única diferencia es que no es necesario realizar una llamada previa a la para crear el objeto de vídeo en el sistema de Video Cloud y obtener una identificación para él.Dynamic Ingest APICMS API Si el archivo de vídeo de origen en la URL especificada es el mismo que se ingirió originalmente, simplemente obtendrá un nuevo conjunto de copias. Si el archivo de origen es nuevo, reemplazará el vídeo existente. Todos los vídeos permanecerán reproducibles con las representaciones existentes hasta que se complete la retranscodificación.

Vea la muestra de trabajo aquí.

Retranscodificación de un vídeo

Si eligió archivar un maestro al ingerir el vídeo a través del módulo Studio Upload Dynamic Ingest API o Studio, también puede volver a transcodificar el vídeo 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 vídeo no se ingería usando 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, smart 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 transcodificar desde el maestro más adelante.
El maestro nunca se modifica durante la retranscodificación
La configuración para archivar y distribuir maestros nunca se modifica durante la retranscodificación
Problema conocido: cuando vuelve a transcodificar un vídeo mediante la ingestión dinámica, la fecha de activación del vídeo se actualiza a la fecha actual. El uso de listas de reproducción inteligentes ordenadas por fecha de activación afecta al orden de aparición de los vídeos en la lista de reproducción.

Imágenes

Puede utilizar el Dynamic Ingest API para capturar imágenes de póster y miniatura de su vídeo, o para agregar sus propias imágenes. Para obtener más información, consulte Imágenes y la API de ingesta dinámica.

Ingesta de subtítulos

También puedes añadir subtítulos de WebVTT a tu vídeo o cargarlos para un vídeo existente mediante la ingesta dinámica. Para obtener más información, consulte Ingerir archivos WebVTT.

DRM y HLSE

La ingesta dinámica controla los vídeos que utilizan cualquiera de los tipos DRM admitidos por Brightcove. También se admite HLSE.

Archivado de copias

De forma predeterminada, todas las copias de vídeo e imágenes se archivan automáticamente. Si desea desactivar el archivado de copias, póngase en contacto con el Soporte técnico de Brightcove. Tenga en cuenta que los maestros digitales se archivan si se especifica en el perfil de ingesta.

Notificaciones

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

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