Skip to content

Commit 126f673

Browse files
author
THEOplayer CI
committed
THEOplayer 11.6.0
1 parent 31b3c02 commit 126f673

160 files changed

Lines changed: 1252 additions & 880 deletions

File tree

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

theoplayer/api-reference/roku.md

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -41,6 +41,7 @@ The attributes, methods and events.
4141
| src | string | | read | The current URL of the media resource. |
4242
| theolive | THEOlive API | | read | API node for THEOlive operations. |
4343
| textTracks | roArray of roAssociativeArrays | [] | read,write | Provides information about text and metadata tracks detected automatically in video. Each Associative array has the following fields: id - track identifier, label - track description, language - track language, mode - determines track state, available values: disabled, showing, hidden, activeCues: the current cue for this track |
44+
| version | string | | read | The version of the THEOplayer Roku SDK. |
4445

4546
### Source Description
4647

@@ -510,6 +511,7 @@ For the `distributionloaded` event, the following properties are available on th
510511
| -------------- | -------------------- | ---------------------------------------------------- |
511512
| deleted | boolean | Optional. Whether the distribution has been deleted. |
512513
| endpoints | roArray of Endpoints | An array of endpoints. |
514+
| externalId | string | Optional. The distribution's external ID. |
513515
| id | string | The distribution's ID. |
514516
| maxBitrate | integer | Optional. The maximum bitrate of the distribution. |
515517
| name | string | The distribution's name. |

theoplayer/changelog.md

