Extensions to video/broadcast for access to EIT p/f
Support in HbbTV
Available since: HbbTV 1.0 (ETSI TS 102 796 V1.1.1, OIPF DAE V1.1)
Comment
Broadcast-related
The following properties and events SHALL be added to the video/broadcast embedded object, if the OITF has indicated support for accessing DVB-SI EIT p/f information, by giving the value “true” to element <clientMetadata> and the value “eit-pf” or “dvb-si” to the type attribute of that element as defined in section 9.3.7 in their capability profile.
Access to these properties SHALL adhere to the security model in section 10. The associated permission name is “permission_metadata”.
| readonly ProgrammeCollection programmes |
| The collection of programmes available on the currently tuned channel. This list is a ProgrammeCollection as defined in section 7.16.3 and is ordered by start time, so index 0 will always refer to the present programme (if this information is available). If the type attribute of the <clientMetadata> element in the OITF’s capability description has the value “eit-pf”, this list SHALL at least provide Programme objects as defined in section 7.16.2 for the present and the directly following programme on the currently tuned channel, if that information is available. In other words, the DAE application should not expect programmes.length to be larger than 2. If the video/broadcast object is not currently tuned to a channel, or if the present/following information has not yet been retrieved (e.g. the object has just tuned to a new channel and present/following information has not yet been broadcast), or if present/following information is not available for the current channel, the length of this collection SHALL be 0. If the type attribute of the <clientMetadata> element in the OITF’s capability description has a value other than “eit-pf”, an OITF MAY populate this field from other metadata sources described in [OIPF_META2]. The programmes.length property SHALL indicate the number of items that are currently known and up to date (i.e. whereby the “startTime + duration” is not smaller than the current time). This may be 0 if no programme information is currently known for the currently tuned channel. In order to prevent misuse of this information, access to this property SHALL adhere to the security model in section 10. The associated permission name is “permission_metadata”. |
| function onProgrammesChanged() |
| The function that is called when the programmes property has been updated with new programme information, e.g. when the current broadcast programme is finished and a new one has started. The specified function is called with no arguments. |
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 |
| onProgrammesChanged | ProgrammesChanged | Bubbles: No Cancellable: No Context Info: None |
Note: this DOM event is 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 video/broadcast object itself. The third parameter of addEventListener, i.e. “useCapture”, will be ignored.