Formato de URL para acesso HLS

Descrição dos formatos de URL para acessar streams HLS, abrangendo conteúdo ao vivo, com time-shift (DVR) e sob demanda (VOD).

Todas as URLs são relativas ao servidor OTT: http://<server-address>:<ott-port>. A porta OTT é definida no assistente de configuração e pode ser alterada em Settings → HTTP Servers.

1. Estrutura da URL

Caminho base: /<channel_name> (por exemplo, /discovery)
Caminho da variante (multi-bitrate): /<channel_name>/<variant> (por exemplo, /discovery/1080p)
Nomes de arquivo (padrão, configuráveis em HLS Access):
- index.m3u8: ponto de acesso principal para conteúdo ao vivo e sob demanda
  - Sem parâmetros: transmite o conteúdo ao vivo
  - Com o parâmetro start: fornece conteúdo com time-shift
- media.m3u8 – acesso direto ao conteúdo ao vivo sem criação de sessão
- vod.m3u8 – acesso direto ao conteúdo sob demanda sem criação de sessão; a URL inclui os parâmetros start e duration

2. Playlist de índice (modo Stream)

URL:

  /<channel_name>/index.m3u8

ou com parâmetros opcionais:

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

start (opcional):
- Relativo: segundos antes de agora (por exemplo, -300)
- Absoluto: timestamp Unix (por exemplo, 1747485787)
duration (opcional): duração da reprodução em segundos

Exemplos:

# 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. Playlist de índice com timestamp incorporado (comportamento semelhante ao Flussonic)

Sintaxe alternativa em que os parâmetros são incorporados ao nome do arquivo em vez de na query string. Os prefixos index- e archive- são ambos suportados para compatibilidade com o comportamento semelhante ao Flussonic.

URL:

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

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

timestamp: timestamp Unix (por exemplo, 1747485787)
duration: duração da reprodução em segundos (use now para ilimitado/ao vivo)

Exemplos:

# 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. Playlist de mídia (ao vivo)

URL:

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

Transmite os segmentos ao vivo atuais
Sem parâmetros de consulta
Use o caminho da variante para reprodução multi-bitrate

4. Playlist VOD (sob demanda)

URL:

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

start: relativo ou absoluto
duration: obrigatório

Exemplos:

# 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	Descrição
`start`	relativo/absoluto	Hora de início da reprodução (deslocamento ou hora Unix)
`duration`	segundos	Duração da reprodução

6. Códigos de resposta

Código	Descrição
`400`	URL ou parâmetros inválidos. Por exemplo, `vod.m3u8` sem `start` e `duration`
`403`	Acesso negado pela autorização
`404`	Canal não encontrado ou não está em execução
`410`	Os dados de mídia ainda não estão prontos
`425`	A playlist ainda não está pronta. Aguarde alguns segundos após o início ou a reinicialização do canal

7. Observações sobre a reprodução

Acesso: público por padrão. Ative a autenticação se necessário.
Pausa/Busca:
- Index: retrocesso limitado
- VOD: busca completa dentro do intervalo solicitado
Multi-bitrate:
- index.m3u8 lista as variantes disponíveis
- As URLs media.m3u8 e vod.m3u8 com o nome da variante forçam uma variante específica. index.m3u8 está disponível apenas sem variante
Arquivo: o acesso a VOD ou ao índice com time-shift exige que o arquivo esteja ativado (um Armazenamento deve ser atribuído nas configurações do canal)