Resumen
Los activos remotos se añaden principalmente a través de las operaciones de activos, con un par de excepciones que se indican a continuación. Tenga en cuenta que las operaciones GET para activos se pueden utilizar tanto para activos ingeridos como remotos.
Autorización
Flujo de trabajo
A continuación se indican los pasos para configurar un activo remoto:
En las siguientes secciones, veremos cada uno de estos pasos.
Crear el vídeo
Para poder agregar activos remotos, debe crear un objeto de vídeo en la biblioteca multimedia de Video Cloud, utilizando la solicitud POST para:
https://cms.api.brightcove.com/v1/accounts/{account_id}/videos
En el cuerpo de la solicitud, incluya un objeto JSON que contenga mínimamente el nombre del vídeo, pero que puede contener metadatos adicionales:
{
"name": "My Remote Video",
"description": "A short description of the video",
"tags": ["remote", "fall_campaign"],
"reference_id": "myUniqueReferenceID"
}
Para obtener más información sobre la operación de creación de vídeo, consulte la Referencia de API.
Agregar copias
A continuación, agregue una o más copias remotas de vídeo de duración completa mediante una solicitud POST a:
https://cms.api.brightcove.com/v1/accounts/{account_id}/videos/{video_id}/assets/renditions
El JSON en el cuerpo de la solicitud debe contener mínimamente la url remota, pero puede contener otros metadatos para la copia:
{
"video_duration": 31487,
"name": "RA - Great Blue Heron",
"remote_url": "//learning-services-media.brightcove.com/videos/mp4/greatblueheron.mp4",
"encoding_rate": 983000,
"frame_height": 360,
"size": 3887659,
"frame_width": 640,
"video_codec": "h264",
"video_container": "MP4",
"progressive_download": true
}
Notas
- Utilice este extremo sólo para agregar copias de vídeo de longitud completa (normalmente un archivo.mp4 o .mov): para agregar secuencias segmentadas como HLS o DASH, utilice los extremos de manifiesto descritos en la siguiente sección.
-
Video Cloud no inspecciona los archivos de vídeo remotos, por lo que si proporciona metadatos adicionales, Video Cloud podrá mostrar esta información en Studio (o en el reproductor de Brightcove, si configura el reproductor para mostrar los metadatos).
Para obtener más información sobre la operación de adición de copia, consulte Referencia de API.
- Las representaciones de activos remotos deben tener la
video_codec
yvideo_container
campos para que funcionen correctamente. - Las copias MP4 deben tener el
"progressive_download": true
campo configurado para que funcione correctamente en el reproductor de Brightcove - No se permiten activos mixtos: no se puede agregar una copia remota a un vídeo ingerido
- Si su CDN u otro repositorio remoto admite la entrega HTTP y HTTPS, especifique la URL para los activos remotos con una URL neutral de protocolo como se muestra en el ejemplo anterior (es decir, use «//mi.dominio/path/...» en lugar de "http://my.domain/path/...»)
Añadir manifiestos
Tenga en cuenta que para agregar tipos segmentados remotos como copias DASH y HLS, solo necesita crear el vídeo y luego agregar los manifiestos; no necesita «agregar copias» como se explicó en la sección anterior.
Además de agregar copias de longitud completa, también puede agregar manifiestos para copias segmentadas como HLS, HDS e ISM, realizando una solicitud POST al extremo para el tipo de manifiesto:
https://cms.api.brightcove.com/v1/accounts/{account_id}/videos/{video_id}/assets/hls_manifest
https://cms.api.brightcove.com/v1/accounts/{account_id}/videos/{video_id}/assets/hds_manifest
https://cms.api.brightcove.com/v1/accounts/{account_id}/videos/{video_id}/assets/ism_manifest
https://cms.api.brightcove.com/v1/accounts/{account_id}/videos/{video_id}/assets/ismc_manifest
https://cms.api.brightcove.com/v1/accounts/{account_id}/videos/{video_id}/assets/dash_manifests
En el cuerpo de solicitud JSON, proporcione la url remota y un nombre (opcional):
{
"remote_url": "http://learning-services-media.brightcove.com/avideo/hls/chickadee/chickadee.m3u8",
"name": "chickadee_hls"
}
Para obtener más información sobre el uso de las operaciones de adición de manifiesto, consulte la sección correspondiente de la Referencia de API:
Añadir cartel o miniatura
Puede agregar un póster remoto y una miniatura al vídeo realizando solicitudes POST a estos extremos:
https://cms.api.brightcove.com/v1/accounts/{account_id}/videos/{video_id}/assets/poster
https://cms.api.brightcove.com/v1/accounts/{account_id}/videos/{video_id}/assets/thumbnail
En el cuerpo de solicitud JSON, debe incluir la url remota para la imagen, y puede agregar un nombre si lo desea:
{
"remote_url": "http://learning-services-media.brightcove.com/images/great-blue-heron-poster.png"
}
Para obtener más información sobre las operaciones, consulte la Referencia de API:
Añadir pistas de texto
Las pistas de texto se pueden utilizar para agregar subtítulos, capítulos y otros metadatos basados en tiempo al vídeo.
A diferencia de las representaciones y las imágenes, las pistas de texto se tratan igual para los vídeos de activos remotos que para los vídeos que se ingieren en el sistema de Video Cloud. Para agregar realmente las pistas de texto a un video, debe usar el módulo de Medios en Studio o el CMS API Actualizar operación de video.
Reemplazar el control remoto por ingerido
Puede reemplazar un vídeo de activo remoto por uno ingerido haciendo una solicitud a la API de ingesta dinámica:
https://ingest.api.brightcove.com/v1/accounts/{account_id}/videos/{video_id}/ingest-requests
El cuerpo de solicitud más simple se vería así:
{
"master": {
"url": "http://host/master.mp4"
}
}
Consulte la Referencia de API de ingesta dinámica para obtener más opciones e información.
Uno de los usos comunes de los vídeos de activos remotos es crear un vídeo marcador de posición para su uso en un evento de transmisión en vivo. Una vez completado el evento, es posible que desee reemplazar el vídeo «en directo» por una grabación de vídeo a la carta del evento que aparece en el mismo reproductor que utilizó para la transmisión en directo. Puede hacerlo utilizando el método descrito anteriormente, aunque también se puede utilizar para convertir cualquier vídeo de activo remoto en uno que se ingiera en Video Cloud.
Modificar activos
Además de agregar activos remotos para un vídeo, también hay operaciones para recuperar, actualizar y eliminar la información del activo. Estas operaciones utilizan los extremos descritos anteriormente, pero con solicitudes GET, PATCH o DELETE. Para las solicitudes de actualización y eliminación, debe agregar el identificador de activo (que se incluye en la respuesta a las solicitudes POST y GET) para solicitar la URL:
https://cms.api.brightcove.com/v1/accounts/{account_id}/videos/{video_id}/assets/{asset_type}/{asset_id}
Consulte la Referencia de API para obtener información detallada sobre las operaciones de obtener, actualizar y eliminar.