URL Parameters for HTTP Adaptive Streaming Content
URL Parameters for HTTP Adaptive Streaming Content
This section describes Samsung specific URL parameters for HAS contents. With these URL parameters, the HAS engine’s logical behaviours can be controlled. The functionalities of each parameter are described in the table below.
The Samsung specific parameters in URL are delivered only to Samsung HAS module. These are removed before sending HTTP requests.
Source Files
Note
The files needed for the sample application are here.
This files doesn't work in the emulator. It must execute from TV or It works on TV.
Apple Type URL Syntax
URL syntax | CONTENT_URL | BITRATES | UPTIMER | STARTBITRATE | COMPONENT |
Parameter | Description | Attribute | |||
---|---|---|---|---|---|
CONTENT_URL | The URL of Apple HTTP Live Streaming content. | Mandatory | |||
BITRATES | Specifies available content bitrates and bitrates group |
Optional
(if not specified, then all bitrates described in ‘m3u8’ is used while playing)
|
|||
Syntax |
BITRATES= BRGROUP[GSEP BRGROUP]
BRGROUP = GSTART BITRATELIST GEND
BITRATELIST= 'xx: yy: zz' or 'xx~zz'
GSTART : '(' //Group start
GEND : ')' //Group end
GSEP : NORMSWITCH | DONLYSWITCH
NORMSWITCH : ':' //Normal switching
DONLYSWITCH : '>' //Down-only switching
Example 1: BITRATELIST=8000000:5000000:2000000
Example 2: BITRATELIST=(2000000~5000000)
Example 3: BITRATELIST=(8000000):(5000000:2000000)
Example 4: BITRATELIST=(8000000):(5000000~2000000)
Example 5: BITRATELIST=(8000000)>(5000000:2000000)
|
||||
UPTIMER | Specifies the threshold of the initial UP switching time which applies to switching between streams in different groups. | Optional | |||
syntax |
UPTIMER=xx
UPTIMER is meaningless if there is one bitrate group.
UPTIMER is dynamically increases if network bandwidth is changes frequently.
UPTIMER is not applied on bitrate switching within same group.
If UPTIMER is not specified, then default UPTIMER=0 is applied.
|
||||
STARTBITRATE | Specifies the initial stream bitrates to playback. |
Optional
(if not specified, start bitrates is selected by HAS engine)
|
|||
syntax |
STARTBITRATE=XXX
|
||||
COMPONENT | Specifies the adaptive streaming type. | Mandatory | |||
syntax |
COMPONENT=HLS
|
||||
HLS | Apple Type (HTTP Live Streaming) | ||||
HLS URL Examples |
(Example 1: Sets HLS Type)
http://127.0.0.1/movie/master_wired.m3u8|COMPONENT=HLS
(Example 2-1: Specifies switchable bitrates range)
http://127.0.0.1/movie/master_wired.m3u8%20|BITRATELIST=1800000~3000000|COMPONENT=HLS
(Example 2-2: Specifies switchable bitrates list)
http://127.0.0.1/movie/master_wired.m3u8%20|BITRATELIST=3000000:2200000:1800000|COMPONENT=HLS
(Example 3: Specifies switchable bitrates group and initial start bitrates)
http://127.0.0.1/movie/master_wired.m3u8|BITRATELIST=(3000000:2200000)%3e(1800000)|UPTIMER=120|STARTBITRATE=3000000|COMPONENT=HLS
|
OIPF HAS Type URL Syntax
URL syntax | CONTENT_URL | BITRATES | UPTIMER | STARTBITRATE | ADMODE | COMPONENT |
Parameter | Description | Attribute | ||||
---|---|---|---|---|---|---|
CONTENT_URL | The URL of OIPF type HTTP adaptive streaming content. | Mandatory | ||||
BITRATES | Specifies the available content bitrates and bitrates group |
Optional
(if not specified, then all bitrates described in mpd file is used while playing)
|
||||
Syntax |
BITRATES= BRGROUP[GSEP BRGROUP]
BRGROUP = GSTART BITRATELIST GEND
BITRATELIST= xx: yy: zz or xx~zz
GSTART : '(' //Group start
GEND : ')' //Group end
GSEP : NORMSWITCH | DONLYSWITCH
NORMSWITCH : ':' //Normal switching
DONLYSWITCH : '>' //Down-only switching
|
|||||
UPTIMER | Specifies the threshold of initial UP switching time which applies to switching between streams in different bitrates groups. | Optional | ||||
syntax |
UPTIMER=xx
UPTIMER is meaningless if there is one bitrate group.
UPTIMER is dynamically increases if network bandwidth is changes frequently.
UPTIMER is not applied on bitrate switching within same group.
If UPTIMER is not specified, then default UPTIMER=0 is applied.
|
|||||
STARTBITRATE | Specifies initial stream bitrates to playback | Optional | ||||
syntax |
STARTBITRATE=100000
|
|||||
ADMODE | Specifies the AD force play mode when a seek (jump) operation is requested. |
Optional
(if not specified, LAST mode is applied)
|
||||
syntax |
ADMODE=FIRST | LAST
|
|||||
FIRST |
Seeks the first AD among ADs between the current position and the target jump position.
Then force-plays the first AD and keeps the main content play from the AD insertion time.
|
|||||
LAST
(default)
|
Seeks the last AD among ADs between the current position and the target jump position
hen force-plays the last AD and starts playing from the target seek position.
|
|||||
COMPONENT | Specifies the adaptive streaming type. | Mandatory | ||||
syntax |
COMPONENT=HAS
|
|||||
HAS | OIPF Type (HTTP Adaptive Streaming) | |||||
HAS URL Examples |
((Example 1: Sets HAS Type))
http://127.0.0.1/has/movie.mpd|COMPONENT=HAS
(Example 2-1: Specifies switchable bitrates range)
http://127.0.0.1/has/movie.mpd|BITRATELIST=1800000~3000000|COMPONENT=HAS
(Example 2-2: Specifies switchable bitrates list)
http://127.0.0.1/has/movie.mpd|BITRATELIST=3000000:2200000:1800000|COMPONENT=HAS
(Example 3: Specifies switchable bitrates group and initial start bitrates)
http://127.0.0.1/has/movie.mpd|BITRATELIST=(3000000:2200000)%3e(1800000)|UPTIMER=120|STARTBITRATE=3000000|COMPONENT=HAS
|