API en vivo: Puntos de entrada estáticos

Este tema explica los puntos de entrada estáticos y cómo implementarlos usando la API en vivo.

Introducción

La función Static Entry Points (SEP) permite un trabajo en vivo de larga duración que se puede activar y desactivar mientras se mantienen las URL de los puntos de entrada y las URL de reproducción estáticas y reutilizables. Esta característica permite a los clientes configurar su codificador en sus instalaciones o en el campo y permite al cliente crear su propia lógica de programación para canales o programas en vivo.

DVR y SEP

La capacidad de DVR está disponible para puntos de entrada estáticos, pero solo mientras el SEP está activado.

Creando un punto de entrada estático

El estandar Crear trabajo Se utiliza la operación will, pero para la adición de puntos de entrada estáticos, será necesario agregar una propiedad a la solicitud de trabajo:

"static": true

La URL de RTMP que responde de este trabajo será estática y luego podrá reutilizarse activando / desactivando el trabajo con las operaciones descritas en las secciones siguientes. Lea y comprenda las limitaciones enumeradas al final de este documento.

Tiempo máximo de espera

Después de que se activa un trabajo SEP, se desactivará automáticamente después de un tiempo si no se inicia el codificador. Las reglas son las siguientes:

Si el event_length El valor es superior a 30 minutos, el trabajo terminará automáticamente en 30 minutos de forma predeterminada; si desea cambiar el tiempo de espera, deberá ponerse en contacto con el servicio de asistencia. La desactivación automática no se puede deshabilitar.
Si el event_length valor es inferior al reconnect_time, el trabajo finalizará en el tiempo establecido para event_length.

Activar SEP Live Stream

Para activar una transmisión en vivo de un punto de entrada estático, envíe la siguiente solicitud a la API en vivo:

Para poder ingerir a un punto de entrada estático, debe realizar la activate Solicitud de API.

Secuencia SEP activa
Método	`PUT`
Punto final	`https://api.bcovlive.io/v1/jobs/{jobID}/activate`

No se requiere ningún cuerpo de solicitud.

Desactivar SEP Live Stream

Para desactivar una transmisión en vivo de un punto de entrada estático, envíe la siguiente solicitud a la API en vivo:

Secuencia SEP activa
Método	`PUT`
Punto final	`https://api.bcovlive.io/v1/jobs/{jobID}/deactivate`

No se requiere ningún cuerpo de solicitud.

Cancelar un trabajo de SEP

Para detener permanentemente un trabajo de punto de entrada estático, puede cancelar el trabajo como lo haría con cualquier trabajo en vivo, enviando un PUT solicitar el punto final /jobs/{job_id}/cancel. Ver el Referencia de API para conocer todos los detalles.

Limitaciones

Live to VOD no se puede configurar para archivar la transmisión al finalizar.
Alternativas:
- Usar recorte para archivar el evento en vivo completo como un VOD. La ventana de recorte estará disponible durante la duración estándar después de un evento o hasta la próxima activación del SEP (lo que sea más corto).
La configuración del trabajo no se puede modificar. Actualmente están vinculados a la configuración que creó inicialmente el SEP.
La activación de la transmisión puede demorar hasta 60 segundos para que el punto de entrada esté disponible.
Mejores prácticas:

Implemente notificaciones desde la plataforma Live para cambios en el estado del trabajo para obtener actualizaciones en tiempo real para cuando un trabajo SEP esté realmente listo.

Alternativas:
1. Active la transmisión al menos 60 segundos antes de iniciar el codificador.
2. Si el codificador tiene reintento incorporado (Wirecast, Elemental, etc.), la transmisión se puede conectar inmediatamente (aunque puede haber algunos errores) y los codificadores se volverán a conectar tan pronto como el punto de entrada esté disponible.
Reconnect_time sigue siendo aplicable para trabajos SEP en desconexiones del codificador. Si se alcanza el tiempo de reconexión, el trabajo SEP se colocará de nuevo en un estado desactivado.
Mejores prácticas:

Desactive siempre una transmisión a través de las API cuando se complete un trabajo y establezca el tiempo de reconexión en un período de tiempo aceptable para esperar en caso de una desconexión (los costos de las horas de entrada se acumulan durante este período de espera).
A cada cuenta solo se le asignarán 3 trabajos SEP disponibles por región. Si alcanza el límite, deberá cancelar uno de sus trabajos SEP antes de poder crear uno nuevo.
Si ha alcanzado el número máximo de trabajos SEP e intenta crear otro, se devolverá el siguiente error:
```
{
  "error": "You've reached the number of static entry points jobs you can create for your account"
}
```

Si intenta activar más de 5 trabajos SEP a la vez, recibirá un error como el siguiente:

{
  “message”:“Allocating additional streaming capacity to the region. Please retry your request.: no_streaming_capacity_in_region”,
  “statusCode”:500,
  “name”:“ApiError”,
  “isApiError”:true
}

Deberá esperar hasta que algunos trabajos hayan terminado de activarse antes de volver a intentar la solicitud.

Notas

Recorte de trabajos SEP después de la desactivación: Los usuarios pueden crear clips hasta la próxima activación de la transmisión, o durante 7 días, lo que sea más corto. Cuando se reactiva la transmisión, las sesiones de grabación anteriores se eliminan del servidor y ya no se pueden recortar.
¿Cuál es el tiempo para el campo stream_start_time cuando se usa un SEP?: Cuando se activa un SEP, se consideraría la hora de inicio.