soporte Contactar con Soporte | Estadoestado del sistema del sistema
Contenido de la página

    Activos remotos

    En este tema, aprenderá a agregar recursos remotos, incluidos vídeos, copias, manifiestos, imágenes y pistas de texto de WebVTT, a Video Cloud mediante la API de CMS. En este tema se explica cómo configurar el vídeo y, a continuación, agregar, actualizar y quitar activos remotos.

    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:

    <img class="bcls-image—no-border» alt="flujo de trabajo de activos remotos» src=» /assets/images/cms/managing-videos/remote-assets-workflow.svg «»/>
    Flujo de trabajo de activos

    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

    1. 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.
    2. 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.

    3. Las representaciones de activos remotos deben tener la video_codec y video_container campos para que funcionen correctamente.
    4. Las copias MP4 deben tener el "progressive_download": true campo configurado para que funcione correctamente en el reproductor de Brightcove
    5. No se permiten activos mixtos: no se puede agregar una copia remota a un vídeo ingerido
    6. 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.

    Limitaciones

  • SSAI no es compatible con activos remotos.
  • DRM sólo se admite si puede personalizar el reproductor para comunicarse con el servidor de licencias DRM. Esto es posible con Brightcove Player a través de un plugin. Para otros jugadores, tendrá que consultar la documentación del jugador.
  • Análisis: el sistema Brightcove Analytics depende de los metadatos de vídeo generados por el sistema, como la duración del vídeo. Los datos de análisis para activos remotos serán menos ricos a menos que pueda proporcionar estos metadatos para el activo remoto.
  • Garantía de reproducción: todos los vídeos ingeridos en Video Cloud pueden reproducirse en Brightcove Player. Esto es cierto para casi todos los activos remotos, pero hay algunos casos extremos en los que es posible que los vídeos no se reproduzcan. Hay algunas características avanzadas de DASH y HLS que aún no soportamos, por ejemplo. En el caso de reproductores que no sean de BrightCove, deberá verificar que el formato de vídeo es totalmente compatible con ese reproductor.

  • Última actualización de la página el 28-09-2020