THEOplayer 8.2.0

THEOplayer · Oct 10, 2024 · c762902 · c762902
1 parent 5108dda
commit c762902
Show file tree

Hide file tree

Showing 31 changed files with 2,301 additions and 547 deletions.
diff --git a/theoplayer/changelog.md b/theoplayer/changelog.md
@@ -5,6 +5,59 @@ sidebar_custom_props: { 'icon': '📰' }
 toc_max_heading_level: 2
 ---
 
+## 🚀 8.2.0 (2024/10/10)
+
+### General
+
+#### ✨ Features
+
+- Added THEOads API to allow to changing the ad tag parameters via `player.ads.theoads.replaceAdTagParameters`.
+
+#### ⚡ Improvements
+
+- Prevent unnecessary first seek when starting playback at the beginning of a VoD source for DASH, to improve startup times on lower-end smart TVs.
+
+#### 🐛 Issues
+
+- Fixed an issue where the latency manager would not be automatically enabled when overriding the source with another source containing a `SourceLatencyConfiguration`.
+- Fixed an issue where the player would sometimes skip some segments when playing certain MPEG-DASH live streams with slightly misaligned segments, which could result in excessive gap jumping and stalling.
+- Fixed an issue where the player could stall indefinitely when playing an HLS stream with misaligned discontinuities on macOS Safari and other WebKit-based browsers.
+
+### Web
+
+#### 💥 Breaking Changes
+
+- In order to use THEOads, you now need to set [`PlayerConfiguration.ads.theoads`](https://www.theoplayer.com/docs/theoplayer/v8/api-reference/web/interfaces/AdsConfiguration.html#theoads) to `true`. Users of the [@theoplayer/theoads](https://www.npmjs.com/package/@theoplayer/theoads) package can temporarily keep using THEOads without updating their player configuration.
+
+#### ✨ Features
+
+- Added support for CEA-608 and CEA-708 subtitles for HESP streams.
+- Added support for THEOlive sources.
+- Fixed an issue where the player could remain stuck retrying offline HLS media playlists even after a new source is set.
+
+#### 🐛 Issues
+
+- Fixed an issue where some HESP streams would not play on iOS <17.1 devices.
+
+### Android
+
+#### ✨ Features
+
+- Added [Millicast](https://dolby.io/products/real-time-streaming/) integration for real-time streaming. The integration is available on [our Maven repository](https://maven.theoplayer.com/) as `com.theoplayer.theoplayer-sdk-android:integration-millicast`.
+- Added `TheoAdsIntegration.replaceAdTagParameters()` to allow changing ad tag parameters for THEOads dynamically.
+
+#### 🐛 Issues
+
+- Fixed an issue where an HTTP 3xx redirect from `http://` to `https://` was not followed.
+- Fixed an issue where multiple CANPLAYTHROUGH events were triggered
+- Fixed an issue where THEOplayer licenses containing `ip-range()` source domains were not handled correctly.
+
+### iOS
+
+#### 🐛 Issues
+
+- Fixed an issue where the player automatically resumed playing after coming back from tapping the Learn more button during a Google IMA ad.
+
 ## 🚀 8.1.2 (2024/10/02)
 
 ### Android

diff --git a/theoplayer/static/theoplayer/v8/api-reference/android/allclasses.html b/theoplayer/static/theoplayer/v8/api-reference/android/allclasses.html
@@ -33,6 +33,10 @@ <h1 class="bar">All Classes</h1>
 
             <li><a href=com/theoplayer/android/api/cast/CastStrategy.html>CastStrategy</a></li>
 
+            <li><a href=com/theoplayer/android/api/media3/Media3PlayerIntegration.html>Media3PlayerIntegration</a></li>
+
+            <li><a href=com/theoplayer/android/api/media3/Media3PlayerIntegrationFactory.html>Media3PlayerIntegrationFactory</a></li>
+
             <li><a href=com/theoplayer/android/api/fullscreen/IntentCreationListener.html>IntentCreationListener</a></li>
 
             <li><a href=com/theoplayer/android/api/fullscreen/FullScreenActivity.html>FullScreenActivity</a></li>

diff --git a/...tatic/theoplayer/v8/api-reference/android/com/theoplayer/android/api/IntegrationType.html b/...tatic/theoplayer/v8/api-reference/android/com/theoplayer/android/api/IntegrationType.html
@@ -255,6 +255,18 @@ <h3>Enum Constant Summary</h3>
                                         <td class="colLast"></td>
                                     </tr>
 
+                                    <tr class="altColor">
+                                        <th class="colFirst" scope="row"><code><span class="memberNameLink"><a
+                                                href="TODO"><a href=IntegrationType.html#MEDIA3>MEDIA3</a></a></span></code></th>
+                                        <td class="colLast"></td>
+                                    </tr>
+
+                                    <tr class="rowColor">
+                                        <th class="colFirst" scope="row"><code><span class="memberNameLink"><a
+                                                href="TODO"><a href=IntegrationType.html#MILLICAST>MILLICAST</a></a></span></code></th>
+                                        <td class="colLast"></td>
+                                    </tr>
+
                                 </table>
                             </li>
                         </ul>

diff --git a/...er/v8/api-reference/android/com/theoplayer/android/api/ads/theoads/TheoAdDescription.html b/...er/v8/api-reference/android/com/theoplayer/android/api/ads/theoads/TheoAdDescription.html
@@ -114,7 +114,7 @@ <h2 title="Class TheoAdDescription" class="title">Class TheoAdDescription</h2>
                     <hr>
                     <pre class="wrap-overflow">
 
-public final class <span class="typeNameLabel"><a href=TheoAdDescription.html>TheoAdDescription</a></span>
+public class <span class="typeNameLabel"><a href=TheoAdDescription.html>TheoAdDescription</a></span>
 extends <a href=../../source/addescription/AdDescription.html>AdDescription</a>
                     </pre>
                     <div class="block"><p>Describes a THEOads SGAI ad break request.</p><ul><li><p>For THEOads, one configured ad break request suffices to enable THEOads ad playback for the entire stream.</p></li></ul></div>
@@ -203,6 +203,12 @@ <h3>Field Summary</h3>
                                         </tr>
 
                                         <tr class="rowColor">
+                                            <td class="colFirst"><code>private final <a href=https://developer.android.com/reference/kotlin/java/util/Map.html>Map</a>&lt;<a href=https://developer.android.com/reference/kotlin/java/lang/String.html>String</a>, <a href=https://developer.android.com/reference/kotlin/java/lang/String.html>String</a>&gt;</code></td>
+                                            <th class="colSecond" scope="row"><code><a href=TheoAdDescription.html#adTagParameters>adTagParameters</a></code></th>
+                                            <td class="colLast"></td>
+                                        </tr>
+
+                                        <tr class="altColor">
                                             <td class="colFirst"><code>private final <a href=https://developer.android.com/reference/kotlin/java/lang/Boolean.html>Boolean</a></code></td>
                                             <th class="colSecond" scope="row"><code><a href=TheoAdDescription.html#useId3>useId3</a></code></th>
                                             <td class="colLast"></td>
@@ -234,7 +240,7 @@ <h3>Constructor Summary</h3>
 
                                             <tr class="altColor">
                                                 <th class="colConstructorName" scope="row"><code><span class="memberNameLink"><a
-                                                        href="#TheoAdDescription(java.lang.String,java.lang.String,java.lang.String,java.lang.String,com.theoplayer.android.api.ads.theoads.TheoAdsLayoutOverride,java.lang.Boolean)">TheoAdDescription</a></span>(<a href=https://developer.android.com/reference/kotlin/java/lang/String.html>String</a> networkCode, <a href=https://developer.android.com/reference/kotlin/java/lang/String.html>String</a> customAssetKey, <a href=https://developer.android.com/reference/kotlin/java/lang/String.html>String</a> backdropDoubleBox, <a href=https://developer.android.com/reference/kotlin/java/lang/String.html>String</a> backdropLShape, <a href=TheoAdsLayoutOverride.html>TheoAdsLayoutOverride</a> overrideLayout, <a href=https://developer.android.com/reference/kotlin/java/lang/Boolean.html>Boolean</a> useId3)</code></th>
+                                                        href="#TheoAdDescription(java.lang.String,java.lang.String,java.lang.String,java.lang.String,com.theoplayer.android.api.ads.theoads.TheoAdsLayoutOverride,java.util.Map,java.lang.Boolean)">TheoAdDescription</a></span>(<a href=https://developer.android.com/reference/kotlin/java/lang/String.html>String</a> networkCode, <a href=https://developer.android.com/reference/kotlin/java/lang/String.html>String</a> customAssetKey, <a href=https://developer.android.com/reference/kotlin/java/lang/String.html>String</a> backdropDoubleBox, <a href=https://developer.android.com/reference/kotlin/java/lang/String.html>String</a> backdropLShape, <a href=TheoAdsLayoutOverride.html>TheoAdsLayoutOverride</a> overrideLayout, <a href=https://developer.android.com/reference/kotlin/java/util/Map.html>Map</a>&lt;<a href=https://developer.android.com/reference/kotlin/java/lang/String.html>String</a>, <a href=https://developer.android.com/reference/kotlin/java/lang/String.html>String</a>&gt; adTagParameters, <a href=https://developer.android.com/reference/kotlin/java/lang/Boolean.html>Boolean</a> useId3)</code></th>
                                                 <td class="colLast"></td>
                                             </tr>
 
@@ -328,6 +334,14 @@ <h3>Method Summary</h3>
                                         </tr>
 
                                         <tr id="i5" class="rowColor">
+                                            <td class="colFirst"><code>final <a href=https://developer.android.com/reference/kotlin/java/util/Map.html>Map</a>&lt;<a href=https://developer.android.com/reference/kotlin/java/lang/String.html>String</a>, <a href=https://developer.android.com/reference/kotlin/java/lang/String.html>String</a>&gt;</code>
+                                            </td>
+                                            <th class="colSecond" scope="row"><code><a href=TheoAdDescription.html#getAdTagParameters()>getAdTagParameters</a>() </code>
+                                            </th>
+                                            <td class="colLast">The ad tag parameters added to the stream request.</td>
+                                        </tr>
+
+                                        <tr id="i6" class="altColor">
                                             <td class="colFirst"><code>final <a href=https://developer.android.com/reference/kotlin/java/lang/Boolean.html>Boolean</a></code>
                                             </td>
                                             <th class="colSecond" scope="row"><code><a href=TheoAdDescription.html#getUseId3()>getUseId3</a>() </code>
@@ -372,11 +386,11 @@ <h3>Methods inherited from class&nbsp;java.lang.Object</h3>
                             </a>
                                 <h3>Constructor Detail</h3>
 
-                                <a name="TheoAdDescription(java.lang.String,java.lang.String,java.lang.String,java.lang.String,com.theoplayer.android.api.ads.theoads.TheoAdsLayoutOverride,java.lang.Boolean)"></a>
+                                <a name="TheoAdDescription(java.lang.String,java.lang.String,java.lang.String,java.lang.String,com.theoplayer.android.api.ads.theoads.TheoAdsLayoutOverride,java.util.Map,java.lang.Boolean)"></a>
                                 <ul class="blockList">
                                     <li class="blockList">
                                         <h4>TheoAdDescription</h4>
-                                        <pre>TheoAdDescription(<a href=https://developer.android.com/reference/kotlin/java/lang/String.html>String</a> networkCode, <a href=https://developer.android.com/reference/kotlin/java/lang/String.html>String</a> customAssetKey, <a href=https://developer.android.com/reference/kotlin/java/lang/String.html>String</a> backdropDoubleBox, <a href=https://developer.android.com/reference/kotlin/java/lang/String.html>String</a> backdropLShape, <a href=TheoAdsLayoutOverride.html>TheoAdsLayoutOverride</a> overrideLayout, <a href=https://developer.android.com/reference/kotlin/java/lang/Boolean.html>Boolean</a> useId3)</pre>
+                                        <pre>TheoAdDescription(<a href=https://developer.android.com/reference/kotlin/java/lang/String.html>String</a> networkCode, <a href=https://developer.android.com/reference/kotlin/java/lang/String.html>String</a> customAssetKey, <a href=https://developer.android.com/reference/kotlin/java/lang/String.html>String</a> backdropDoubleBox, <a href=https://developer.android.com/reference/kotlin/java/lang/String.html>String</a> backdropLShape, <a href=TheoAdsLayoutOverride.html>TheoAdsLayoutOverride</a> overrideLayout, <a href=https://developer.android.com/reference/kotlin/java/util/Map.html>Map</a>&lt;<a href=https://developer.android.com/reference/kotlin/java/lang/String.html>String</a>, <a href=https://developer.android.com/reference/kotlin/java/lang/String.html>String</a>&gt; adTagParameters, <a href=https://developer.android.com/reference/kotlin/java/lang/Boolean.html>Boolean</a> useId3)</pre>
                                         <div class="block"></div>
 
                                     </li>
@@ -506,6 +520,29 @@ <h4>getOverrideLayout</h4>
 
 
 
+                                        </dl>
+                                    </li>
+                                </ul>
+
+                                <a id="getAdTagParameters()">
+                                    <!--   -->
+                                </a>
+                                <ul class=
+                                              "blockList"
+                                          >
+                                    <li class="blockList">
+                                        <h4>getAdTagParameters</h4>
+                                        <pre class="methodSignature"> final <a href=https://developer.android.com/reference/kotlin/java/util/Map.html>Map</a>&lt;<a href=https://developer.android.com/reference/kotlin/java/lang/String.html>String</a>, <a href=https://developer.android.com/reference/kotlin/java/lang/String.html>String</a>&gt; <a href=TheoAdDescription.html#getAdTagParameters()>getAdTagParameters</a>()</pre>
+                                        <div class="block"><p>The ad tag parameters added to the stream request.</p></div>
+
+                                        <dl>
+
+
+
+
+
+
+
                                         </dl>
                                     </li>
                                 </ul>

diff --git a/...r/v8/api-reference/android/com/theoplayer/android/api/ads/theoads/TheoAdsIntegration.html b/...r/v8/api-reference/android/com/theoplayer/android/api/ads/theoads/TheoAdsIntegration.html
@@ -248,6 +248,14 @@ <h3>Method Summary</h3>
                                             <th class="colLast" scope="col">Description</th>
                                         </tr>
 
+                                        <tr id="i0" class="altColor">
+                                            <td class="colFirst"><code>abstract <a href=https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-unit/index.html>Unit</a></code>
+                                            </td>
+                                            <th class="colSecond" scope="row"><code><a href=TheoAdsIntegration.html#replaceAdTagParameters(java.util.Map)>replaceAdTagParameters</a>(<a href=https://developer.android.com/reference/kotlin/java/util/Map.html>Map</a>&lt;<a href=https://developer.android.com/reference/kotlin/java/lang/String.html>String</a>, <a href=https://developer.android.com/reference/kotlin/java/lang/String.html>String</a>&gt; adTagParameters) </code>
+                                            </th>
+                                            <td class="colLast">Replaces all of the ad tag parameters used for upcoming ad requests for a live stream.</td>
+                                        </tr>
+
                                         </tbody>
                                     </table>
                                 </div>
@@ -298,6 +306,29 @@ <h3>Constructor Detail</h3>
                             </a>
                                 <h3>Method Detail</h3>
 
+                                <a id="replaceAdTagParameters(java.util.Map)">
+                                    <!--   -->
+                                </a>
+                                <ul class=
+                                              "blockListLast"
+                                          >
+                                    <li class="blockList">
+                                        <h4>replaceAdTagParameters</h4>
+                                        <pre class="methodSignature"> abstract <a href=https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-unit/index.html>Unit</a> <a href=TheoAdsIntegration.html#replaceAdTagParameters(java.util.Map)>replaceAdTagParameters</a>(<a href=https://developer.android.com/reference/kotlin/java/util/Map.html>Map</a>&lt;<a href=https://developer.android.com/reference/kotlin/java/lang/String.html>String</a>, <a href=https://developer.android.com/reference/kotlin/java/lang/String.html>String</a>&gt; adTagParameters)</pre>
+                                        <div class="block"><p>Replaces all of the ad tag parameters used for upcoming ad requests for a live stream.</p><p>If set, this value overrides any parameters set on the <a href=TheoAdDescription.html#adTagParameters>TheoAdDescription.adTagParameters</a>.</p></div>
+
+                                        <dl>
+
+
+
+
+
+
+
+                                        </dl>
+                                    </li>
+                                </ul>
+
                             </li>
                         </ul>
                     </section>