Extensions to A/V Control object for trickmodes

Support in HbbTV

Available since: HbbTV 1.0 (ETSI TS 102 796 V1.1.1, OIPF DAE V1.1)

Only the onPlayPositionChanged and onPlaySpeedChanged properties and events are required.

Properties

The following additional properties SHALL be supported on the audio object and video object defined in section 5.7.1 of [CEA-2014-A].

function onPlaySpeedChanged( Number speed )
The function that is called when the playback speed of the media changes. The specified function is called with one argument, speed, which is defined as follows: · Number speed – the playback speed of the media at the time the event was dispatched. The behaviour of the A/V Control object when the end of media (or the end of the currently-available media) is reached is defined in section 7.14.1.
function onPlayPositionChanged( Integer position )
The function that is called when change occurs in the play position of the media due to the use of trick play functions. The specified function is called with one argument, position, which is defined as follows: · Integer position – the playback position of the media at the time the event was dispatched, measured in milliseconds since the beginning of the referenced media as denoted by the server. The behaviour of the A/V Control object when the end of media (or the end of the currently-available media) is reached is defined in section 7.14.1.
readonly Number playSpeeds[ ]
Returns an ordered list of playback speeds, expressed as values relative to the normal playback speed (1.0), at which the currently specified A/V content can be played (either through an CEA-2014 audio or video object), or undefined if the supported playback speeds are not (yet) known.
function onplaySpeedsArrayChanged()
The function that is called when the playSpeeds array values have changed. An application that makes use of the playSpeeds array needs to read the values of the playSpeeds property again.
readonly String oitfSourceIPAddress
The OITF source IP address for RTSP or HTTP signalling, as well as, the address where the RTSP stream is expected to arrive. The information shall be available in “buffering”, “paused” or “playing” states.
readonly String oitfSourcePortAddress
The OITF Port Address where the RTSP stream is expected to arrive. The information shall be available in “buffering”, “paused” or “playing” states.
Boolean oitfNoRTSPSessionControl
When the oitfNoRTSPSessionControl is set to true then the OITF SHALL NOT signal the RTSP messages DESCRIBE, SETUP or TEARDOWN.
String oitfRTSPSessionId
The sessionId to be used by the A/V Control object when signalling RTSP. This property is only applicable when property oitfNoRTSPSessionControl is set to true.

Events

For the intrinsic events listed in the table below, a corresponding DOM event SHALL be generated in the following manner:

Intrinsic eventCorresponding DOM eventDOM Event properties
onPlaySpeedChangedPlaySpeedChangedBubbles: No Cancellable: No Context Info: speed
onPlayPositionChangedPlayPositionChangedBubbles: No Cancellable: No Context Info: position
onPlaySpeedsArrayChangedPlaySpeedsArrayChangedBubbles: No Cancellable: No Context Info: None

Note: the DOM events are directly dispatched to the event target, and will not bubble nor capture. Applications SHOULD NOT rely on receiving these events during the bubbling or the capturing phase. Applications that use DOM event handlers SHALL call the addEventListener() method on the A/V Control object itself. The third parameter of addEventListener, i.e. “useCapture”, will be ignored.