Video Playback
Protocols for video playback
Flussonic Media Server can play video streams via various protocols. Click the stream name on the Media — Streams tab, then go to the Output tab to see all available playback URLs. You can copy each URL to the clipboard by clicking the "Copy" button on the right next to the corresponding URL.
Below you will find a bit more detailed descriptions of the URL addresses that you should use in players in order to play video via different protocols with links to sections that provide more information about configuring the playback via each certain protocol. You can also play a stream in the Preview Player directly in the Flussonic UI.
Additionally, you can manage video playback via the Streaming API.
Restricting certain protocols
By default, playback via all protocols is allowed, but you can prohibit playback via the selected protocols (Except) or allow only certain protocols (Only) with the switch to the left of each of the URLs on the Output tab. This feature is useful not only for security, but also for reducing the load on the server: packing into all available protocols can consume a lot of resources.
These settings can be done in the config file as well. For example, you can allow all protocols except MPEG-TS and HLS for the stream channel_01
(corresponds to Except switch position):
stream channel_01 {
protocols -mpegts -hls;
}
To allow only DASH playback and API requests for the stream channel_02
and disable other protocols (corresponds to Only switch position):
stream channel_02 {
protocols dash api;
}
embed.html
URL: http://FLUSSONIC-IP/STREAMNAME/embed.html
Flussonic Media Server has a special page embed.html which is intended for video insertion to a website or viewing of video via a browser. The page automatically detects a browser version to select a supported protocol. For the majority of devices for today — it's HLS. Read more in the Video insertion on the website (embed.html) article.
The complete OpenAPI specification: Streaming API.
HLS
URL for the player: http://FLUSSONIC-IP/STREAMNAME/index.m3u8
Read more in HLS playback. Use (embed.html)or any third-party player to insert HLS stream on your website. For example, hls.js or clappr.
The complete OpenAPI specification: Streaming API.
DASH
The stream is available at the URL:
http://FLUSSONIC-IP/STREAMNAME/index.mpd
Read more in DASH playback.
The complete OpenAPI specification: Streaming API.
MSE-LD
URL for the player: ws://FLUSSONIC-IP/STREAMNAME/mse_ld
HTML5 (MSE-LD)
The stream played through HTML5 is available at the URL: http://FLUSSONIC-IP/STREAMNAME/embed.html?realtime=true
Read more in HTML5 (MSE) low latency playback.
MSS
The stream is available at the URL: http://FLUSSONIC-IP/STREAMNAME.isml/manifest
Read more in MSS Playback.
The complete OpenAPI specification: Streaming API.
HTTP MPEG-TS
The stream is available at the URL: http://FLUSSONIC-IP/STREAMNAME/mpegts
HTTP MPEG-TS relative timeshift
The URL for HTTP MPEG-TS playback with relative timeshift:
http://FLUSSONIC-IP:PORT/STREAM_NAME/timeshift_rel-3600.ts
In this example, the recorded stream will be played with one hour (3600 seconds) delay.
HTTP MPEG-TS absolute timeshift
The URL for HTTP MPEG-TS playback with absolute timeshift:
http://FLUSSONIC-IP:PORT/STREAM_NAME/timeshift_abs-1643257722.ts
.
A fragment of an archive can be retrieved not on the full speed, but in the streaming mode, over a time equal to the length of the fragment.
RTMP
The stream is available at the URL:
rtmp://FLUSSONIC-IP/static/STREAMNAME
RTSP
The stream is available at the URL:
rtsp://FLUSSONIC-IP/STREAMNAME
If a stream has several audio and video tracks, Flussonic uses the first track by default (a1v1).
You can specify which tracks Flussonic must deliver. For this, specify track numbers in the filter.tracks
parameter of the stream's URL.
Examples:
rtsp://FLUSSONIC-IP/STREAMNAME?filter.tracks=a2v1
rtsp://FLUSSONIC-IP/vod/file?filter.tracks=a2v1
— VOD.rtsp://FLUSSONIC-IP/STREAMNAME2 = rtsp://FLUSSONIC-IP/STREAMNAME1?filter.tracks=v1a1
Selecting only one track:
rtsp://FLUSSONIC-IP/STREAMNAME?filter.tracks=a1
— select an audio track.rtsp://FLUSSONIC-IP/STREAMNAME?filter.tracks=v1
— select a video track.
If you specify more than two tracks or make a syntax error, the default tracks will be used (a1v1).
WebRTC
WebRTC WHEP is available at the URL:
ws://FLUSSONIC-IP/STREAM_NAME/whap
Read more about our WebRTC player and how to organize playback in WebRTC Playback.
The complete OpenAPI specification: Streaming API.
SHOUTcast
The stream is available at the URL: http://FLUSSONIC-IP/STREAMNAME/shoutcast
Flussonic Media Server can deliver SHOUTcast, ICEcast radio stream.
The complete OpenAPI specification: Streaming API.
SRT
Flussonic supports playing SRT streams.
SRT protocol offers three modes: Caller, Listener, and Rendezvous. Flussonic acts as a Listener during a playback. It waits for a connection and, as soon as it is established, it starts to communicate with the Caller.
SRT port is usually configured per stream, i.e. one SRT stream per port. Nevertheless, Flussonic provides you with the way to set up a single SRT port for multiple streams. For example, if you use SRT for restreaming only, it may come in handy.
Read more about SRT playback in SRT Playback.
Getting data about played stream
You can make API requests to receive the information about the played stream. You can integrate the received data into any external system like site, monitoring, player, or mobile application.
The URL for getting technical information about the output media content:
http://FLUSSONIC-IP/STREAM_NAME/media_info.json
The URL for getting the information about DVR recording status of a stream:
http://FLUSSONIC-IP/STREAM_NAME/recording_status.json
Preview Player in Flussonic UI
You can play a stream directly in Flussonic UI using the Preview Player. This player allows to play a stream via HLS, MSE-LD, or DASH protocol. Additionally, DVR playback is available for streams with DVR enabled. The Preview Player uses the special embed.html page (for details, see Adding Video to Websites) with corresponding parameters.
To open the Preview Player, go to Media > Streams and click the Play button next to the corresponding stream.
In the opened window choose one of the tabs and start playing. The following tabs are available:
- HLS — for HLS playback. The player will use
embed.html
page. - MSE — for HTML (MSE-LD) low latency playback. The player will use
embed.html?realtime=true
page. - DASH — for DASH playback. The player will use
embed.html?proto=dash
page. - DVR — for DVR archive playback (if DVR is enabled). The player will use
embed.html?dvr=true
page. You can read more about the settings of DVR player in the Viewing the DVR recordings from the web interface chapter.
In the bottom of the Preview Player window you can see HTML code for inserting the corresponding player into a web page.
To close the Preview Player window, press Esc.