Activos remotos

Resumen

Los activos remotos se agregan principalmente a través de la 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 para activos remotos.

Autorización

Flujo de trabajo

Estos son los pasos para configurar un activo remoto:

En las siguientes secciones, veremos cada uno de estos pasos.

Crea el video

Antes de que pueda agregar activos remotos, debe crear un objeto de video en su biblioteca de medios de Video Cloud, utilizando la solicitud POST para:

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

En el cuerpo de la solicitud, incluye un objeto JSON que contenga como mínimo el nombre del video, pero puede contener metadatos adicionales:

      {
        "name": "My Remote Video",
        "description": "A short description of the video",
        "tags": ["remote", "fall_campaign"],
        "reference_id": "myUniqueReferenceID"
      }
      
      

Para obtener detalles sobre la operación de creación de video, consulte la Referencia de API.

Agregar copias

A continuación, agregue una o más representaciones de video remotas de larga duración realizando una solicitud POST para:

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

El JSON en el cuerpo de la solicitud debe contener como mínimo la URL remota, pero puede contener otros metadatos para la interpretación:

      {
        "video_duration": 31487,
        "name": "RA - Great Blue Heron",
        "remote_url": "//some.site.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

1. Use este punto final solo para agregar representaciones de video de larga duración (generalmente un archivo .mp4 o .mov); para agregar secuencias segmentadas como HLS o DASH, use los puntos finales de manifiesto que se describen en la siguiente sección.

2. Video Cloud no inspecciona los archivos de video remotos, por lo que proporcionar metadatos adicionales permitirá que Video Cloud muestre esta información en Studio (o en el reproductor Brightcove, si configura el reproductor para mostrar los metadatos).

   Para obtener detalles sobre la operación de adición de representación, consulte la Referencia de API.

3. Las representaciones de activos remotos deben tener la video_codec y video_container campos para que funcionen correctamente.
4. Reproducciones MP4 deber tener el "progressive_download": true campo configurado para funcionar correctamente en el reproductor Brightcove
5. No se permiten activos mixtos: no puede agregar una interpretación remota a un video ingerido
6. Si su CDN u otro repositorio remoto admite la entrega de HTTP y HTTPS, especifique la URL para los activos remotos con un URL de protocolo neutral como se muestra en el ejemplo anterior (es decir, use "//my.domain/path/..." en lugar de "https://my.domain/path/...")

Agregar manifiestos

Tenga en cuenta que para agregar tipos segmentados remotos, como representaciones DASH y HLS, solo necesita crear el video y luego agregar los manifiestos, lo hace no necesita "agregar representaciones" como se explica en la sección anterior.

Además de agregar representaciones completas, también puede agregar manifiestos para representaciones segmentadas como HLS, HDS e ISM, realizando una solicitud POST al punto final 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 JSON del cuerpo de la solicitud, proporcione la URL remota y un nombre (opcional):

      {
        "remote_url": "https://some.site.com/avideo/hls/chickadee/chickadee.m3u8",
        "name": "chickadee_hls"
      }
      
      

Para obtener detalles sobre el uso de las operaciones de agregar manifiesto, consulte la sección correspondiente de la Referencia de API:

• Agregar manifiesto de HLS
• Agregar manifiesto HDS
• Agregar manifiesto ISM
• Agregar manifiesto ISMC
• Agregar manifiesto DASH

Agregar póster / miniatura

Puede agregar un póster remoto y una miniatura a su video realizando solicitudes POST a estos puntos finales:

      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 JSON del cuerpo de la solicitud, debe incluir la URL remota de la imagen y puede agregar un nombre si lo desea:

      {
        "remote_url": "https://some.site.com/images/great-blue-heron-poster.png"
      }
      
      

Para obtener detalles de las operaciones, consulte la Referencia de API:

• Agregar póster
• Agregar miniatura

Agregar pistas de texto

Las pistas de texto se pueden usar para agregar leyendas, capítulos y otros metadatos basados en el tiempo a su video.

A diferencia de las representaciones e imágenes, las pistas de texto se tratan de la misma manera para los videos de activos remotos que para los videos ingeridos en el sistema 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 control remoto con ingerido

Puede reemplazar un video de activos remotos con uno ingerido haciendo una solicitud a la API de Dynamic Ingest:

      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": "https://host/master.mp4"
        }
      }
      
      

Ver el Referencia de API de ingesta dinámica para obtener información y opciones adicionales.

Uno de los usos comunes de los videos de activos remotos es crear un video de marcador de posición para usar en un evento de transmisión en vivo. Una vez que se complete el evento, es posible que desee reemplazar el video "en vivo" con una grabación de video a pedido del evento que aparece en el mismo reproductor que utilizó para la transmisión en vivo. Puede hacer esto mediante el método descrito anteriormente, aunque también se puede usar para convertir cualquier video activo remoto en uno que se ingiera en Video Cloud.

Modificar activos

Además de agregar activos remotos para un video, también existen operaciones para recuperar, actualizar y eliminar la información del activo. Estas operaciones utilizan los puntos finales descritos anteriormente, pero con solicitudes GET, PATCH o DELETE. Para las solicitudes de actualización y eliminación, debe agregar el ID del 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}
      
      

Ver el Referencia de API para obtener detalles sobre las operaciones de obtención, actualización y eliminación.

Limitaciones