Formato de URL para acceso HLS

Descripción de los formatos de URL para acceder a las transmisiones HLS, que abarcan contenido en vivo, con desplazamiento temporal (DVR) y bajo demanda (VOD).

Todas las URL son relativas al servidor OTT: http://<server-address>:<ott-port>. El puerto OTT se define en el asistente de configuración y se puede cambiar en Settings → HTTP Servers.

1. Estructura de la URL

Ruta base: /<channel_name> (p. ej., /discovery)
Ruta de variante (multi-bitrate): /<channel_name>/<variant> (p. ej., /discovery/1080p)
Nombres de archivo (predeterminados, configurables en Acceso HLS):
- index.m3u8: Punto de acceso principal tanto para contenido en vivo como bajo demanda
  - Sin parámetros: Transmite contenido en vivo
  - Con el parámetro start: Proporciona contenido con desplazamiento temporal
- media.m3u8 – Acceso directo al contenido en vivo sin crear una sesión
- vod.m3u8 – Acceso directo al contenido bajo demanda sin crear una sesión; la URL incluye los parámetros start y duration

2. Lista de reproducción Index (modo de transmisión)

URL:

  /<channel_name>/index.m3u8

o con parámetros opcionales:

/<channel_name>/index.m3u8?start=<time>&duration=<sec>

start (opcional):
- Relativo: Segundos antes de ahora (p. ej., -300)
- Absoluto: Marca de tiempo Unix (p. ej., 1747485787)
duration (opcional): Duración de la reproducción en segundos

Ejemplos:

# 5 minutes ago to now
/discovery/index.m3u8?start=-300

# 40-second segment from a timestamp
/discovery/index.m3u8?start=1747485787&duration=40

2.1. Lista de reproducción Index con marca de tiempo incrustada (comportamiento similar a Flussonic)

Sintaxis alternativa en la que los parámetros se incrustan en el nombre del archivo en lugar de en la cadena de consulta. Se admiten los prefijos index- y archive- por compatibilidad con el comportamiento similar a Flussonic.

URL:

/<channel_name>/index-<timestamp>-<duration>.m3u8

/<channel_name>/archive-<timestamp>-<duration>.m3u8

timestamp: Marca de tiempo Unix (p. ej., 1747485787)
duration: Duración de la reproducción en segundos (use now para ilimitado/en vivo)

Ejemplos:

# 15-minute segment from specific timestamp
/discovery/index-1747485787-900.m3u8

# Live stream from specific timestamp (increased constantly)
/discovery/index-1747485787-now.m3u8

# Same using `archive-` prefix
/discovery/archive-1747485787-900.m3u8

3. Lista de reproducción Media (en vivo)

URL:

/<channel_name>/<variant>/media.m3u8

Transmite los segmentos en vivo actuales
Sin parámetros de consulta
Use la ruta de variante para la reproducción multi-bitrate

4. Lista de reproducción VOD (bajo demanda)

URL:

/<channel_name>/<variant>/vod.m3u8?start=<time>&duration=<sec>

start: Relativo o absoluto
duration: Obligatorio

Ejemplos:

# 30s clip from 100s ago for SD variant
/discovery/sd/vod.m3u8?start=-100&duration=30

# 30s clip from timestamp using variant
/discovery/hd/vod.m3u8?start=1747485787&duration=30

5. Parámetros de consulta

Parámetro	Tipo	Descripción
`start`	relativo/absoluto	Hora de inicio de la reproducción (desplazamiento u hora Unix)
`duration`	segundos	Duración de la reproducción

6. Códigos de respuesta

Código	Descripción
`400`	URL o parámetros no válidos. Por ejemplo, `vod.m3u8` sin `start` y `duration`
`403`	Acceso denegado por la autorización
`404`	Canal no encontrado o no está en ejecución
`410`	Los datos de medios aún no están listos
`425`	La lista de reproducción aún no está lista. Espere unos segundos después de iniciar o reiniciar el canal

7. Notas de reproducción

Acceso: Público de forma predeterminada. Active la autenticación si es necesario.
Pausa/Búsqueda:
- Index: Retroceso limitado
- VOD: Búsqueda completa dentro del rango solicitado
Multi-bitrate:
- index.m3u8 enumera las variantes disponibles
- Las URL de media.m3u8 y vod.m3u8 con el nombre de la variante fuerzan una variante específica. index.m3u8 está disponible solo sin variante
Archivo: El acceso a VOD o a index con desplazamiento temporal requiere que el archivo esté habilitado (se debe asignar un Almacenamiento en la configuración del canal)