API en vivo: Creación de clips VOD

Resumen

Los clips son videos extraídos de una transmisión en vivo. Se pueden enviar a un bucket de S3, un sitio FTP o un Video Cloud cuenta. El clip se crea como un video MP4, y eso es lo que se envía al destino en todos los casos. En el caso de Video Cloud , el sistema de ingesta transcodificará el MP4 y los tipos de representaciones que se creen para el video dependerán del perfil de ingesta utilizado.

Las definiciones de los clips se crean utilizando el /vods punto final.

Los clips se pueden crear de varias formas:

• Con stream_start_timecode y / o stream_end_timecode definido en los códigos de tiempo SMPTE para el evento de transmisión en vivo - tenga en cuenta que esto requiere que el codificador envíe información de código de tiempo
• Con start_time y/o end_time definido en relación con la hora de inicio ( stream_start_time ) de todo el evento de transmisión en vivo
• Con start_time y / o end_time definido en tiempo Epoch (Unix) (en segundos)
• Con duration
• Tanto Live API como Live Module admiten la creación de clips a partir de trabajos encriptados o protegidos con DRM.

Notas

1. Para que los clips estén disponibles lo más rápido posible, primero se crea un clip con precisión de segmento y luego se reemplaza por un clip con precisión de fotograma tan pronto como esté disponible.
2. Si lo especifica duration, el clip resultante será el siguiente:
   • Si el trabajo está activo y aún en vivo: (tiempo de solicitud - duración) a (tiempo de solicitud)
   • Si el trabajo está terminado: ( finished_at - duración) a ( finished_at)
3. Si especifica ambos start_time Y end_time:
   • Si el trabajo está activo y aún en vivo: siempre que la ventana de tiempo de Época se encuentre completamente dentro created_at y el tiempo de solicitud, se realizará el clip
   • Si el trabajo ha finalizado: siempre que la ventana de tiempo de época caiga completamente dentro created_at y finished_at, se realizará el clip
4. Clips de transmisiones en vivo usando SSAI no incluirá anuncios.
5. Los clips se pueden crear hasta 7 días después de un evento. Para SEP , se pueden crear hasta la próxima activación o 7 días (lo que sea más corto).
6. La API de VOD no agregará ningún contenido fuera de lo que está presente en la transmisión. Si especifica 350 en una transmisión en vivo de 300 segundos, la salida será de 300 segundos.
7. No es necesario que use una transmisión en vivo habilitada para DVR para que el recorte funcione, porque la transmisión en vivo se almacena mientras se transmite y está disponible de inmediato y durante 7 días después de que finaliza el evento.
8. El recorte de Brightcove Live solo producirá un clip que tenga la misma resolución que la salida de mayor resolución. No coincidirá con la resolución de entrada de la fuente (a menos que sea la misma que la salida con la resolución más alta).

Los clips también se pueden enviar a varios destinos:

• A Video Cloud cuenta
• Un servidor FTP
• Un cubo S3

Cuando especifica un clip, la salida deber Contiene ya sea a url destino o a videocloud objeto para detallar la creación del video y la ingestión del clip en Video Cloud.

Nota: clips se puede crear mientras se ejecuta la transmisión en vivo. Para hacer esto, deberá definir las horas de inicio y finalización del clip en tiempo de Época o en relación con comienzo hora de la transmisión en vivo.

Cartas credenciales

Si el destino al que está enviando el clip requiere credenciales para acceder, puede crearlas usando las operaciones de credenciales de Live API. Ver Administrar credenciales para la API en vivo para más detalles.

Punto final

Los clips se crean enviando un POST solicitud de:

https://api.bcovlive.io/v1/vods

Cuerpo de la solicitud - Video Cloud

Ejemplo 1: horas de inicio / finalización relativas al inicio de la transmisión

El cuerpo de la solicitud incluye las horas de inicio y finalización, y detalles sobre dónde enviar el clip. Aquí hay un cuerpo de solicitud de muestra que crea un clip del tercer minuto de una transmisión y lo envía a un Video Cloud cuenta:

{
  "live_job_id":"PUT-LIVE-JOB-ID-HERE",
  "outputs":[
    {
      "label": "60 secs by stream from min 2 to min 3",
      "stream_start_time": 120,
      "stream_end_time": 180,
      "credentials": "USER_VIDEOCLOUD_CREDENTIAL_LABEL",
      "videocloud": {
        "video": {
        "name": "One Minute Clip",
        "tags": ["live", "clip"]
        },
          "ingest": {
            "capture-images": true
        }
      }
    }
  ]
}

En este ejemplo, estamos creando un clip de un minuto de duración y enviándolo a Video Cloud . Le damos al clip un nombre y un par de etiquetas, sin especificar el ingest profile para retranscodificar, de modo que se utilice la cuenta predeterminada, e instruir Video Cloud para capturar imágenes en miniatura y póster del clip durante la transcodificación.

Ejemplo 2: horas de inicio / finalización en la época de la Época

