bitmovin-player-react-native 1.2.0 → 1.4.0

package/build/subtitleFormat.js.map

@@ -1 +1 @@
-{"version":3,"file":"subtitleFormat.js","sourceRoot":"","sources":["../src/subtitleFormat.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,CAAN,IAAY,cAqBX;AArBD,WAAY,cAAc;IACxB;;;OAGG;IACH,6BAAW,CAAA;IACX;;;OAGG;IACH,+BAAa,CAAA;IACb;;;OAGG;IACH,6BAAW,CAAA;IACX;;;OAGG;IACH,6BAAW,CAAA;AACb,CAAC,EArBW,cAAc,KAAd,cAAc,QAqBzB","sourcesContent":["/**\n * Supported subtitle/caption file formats.\n * @remarks Platform: Android, iOS, tvOS\n */\nexport enum SubtitleFormat {\n  /**\n   * Closed Captioning (CEA) subtitle format.\n   * @remarks Platform: Android, iOS, tvOS\n   */\n  CEA = 'cea',\n  /**\n   * Timed Text Markup Language (TTML) subtitle format.\n   * @remarks Platform: Android, iOS, tvOS\n   */\n  TTML = 'ttml',\n  /**\n   * Web Video Text Tracks Format (WebVTT) subtitle format.\n   * @remarks Platform: Android, iOS, tvOS\n   */\n  VTT = 'vtt',\n  /**\n   * SubRip (SRT) subtitle format.\n   * @remarks Platform: Android, iOS, tvOS\n   */\n  SRT = 'srt',\n}\n"]}
+{"version":3,"file":"subtitleFormat.js","sourceRoot":"","sources":["../src/subtitleFormat.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,CAAN,IAAY,cAqBX;AArBD,WAAY,cAAc;IACxB;;;OAGG;IACH,6BAAW,CAAA;IACX;;;OAGG;IACH,+BAAa,CAAA;IACb;;;OAGG;IACH,6BAAW,CAAA;IACX;;;OAGG;IACH,6BAAW,CAAA;AACb,CAAC,EArBW,cAAc,KAAd,cAAc,QAqBzB","sourcesContent":["/**\n * Supported subtitle/caption file formats.\n * @platform Android, iOS, tvOS\n */\nexport enum SubtitleFormat {\n  /**\n   * Closed Captioning (CEA) subtitle format.\n   * @platform Android, iOS, tvOS\n   */\n  CEA = 'cea',\n  /**\n   * Timed Text Markup Language (TTML) subtitle format.\n   * @platform Android, iOS, tvOS\n   */\n  TTML = 'ttml',\n  /**\n   * Web Video Text Tracks Format (WebVTT) subtitle format.\n   * @platform Android, iOS, tvOS\n   */\n  VTT = 'vtt',\n  /**\n   * SubRip (SRT) subtitle format.\n   * @platform Android, iOS, tvOS\n   */\n  SRT = 'srt',\n}\n"]}

package/build/subtitleTrack.d.ts

@@ -2,7 +2,7 @@ import { MediaTrackRole } from './mediaTrackRole';
 import { SubtitleFormat } from './subtitleFormat';
 /**
  * Describes a subtitle track.
- * @remarks Platform: Android, iOS, tvOS
+ * @platform Android, iOS, tvOS
  */
 export interface SubtitleTrack {
     /**

package/build/subtitleTrack.js.map

@@ -1 +1 @@
-{"version":3,"file":"subtitleTrack.js","sourceRoot":"","sources":["../src/subtitleTrack.ts"],"names":[],"mappings":"","sourcesContent":["import { MediaTrackRole } from './mediaTrackRole';\nimport { SubtitleFormat } from './subtitleFormat';\n\n/**\n * Describes a subtitle track.\n * @remarks Platform: Android, iOS, tvOS\n */\nexport interface SubtitleTrack {\n  /**\n   * The URL to the timed file, e.g. WebVTT file.\n   */\n  url?: string;\n  /**\n   * The label for this track.\n   */\n  label?: string;\n  /**\n   * The unique identifier for this track. If no value is provided, a random UUIDv4 will be generated for it.\n   */\n  identifier?: string;\n  /**\n   * Specifies the file format to be used by this track.\n   */\n  format?: SubtitleFormat;\n  /**\n   * If set to true, this track would be considered as default. Default is `false`.\n   */\n  isDefault?: boolean;\n  /**\n   * Tells if a subtitle track is forced. If set to `true` it means that the player should automatically\n   * select and switch this subtitle according to the selected audio language. Forced subtitles do\n   * not appear in `Player.getAvailableSubtitles`.\n   *\n   * Default is `false`.\n   */\n  isForced?: boolean;\n  /**\n   * The IETF BCP 47 language tag associated with this track, e.g. `pt`, `en`, `es` etc.\n   */\n  language?: string;\n  /**\n   * An array of {@link MediaTrackRole} objects, each describing a specific role or characteristic of the subtitle track.\n   * This property provides a unified way to understand track purposes (e.g., for accessibility) across platforms.\n   */\n  roles?: MediaTrackRole[];\n}\n\n/**\n * A subtitle track that can be added to `SourceConfig.subtitleTracks`.\n */\nexport interface SideLoadedSubtitleTrack extends SubtitleTrack {\n  url: string;\n  label: string;\n  language: string;\n  format: SubtitleFormat;\n}\n"]}
+{"version":3,"file":"subtitleTrack.js","sourceRoot":"","sources":["../src/subtitleTrack.ts"],"names":[],"mappings":"","sourcesContent":["import { MediaTrackRole } from './mediaTrackRole';\nimport { SubtitleFormat } from './subtitleFormat';\n\n/**\n * Describes a subtitle track.\n * @platform Android, iOS, tvOS\n */\nexport interface SubtitleTrack {\n  /**\n   * The URL to the timed file, e.g. WebVTT file.\n   */\n  url?: string;\n  /**\n   * The label for this track.\n   */\n  label?: string;\n  /**\n   * The unique identifier for this track. If no value is provided, a random UUIDv4 will be generated for it.\n   */\n  identifier?: string;\n  /**\n   * Specifies the file format to be used by this track.\n   */\n  format?: SubtitleFormat;\n  /**\n   * If set to true, this track would be considered as default. Default is `false`.\n   */\n  isDefault?: boolean;\n  /**\n   * Tells if a subtitle track is forced. If set to `true` it means that the player should automatically\n   * select and switch this subtitle according to the selected audio language. Forced subtitles do\n   * not appear in `Player.getAvailableSubtitles`.\n   *\n   * Default is `false`.\n   */\n  isForced?: boolean;\n  /**\n   * The IETF BCP 47 language tag associated with this track, e.g. `pt`, `en`, `es` etc.\n   */\n  language?: string;\n  /**\n   * An array of {@link MediaTrackRole} objects, each describing a specific role or characteristic of the subtitle track.\n   * This property provides a unified way to understand track purposes (e.g., for accessibility) across platforms.\n   */\n  roles?: MediaTrackRole[];\n}\n\n/**\n * A subtitle track that can be added to `SourceConfig.subtitleTracks`.\n */\nexport interface SideLoadedSubtitleTrack extends SubtitleTrack {\n  url: string;\n  label: string;\n  language: string;\n  format: SubtitleFormat;\n}\n"]}

package/build/tweaksConfig.d.ts

@@ -34,7 +34,7 @@ export interface TweaksConfig {
      * Default value in iOS is `1.0`.
      * Default value in Android is `0.2`.
      *
-     * @remarks Platform: iOS, Android
+     * @platform iOS, Android
      */
     timeChangedInterval?: number;
     /**
@@ -48,7 +48,7 @@ export interface TweaksConfig {
      *
      * Default is false.
      *
-     * @remarks Platform: iOS
+     * @platform iOS
      */
     isNativeHlsParsingEnabled?: boolean;
     /**
@@ -61,7 +61,7 @@ export interface TweaksConfig {
      *
      * Default is true.
      *
-     * @remarks Platform: iOS
+     * @platform iOS
      */
     isCustomHlsLoadingEnabled?: boolean;
     /**
@@ -75,7 +75,7 @@ export interface TweaksConfig {
      *
      * Default is 0.5.
      *
-     * @remarks Platform: iOS
+     * @platform iOS
      */
     seekToEndThreshold?: number;
     /**
@@ -84,7 +84,7 @@ export interface TweaksConfig {
      * - 'relaxed': Starts playback when enough media data is buffered and continuous playback without stalling can be ensured. If insufficient media data is buffered for playback to start, the player will act as if the buffer became empty during playback.
      * - 'aggressive': When the buffer is not empty, this setting will cause the player to start playback of available media immediately. If insufficient media data is buffered for playback to start, the player will act as if the buffer became empty during playback.
      *
-     * @remarks Platform: iOS
+     * @platform iOS
      */
     playbackStartBehaviour?: 'relaxed' | 'aggressive';
     /**
@@ -93,20 +93,20 @@ export interface TweaksConfig {
      * - 'relaxed': The player will wait until the buffer is filled that it can, most likely, ensure continuous playback without another stalling right after playback continued.
      * - 'aggressive': The player will try to unstall as soon as some media data became available and will start playback of this media immediately.
      *
-     * @remarks Platform: iOS
+     * @platform iOS
      */
     unstallingBehaviour?: 'relaxed' | 'aggressive';
     /**
      * Constantly aggregated and weighted bandwidth samples are summed up to this weight limit to calculate an bandwidth estimation. Remaining samples (i.e. that would lead to exceeding the limit) are dropped from memory as they are not relevant anymore.
      * Default is 2000.
      *
-     * @remarks Platform: Android
+     * @platform Android
      */
     bandwidthEstimateWeightLimit?: number;
     /**
      * Some devices have an incorrect implementation of MediaCodec.setOutputSurface. This leads to failure when the surface changes. To prevent failure, the codec will be released and re-instantiated in those scenarios.
      *
-     * @remarks Platform: Android
+     * @platform Android
      */
     devicesThatRequireSurfaceWorkaround?: {
         /**
@@ -131,14 +131,14 @@ export interface TweaksConfig {
      * - "en_us" is normalized to "en-us"
      * - "en-US-x-lvariant-POSIX" is normalized to "en-us-posix"
      *
-     * @remarks Platform: Android
+     * @platform Android
      */
     languagePropertyNormalization?: boolean;
     /**
      * The interval in which dynamic DASH windows are updated locally. I.e. The rate by which the
      * playback window is moved forward on the timeline.
      *
-     * @remarks Platform: Android
+     * @platform Android
      */
     localDynamicDashWindowUpdateInterval?: number;
     /**
@@ -146,7 +146,7 @@ export interface TweaksConfig {
      * DRM sessions for clear content avoids the recreation of decoders when transitioning between clear
      * and encrypted sections of content. Default is false.
      *
-     * @remarks Platform: Android
+     * @platform Android
      */
     useDrmSessionForClearPeriods?: boolean;
     /**
@@ -155,7 +155,7 @@ export interface TweaksConfig {
      * periods in a DRM protected source. Using DRM sessions for clear content avoids the recreation of
      * decoders when transitioning between clear and encrypted sections of content. Default is false.
      *
-     * @remarks Platform: Android
+     * @platform Android
      */
     useDrmSessionForClearSources?: boolean;
     /**
@@ -163,7 +163,7 @@ export interface TweaksConfig {
      * matching extractor was found. If the fallback is applied, this will ignore potential incompatibilities
      * with streams and thus can result in unstable or failing playback.
      *
-     * @remarks Platform: Android
+     * @platform Android
      */
     useFiletypeExtractorFallbackForHls?: boolean;
     /**
@@ -176,7 +176,7 @@ export interface TweaksConfig {
      * Default is `true`.
      *
      * @deprecated To enable the Now Playing information use {@link MediaControlConfig.isEnabled}
-     * @remarks Platform: iOS
+     * @platform iOS
      */
     updatesNowPlayingInfoCenter?: boolean;
     /**
@@ -190,7 +190,7 @@ export interface TweaksConfig {
      *
      * Default is `null` i.e not set
      *
-     * @remarks Platform: Android
+     * @platform Android
      */
     forceReuseVideoCodecReasons?: ForceReuseVideoCodecReason[];
 }

package/build/tweaksConfig.js.map

@@ -1 +1 @@
-{"version":3,"file":"tweaksConfig.js","sourceRoot":"","sources":["../src/tweaksConfig.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,MAAM,CAAN,IAAY,0BAaX;AAbD,WAAY,0BAA0B;IACpC;;OAEG;IACH,qEAAuC,CAAA;IACvC;;OAEG;IACH,2EAA6C,CAAA;IAC7C;;OAEG;IACH,6EAA+C,CAAA;AACjD,CAAC,EAbW,0BAA0B,KAA1B,0BAA0B,QAarC","sourcesContent":["/**\n * When switching the video quality, the video decoder's configuration might change\n * as the player can't always know if the codec supports such configuration change, it destroys and recreates it.\n * This behaviour can cause brief black screens when switching between video qualities as codec recreation can be slow.\n *\n * If a codec is know to support a given configuration change without issues,\n * the configuration can be added to the `TweaksConfig.forceReuseVideoCodecReasons`\n * to always reuse the video codec and avoid the black screen.\n */\nexport enum ForceReuseVideoCodecReason {\n  /**\n   * The new video quality color information is not compatible.\n   */\n  ColorInfoMismatch = 'ColorInfoMismatch',\n  /**\n   * The new video quality exceed the decoder's configured maximum sample size.\n   */\n  MaxInputSizeExceeded = 'MaxInputSizeExceeded',\n  /**\n   * The new video quality exceed the decoder's configured maximum resolution.\n   */\n  MaxResolutionExceeded = 'MaxResolutionExceeded',\n}\n\n/**\n * This configuration is used as an incubator for experimental features. Tweaks are not officially\n * supported and are not guaranteed to be stable, i.e. their naming, functionality and API can\n * change at any time within the tweaks or when being promoted to an official feature and moved\n * into its final configuration namespace.\n */\nexport interface TweaksConfig {\n  /**\n   * The frequency in seconds `onTimeChanged` is called with `TimeChangedEvent`s.\n   *\n   * Default value in iOS is `1.0`.\n   * Default value in Android is `0.2`.\n   *\n   * @remarks Platform: iOS, Android\n   */\n  timeChangedInterval?: number;\n  /**\n   * If enabled, HLS playlists will be parsed and additional features and events are enabled. This includes:\n   *\n   * - MetadataEvents carrying segment-specific metadata for custom HLS tags, like `#EXT-X-SCTE35`\n   * - MetadataParsedEvents carrying segment-specific metadata for custom HLS tags, like `#EXT-X-SCTE35`\n   * - DrmDataParsedEvents when a `#EXT-X-KEY` is found\n   * - `Player.availableVideoQualities` includes additional information\n   * - Automatic retries when HLS playlist requests failed with non-2xx HTTP status code\n   *\n   * Default is false.\n   *\n   * @remarks Platform: iOS\n   */\n  isNativeHlsParsingEnabled?: boolean;\n  /**\n   * If enabled, playlists will be downloaded by the Bitmovin Player SDK instead of AVFoundation.\n   * This enables additional features and events, like:\n   *\n   * - DownloadFinishedEvents for playlist downloads.\n   * - SourceWarningEvents when no `#EXT-X-PLAYLIST-TYPE` is found If set to false, enabling\n   * nativeHlsParsingEnabled won’t have any effect.\n   *\n   * Default is true.\n   *\n   * @remarks Platform: iOS\n   */\n  isCustomHlsLoadingEnabled?: boolean;\n  /**\n   * The threshold which will be applied when seeking to the end in seconds. This value will be used\n   * to calculate the maximum seekable time when calling `player.seek(time:)` or `player.playlist.seek(source:time:)`,\n   * so the maximum value will be duration - seekToEndThreshold.\n   *\n   * This is useful if the duration of the segments does not match the duration specified in the\n   * manifest. In this case, if we try to seek to the end, AVPlayer could get stuck and might stall\n   * forever Therefore increasing this value could help.\n   *\n   * Default is 0.5.\n   *\n   * @remarks Platform: iOS\n   */\n  seekToEndThreshold?: number;\n  /**\n   * Specifies the player behaviour when `Player.play` is called. Default is 'relaxed'.\n   *\n   * - 'relaxed': Starts playback when enough media data is buffered and continuous playback without stalling can be ensured. If insufficient media data is buffered for playback to start, the player will act as if the buffer became empty during playback.\n   * - 'aggressive': When the buffer is not empty, this setting will cause the player to start playback of available media immediately. If insufficient media data is buffered for playback to start, the player will act as if the buffer became empty during playback.\n   *\n   * @remarks Platform: iOS\n   */\n  playbackStartBehaviour?: 'relaxed' | 'aggressive';\n  /**\n   * Specifies the player behaviour when stalling should be exited. Default is 'relaxed'.\n   *\n   * - 'relaxed': The player will wait until the buffer is filled that it can, most likely, ensure continuous playback without another stalling right after playback continued.\n   * - 'aggressive': The player will try to unstall as soon as some media data became available and will start playback of this media immediately.\n   *\n   * @remarks Platform: iOS\n   */\n  unstallingBehaviour?: 'relaxed' | 'aggressive';\n  /**\n   * Constantly aggregated and weighted bandwidth samples are summed up to this weight limit to calculate an bandwidth estimation. Remaining samples (i.e. that would lead to exceeding the limit) are dropped from memory as they are not relevant anymore.\n   * Default is 2000.\n   *\n   * @remarks Platform: Android\n   */\n  bandwidthEstimateWeightLimit?: number;\n  /**\n   * Some devices have an incorrect implementation of MediaCodec.setOutputSurface. This leads to failure when the surface changes. To prevent failure, the codec will be released and re-instantiated in those scenarios.\n   *\n   * @remarks Platform: Android\n   */\n  devicesThatRequireSurfaceWorkaround?: {\n    /**\n     * A device name as reported by Build.DEVICE.\n     *\n     * @see Build.DEVICE: https://developer.android.com/reference/kotlin/android/os/Build.html#DEVICE--\n     */\n    deviceNames?: string[];\n    /**\n     * A model name as reported by Build.MODEL.\n     *\n     * @see Build.MODEL: https://developer.android.com/reference/kotlin/android/os/Build.html#MODEL--\n     */\n    modelNames?: string[];\n  };\n  /**\n   * Specifies if the language property on DASH Representations, HLS Renditions and SmoothStreaming QualityLevels is normalized.\n   * If enabled, language properties are normalized to IETF BCP 47 language tags. Default is true.\n   *\n   * Examples:\n   * - \"ENG\" is normalized to \"en\"\n   * - \"en_us\" is normalized to \"en-us\"\n   * - \"en-US-x-lvariant-POSIX\" is normalized to \"en-us-posix\"\n   *\n   * @remarks Platform: Android\n   */\n  languagePropertyNormalization?: boolean;\n  /**\n   * The interval in which dynamic DASH windows are updated locally. I.e. The rate by which the\n   * playback window is moved forward on the timeline.\n   *\n   * @remarks Platform: Android\n   */\n  localDynamicDashWindowUpdateInterval?: number;\n  /**\n   * Specifies whether a DRM session should be used for clear tracks of type video and audio. Using\n   * DRM sessions for clear content avoids the recreation of decoders when transitioning between clear\n   * and encrypted sections of content. Default is false.\n   *\n   * @remarks Platform: Android\n   */\n  useDrmSessionForClearPeriods?: boolean;\n  /**\n   * Specifies whether a DRM session should be used for clear tracks of type video and audio in a clear\n   * source that follows after a DRM protected source. In addition, a DRM session will be used for clear\n   * periods in a DRM protected source. Using DRM sessions for clear content avoids the recreation of\n   * decoders when transitioning between clear and encrypted sections of content. Default is false.\n   *\n   * @remarks Platform: Android\n   */\n  useDrmSessionForClearSources?: boolean;\n  /**\n   * Specifies if the player should always fall back to an extractor matching the file type, if no\n   * matching extractor was found. If the fallback is applied, this will ignore potential incompatibilities\n   * with streams and thus can result in unstable or failing playback.\n   *\n   * @remarks Platform: Android\n   */\n  useFiletypeExtractorFallbackForHls?: boolean;\n  /**\n   * Determines whether `AVKit` should update Now Playing information automatically when using System UI.\n   *\n   * - If set to `false`, the automatic updates of Now Playing Info sent by `AVKit` are disabled.\n   *   This prevents interference with manual updates you may want to perform.\n   * - If set to `true`, the default behaviour is maintained, allowing `AVKit` to handle Now Playing updates.\n   *\n   * Default is `true`.\n   *\n   * @deprecated To enable the Now Playing information use {@link MediaControlConfig.isEnabled}\n   * @remarks Platform: iOS\n   */\n  updatesNowPlayingInfoCenter?: boolean;\n\n  /**\n   * When switching between video formats (eg: adapting between video qualities)\n   * the codec might be recreated due to several reasons.\n   * This behaviour can cause brief black screens when switching between video qualities as codec recreation can be\n   * slow.\n   *\n   * If a device is know to support video format changes and keep the current decoder without issues,\n   * this set can be filled with multiple `ForceReuseVideoCodecReason` and avoid the black screen.\n   *\n   * Default is `null` i.e not set\n   *\n   * @remarks Platform: Android\n   */\n  forceReuseVideoCodecReasons?: ForceReuseVideoCodecReason[];\n}\n"]}
+{"version":3,"file":"tweaksConfig.js","sourceRoot":"","sources":["../src/tweaksConfig.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,MAAM,CAAN,IAAY,0BAaX;AAbD,WAAY,0BAA0B;IACpC;;OAEG;IACH,qEAAuC,CAAA;IACvC;;OAEG;IACH,2EAA6C,CAAA;IAC7C;;OAEG;IACH,6EAA+C,CAAA;AACjD,CAAC,EAbW,0BAA0B,KAA1B,0BAA0B,QAarC","sourcesContent":["/**\n * When switching the video quality, the video decoder's configuration might change\n * as the player can't always know if the codec supports such configuration change, it destroys and recreates it.\n * This behaviour can cause brief black screens when switching between video qualities as codec recreation can be slow.\n *\n * If a codec is know to support a given configuration change without issues,\n * the configuration can be added to the `TweaksConfig.forceReuseVideoCodecReasons`\n * to always reuse the video codec and avoid the black screen.\n */\nexport enum ForceReuseVideoCodecReason {\n  /**\n   * The new video quality color information is not compatible.\n   */\n  ColorInfoMismatch = 'ColorInfoMismatch',\n  /**\n   * The new video quality exceed the decoder's configured maximum sample size.\n   */\n  MaxInputSizeExceeded = 'MaxInputSizeExceeded',\n  /**\n   * The new video quality exceed the decoder's configured maximum resolution.\n   */\n  MaxResolutionExceeded = 'MaxResolutionExceeded',\n}\n\n/**\n * This configuration is used as an incubator for experimental features. Tweaks are not officially\n * supported and are not guaranteed to be stable, i.e. their naming, functionality and API can\n * change at any time within the tweaks or when being promoted to an official feature and moved\n * into its final configuration namespace.\n */\nexport interface TweaksConfig {\n  /**\n   * The frequency in seconds `onTimeChanged` is called with `TimeChangedEvent`s.\n   *\n   * Default value in iOS is `1.0`.\n   * Default value in Android is `0.2`.\n   *\n   * @platform iOS, Android\n   */\n  timeChangedInterval?: number;\n  /**\n   * If enabled, HLS playlists will be parsed and additional features and events are enabled. This includes:\n   *\n   * - MetadataEvents carrying segment-specific metadata for custom HLS tags, like `#EXT-X-SCTE35`\n   * - MetadataParsedEvents carrying segment-specific metadata for custom HLS tags, like `#EXT-X-SCTE35`\n   * - DrmDataParsedEvents when a `#EXT-X-KEY` is found\n   * - `Player.availableVideoQualities` includes additional information\n   * - Automatic retries when HLS playlist requests failed with non-2xx HTTP status code\n   *\n   * Default is false.\n   *\n   * @platform iOS\n   */\n  isNativeHlsParsingEnabled?: boolean;\n  /**\n   * If enabled, playlists will be downloaded by the Bitmovin Player SDK instead of AVFoundation.\n   * This enables additional features and events, like:\n   *\n   * - DownloadFinishedEvents for playlist downloads.\n   * - SourceWarningEvents when no `#EXT-X-PLAYLIST-TYPE` is found If set to false, enabling\n   * nativeHlsParsingEnabled won’t have any effect.\n   *\n   * Default is true.\n   *\n   * @platform iOS\n   */\n  isCustomHlsLoadingEnabled?: boolean;\n  /**\n   * The threshold which will be applied when seeking to the end in seconds. This value will be used\n   * to calculate the maximum seekable time when calling `player.seek(time:)` or `player.playlist.seek(source:time:)`,\n   * so the maximum value will be duration - seekToEndThreshold.\n   *\n   * This is useful if the duration of the segments does not match the duration specified in the\n   * manifest. In this case, if we try to seek to the end, AVPlayer could get stuck and might stall\n   * forever Therefore increasing this value could help.\n   *\n   * Default is 0.5.\n   *\n   * @platform iOS\n   */\n  seekToEndThreshold?: number;\n  /**\n   * Specifies the player behaviour when `Player.play` is called. Default is 'relaxed'.\n   *\n   * - 'relaxed': Starts playback when enough media data is buffered and continuous playback without stalling can be ensured. If insufficient media data is buffered for playback to start, the player will act as if the buffer became empty during playback.\n   * - 'aggressive': When the buffer is not empty, this setting will cause the player to start playback of available media immediately. If insufficient media data is buffered for playback to start, the player will act as if the buffer became empty during playback.\n   *\n   * @platform iOS\n   */\n  playbackStartBehaviour?: 'relaxed' | 'aggressive';\n  /**\n   * Specifies the player behaviour when stalling should be exited. Default is 'relaxed'.\n   *\n   * - 'relaxed': The player will wait until the buffer is filled that it can, most likely, ensure continuous playback without another stalling right after playback continued.\n   * - 'aggressive': The player will try to unstall as soon as some media data became available and will start playback of this media immediately.\n   *\n   * @platform iOS\n   */\n  unstallingBehaviour?: 'relaxed' | 'aggressive';\n  /**\n   * Constantly aggregated and weighted bandwidth samples are summed up to this weight limit to calculate an bandwidth estimation. Remaining samples (i.e. that would lead to exceeding the limit) are dropped from memory as they are not relevant anymore.\n   * Default is 2000.\n   *\n   * @platform Android\n   */\n  bandwidthEstimateWeightLimit?: number;\n  /**\n   * Some devices have an incorrect implementation of MediaCodec.setOutputSurface. This leads to failure when the surface changes. To prevent failure, the codec will be released and re-instantiated in those scenarios.\n   *\n   * @platform Android\n   */\n  devicesThatRequireSurfaceWorkaround?: {\n    /**\n     * A device name as reported by Build.DEVICE.\n     *\n     * @see Build.DEVICE: https://developer.android.com/reference/kotlin/android/os/Build.html#DEVICE--\n     */\n    deviceNames?: string[];\n    /**\n     * A model name as reported by Build.MODEL.\n     *\n     * @see Build.MODEL: https://developer.android.com/reference/kotlin/android/os/Build.html#MODEL--\n     */\n    modelNames?: string[];\n  };\n  /**\n   * Specifies if the language property on DASH Representations, HLS Renditions and SmoothStreaming QualityLevels is normalized.\n   * If enabled, language properties are normalized to IETF BCP 47 language tags. Default is true.\n   *\n   * Examples:\n   * - \"ENG\" is normalized to \"en\"\n   * - \"en_us\" is normalized to \"en-us\"\n   * - \"en-US-x-lvariant-POSIX\" is normalized to \"en-us-posix\"\n   *\n   * @platform Android\n   */\n  languagePropertyNormalization?: boolean;\n  /**\n   * The interval in which dynamic DASH windows are updated locally. I.e. The rate by which the\n   * playback window is moved forward on the timeline.\n   *\n   * @platform Android\n   */\n  localDynamicDashWindowUpdateInterval?: number;\n  /**\n   * Specifies whether a DRM session should be used for clear tracks of type video and audio. Using\n   * DRM sessions for clear content avoids the recreation of decoders when transitioning between clear\n   * and encrypted sections of content. Default is false.\n   *\n   * @platform Android\n   */\n  useDrmSessionForClearPeriods?: boolean;\n  /**\n   * Specifies whether a DRM session should be used for clear tracks of type video and audio in a clear\n   * source that follows after a DRM protected source. In addition, a DRM session will be used for clear\n   * periods in a DRM protected source. Using DRM sessions for clear content avoids the recreation of\n   * decoders when transitioning between clear and encrypted sections of content. Default is false.\n   *\n   * @platform Android\n   */\n  useDrmSessionForClearSources?: boolean;\n  /**\n   * Specifies if the player should always fall back to an extractor matching the file type, if no\n   * matching extractor was found. If the fallback is applied, this will ignore potential incompatibilities\n   * with streams and thus can result in unstable or failing playback.\n   *\n   * @platform Android\n   */\n  useFiletypeExtractorFallbackForHls?: boolean;\n  /**\n   * Determines whether `AVKit` should update Now Playing information automatically when using System UI.\n   *\n   * - If set to `false`, the automatic updates of Now Playing Info sent by `AVKit` are disabled.\n   *   This prevents interference with manual updates you may want to perform.\n   * - If set to `true`, the default behaviour is maintained, allowing `AVKit` to handle Now Playing updates.\n   *\n   * Default is `true`.\n   *\n   * @deprecated To enable the Now Playing information use {@link MediaControlConfig.isEnabled}\n   * @platform iOS\n   */\n  updatesNowPlayingInfoCenter?: boolean;\n\n  /**\n   * When switching between video formats (eg: adapting between video qualities)\n   * the codec might be recreated due to several reasons.\n   * This behaviour can cause brief black screens when switching between video qualities as codec recreation can be\n   * slow.\n   *\n   * If a device is know to support video format changes and keep the current decoder without issues,\n   * this set can be filled with multiple `ForceReuseVideoCodecReason` and avoid the black screen.\n   *\n   * Default is `null` i.e not set\n   *\n   * @platform Android\n   */\n  forceReuseVideoCodecReasons?: ForceReuseVideoCodecReason[];\n}\n"]}

package/ios/FullscreenHandlerModule.swift

@@ -12,30 +12,46 @@ public class FullscreenHandlerModule: Module {
     /// ResultWaiter used for blocking thread while waiting for fullscreen state change
     private let waiter = ResultWaiter<Bool>()
 
+    private var fullscreenActiveUpdateBuffer = LockedBox(value: [NativeId: Bool]())
+
     public func definition() -> ModuleDefinition {
         Name("FullscreenHandlerModule")
 
         OnDestroy {
             fullscreenHandlers.removeAll()
             waiter.removeAll()
+            fullscreenActiveUpdateBuffer.update { value in
+                value.removeAll()
+            }
         }
 
         Events("onEnterFullscreen", "onExitFullscreen")
 
         AsyncFunction("registerHandler") { (nativeId: NativeId) in
             DispatchQueue.main.async { [weak self] in
-                guard let self, self.fullscreenHandlers[nativeId] == nil else {
+                guard let self, fullscreenHandlers[nativeId] == nil else {
                     return
                 }
-                self.fullscreenHandlers[nativeId] = FullscreenHandlerBridge(
+                let handler = FullscreenHandlerBridge(
                     nativeId,
                     moduleRegistry: appContext?.moduleRegistry
                 )
+                if let isFullscreen = fullscreenActiveUpdateBuffer.value[nativeId] {
+                    // Apply buffered value
+                    handler.isFullscreenValueBox.update(isFullscreen)
+                    fullscreenActiveUpdateBuffer.update { value in
+                        value.removeValue(forKey: nativeId)
+                    }
+                }
+                fullscreenHandlers[nativeId] = handler
             }
         }.runOnQueue(.main)
 
         AsyncFunction("destroy") { [weak self] (nativeId: NativeId) in
             self?.fullscreenHandlers.removeValue(forKey: nativeId)
+            self?.fullscreenActiveUpdateBuffer.update { value in
+                value.removeValue(forKey: nativeId)
+            }
         }.runOnQueue(.main)
 
         AsyncFunction("notifyFullscreenChanged") { [weak self] (id: Int, isFullscreenEnabled: Bool) in
@@ -43,7 +59,14 @@ public class FullscreenHandlerModule: Module {
         }
 
         AsyncFunction("setIsFullscreenActive") { [weak self] (nativeId: NativeId, isFullscreen: Bool) in
-            self?.fullscreenHandlers[nativeId]?.isFullscreenValueBox.update(isFullscreen)
+            guard let handler = self?.fullscreenHandlers[nativeId] else {
+                // Buffer the value until the handler is registered
+                self?.fullscreenActiveUpdateBuffer.update { value in
+                    value[nativeId] = isFullscreen
+                }
+                return
+            }
+            handler.isFullscreenValueBox.update(isFullscreen)
         }.runOnQueue(.main)
     }
 

package/ios/LockedBox.swift

@@ -18,4 +18,10 @@ internal class LockedBox<T> {
             self._value = value
         }
     }
+
+    func update(_ updateBlock: (inout T) -> Void) {
+        lock.withLock {
+            updateBlock(&self._value)
+        }
+    }
 }

package/ios/PlayerModule.swift

@@ -1,7 +1,10 @@
 import BitmovinPlayer
 import ExpoModulesCore
 
+// swiftlint:disable:next type_body_length
 public class PlayerModule: Module {
+    private let imaSettingsWaiter = ResultWaiter<[String: Any]>()
+
     // swiftlint:disable:next function_body_length
     public func definition() -> ModuleDefinition {
         Name("PlayerModule")
@@ -14,7 +17,9 @@ public class PlayerModule: Module {
                 PlayerRegistry.getAllPlayers().forEach { $0.destroy() }
                 PlayerRegistry.clear()
             }
+            imaSettingsWaiter.removeAll()
         }
+        Events("onImaBeforeInitialization")
         AsyncFunction("play") { (nativeId: NativeId) in
             PlayerRegistry.getPlayer(nativeId: nativeId)?.play()
         }.runOnQueue(.main)
@@ -169,6 +174,9 @@ public class PlayerModule: Module {
         AsyncFunction("skipAd") { (nativeId: NativeId) in
             PlayerRegistry.getPlayer(nativeId: nativeId)?.skipAd()
         }.runOnQueue(.main)
+        AsyncFunction("setPreparedImaSettings") { [weak self] (id: Int, settings: [String: Any]?) in
+            self?.imaSettingsWaiter.complete(id: id, with: settings ?? [:])
+        }
         AsyncFunction(
             "initializeWithConfig"
         ) { [weak self] (nativeId: NativeId, config: [String: Any]?, networkNativeId: NativeId?, _: String?) in // swiftlint:disable:this line_length
@@ -180,6 +188,7 @@ public class PlayerModule: Module {
             if let networkNativeId, let networkConfig = self?.setupNetworkConfig(nativeId: networkNativeId) {
                 playerConfig.networkConfig = networkConfig
             }
+            self?.setupImaBeforeInitialization(nativeId: nativeId, config: config, playerConfig: playerConfig)
             let player = PlayerFactory.create(playerConfig: playerConfig)
             PlayerRegistry.register(player: player, nativeId: nativeId)
         }.runOnQueue(.main)
@@ -195,6 +204,7 @@ public class PlayerModule: Module {
             if let networkNativeId, let networkConfig = self?.setupNetworkConfig(nativeId: networkNativeId) {
                 playerConfig.networkConfig = networkConfig
             }
+            self?.setupImaBeforeInitialization(nativeId: nativeId, config: config, playerConfig: playerConfig)
             let defaultMetadata = RCTConvert.analyticsDefaultMetadataFromAnalyticsConfig(analyticsConfig)
             let player = PlayerFactory.create(
                 playerConfig: playerConfig,
@@ -235,4 +245,34 @@ public class PlayerModule: Module {
         }
         return networkModule.retrieve(nativeId)
     }
+
+    private func setupImaBeforeInitialization(
+        nativeId: NativeId,
+        config: [String: Any]?,
+        playerConfig: PlayerConfig
+    ) {
+        guard
+            let advertisingJson = config?["advertisingConfig"] as? [String: Any],
+            let imaJson = advertisingJson["ima"] as? [String: Any],
+            imaJson["beforeInitialization"] != nil
+        else {
+            return
+        }
+
+        playerConfig.advertisingConfig.beforeInitialization = { [weak self] settings in
+            guard let self else { return }
+            let (id, wait) = imaSettingsWaiter.make(timeout: 0.25)
+            let payload = RCTConvert.imaSettingsDictionary(settings)
+            self.sendEvent(
+                "onImaBeforeInitialization",
+                [
+                    "nativeId": nativeId,
+                    "id": id,
+                    "settings": payload
+                ]
+            )
+            guard let updated = wait() else { return }
+            RCTConvert.applyImaSettings(settings, from: updated)
+        }
+    }
 }

package/ios/RCTConvert+BitmovinPlayer.swift

@@ -247,6 +247,47 @@ extension RCTConvert {
         return AdvertisingConfig(schedule: schedule.compactMap { RCTConvert.adItem($0) })
     }
 
+    static func imaSettingsDictionary(_ settings: ImaSettings) -> [String: Any] {
+        var map: [String: Any] = [
+            "language": settings.language,
+            "maxRedirects": Int(settings.maxRedirects),
+            "enableBackgroundPlayback": settings.enableBackgroundPlayback,
+            "ppid": settings.ppid,
+            "playerVersion": settings.playerVersion,
+            "sessionId": settings.sessionId
+        ]
+#if !os(tvOS)
+        map["sameAppKeyEnabled"] = settings.sameAppKeyEnabled
+#endif
+        return map
+    }
+
+    static func applyImaSettings(_ settings: ImaSettings, from json: [String: Any]) {
+        if let ppid = json["ppid"] as? String {
+            settings.ppid = ppid
+        }
+        if let language = json["language"] as? String {
+            settings.language = language
+        }
+        if let redirects = json["maxRedirects"] as? NSNumber {
+            settings.maxRedirects = redirects.uintValue
+        }
+        if let enableBackgroundPlayback = json["enableBackgroundPlayback"] as? Bool {
+            settings.enableBackgroundPlayback = enableBackgroundPlayback
+        }
+        if let playerVersion = json["playerVersion"] as? String {
+            settings.playerVersion = playerVersion
+        }
+        if let sessionId = json["sessionId"] as? String {
+            settings.sessionId = sessionId
+        }
+#if !os(tvOS)
+        if let sameAppKeyEnabled = json["sameAppKeyEnabled"] as? Bool {
+            settings.sameAppKeyEnabled = sameAppKeyEnabled
+        }
+#endif
+    }
+
     static func adItem(_ json: Any?) -> AdItem? {
         guard
             let json = json as? [String: Any?],

package/ios/RNBitmovinPlayer.podspec

@@ -28,7 +28,7 @@ Pod::Spec.new do |s|
   s.static_framework = true
 
   s.dependency 'ExpoModulesCore'
-  s.dependency "BitmovinPlayer", "3.97.2"
+  s.dependency "BitmovinPlayer", "3.98.0"
   s.ios.dependency "GoogleAds-IMA-iOS-SDK", "3.26.1"
   s.tvos.dependency "GoogleAds-IMA-tvOS-SDK", "4.15.1"
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "bitmovin-player-react-native",
-  "version": "1.2.0",
+  "version": "1.4.0",
   "description": "Official React Native bindings for Bitmovin's mobile Player SDKs.",
   "main": "build/index.js",
   "types": "build/index.d.ts",

package/plugin/build/withBitmovinConfig.js

@@ -43,8 +43,14 @@ const defaultFeatures = {
 const withBitmovinConfig = (config, options) => {
     const { playerLicenseKey, features } = options;
     const mergedFeatures = { ...defaultFeatures, ...(features || {}) };
-    config = (0, withBitmovinIosConfig_1.default)(config, { playerLicenseKey, features: mergedFeatures });
-    config = (0, withBitmovinAndroidConfig_1.default)(config, { playerLicenseKey, features: mergedFeatures });
+    config = (0, withBitmovinIosConfig_1.default)(config, {
+        playerLicenseKey,
+        features: mergedFeatures,
+    });
+    config = (0, withBitmovinAndroidConfig_1.default)(config, {
+        playerLicenseKey,
+        features: mergedFeatures,
+    });
     return config;
 };
 exports.default = withBitmovinConfig;

package/plugin/src/withAppGradleDependencies.ts

@@ -38,38 +38,39 @@ const withAppGradleDependencies: ConfigPlugin<PluginProps> = (
       return config;
     }
 
-    const androidBlockStart = config.modResults.contents.search(/^android \{$/m);
+    const androidBlockStart =
+      config.modResults.contents.search(/^android \{$/m);
     if (androidBlockStart === -1) {
       WarningAggregator.addWarningAndroid(
-          'withAppGradleDependencies',
-          `Cannot configure app/build.gradle as no android block start was found`
+        'withAppGradleDependencies',
+        `Cannot configure app/build.gradle as no android block start was found`
       );
       return config;
     }
-    const fromAndroid = config.modResults.contents.substring(
-      androidBlockStart
-    );
+    const fromAndroid = config.modResults.contents.substring(androidBlockStart);
     const androidBlockEnd = fromAndroid.search(/^\}$/m);
     if (androidBlockEnd === -1) {
       WarningAggregator.addWarningAndroid(
-          'withAppGradleDependencies',
-          `Cannot configure app/build.gradle as no android block end was found`
+        'withAppGradleDependencies',
+        `Cannot configure app/build.gradle as no android block end was found`
       );
       return config;
     }
     const androidPosition = androidBlockStart + androidBlockEnd;
-    const compileOptions = []
-      compileOptions.push(`${combinedProps.spacing}compileOptions {`)
-      compileOptions.push('\n');
-      compileOptions.push(`${combinedProps.spacing}setCoreLibraryDesugaringEnabled(true)`)
-      compileOptions.push('\n');
-      compileOptions.push(`${combinedProps.spacing}}`)
-      compileOptions.push('\n');
-      config.modResults.contents = [
-          config.modResults.contents.slice(0, androidPosition),
-          ... compileOptions,
-          config.modResults.contents.slice(androidPosition),
-      ].join('');
+    const compileOptions = [];
+    compileOptions.push(`${combinedProps.spacing}compileOptions {`);
+    compileOptions.push('\n');
+    compileOptions.push(
+      `${combinedProps.spacing}setCoreLibraryDesugaringEnabled(true)`
+    );
+    compileOptions.push('\n');
+    compileOptions.push(`${combinedProps.spacing}}`);
+    compileOptions.push('\n');
+    config.modResults.contents = [
+      config.modResults.contents.slice(0, androidPosition),
+      ...compileOptions,
+      config.modResults.contents.slice(androidPosition),
+    ].join('');
 
     const dependenciesBlockStart =
       config.modResults.contents.search(/^dependencies \{$/m);
@@ -94,7 +95,9 @@ const withAppGradleDependencies: ConfigPlugin<PluginProps> = (
     const position = dependenciesBlockStart + dependenciesBlockEnd;
     let insertedDependencies: string[] = [];
     insertedDependencies.push('\n');
-    insertedDependencies.push(`${combinedProps.spacing}coreLibraryDesugaring 'com.android.tools:desugar_jdk_libs:2.1.5'`)
+    insertedDependencies.push(
+      `${combinedProps.spacing}coreLibraryDesugaring 'com.android.tools:desugar_jdk_libs:2.1.5'`
+    );
     insertedDependencies.push('\n');
     filteredDependencies.forEach((dependency) => {
       insertedDependencies.push(

package/plugin/src/withBitmovinAndroidConfig.ts

@@ -9,7 +9,10 @@ import { BitmovinConfigOptions } from './withBitmovinConfig';
 
 type ManifestActivity = AndroidConfig.Manifest.ManifestActivity;
 
-const withBitmovinAndroidConfig: ConfigPlugin<BitmovinConfigOptions> = (config, options) => {
+const withBitmovinAndroidConfig: ConfigPlugin<BitmovinConfigOptions> = (
+  config,
+  options
+) => {
   const { playerLicenseKey = '', features = {} } = options || {};
   const offlineFeatureConfig =
     typeof features.offline === 'object'

package/plugin/src/withBitmovinConfig.ts

@@ -44,11 +44,20 @@ export interface BitmovinConfigOptions {
  *   ]
  * };
  */
-const withBitmovinConfig: ConfigPlugin<BitmovinConfigOptions> = (config, options) => {
+const withBitmovinConfig: ConfigPlugin<BitmovinConfigOptions> = (
+  config,
+  options
+) => {
   const { playerLicenseKey, features } = options;
   const mergedFeatures = { ...defaultFeatures, ...(features || {}) };
-  config = withBitmovinIosConfig(config, { playerLicenseKey, features: mergedFeatures });
-  config = withBitmovinAndroidConfig(config, { playerLicenseKey, features: mergedFeatures });
+  config = withBitmovinIosConfig(config, {
+    playerLicenseKey,
+    features: mergedFeatures,
+  });
+  config = withBitmovinAndroidConfig(config, {
+    playerLicenseKey,
+    features: mergedFeatures,
+  });
   return config;
 };
 

package/plugin/src/withBitmovinIosConfig.ts

@@ -7,7 +7,10 @@ import { BitmovinConfigOptions } from './withBitmovinConfig';
 
 const isTV = !!process.env.EXPO_TV;
 
-const withBitmovinIosConfig: ConfigPlugin<BitmovinConfigOptions> = (config, options) => {
+const withBitmovinIosConfig: ConfigPlugin<BitmovinConfigOptions> = (
+  config,
+  options
+) => {
   const { playerLicenseKey = '', features = {} } = options || {};
   const offlineFeatureConfig =
     typeof features.offline === 'object'

package/src/adaptationConfig.ts

@@ -11,7 +11,7 @@ export interface AdaptationConfig {
   /**
    * The initial bandwidth estimate in bits per second the player uses to select the optimal media tracks before actual bandwidth data is available. Overriding this value should only be done in specific cases and will most of the time not result in better selection logic.
    *
-   * @remarks Platform: Android
+   * @platform Android
    * @see https://cdn.bitmovin.com/player/android/3/docs/player-core/com.bitmovin.player.api.media/-adaptation-config/initial-bandwidth-estimate-override.html
    */
   initialBandwidthEstimateOverride?: number;

package/src/advertising.ts

@@ -83,7 +83,7 @@ export interface AdItem {
    *
    * Default value is 0.0
    *
-   * @remarks Platform: Android
+   * @platform Android
    */
   preloadOffset?: number;
 }
@@ -96,6 +96,61 @@ export interface AdvertisingConfig {
    * The ad items that are scheduled when a new playback session is started via `Player.load()`.
    */
   schedule: AdItem[];
+  /**
+   * Configuration to customize Google IMA SDK integration.
+   */
+  ima?: ImaAdvertisingConfig;
+}
+
+/**
+ * Configuration options applied to Google IMA SDK before initialization.
+ */
+export interface ImaAdvertisingConfig {
+  /**
+   * Invoked before the IMA SDK initializes, allowing mutation of the SDK settings.
+   *
+   * @param settings - Current IMA settings received from the native SDK.
+   * @returns The settings object to apply. If omitted, the (mutated) `settings` argument is used.
+   */
+  beforeInitialization?: (settings: ImaSettings) => ImaSettings | void;
+}
+
+/**
+ * Represents Google IMA SDK wide settings.
+ */
+export interface ImaSettings {
+  /**
+   * Publisher Provided Identification (PPID) sent with ad requests.
+   */
+  ppid?: string;
+  /**
+   * Language identifier in IETF BCP 47 format.
+   */
+  language: string;
+  /**
+   * Maximum allowed wrapper redirects. Default is `4`.
+   */
+  maxRedirects: number;
+  /**
+   * Enables background audio playback. Defaults to `false`.
+   *
+   * @platform iOS, tvOS
+   */
+  enableBackgroundPlayback?: boolean;
+  /**
+   * Player version identifier reported to IMA.
+   */
+  playerVersion?: string;
+  /**
+   * Session identifier used for frequency capping.
+   */
+  sessionId?: string;
+  /**
+   * Controls Same App Key usage.
+   *
+   * @platform iOS
+   */
+  sameAppKeyEnabled?: boolean;
 }
 
 /**