Видеоплейбэк и перевод “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

The complete OpenAPI specification: Streaming API.

HLS

URL for the player: http://FLUSSONIC-IP/STREAMNAME/index.m3u8

The complete OpenAPI specification: Streaming API.

DASH

The stream is available at the URL:
http://FLUSSONIC-IP/STREAMNAME/index.mpd

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

MSS

The stream is available at the URL: http://FLUSSONIC-IP/STREAMNAME.isml/manifest

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:

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:

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.

• 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

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.

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:

The URL for getting the information about DVR recording status of a stream:

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.

• 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.

Flussonic Media Server supports playing video via the DASH protocol.

The supported codecs are: H264, H265, AAC, MP3, and AC-3.

Flussonic Media Server supports access via MPEG-DASH to live streams, VOD files, and DVR (catchup and timeshift).

If an incoming stream has DVB subtitles, then Flussonic can pass them to an output MPEG-DASH stream if you configure Flussonic for that. Subtitles are saved in DVR archive if a stream is recorded to the archive.

DASH uses a manifest file for transmitting information about a requested stream. To keep it simple, we call it ‘playlist’ here.

On this page:

Simple video playback via DASH

When you have a live stream or file (one video track, one audio track) for playing, the URL for playback via DASH is simple:

http://FLUSSONIC-IP/STREAMNAME/index.mpd

where flussonic-ip is a placeholder for your Flussonic Media Server host + port address.

Playing back individual tracks

If a stream has several audio and video tracks, you can specify which tracks should be delivered. For this, specify track numbers by adding ?filter.tracks= to the stream’s URL.

Select the first audio and second video tracks:

http://FLUSSONIC-IP/STREAMNAME/index.mpd?filter.tracks=v2a1

Select video only:

http://FLUSSONIC-IP/STREAMNAME/index.mpd?filter.tracks=v1

DVR archive playback starting from UTC 1362504585 and with the duration of 3600 seconds:

http://FLUSSONIC-IP/STREAMNAME/archive-1362504585-3600.mpd?filter.tracks=v2a1

The obsolete filter=tracks: syntax is still supported but the filter.tracks= syntax is recommended.

DVR catchup playback via DASH

When your stream is already recorded on a server with our DVR, you can play video via DASH if you know the beginning and ending time of telecast, for example, from EPG.

URLs for playing video from archives will be like this:

http://FLUSSONIC-IP/STREAMNAME/archive-1362504585-3600.mpd

Such a URL will give a list of segments starting from UTC 1362504585 (2013, March, 5th, 17:29:45 GMT) and for one hour forward (3600 seconds).

If you have more than one language or more than one bitrate, you will get an adaptive stream with the possibility to select the audio track.

Rewinding DASH videos

Flussonic Media Server has a special playlist “rewind-N.mpd” with a wide sliding window that allows you to rewind DASH streams and pause them for many hours.

http://FLUSSONIC-IP/STREAMNAME/rewind-7200.mpd

Here 7200 is the duration of the DASH manifest in seconds, so your clients will be able to pause the stream for up to 2 hours or rewind to the start of a TV show without using catchup URLs.

http://FLUSSONIC-IP/STREAMNAME/archive-1362504585-now.mpd

DVR timeshift playback

Here we descibe one more way to play an archive via DASH with the option to rewind up to the specified time. If you haven’t configured a timeshifted stream, you can still play timeshifted video via DASH by using a propely constructed URL.

Here goes the example of an URL for absolute timeshift:

http://FLUSSONIC-IP/STREAMNAME/timeshift_abs-1584435600.mpd

The player will play live at the start and allow rewinding up to 1584435600.

DASH manifests for playing DVR on TVs with WebOS

Flussonic can create DASH manifest of two types: with multiple periods and with a single period.

Initially, Flussonic designed its DASH manifest for DVR playback with the view to usage in CDN. The manifest with multiple periods was suitable for this purpose.

However, such a manifest is incompatible with a wide range of devices and TV sets used by consumers in many countries, such as US. These include LG TVs on WebOS and others.

For devices that cannot play DASH with multi-period timeline, we designed a single-period manifest enabling you to play DASH on that devices.

http://FLUSSONIC-IP/STREAMNAME/archive-TIME-DURATION.mpd?period=mono

http://FLUSSONIC-IP/STREAMNAME/archive-TIME-now.mpd?period=mono

Note. The single-period manifest for live with the option to view the recorded archive (archive-TIME-now.mpd?period=mono) is sensitive to the quality of the input stream source — it is necessary that there are no gaps in the live stream.

Turning on DVB compliance of a DASH manifest

If you use a validator for DASH and you turn on checking for DVB compliance in the validator, you’ll need to make sure that your DASH manifests are compliant with the DVB profile.

In order to get a DVB-compliant manifest, add the option dvb=1 to the stream’s URL:

http://FLUSSONIC-IP/STREAMNAME/index.mpd?dvb=1

Playback with subtitles

Flussonic supports passing both TTML and WebVTT subtitles into DASH streams. This allows showing subtitles on a wider range of devices and set-top boxes.

Choosing subtitles format for DASH playback

As two formats of subtitles are included in a DASH manifest, you can choose one of them when playing an output stream:

https://FLUSSONIC-IP/STREAMNAME/index.mpd?text=wvtt

or (TTML is the default format)

https://FLUSSONIC-IP/STREAMNAME/index.mpd?text=ttml

The option text can be used also with URLs like:

http://FLUSSONIC-IP/STREAMNAME/rewind-7200.mpd?text=wvtt

DASH playback with thumbnails

It is possible to add thumbnails into DASH playlist as special tags that a player can read. It works both for streams with DVR enabled and for VOD files.

To include thumbnails into the playlist, add ?thumbnails= option to the stream or the VOD file URL.

Example for a DVR window:

Example for a VOD file:

This value defines how many thumbnail links will be added to the thumbnail playlist to cover the duration of the DVR window or the VOD file correspondingly. The player will add the thumbnail links to the progress bar at regular intervals. The duration of the interval between thumbnails is the whole duration of the DVR window or the VOD file divided by this value.

If you specify a big number, then the player will use additional resources which may make the player or the browser stuck. Decreasing this parameter allows to limit the number of thumbnails to play and thus to reduce the player resources usage.

This option requires the parameters thumbnails enabled=ondemand and size (thumbnail size) included in the stream or VOD location settings. For example, thumbnails enabled=ondemand size=320x240;. You can specify multiple sizes separated by spaces, for example, size=320x250 size=640x480. In this case, several thumbnails tracks will be included into the playlist. Each thumbnail in the playlist will be resized proportionally to fit the specified size.