OTT serviceΒΆ

HTTP-based streams output - HLS and MPEG-TS over HTTP. HTTPS (SSL) is supported. Output is enabled on the OTT tab of Stream settings.

URLs for connections have format:

host and port - set in http server settings.

stream - stream ID. Not to be confused with the sequence number in streams list. ID is shown in stream stats page header and in streams list ID column, ID is set at stream creation and never changes.

Similarly for HLS:

Output URL templates and working status are shown on stream stats page. Unauthorized access is denied, all clients should be registered in Peers.

Additional HLS parameters are available in URL (optional):

[URL]?a=1&s=40&m=40&v=5

  • a: 1 - use absolute paths in playlist (default), 0 - relative paths.

  • s - dynamic play list duration (sec), default 40 sec.

  • m: dynamic playlist minimum duration (sec), 40 sec by default. Maximum play list duration is 60 sec. If current chunk buffer size is less than minimum in request, error 404 will be raised. This is done so that HLS would start with a full chunk buffer on the server.

  • v: HLS protocol version for play list, 5 by default. Version change may be required for some players.

File name index.m3u8 could be added to URL for some players support, for example: http://host:port/hls/stream/login/password/index.m3u8.

There are two modes supported for HLS server - Peer mode and OTT mode

Peer mode - simple chunks segmentation mode. Recommended for streams peering (streams distribution).

OTT mode - optimized chunks segmentation mode for players fast start. In this case CPU load is higher, recommended for broadcasting.

SSL (HTTPS) can be enabled for HTTP server, this is done in the server settings.

HLS Adaptive Multistream support is available starting from version 1.10.

HLS playlist should be configured for each adaptive stream. To do it:

  • Enable HLS with OTT mode for each stream you going to use in adaptive streams.

  • Streams Adaptive menu item will available in main menu. There you should add adaptive stream and select all streams you need for current adaptive stream playlist.

  • Bitrate parameter can be configured for each stream. Default is 0, which indicates to use measured stream bitrate. Otherwise you can configure it manually.

Adaptive stream URL is differ:

Peer (client) can have access list where adaptive streams are also available.Permission for an adaptive stream includes permissions for all streams that are included in it.