Lines changed: 78 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -9,6 +9,79 @@ These are the release notes for THEOplayer 11.0.0 and higher. For older versions
99
- [Version 5.x and 6.x](https://optiview.dolby.com/docs/theoplayer/v6/changelog/)
1010
- [Version 2.x, 3.x and 4.x](https://optiview.dolby.com/docs/theoplayer/v4/changelog/)
1111

12+
## 🚀 11.6.0 (2026/07/03)
13+
14+
### General
15+
16+
#### ✨ Features
17+
18+
- Added `externalId` to OptiView Live distribution metadata exposed by the `distributionloaded` event.
19+
20+
### Web
21+
22+
#### 🐛 Issues
23+
24+
- Fixed an issue where an OptiView Live stream was incorrectly flagged as offline during slow startup.
25+
- Fixed an issue where ID3 text tracks did not initially have a `TextTrack.type` set when playing inside a `WKWebView` on iOS.
26+
- Fixed an issue where the player would error on some specific HLS streams with TTML subtitles.
27+
- Fixed an issue where the player would create gaps in the buffer around discontinuities in certain HLS streams, which could result in undesirable gap jumps or short freezes during playback.
28+
- Fixed an issue where the player sometimes would play only audio after a stall when playing an HESP stream.
29+
- Fixed an issue where the device motion controls were not working in VR on mobile Chrome browsers.
30+
- Fixed an issue where the device motion orientation in VR was inverted on mobile Chrome browsers.
31+
- Fixed an issue where VR videos were being rendered upside down on iPad Safari.
32+
33+
### Android
34+
35+
#### ✨ Features
36+
37+
- CMCD ad event reporting is now supported for all ad integrations (and no longer limited to just OptiView Ads).
38+
39+
#### ⚡ Improvements
40+
41+
- Added optional provider information to OptiView Live endpoints.
42+
43+
#### 🐛 Issues
44+
45+
- Fixed an issue where an OptiView Ads overlay stays onscreen indefinitely after it has expired.
46+
- Fixed an issue where Double Box and L-shape layouts were incorrectly shown in Picture-in-Picture mode with OptiView Ads.
47+
- Fixed an issue where the player would crash if OptiView Ads playback was started while in Picture-in-Picture mode.
48+
- Fixed an issue where the ads UI could get stuck after playing two consecutive ad breaks with OptiView Ads.
49+
50+
### iOS
51+
52+
#### ✨ Features
53+
54+
- Added support for customData on the Ad and AdBreak protocols.
55+
56+
#### 🐛 Issues
57+
58+
- Fixed an issue where the duration of OptiView Break Manifest Ads were not respected.
59+
- Fixed an issue where changing or clearing `player.source` while playing an HESP stream could cause the app to crash due to an internal race condition.
60+
- Fixed an issue where transitioning between IMA prerolls would cause the PiP window to close.
61+
- Fixed an issue where sources with multiple IMA prerolls would load trailing prerolls after the main content.
62+
- Fixed an issue where setting a source with an IMA ad while another source with an ad is playing would cause a crash.
63+
- Fixed an issue where scheduling IMA ads causes a momentary black screen in main content.
64+
- Fixed an issue where ads from different systems would overlap with OptiView Ads.
65+
- Fixed an issue in OptiView Ads where the layout would switch to single momentarily in between companion ads.
66+
- Fixed an issue where during ad playback in PiP, the original player view continues to playback main content.
67+
- Fixed an issue where double box and L-shape ads don't show in PiP.
68+
- Fixed an issue where Ads would remain in double box layout after finishing.
69+
70+
### Roku
71+
72+
#### ✨ Features
73+
74+
- Added client-side ad beaconing for MediaKind SSAI streams.
75+
- Added session beacons for the MediaKind connector.
76+
77+
#### ⚡ Improvements
78+
79+
- Removed automatic use of `START=Live` for live MediaKind streams. The client now can specify the live stream URL params.
80+
81+
#### 🐛 Issues
82+
83+
- Fixed an issue where during fallback on an OptiView Live stream the wrong endpoint was selected.
84+
1285
## 🚀 11.5.1 (2026/07/03)
1386

1487
### iOS
@@ -115,7 +188,7 @@ These are the release notes for THEOplayer 11.0.0 and higher. For older versions
115188

116189
#### 🐛 Issues
117190

118-
- Fixed an issue with Optiview Ads where setting overlay positions (top/bottom/left/right) to 0 was not supported.
191+
- Fixed an issue with OptiView Ads where setting overlay positions (top/bottom/left/right) to 0 was not supported.
119192
- Fixed an issue where the player could crash on Sky Glass/Puck when `autoplay` is set to `true`.
120193
- Fixed an issue where using WebXR on iOS Safari was preventing VR video from being rendered inline.
121194
- Fixed an issue where clicking the "LIVE" button on an HLS live stream would sometimes seek to the start of the DVR window instead of the live edge when using native HLS playback on macOS/iOS Safari.
@@ -164,7 +237,7 @@ These are the release notes for THEOplayer 11.0.0 and higher. For older versions
164237

165238
#### 🐛 Issues
166239

167-
- Fixed an issue with Optiview Ads where setting overlay positions (top/bottom/left/right) to 0 was not supported.
240+
- Fixed an issue with OptiView Ads where setting overlay positions (top/bottom/left/right) to 0 was not supported.
168241

169242
### Roku
170243

@@ -183,7 +256,7 @@ These are the release notes for THEOplayer 11.0.0 and higher. For older versions
183256

184257
#### ✨ Features
185258

186-
- Added support for OptiView Live Streams with JWT token security on iOS Safari. Note that this requires a long-lived token that remains valid for the entire playback session. For short-lived tokens, we recommend [using a service worker](/theoplayer/how-to-guides/web/theolive/token-based-security/#short-lived-tokens-using-service-worker).
259+
- Added support for OptiView Live Streams with JWT token security on iOS Safari. Note that this requires a long-lived token that remains valid for the entire playback session. For short-lived tokens, we recommend [using a service worker](https://optiview.dolby.com/docs/theoplayer/how-to-guides/web/theolive/token-based-security/#short-lived-tokens-using-service-worker).
187260
- Added support for DRM-protected OptiView Live Streams with JWT token security on macOS Safari. Note that this requires a long-lived token that remains valid for the entire playback session.
188261

189262
#### 🐛 Issues
@@ -350,7 +423,7 @@ THEOplayer 11.0 includes **some breaking changes per SDK**. Please review them c
350423
- On Android, the Google IMA integration has been updated to support version 3.39.0 of the Google IMA SDK.
351424
This requires core library desugaring to be enabled in your app.
352425

353-
For more info on navigating our breaking changes, take a look at our migration guides for [Web](/theoplayer/getting-started/sdks/web/migrating-to-theoplayer-11/), [Android](/theoplayer/getting-started/sdks/android/migrating-to-theoplayer-11/), [iOS](/theoplayer/getting-started/sdks/ios/migrating-to-theoplayer-11/) and [React Native](/theoplayer/getting-started/frameworks/react-native/migrating-to-react-native-theoplayer-11/).
426+
For more info on navigating our breaking changes, take a look at our migration guides for [Web](https://optiview.dolby.com/docs/theoplayer/getting-started/sdks/web/migrating-to-theoplayer-11/), [Android](https://optiview.dolby.com/docs/theoplayer/getting-started/sdks/android/migrating-to-theoplayer-11/), [iOS](https://optiview.dolby.com/docs/theoplayer/getting-started/sdks/ios/migrating-to-theoplayer-11/) and [React Native](https://optiview.dolby.com/docs/theoplayer/getting-started/frameworks/react-native/migrating-to-react-native-theoplayer-11/).
354427

355428
### Web
356429

@@ -363,7 +436,7 @@ For more info on navigating our breaking changes, take a look at our migration g
363436
#### 💥 Breaking Changes
364437

365438
- All methods on `Player` and `THEOplayerView` must only be called from the main thread and are annotated with `@MainThread`. Calling these methods from a different thread will throw an `IllegalStateException`.
366-
- The Google IMA SDK integration now requires [core library desugaring](https://developer.android.com/studio/write/java8-support#library-desugaring) to be enabled. See [our updated guide for Google IMA](/theoplayer/how-to-guides/ads/google-ima/#android-sdk) for instructions.
439+
- The Google IMA SDK integration now requires [core library desugaring](https://developer.android.com/studio/write/java8-support#library-desugaring) to be enabled. See [our updated guide for Google IMA](https://optiview.dolby.com/docs/theoplayer/how-to-guides/ads/google-ima/#android-sdk) for instructions.
367440
- Removed `preloadChannels` in THEOlive API.
368441
- Changed `MediaTailorAdAvail.id` to return a `String` instead of an `Int`, to align with `AdBreak.id`.
369442
- Removed `TheoAdsErrorEvent`, use `AdErrorEvent` instead.

theoplayer/static/theoplayer/v11/api-reference/android/com/theoplayer/android/api/theolive/Distribution.html

Lines changed: 31 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -254,6 +254,14 @@ <h3>Method Summary</h3>
254254
</tr>
255255

256256
<tr id="i1" class="rowColor">
257+
<td class="colFirst"><code>abstract <a href=https://developer.android.com/reference/kotlin/java/lang/String.html>String</a></code>
258+
</td>
259+
<th class="colSecond" scope="row"><code><a href=Distribution.html#getExternalId()>getExternalId</a>() </code>
260+
</th>
261+
<td class="colLast"></td>
262+
</tr>
263+
264+
<tr id="i2" class="altColor">
257265
<td class="colFirst"><code>abstract <a href=https://developer.android.com/reference/kotlin/java/lang/String.html>String</a></code>
258266
</td>
259267
<th class="colSecond" scope="row"><code><a href=Distribution.html#getName()>getName</a>() </code>
@@ -324,6 +332,29 @@ <h4>getId</h4>
324332

325333

326334

335+
</dl>
336+
</li>
337+
</ul>
338+
339+
<a id="getExternalId()">
340+
<!-- -->
341+
</a>
342+
<ul class=
343+
"blockList"
344+
>
345+
<li class="blockList">
346+
<h4>getExternalId</h4>
347+
<pre class="methodSignature"> abstract <a href=https://developer.android.com/reference/kotlin/java/lang/String.html>String</a> <a href=Distribution.html#getExternalId()>getExternalId</a>()</pre>
348+
<div class="block"></div>
349+
350+
<dl>
351+
352+
353+
354+
355+
356+
357+
327358
</dl>
328359
</li>
329360
</ul>

0 commit comments

Comments
 (0)