El cuerpo de la solicitud incluye las horas de inicio y finalización en la época de Epoch y detalles sobre dónde enviar el clip. Aquí hay un cuerpo de solicitud de muestra que crea un clip del tercer minuto de una transmisión y lo envía a un Video Cloud cuenta:

{
  "live_job_id":"PUT-LIVE-JOB-ID-HERE",
    "outputs":[
      {
        "label": "60 secs - epoch time",
        "start_time": 1516652694,
        "end_time": 1516652754,
        "credentials": "USER_VIDEOCLOUD_CREDENTIAL_LABEL",
        "videocloud": {
          "video": {
          "name": "One Minute Clip",
          "tags": ["live", "clip"]
          },
            "ingest": {
            "capture-images": true
        }
      }
    }
  ]
}

En este ejemplo, estamos creando un clip de un minuto de duración en una época específica (en este caso, el 22 de enero de 2018 a las 08:24:54 GMT).

Ejemplo 3: duración con hora de inicio relativa al inicio de la transmisión

El cuerpo de la solicitud incluye la duración y stream_start_time, y detalles sobre dónde enviar el clip. Aquí hay un cuerpo de solicitud de muestra que crea un clip del tercer minuto de una transmisión y lo envía a un Video Cloud cuenta:

{
  "live_job_id":"PUT-LIVE-JOB-ID-HERE",
  "outputs":[
    {
      "label": "60 secs from start time",
      "stream_start_time": 300,
      "duration": 60,
      "credentials": "USER_VIDEOCLOUD_CREDENTIAL_LABEL",
      "videocloud": {
        "video": {
        "name": "One Minute Clip",
        "tags": ["live", "clip"]
        },
        "ingest": {
        "capture-images": true,
        "profile": "valid-ingest-profile-name"
        }
      }
    }
  ]
}

En este ejemplo, estamos creando un clip de un minuto de duración que comienza 5 minutos después del inicio de la transmisión en vivo.

Ejemplo 4: duración sin hora de inicio ni de finalización

El cuerpo de la solicitud incluye las horas de inicio y finalización en la época de Epoch y detalles sobre dónde enviar el clip. Aquí hay un cuerpo de solicitud de muestra que crea un clip del tercer minuto de una transmisión y lo envía a un Video Cloud cuenta:

{
  "live_job_id":"PUT-LIVE-JOB-ID-HERE",
  "outputs":[
    {
      "label": "60 secs - duration",
      "duration": 60,
      "credentials": "USER_VIDEOCLOUD_CREDENTIAL_LABEL",
      "videocloud": {
        "video": {
        "name": "One Minute Clip",
        "tags": ["live", "clip"]
        },
        "ingest": {
          "capture-images": true
        }
      },
      "notifications": ["https://myserver.com/api/notification_listener?type=jvod"]
    }
  ]
}

En este ejemplo, estamos creando un clip de un minuto de duración. Dado que no estamos especificando una hora de inicio o finalización, el clip se tomará de los últimos 60 segundos de la transmisión en vivo.

Ejemplo 5: usar stream_start_timecode y stream_end_timecode

El cuerpo de la solicitud incluye las horas / fotogramas de inicio y finalización en los códigos de tiempo HH: MM: SS: FF y detalles sobre dónde enviar el clip. Tenga en cuenta que para utilizar códigos de tiempo, el codificador debe enviar códigos de tiempo. Aquí hay un cuerpo de solicitud de muestra que crea un clip de los 50 minutos de una transmisión y lo envía a un Video Cloud cuenta:

{
  "live_job_id":"PUT-LIVE-JOB-ID-HERE",
  "outputs":[
    {
      "label": "Clipping using Timecode from-01:10:18:15 to-01:11:08:15",
      "stream_start_timecode": "01:10:18:15",
      "stream_end_timecode": "01:11:08:15",
      "credentials": "USER_VIDEOCLOUD_CREDENTIAL_LABEL",
      "videocloud": {
        "video": {
          "name": "Fifty Minute Clip",
          "tags": ["live", "clip"]
        },
        "ingest": {
        "capture-images": true
        }
      }
    },
    "notifications": ["https://myserver.com/api/notification_listener?type=jvod"]
  ]
}

Información general sobre el envío de clips a Video Cloud

Para ver qué campos se pueden incluir en el video y ingest objetos, ver el Dynamic Ingest API Reference.

{
  "live_job_id":"",
  "outputs":[
    {
      "label": "last_30",
      "duration": 30,
      "url": "s3://YOUR_BUCKET_NAME/file_name.mp4",
      "credentials": "s3-credentials",
      "notifications": ["https://myserver.com/api/notification_listener?type=jvod"]
    }
  ],
}

{
  "vod_jobs": [
    {
      "jvod_id": "9582606c50d84be5ad4bc104f2aa3360",
      "label": "last 60 secs of live job"
    }
  ],
  "live_job_id": "88ba5d87b61a4ef3a6dddabd0c38d319"
}