URL Parameters for HTTP Adaptive Streaming Content

Published 2014-10-27 | (Compatible with SDK 2.5,3.5,4.5,5.0,5.1 and 2011,2012,2013,2014 models)

URL Parameters for HTTP Adaptive Streaming Content

Contents

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
  • If there is only one group, then GSTART, GEND can be removed.
  • If BITRATES is not specified, then all bitrates described in MPD are used.
  • If DONLYSWITCH is specified between bitrate groups, then up switching from a low bitrate group to a high bitrate group is prohibited. (only high to low switching is allowed)
  • Bitrate switching within same group is always allowed.
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
  • If there is only one group, then GSTART, GEND can be removable.
  • If BITRATES is not specified, then all bitrates described in MPD are used.
  • If DONLYSWITCH is specified between bitrates group, then up switching from a low bitrates group to a high bitrates group is prohibited.(only high to low switching is allowed)
  • Bitrate switching within same group is always allowed.
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