bitmovin-player-react-native 1.18.0 → 1.20.1

package/plugin/src/withBitmovinIosConfig.ts

@@ -61,10 +61,12 @@ const withBitmovinIosConfig: ConfigPlugin<BitmovinConfigOptions> = (
         delete config.modResults['BitmovinPlayerOfflineSupportEnabled'];
       }
       if (googleCastConfig?.ios != null) {
+        const defaultLocalNetworkUsageDescription =
+          '${PRODUCT_NAME} uses the local network to discover Cast-enabled devices on your WiFi network.';
         const localNetworkUsageDescription =
-          typeof googleCastConfig?.ios === 'object'
+          (typeof googleCastConfig?.ios === 'object'
             ? googleCastConfig?.ios?.localNetworkUsageDescription
-            : '${PRODUCT_NAME} uses the local network to discover Cast-enabled devices on your WiFi network.';
+            : undefined) ?? defaultLocalNetworkUsageDescription;
 
         config.modResults['BitmovinPlayerGoogleCastApplicationId'] =
           googleCastAppId;

package/src/advertising.ts

@@ -113,6 +113,26 @@ export interface AdvertisingConfig {
    * - `false` → the ad item will be skipped and removed from the playback schedule.
    */
   shouldLoadAdItem?: (adItem: AdItem) => boolean;
+  /**
+   * Called right before a scheduled ad break starts playback.
+   *
+   * Use this callback to conditionally allow or skip ad breaks at runtime
+   * (e.g., when starting playback from a time offset and discarding past breaks).
+   *
+   * @param adBreak - The ad break that is about to start.
+   *
+   * @returns
+   * - `true` → the ad break will start playback.
+   * - `false` → the ad break will be skipped.
+   *
+   * @remarks
+   * If the callback does not return within the platform's internal timeout,
+   * the ad break will play.
+   * The callback must be synchronous.
+   *
+   * @platform Android
+   */
+  shouldPlayAdBreak?: (adBreak: AdBreak) => boolean;
   /**
    * Configuration to customize Google IMA SDK integration.
    */

package/src/components/PlayerView/events.ts

@@ -247,8 +247,6 @@ export type PlayerViewEvents = {
   onPictureInPictureEnter?: (event: PictureInPictureEnterEvent) => void;
   /**
    * Event emitted when the player entered Picture in Picture mode.
-   *
-   * @platform iOS
    */
   onPictureInPictureEntered?: (event: PictureInPictureEnteredEvent) => void;
   /**
@@ -257,8 +255,6 @@ export type PlayerViewEvents = {
   onPictureInPictureExit?: (event: PictureInPictureExitEvent) => void;
   /**
    * Event emitted when the player exited Picture in Picture mode.
-   *
-   * @platform iOS
    */
   onPictureInPictureExited?: (event: PictureInPictureExitedEvent) => void;
   /**

package/src/components/PlayerView/nativeEvents.ts

@@ -262,8 +262,6 @@ export type NativePlayerViewEvents = {
   }) => void;
   /**
    * Event emitted when the player entered Picture in Picture mode.
-   *
-   * @platform iOS
    */
   onBmpPictureInPictureEntered?: (event: {
     nativeEvent: PictureInPictureEnteredEvent;
@@ -276,8 +274,6 @@ export type NativePlayerViewEvents = {
   }) => void;
   /**
    * Event emitted when the player exited Picture in Picture mode.
-   *
-   * @platform iOS
    */
   onBmpPictureInPictureExited?: (event: {
     nativeEvent: PictureInPictureExitedEvent;

package/src/events.ts

@@ -383,14 +383,14 @@ export type PictureInPictureExitEvent = Event;
 /**
  * Emitted when the player has finished entering Picture in Picture mode on iOS.
  *
- * @platform iOS
+ * @platform iOS, Android
  */
 export type PictureInPictureEnteredEvent = Event;
 
 /**
  * Emitted when the player has finished exiting Picture in Picture mode on iOS.
  *
- * @platform iOS
+ * @platform iOS, Android
  */
 export type PictureInPictureExitedEvent = Event;
 

package/src/modules/PlayerModule.ts

@@ -1,5 +1,5 @@
 import { NativeModule, requireNativeModule } from 'expo-modules-core';
-import { AdItem, ImaSettings } from '../advertising';
+import { AdBreak, AdItem, ImaSettings } from '../advertising';
 
 export type PlayerModuleEvents = {
   onShouldLoadAdItem: ({
@@ -11,6 +11,15 @@ export type PlayerModuleEvents = {
     id: number;
     adItem: AdItem;
   }) => void;
+  onShouldPlayAdBreak: ({
+    nativeId,
+    id,
+    adBreak,
+  }: {
+    nativeId: string;
+    id: number;
+    adBreak: AdBreak;
+  }) => void;
   onImaBeforeInitialization: ({
     nativeId,
     id,
@@ -173,6 +182,11 @@ declare class PlayerModule extends NativeModule<PlayerModuleEvents> {
    */
   setShouldLoadAdItem(id: number, shouldLoad: boolean): Promise<void>;
 
+  /**
+   * Applies the JS decision for an ad break playback callback.
+   */
+  setShouldPlayAdBreak(id: number, shouldPlay: boolean): Promise<void>;
+
   /**
    * Applies the JS-updated IMA settings for a before-initialization callback.
    */

package/src/player.ts

@@ -9,7 +9,7 @@ import { OfflineContentManager, OfflineSourceOptions } from './offline';
 import { Thumbnail } from './thumbnail';
 import { AnalyticsApi } from './analytics/player';
 import { PlayerConfig } from './playerConfig';
-import { AdItem, ImaSettings } from './advertising';
+import { AdBreak, AdItem, ImaSettings } from './advertising';
 import { BufferApi } from './bufferApi';
 import { VideoQuality } from './media';
 import { Network } from './network';
@@ -52,6 +52,7 @@ export class Player extends NativeInstance<PlayerConfig> {
 
   private decoderConfig?: DecoderConfigBridge;
   private onShouldLoadAdItemSubscription?: EventSubscription;
+  private onShouldPlayAdBreakSubscription?: EventSubscription;
   private onImaBeforeInitializationSubscription?: EventSubscription;
   /**
    * Allocates the native `Player` instance and its resources natively.
@@ -59,6 +60,7 @@ export class Player extends NativeInstance<PlayerConfig> {
   initialize = async (): Promise<void> => {
     if (!this.isInitialized) {
       this.ensureShouldLoadAdItemListener();
+      this.ensureShouldPlayAdBreakListener();
       this.ensureImaBeforeInitializationListener();
       if (this.config?.networkConfig) {
         this.network = new Network(this.config.networkConfig);
@@ -99,8 +101,10 @@ export class Player extends NativeInstance<PlayerConfig> {
       void this.network?.destroy();
       void this.decoderConfig?.destroy();
       this.onShouldLoadAdItemSubscription?.remove();
+      this.onShouldPlayAdBreakSubscription?.remove();
       this.onImaBeforeInitializationSubscription?.remove();
       this.onShouldLoadAdItemSubscription = undefined;
+      this.onShouldPlayAdBreakSubscription = undefined;
       this.onImaBeforeInitializationSubscription = undefined;
       this.isDestroyed = true;
     }
@@ -238,6 +242,43 @@ export class Player extends NativeInstance<PlayerConfig> {
     void PlayerModule.setVolume(this.nativeId, volume);
   };
 
+  private ensureShouldPlayAdBreakListener = () => {
+    if (Platform.OS !== 'android') {
+      return;
+    }
+    const callback = this.config?.advertisingConfig?.shouldPlayAdBreak;
+    if (!callback) {
+      return;
+    }
+    if (this.onShouldPlayAdBreakSubscription) {
+      return;
+    }
+    this.onShouldPlayAdBreakSubscription = PlayerModule.addListener(
+      'onShouldPlayAdBreak',
+      ({ nativeId, id, adBreak }) => {
+        if (nativeId !== this.nativeId) {
+          return;
+        }
+        const cloned: AdBreak = {
+          ...adBreak,
+          ads: adBreak.ads.map((ad) => ({
+            ...ad,
+            data: ad.data ? { ...ad.data } : undefined,
+          })),
+        };
+        let shouldPlay = true;
+        try {
+          const shouldPlayResult = callback(cloned);
+          shouldPlay =
+            typeof shouldPlayResult === 'boolean' ? shouldPlayResult : true;
+        } catch {
+          shouldPlay = true;
+        }
+        void PlayerModule.setShouldPlayAdBreak(id, shouldPlay);
+      }
+    );
+  };
+
   private ensureImaBeforeInitializationListener = () => {
     const callback = this.config?.advertisingConfig?.ima?.beforeInitialization;
     if (!callback) {