Entrega de URL estática

Introducción

Brightcove proporciona URL estáticas a archivos de manifiesto de video para activos en su biblioteca de Video Cloud. Esto le brinda la flexibilidad de administrar su contenido en su propio CMS y entregarlo utilizando un esquema de seguridad personalizado.

Esto es importante para los clientes que tienen una arquitectura existente que no permite una llamada a la API de reproducción antes de necesitar las URL de manifiesto. El reproductor también puede utilizar esta función, lo que reduce el tiempo de inicio de la reproducción al eliminar una llamada.

También vea el Referencia de Playback API v2.

Requisitos

Los siguientes requisitos son necesarios para las URL estáticas:

• Brightcove Playback API v2
• Sus activos se ingieren para la entrega dinámica

Registro de análisis

Con URL estáticas, se está integrando con la API de reproducción sin utilizar Brightcove Player. Si bien Brightcove Player envía automáticamente datos analíticos a Brightcove, utilizará la API de recopilación de datos para hacer esto.

Si no está familiarizado con la API de recopilación de datos, revise la Descripción general: API de recopilación de datos documento.

Para obtener detalles sobre el envío de información al recopilador de datos, consulte la Muestra de API de recopilación de datos.

Nube de vídeo

Hoy en día, cada reproducción a través de VideoCloud requiere 2 llamadas a la API para iniciar la reproducción de video. Con el uso de URL estáticas, puede reducir la cantidad de llamadas a la API a solo una.

El siguiente diagrama muestra las llamadas a la API para la reproducción de video SIN URL estáticas.

URL estáticas

Con Playback API v2 de Brightcove, las URL estáticas ahora están disponibles.

Características

Estas son las funciones asociadas con las URL estáticas:

Implementación de URL estáticas

Las URL estáticas incluyen lo siguiente:

• ID de la cuenta
• ID de video (o referencia)
• Tipo de entrega (HLS, Dash)
• Opciones de configuración (SSAI, DRM, CDN, etc.)

Las URL estáticas se protegen mediante un código generado y firmado por el cliente. JSON Web Token (JWT). Con este token, puede configurar y aplicar aspectos de la entrega. Para obtener más detalles, consulte la Creando un JSON Web Token sección.

Dominio

El dominio utilizado para las URL estáticas es la URL de Playback API v2 (PAPIv2):

https://edge.api.brightcove.com/playback/v1/

Parámetros de consulta

Puntos finales de video a pedido (VOD)

Ejemplos de URL estáticas para cada tipo de entrega:

Manifiesto maestro de HLS

/accounts/{account_id}/videos/{video_id}/master.m3u8?bcov_auth={jwt}

Manifiesto DASH

/accounts/{account_id}/videos/{video_id}/manifest.mpd?bcov_auth={jwt}

HLS VMAP ^[1]

/accounts/{account_id}/videos/{video_id}/hls.vmap?bcov_auth={jwt}

DASH VMAP ^[1]

/accounts/{account_id}/videos/{video_id}/dash.vmap?bcov_auth={jwt}

Tasa de bits más alta MP4 ^[2]

/accounts/{account_id}/videos/{video_id}/high.mp4?bcov_auth={jwt}

Tasa de bits más baja MP4 ^[2]

/accounts/{account_id}/videos/{video_id}/low.mp4?bcov_auth={jwt}

Imágenes en miniatura

/accounts/{account_id}/videos/{video_id}/thumbnail.jpg?bcov_auth={jwt}

Imágenes de carteles

/accounts/{account_id}/videos/{video_id}/poster.jpg?bcov_auth={jwt}

Notas

• ^[1] Los VMAP de HLS y DASH solo se pueden recuperar si incluye el ssai reclamar cuando usted crear el JWT.
• ^[2] Al usar el high.mp4 y low.mp4 puntos finales, sus videos deben incluir representaciones MP4 o obtendrá el siguiente error:

  404 (NO RESOURCE)

Puntos finales en vivo

Ejemplos de URL estáticas para transmisiones en vivo:

Manifiesto maestro de HLS

/accounts/{account_id}/videos/{video_id}/master.m3u8?bcov_auth={jwt}

HLS VMAP ^[1]

/accounts/{account_id}/videos/{video_id}/hls.vmap?bcov_auth={jwt}

Notas

• ^[1] Los VMAP de HLS solo se pueden recuperar si incluye el ssai reclamar cuando usted crear el JWT.

Creando un JSON Web Token

Para crear un token para usar al comunicarse con la API de reproducción de Brightcove, consulte la Creando un JSON Web Token (JWT) documento. Allí encontrará las afirmaciones que se pueden utilizar para la entrega de URL estáticas.

Uso de la protección de contenido (DRM)

Puede incluir el pro reclamo, como se define arriba, para especificar un tipo de protección.

Para las solicitudes de licencia, el JWT no necesita ninguna carga útil, pero debe firmarse con la misma clave RSA que el JWT de solicitud de manifiesto.

Solicitud de licencia de Widevine

Puede usar el siguiente punto final para obtener la licencia DRM para Widevine:

/accounts/{account_id}/videos/{video_id}/licenses/cenc/widevine?bcov_auth={JWT}

Certificado de la aplicación FairPlay

Para los certificados de la aplicación FairPlay, el punto final es:

/accounts/{account_id}/fairplay_app_cert

Punto final PlayReady

Para PlayReady, el punto final para la solicitud de licencia es:

/accounts/{account_id}/videos/{video_id}/licenses/cenc/playready?bcov_auth={JWT}

Notas

Las siguientes notas se aplican a la entrega de URL estáticas:

• Se admiten subtítulos en manifiesto. Los subtítulos de sidecar fuera de banda serán compatibles en una versión futura.
• El BYO CDN del cliente entregará los segmentos de video, mientras que el CDN de Brightcove continuará entregando manifiestos y submanifiestos.
• Brightcove admite el uso de un JWT que no caduca. Para hacer esto, excluya el exp reclamar al crear su token.