Adición de puntos de referencia

Introducción

Los puntos de referencia son lugares especificados en la línea de tiempo del video. Cuando se reproduce el video, un evento se transmite automáticamente cada vez que se alcanza un punto de referencia; con la API del reproductor, puede escuchar estos eventos y realizar cualquier acción que desee. Además, puede leer toda la información de los puntos de referencia de los metadatos de vídeo almacenados en el reproductor. mediainfo objeto, que te permite marcar los puntos de referencia en la línea de tiempo del video de alguna manera si quieres.

Hay dos tipos de puntos de referencia:

• Puntos de referencia de anuncios: se utilizan para marcar lugares donde se debe realizar una solicitud de anuncio (si el video y el reproductor están habilitados para publicidad).
• Puntos de referencia de código: se utilizan para realizar alguna acción utilizando la API del reproductor; algunos usos típicos son mostrar algún tipo de llamado a la acción (CTA) o mostrar alguna imagen o texto relacionado con el contenido del video, tal vez como una superposición de video o en la página alrededor del reproductor.

Aplicación de muestra

Ver la pluma Ejemplo de API de CMS: Añadir puntos de referencia por los servicios de aprendizaje de Brightcove ( @rcrooks1969 ) en CódigoPen.

Resumen de la implementación

Puede agregar puntos de referencia en el módulo Studio Media. También puede agregarlos usando la API de CMS, que es el método que usaremos en esta muestra.

Método HTTP

Los puntos de referencia se pueden agregar cuando crea el video o más tarde con un solicitud de actualización. En esta muestra, los agregaremos a un video existente haciendo un actualización de video solicitud, lo que significa que utilizará el PATCH método.

Punto final

El punto final para la solicitud de actualización de video es:

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

Cuerpo de la solicitud

El cuerpo de la solicitud es un objeto JSON que puede contener muchos elementos de metadatos de video. Aquí solo veremos el cue_points field, que se establece en una matriz de objetos de puntos de referencia, como en el siguiente ejemplo:

          {
          "cue_points": [
              {
                "name": "Ad Cue Point",
                "type": "AD",
                "time": 2.0,
                "metadata": null,
                "force_stop": false
              },
              {
                "name": "Code Cue Point",
                "type": "CODE",
                "time": 4.0,
                "metadata": "The metadata might be text or the url for an image to display",
                "force_stop": true
              }
            ]
          }

Campos de objeto de punto de referencia

A continuación se muestra una descripción de los campos de los objetos de puntos de referencia.

Notas

• ^[1] Técnicamente, el punto de referencia está activo hasta que se alcanza el siguiente punto de referencia; por lo tanto, en la matriz de puntos de referencia que puede recuperar de Brightcove Player, verá un startTime y endTime también en un time para el punto de referencia.