Archivos remotos

Resumen

Los archivos remotos se agregan principalmente a través del Operaciones de archivos , con un par de excepciones indicadas a continuación. Tenga en cuenta que las operaciones GET para activos se pueden usar para archivos tanto ingeridos como remotos.

Autorización

Flujo de Trabajo

Estos son los pasos para configurar un archivos remoto:

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

Para todas las solicitudes a los puntos finales de los activos, puede especificar el video en el que está operando id or Identificación de referencia:

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

Crea el video

Antes de que pueda agregar recursos remotos, debe crear un objeto de video en su Video Cloud biblioteca multimedia, 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 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 más información sobre la operación de creación de video, consulte la Referencia de la API.

Agregar Rendiciones

A continuación, agregue una o más representaciones remotas de video remotas haciendo 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 representación:

      {
        "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
      }

<b>Notas</b>

Use este punto final solo para agregar interpretaciones de video de longitud completa (por lo general, 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.
Video Cloud no inspecciona los archivos de video remotos, por lo que se habilitarán metadatos adicionales Video Cloud para mostrar esta información en Studio (o en el Brightcove player, si configura el player para mostrar los metadatos).

Para obtener detalles sobre la operación de adición de representación, consulte la Referencia de la API.
Las concesiones para activos remotos deben tener el video_codec y video_container campos para que funcionen correctamente
Interpretaciones MP4 tienes tienen el "progressive_download": true campo configurado para funcionar correctamente en el Brightcove player
No se permiten activos mixtos: no puede agregar una representación remota a un video ingerido.
Si su CDN u otro repositorio remoto admite la entrega HTTP y HTTPS, especifique la URL para los activos remotos con un URL neutral al protocolo como se muestra en el ejemplo anterior (es decir, use "//my.domain/path / ..." en lugar de "http: //my.domain/path / ...")

Agregar manifiestos

Tenga en cuenta que para agregar tipos de segmentación remota, como las versiones DASH y HLS, solo necesita crear el video y luego agregar los manifiestos. no necesita "agregar entregas" como se explicó en la sección anterior.

Además de agregar representaciones completas, también puede agregar manifiestos para representaciones segmentadas, como HLS, HDS e ISM, haciendo 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 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 detalles sobre el uso de las operaciones de agregar manifiesto, consulte la sección correspondiente de la Referencia de API:

Añadir póster / miniatura

Puede agregar un póster y una miniatura remotos 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 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 detalles de las operaciones, consulte la Referencia de API:

Añadir pistas de texto

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

A diferencia de las copias 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 la Video Cloud sistema. Para agregar realmente las pistas de texto a un video, debe usar el módulo multimedia en Studio o el CMS API Actualización de la operación de video.

Reemplace el control remoto con ingerido

Puede reemplazar un video activo remoto con uno ingerido haciendo una solicitud al Dynamic Ingest API:

      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"
        }
      }

ver el Dynamic Ingest API Referencia para opciones e información 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 live evento de transmisión. Una vez que se complete el evento, es posible que desee reemplazar el "live"video con una grabación de video a pedido del evento que aparece en el mismo player que usaste para el live corriente. Puede hacer esto usando 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 los activos

Además de agregar activos remotos para un video, también hay operaciones para recuperar, actualizar y eliminar la información de los activos. 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 la identificación 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 la API para obtener detalles de las operaciones de obtención, actualización y eliminación.

Limitaciones

SSAI is not supported for remote assets.

DRM is supported only if you can customize the player to communicate with the DRM license server. This is possible with the Brightcove Player through a plugin. For other players, you will need to consult the player documentación.

Analytics: the Brightcove Analytics system depends on system-generated video metadata, such as the video duration. Analytics data for remote assets will be less rich unless you can provide this metadata for the remote asset.

Playback guarantee: all videos ingested into Video Cloud can be played back in the Brightcove Player. This is true for almost all remote assets, but there are some edge cases where videos may not play. There are a few advanced features of DASH and HLS that we do not yet support for example. For non-Brightcove players, you will need to verify that the video format is fully supported by that player.