Skip to content

HLS

media.play.hls

Transporte

HTTP ou HTTPS; playlists e fragmentos usam requisições separadas por TCP.

Codecs compatíveis

Vídeo

  • H.264
  • HEVC
  • AV1

Áudio

  • AAC
  • MP3
  • MP2
  • AC-3
  • E-AC-3
  • Opus

Esta lista descreve a saída do Sapsan; a decodificação depende do reprodutor. As faixas também precisam de parâmetros de codec válidos para o contêiner selecionado.

Todo stream do Sapsan está disponível de imediato por HLS (fMP4/CMAF) sem configuração extra. Os streams ao vivo recebem por padrão LL-HLS com segmentos parciais.

As faixas de texto estruturadas geradas pelo Sapsan são entregues como WebVTT; teletexto ou legendas DVB em bitmap na entrada não constituem, por si só, uma faixa de texto pronta. Primeiro é necessário ativar a extração ou o reconhecimento correspondente.

Quando há uma faixa de legendas de texto, o LL-HLS é desativado para todo o stream: o HLS usa segmentos comuns. O suporte ao codec no reprodutor e a disponibilidade de LL-HLS são condições distintas.

URL de reprodução

O que URL
Playlist mestre (todas as qualidades) http://server/streaming/v/<stream>/index.m3u8
Playlist de uma única trilha http://server/streaming/v/<stream>/variant/<track>/index.m3u8
Rebobinamento (rewind) http://server/streaming/v/<stream>/rewind/<segundos-atrás>/index.m3u8
Arquivo por tempo absoluto http://server/streaming/v/<stream>/index.m3u8?from=<utc_ms>&to=<utc_ms>

A playlist mestre traz as qualidades com RESOLUTION, FRAME-RATE e CODECS; o áudio vai para grupos rendition (EXT-X-MEDIA). Áudio G.711 (PCMA/PCMU) não é servido por HLS — transcodifique esses streams para AAC primeiro.

HLS sobre MPEG-TS

Para set-top boxes que não reproduzem fMP4, o mesmo stream é entregue por HLS com segmentos MPEG-TS. Os endereços são os mesmos de cima, com um segmento de forma depois do nome do stream:

Forma Playlist mestre Para quem
áudio em trilhas separadas http://server/streaming/v/<stream>/ts/index.m3u8 set-top boxes que entendem EXT-X-MEDIA
áudio dentro do segmento de vídeo http://server/streaming/v/<stream>/ts/mux/index.m3u8 set-top boxes antigos: vídeo e áudio como um único programa em cada segmento

Selecione o arquivo nas duas disposições com ?from=<utc_ms>&to=<utc_ms>. O retrocesso está disponível para TS com faixas separadas: http://server/streaming/v/<stream>/ts/rewind/<seconds>/index.m3u8. A disposição mista ts/mux/ não tem URL de retrocesso.

Em ts/mux/, cada vídeo forma uma variante com todo o áudio publicado, até dez faixas de áudio. As legendas são omitidas. MPEG-TS não aceita LL-HLS. As duas disposições TS HLS têm uma lista de codecs menor que a saída MPEG-TS contínua:

  • H.264
  • HEVC
  • AAC
  • MP3
  • MP2
  • AC-3
  • E-AC-3

Qual forma as URLs do Flussonic (/<stream>/index.m3u8, video.m3u8 e outras) entregam está descrito na página de compatibilidade com o Flussonic. Os segmentos ts/mux/ incompletos e as montagens fora do cache aparecem nas estatísticas.

Tokens nas playlists

Se a reprodução estiver protegida por token, ?token= é acrescentado automaticamente a todas as URLs aninhadas da playlist: variantes, segmentos init, segmentos, partes e preload hints. Ao reprodutor basta abrir a playlist mestre com o token.

Quantidade de segmentos

O comprimento da playlist ao vivo é definido pelo parâmetro segments do stream:

Configure estas opções pelo central na config do streamer.

streams:
  - name: tv1
    inputs:
    - udp: {host: 239.0.0.1, port: 5000}
    segments: 6

O que vem a seguir