Elecard HLS Source

Elecard HLS Source is a GStreamer plugin for receiving media data via the Apple HTTP Live Streaming (HLS) protocol.

Features

Elecard HLS Source has the following features:

  • Supports MPEG-1, MPEG-2, AC3 audio;

  • Supports MPEG-1, MPEG-2, H.264 AVC, H.265 HEVC video.

Parameter Description

Below is the table describing Elecard HLS Source parameters and their values.

Pad Properties

Parameter Name

Description

Value Type

Available Values [range]

Default

Flags

connect-timeout

Specifies the timeout for connection to the source by setting the curl option (CURLOPT_CONNECTTIMEOUT). If the value is 0, the timeout will be equal to the default curl value of 300 seconds.

Range

[0 – 2147483647]

10

readable, writable

current-playlist-bitrate

Indicates the bitrate (bit/s) of the currently used media playlist specified in the master playlist.

String

null

readable

data-timeout

Specifies the timeout between two subsequently downloaded segments. If during the timeout the next segment doesn’t become available for downloading, the EOS will show up. If the value is set to 0, the component will be continuously waiting for data. In this case, EOS will not come up, except when the #EXT-X-ENDLIST tag is found or if the maximum number of attempts to update the playlist (the max-playlist-updates parameter) is achieved before the playlist changes.

Range

[0 – 2147483647]

10

readable, writable

download-rate

Indicates the current data download rate in bit/s.

String

0,00 bps

readable

download-timeout

Specifies the time frame in seconds for the download of the segment and playlist to finish. If they don’t make it in time, the data is discarded. If the value is set to 0, there will be no limit on segment download time.

Range

[0 – 2147483647]

10

readable, writable

license-state

Indicates the license state.

String

evaluation

readable, writable

location

Specifies the URL or local path to the playlist’s .m3u8 file.

String

“”

readable, writable

max-download-buffer-size

Specifies the input buffer size as the number of segments that will be accumulated and kept if the download rate is sufficient. If the download rate is higher than the data output speed, this parameter limits the number of downloaded segments in this sequence and will download new segments only if there is space available in said sequence.

Range

[0 – 2147483647]

2

readable, writable

max-download-rate

Specifies the download rate limit in bit/s. If the value is set to 0, there will be no limit.

Range

[0 – 2147483647]

0

readable, writable

max-playlist-updates

Specifies the number of attempts to update the media playlist and get a new playlist (different from the current one). If set to 0, the number of attempts is infinite.

Range

[0 – 2147483647]

0

readable, writable

name

Specifies the name of the object.

String

hlssrc0

readable, writable

oem-name

Indicates the OEM name.

String

readable

parent

Specifies the parent of the object.

Object of type GstObject

readable, writable

real-stream-bitrate

Indicates the actual bitrate of the downloaded stream.

String

“0,00 bps”

readable

reinitialization-interval

Specifies the reinitialization interval in seconds. It is a frequency for the source to attempt to download the playlist for the first time. If the value is set to 0, there will be only one initialization attempt. If the playlist is not downloaded, the graph start-up will fail.

Range

[0 – 4294967295]

10

readable, writable

start-position

Specifies the starting point (in %) in the playlist that the source will start downloading segments from. If set to 0, the download will start with the oldest segments. When the value is 100, the newest segments will be downloaded.

Range

[0 – 100]

50

readable, writable

user-agent

Indicates the part of the HTTP request header that is required for client application identification by a server or network node. If this field is empty, the option is not used, and the header part is not inserted in the HTTP request.

String

Elecard HLS client

readable, writable