python.libgpac.libgpac.DASHCustomAlgorithm Class Reference

DASH custom algo Upon successful binding to the dashin filter, the object will be assigned a list member called groups, containing the declared group for the active period. More...

Public Member Functions
	on_period_reset (self, reset_type)
	Callback (optional) called upon a period reset.
	on_new_group (self, group)
	Callback (optional) called when a new group (adaptation set) is created.
	on_rate_adaptation (self, group, base_group, force_low_complexity, stats)
	Callback (mandatory) called at the end of the segment download to perform rate adaptation.
	on_download_monitor (self, group, stats)
	Callback (optional) called on regular basis during a segment download.

Detailed Description

DASH custom algo Upon successful binding to the dashin filter, the object will be assigned a list member called groups, containing the declared group for the active period.

Member Function Documentation

on_period_reset()

python.libgpac.libgpac.DASHCustomAlgorithm.on_period_reset	(		self,
			reset_type
	)

Callback (optional) called upon a period reset.

Parameters

reset_type

indicate the type of period reset. Values can be: 0: end of period (groups are no longer valid) 1: start of a static period 2: start of a dynamic (live) period

Returns

on_new_group()

python.libgpac.libgpac.DASHCustomAlgorithm.on_new_group	(		self,
			group
	)

Callback (optional) called when a new group (adaptation set) is created.

Parameters

group

the newly created DASHGroup

Returns

on_rate_adaptation()

python.libgpac.libgpac.DASHCustomAlgorithm.on_rate_adaptation	(		self,
			group,
			base_group,
			force_low_complexity,
			stats
	)

Callback (mandatory) called at the end of the segment download to perform rate adaptation.

Parameters

group	the DASHGroup on which to perform adaptation
base_group	the associated base DASHGroup (tiling only), or None if no base group
force_low_complexity	indicates that the client would like a lower complexity (typically because it is dropping frames)
stats	the DASHGroupStatistics for the downloaded segment

Returns

value can be:

• new quality index,
• -1 to take no decision
• -2 to disable quality (debug, will drop segment)
• other negative values are handled as error

on_download_monitor()

python.libgpac.libgpac.DASHCustomAlgorithm.on_download_monitor	(		self,
			group,
			stats
	)

Callback (optional) called on regular basis during a segment download.

Parameters

group	the DASHGroup associated with the current download
stats	the DASHGroupDownloadStatistics for the download

Returns

value can be:

• -1 to continue download
• -2 to abort download but without retrying to downloading the same segment at lower quality
• the index of the new quality to download for the same segment index (same time)