How is `switchMediaPresentation` used?

Question

It's not clear to me how is switchMediaPresentation supposed to work after reading the docs: https://www.hbbtv.org/wp-content/uploads/2021/07/HbbTV-SPEC-00260-030-ts_103464v010301-without-ETSI-branding.pdf

I'm trying the following:

// ... previous code

<object type="application/hbbtvMediaSwitcher" class="MediaSwitcher" id="MediaSwitcher"></object>

// ... More code

<script>
  document
    .getElementById("MediaSwitcher")
    .switchMediaPresentation(
      originalMediaObject,
      newMediaObject,
    )
    .then(() => {})
    .catch(e => {})
</script>

I'm getting error document.getElementById(...).switchMediaPresentation is not a function

Any idea from my fellow HbbTV developers?

score 2 · Accepted Answer · answered Oct 20 '22 at 05:01

2

Are you sure the device supports switchMediaPresentation and that it's enabled for you? That API is very new, there aren't many implementations and the most widespread one only enables the feature for specific apps.

answered Oct 20 '22 at 05:01

user15227609

46
1

In this case I was using Firefox's HbbTV Emulator and it in fact didn't support this feature. After some time working on it I realized it. Thank you for your comment. :-) – Gerard Jan 23 '23 at 08:45

score 1 · Answer 2 · answered Jan 13 '23 at 09:58

switchMediaPresentation, like lots of other features is optional to support. Prior to use the switchMediaPresentation API you need to check if device implement it, for example by check of presence of "ta" element in the xmlCapabilities property of the application/oipfCapabilities embedded object.

How is `switchMediaPresentation` used?

2 Answers2