Extensions to A/V Control object for trickmodes
- Available since
- HbbTV 1.0 (ETSI TS 102 796 V1.1.1, OIPF DAE V1.1)
Support in HbbTV
Only the onPlayPositionChanged and onPlaySpeedChanged properties and events are required.
Base definition (OIPF DAE)
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 event | Corresponding DOM event | DOM Event properties |
| onPlaySpeedChanged | PlaySpeedChanged | Bubbles: No Cancellable: No Context Info: speed |
| onPlayPositionChanged | PlayPositionChanged | Bubbles: No Cancellable: No Context Info: position |
| onPlaySpeedsArrayChanged | PlaySpeedsArrayChanged | Bubbles: 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.
