bitmovin-player-react-native 0.44.1-alpha.0 → 1.0.0-alpha.0

package/android/src/main/java/com/bitmovin/player/reactnative/extensions/ListExtension.kt

@@ -0,0 +1,89 @@
+package com.bitmovin.player.reactnative.extensions
+
+fun List<Any?>.getBooleanOrNull(index: Int): Boolean? = 
+    if (index in indices) get(index) as? Boolean else null
+
+fun List<Any?>.getIntOrNull(index: Int): Int? = 
+    if (index in indices) (get(index) as? Number)?.toInt() else null
+
+fun List<Any?>.getInt(index: Int): Int = 
+    if (index in indices) (get(index) as? Number)?.toInt() ?: 0 else 0
+
+fun List<Any?>.getDoubleOrNull(index: Int): Double? = 
+    if (index in indices) (get(index) as? Number)?.toDouble() else null
+
+fun List<Any?>.getString(index: Int): String? = 
+    if (index in indices) get(index) as? String else null
+
+fun List<Any?>.getMap(index: Int): Map<String, Any?>? = 
+    if (index in indices) get(index) as? Map<String, Any?> else null
+
+fun List<Any?>.getArray(index: Int): List<Any?>? = 
+    if (index in indices) get(index) as? List<Any?> else null
+
+inline fun <T> List<Any?>.withDouble(
+    index: Int,
+    block: (Double) -> T,
+): T? {
+    val value = if (index in indices) (get(index) as? Number)?.toDouble() else null
+    return if (value != null) block(value) else null
+}
+
+inline fun <T> List<Any?>.withMap(
+    index: Int,
+    block: (Map<String, Any?>) -> T,
+): T? {
+    val value = if (index in indices) get(index) as? Map<String, Any?> else null
+    return if (value != null) block(value) else null
+}
+
+inline fun <T> List<Any?>.withInt(
+    index: Int,
+    block: (Int) -> T,
+): T? {
+    val value = if (index in indices) (get(index) as? Number)?.toInt() else null
+    return if (value != null) block(value) else null
+}
+
+inline fun <T> List<Any?>.withBoolean(
+    index: Int,
+    block: (Boolean) -> T,
+): T? {
+    val value = if (index in indices) get(index) as? Boolean else null
+    return if (value != null) block(value) else null
+}
+
+inline fun <T> List<Any?>.withString(
+    index: Int,
+    block: (String) -> T,
+): T? {
+    val value = if (index in indices) get(index) as? String else null
+    return if (value != null) block(value) else null
+}
+
+inline fun <T> List<Any?>.withArray(
+    index: Int,
+    block: (List<Any?>) -> T,
+): T? {
+    val value = if (index in indices) get(index) as? List<Any?> else null
+    return if (value != null) block(value) else null
+}
+
+inline fun <T> List<Any?>.withStringArray(
+    index: Int,
+    block: (List<String?>) -> T,
+): T? {
+    val value = if (index in indices) (get(index) as? List<*>)?.map { item -> item as? String } else null
+    return if (value != null) block(value) else null
+}
+
+fun List<Any?>.getStringArray(index: Int): List<String?>? = 
+    if (index in indices) (get(index) as? List<*>)?.map { it as? String } else null
+
+inline fun <T, R> List<Any?>.mapValue(
+    index: Int,
+    transform: (Any?) -> R?,
+): R? = if (index in indices) transform(get(index)) else null
+
+inline fun <reified T> List<Any?>.getTyped(index: Int): T? = 
+    if (index in indices) get(index) as? T else null

package/android/src/main/java/com/bitmovin/player/reactnative/extensions/MapExtension.kt

@@ -0,0 +1,95 @@
+package com.bitmovin.player.reactnative.extensions
+
+fun Map<String, Any?>.getBooleanOrNull(key: String): Boolean? = get(key) as? Boolean
+fun Map<String, Any?>.getIntOrNull(key: String): Int? = (get(key) as? Number)?.toInt()
+fun Map<String, Any?>.getInt(key: String): Int = (get(key) as? Number)?.toInt() ?: 0
+fun Map<String, Any?>.getDoubleOrNull(key: String): Double? = (get(key) as? Number)?.toDouble()
+fun Map<String, Any?>.getString(key: String): String? = get(key) as? String
+fun Map<String, Any?>.getMap(key: String): Map<String, Any?>? = get(key) as? Map<String, Any?>
+fun Map<String, Any?>.getArray(key: String): List<Any?>? = get(key) as? List<Any?>
+
+inline fun <T> Map<String, Any?>.withDouble(
+    key: String,
+    block: (Double) -> T,
+): T? {
+    val value = (get(key) as? Number)?.toDouble()
+    return if (value != null) block(value) else null
+}
+
+inline fun <T> Map<String, Any?>.withMap(
+    key: String,
+    block: (Map<String, Any?>) -> T,
+): T? {
+    val value = get(key) as? Map<String, Any?>
+    return if (value != null) block(value) else null
+}
+
+inline fun <T> Map<String, Any?>.withInt(
+    key: String,
+    block: (Int) -> T,
+): T? {
+    val value = (get(key) as? Number)?.toInt()
+    return if (value != null) block(value) else null
+}
+
+inline fun <T> Map<String, Any?>.withBoolean(
+    key: String,
+    block: (Boolean) -> T,
+): T? {
+    val value = get(key) as? Boolean
+    return if (value != null) block(value) else null
+}
+
+inline fun <T> Map<String, Any?>.withString(
+    key: String,
+    block: (String) -> T,
+): T? {
+    val value = get(key) as? String
+    return if (value != null) block(value) else null
+}
+
+inline fun <T> Map<String, Any?>.withArray(
+    key: String,
+    block: (List<Any?>) -> T,
+): T? {
+    val value = get(key) as? List<Any?>
+    return if (value != null) block(value) else null
+}
+
+inline fun <T> Map<String, Any?>.withStringArray(
+    key: String,
+    block: (List<String?>) -> T,
+): T? {
+    val value = (get(key) as? List<*>)?.map { item -> item as? String }
+    return if (value != null) block(value) else null
+}
+
+fun Map<String, Any?>.getStringArray(key: String): List<String?>? = (get(key) as? List<*>)?.map { it as? String }
+
+inline fun <T, R> Map<String, Any?>.mapValue(
+    key: String,
+    transform: (Any?) -> R?,
+): R? = if (containsKey(key)) transform(get(key)) else null
+
+inline fun <reified T> Map<String, Any?>.toMap(): Map<String, T> = mapValues { it.value as T }
+
+/** Convert a [Map] to [Map], adding each [T] value using [put]. */
+private inline fun <T> Map<String, T>.toMap(
+    put: MutableMap<String, Any?>.(String, T) -> Unit = { key, value -> this[key] = value },
+): Map<String, Any?> = mutableMapOf<String, Any?>().apply {
+    forEach { put(it.key, it.value) }
+}
+
+@JvmName("toStringMap")
+fun Map<String, String>.toMap(): Map<String, Any?> = toMap()
+
+fun List<Any?>.toMapList(): List<Map<String, Any?>?> = map { it as? Map<String, Any?> }
+
+fun List<Any?>.toStringList(): List<String?> = map { it as? String }
+fun List<Any?>.toBooleanList(): List<Boolean?> = map { it as? Boolean }
+fun List<Any?>.toDoubleList(): List<Double?> = map { (it as? Number)?.toDouble() }
+fun List<Any?>.toIntList(): List<Int?> = map { (it as? Number)?.toInt() }
+
+inline fun <T> List<T>.mapToList(
+    transform: (T) -> Map<String, Any?>,
+): List<Map<String, Any?>> = map(transform)

package/android/src/main/java/com/bitmovin/player/reactnative/offline/OfflineContentManagerBridge.kt

@@ -1,5 +1,6 @@
 package com.bitmovin.player.reactnative.offline
 
+import android.content.Context
 import com.bitmovin.player.api.deficiency.ErrorEvent
 import com.bitmovin.player.api.offline.OfflineContentManager
 import com.bitmovin.player.api.offline.OfflineContentManagerListener
@@ -9,15 +10,13 @@ import com.bitmovin.player.api.offline.options.OfflineOptionEntryAction
 import com.bitmovin.player.api.offline.options.OfflineOptionEntryState
 import com.bitmovin.player.api.source.SourceConfig
 import com.bitmovin.player.reactnative.NativeId
+import com.bitmovin.player.reactnative.OfflineModule
 import com.bitmovin.player.reactnative.converter.toJson
-import com.facebook.react.bridge.Arguments
-import com.facebook.react.bridge.ReactApplicationContext
-import com.facebook.react.bridge.WritableMap
-import com.facebook.react.modules.core.DeviceEventManagerModule.RCTDeviceEventEmitter
 
 class OfflineContentManagerBridge(
     private val nativeId: NativeId,
-    private val context: ReactApplicationContext,
+    context: Context,
+    private val offlineModule: OfflineModule,
     private val identifier: String,
     source: SourceConfig,
     location: String,
@@ -58,8 +57,7 @@ class OfflineContentManagerBridge(
      */
     fun process(request: OfflineDownloadRequest) {
         if (contentOptions != null) {
-            val sortedVideoOptions = contentOptions!!.videoOptions
-                .sortedBy { option -> option.bitrate }
+            val sortedVideoOptions = contentOptions!!.videoOptions.sortedBy { option -> option.bitrate }
             if (request.minimumBitrate == null) {
                 sortedVideoOptions.lastOrNull()
             } else {
@@ -135,8 +133,7 @@ class OfflineContentManagerBridge(
         options?.videoOptions?.let { allOptions.addAll(it) }
         options?.audioOptions?.let { allOptions.addAll(it) }
         options?.textOptions?.let { allOptions.addAll(it) }
-        val trackableStates =
-            listOf(OfflineOptionEntryState.Suspended, OfflineOptionEntryState.Downloading)
+        val trackableStates = listOf(OfflineOptionEntryState.Suspended, OfflineOptionEntryState.Downloading)
 
         var state = allOptions.firstOrNull { trackableStates.contains(it.state) }?.state
 
@@ -147,86 +144,57 @@ class OfflineContentManagerBridge(
         return state ?: OfflineOptionEntryState.NotDownloaded
     }
 
-    /**
-     * Called when a process call has completed.
-     */
     override fun onCompleted(source: SourceConfig, options: OfflineContentOptions) {
         this.contentOptions = options
         sendEvent(
             OfflineEventType.ON_COMPLETED,
-            Arguments.createMap().apply {
-                putMap("options", options.toJson())
-            },
+            mapOf("options" to options.toJson()),
         )
     }
 
-    /**
-     * Called when an error occurs.
-     */
     override fun onError(source: SourceConfig, event: ErrorEvent) {
         sendEvent(
             OfflineEventType.ON_ERROR,
-            Arguments.createMap().apply {
-                putInt("code", event.code.value)
-                putString("message", event.message)
-            },
+            mapOf(
+                "code" to event.code.value,
+                "message" to event.message,
+            ),
         )
     }
 
-    /**
-     * Called when the progress for a process call changes.
-     */
     override fun onProgress(source: SourceConfig, progress: Float) {
         sendEvent(
             OfflineEventType.ON_PROGRESS,
-            Arguments.createMap().apply {
-                putDouble("progress", progress.toDouble())
-            },
+            mapOf("progress" to progress.toDouble()),
         )
     }
 
-    /**
-     * Called after a getOptions or when am OfflineOptionEntry has been updated during a process call.
-     */
     override fun onOptionsAvailable(source: SourceConfig, options: OfflineContentOptions) {
         this.contentOptions = options
         sendEvent(
             OfflineEventType.ON_OPTIONS_AVAILABLE,
-            Arguments.createMap().apply {
-                putMap("options", options.toJson())
-            },
+            mapOf("options" to options.toJson()),
         )
     }
 
-    /**
-     * Called when the DRM license was updated.
-     */
     override fun onDrmLicenseUpdated(source: SourceConfig) {
         sendEvent(OfflineEventType.ON_DRM_LICENSE_UPDATED)
     }
 
-    /**
-     * Called when all actions have been suspended.
-     */
     override fun onSuspended(source: SourceConfig) {
         sendEvent(OfflineEventType.ON_SUSPENDED)
     }
 
-    /**
-     * Called when all actions have been resumed.
-     */
     override fun onResumed(source: SourceConfig) {
         sendEvent(OfflineEventType.ON_RESUMED)
     }
 
-    private fun sendEvent(eventType: OfflineEventType, event: WritableMap = Arguments.createMap()) {
-        event.putString("nativeId", nativeId)
-        event.putString("identifier", identifier)
-        event.putString("eventType", eventType.eventName)
-        event.putString("state", aggregateState(contentOptions).name)
-        context.rtcDeviceEventEmitter.emit("BitmovinOfflineEvent", event)
+    private fun sendEvent(eventType: OfflineEventType, event: Map<String, Any> = mapOf()) {
+        val mutableEvent = event.toMutableMap()
+        mutableEvent["nativeId"] = nativeId
+        mutableEvent["identifier"] = identifier
+        mutableEvent["eventType"] = eventType.eventName
+        mutableEvent["state"] = aggregateState(contentOptions).name
+        offlineModule.sendEvent("onBitmovinOfflineEvent", mutableEvent)
     }
 }
-
-val ReactApplicationContext.rtcDeviceEventEmitter: RCTDeviceEventEmitter
-    get() = getJSModule(RCTDeviceEventEmitter::class.java)

package/android/src/main/java/com/bitmovin/player/reactnative/ui/CustomMessageHandlerBridge.kt

@@ -1,39 +1,29 @@
 package com.bitmovin.player.reactnative.ui
 
 import android.webkit.JavascriptInterface
+import com.bitmovin.player.reactnative.CustomMessageHandlerModule
 import com.bitmovin.player.reactnative.NativeId
-import com.bitmovin.player.reactnative.extensions.getModule
 import com.bitmovin.player.ui.CustomMessageHandler
-import com.facebook.react.bridge.ReactApplicationContext
 
 class CustomMessageHandlerBridge(
-    val context: ReactApplicationContext,
     private val nativeId: NativeId,
+    private val module: CustomMessageHandlerModule? = null,
 ) {
     val customMessageHandler = CustomMessageHandler(
         object : Any() {
             @JavascriptInterface
-            fun sendSynchronous(name: String, data: String?): String? = context
-                .getModule<CustomMessageHandlerModule>()
-                ?.receivedSynchronousMessage(nativeId, name, data)
+            fun sendSynchronous(
+                name: String,
+                data: String?,
+            ): String? = module?.receivedSynchronousMessage(nativeId, name, data)
 
             @JavascriptInterface
-            fun sendAsynchronous(name: String, data: String?) = context
-                .getModule<CustomMessageHandlerModule>()
-                ?.receivedAsynchronousMessage(nativeId, name, data)
+            fun sendAsynchronous(
+                name: String,
+                data: String?,
+            ) = module?.receivedAsynchronousMessage(nativeId, name, data)
         },
     )
 
-    private var currentSynchronousResult: String? = null
-
     fun sendMessage(message: String, data: String?) = customMessageHandler.sendMessage(message, data)
-
-    fun popSynchronousResult(): String? = currentSynchronousResult?.let {
-        currentSynchronousResult = null
-        return it
-    }
-
-    fun pushSynchronousResult(result: String?) {
-        currentSynchronousResult = result
-    }
 }

package/android/src/main/java/com/bitmovin/player/reactnative/ui/FullscreenHandlerBridge.kt

@@ -1,13 +1,12 @@
 package com.bitmovin.player.reactnative.ui
 
 import com.bitmovin.player.api.ui.FullscreenHandler
+import com.bitmovin.player.reactnative.FullscreenHandlerModule
 import com.bitmovin.player.reactnative.NativeId
-import com.bitmovin.player.reactnative.extensions.getModule
-import com.facebook.react.bridge.ReactApplicationContext
 
 class FullscreenHandlerBridge(
-    val context: ReactApplicationContext,
     private val nativeId: NativeId,
+    private val module: FullscreenHandlerModule? = null,
 ) : FullscreenHandler {
     override var isFullscreen = false
 
@@ -16,15 +15,11 @@ class FullscreenHandlerBridge(
     }
 
     override fun onFullscreenExitRequested() {
-        context
-            .getModule<FullscreenHandlerModule>()
-            ?.requestExitFullscreen(nativeId)
+        module?.requestExitFullscreen(nativeId)
     }
 
     override fun onFullscreenRequested() {
-        context
-            .getModule<FullscreenHandlerModule>()
-            ?.requestEnterFullscreen(nativeId)
+        module?.requestEnterFullscreen(nativeId)
     }
 
     override fun onPause() {

package/app.plugin.js

@@ -0,0 +1,21 @@
+/**
+ * Expo plugin for bitmovin-player-react-native
+ *
+ * Example:
+ *   "plugins": [
+ *     [
+ *       "bitmovin-player-react-native",
+ *       {
+ *          "licenseKey": "ENTER_LICENSE_KEY",
+ *         "featureFlags": {
+ *           "airPlay": true,
+ *           "backgroundPlayback": true,
+ *           "googleCastSDK": { "android": "21.3.0", "ios": "4.8.1.2" },
+ *           "offline": true,
+ *           "pictureInPicture": true
+ *         }
+ *       }
+ *     ]
+ *   ]
+ */
+module.exports = require('./plugin/build');

package/build/BitmovinPlayerReactNative.types.d.ts

@@ -0,0 +1,18 @@
+import type { StyleProp, ViewStyle } from 'react-native';
+export type OnLoadEventPayload = {
+    url: string;
+};
+export type BitmovinPlayerReactNativeModuleEvents = {
+    onChange: (params: ChangeEventPayload) => void;
+};
+export type ChangeEventPayload = {
+    value: string;
+};
+export type BitmovinPlayerReactNativeViewProps = {
+    url: string;
+    onLoad: (event: {
+        nativeEvent: OnLoadEventPayload;
+    }) => void;
+    style?: StyleProp<ViewStyle>;
+};
+//# sourceMappingURL=BitmovinPlayerReactNative.types.d.ts.map

package/build/BitmovinPlayerReactNative.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"BitmovinPlayerReactNative.types.d.ts","sourceRoot":"","sources":["../src/BitmovinPlayerReactNative.types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAEzD,MAAM,MAAM,kBAAkB,GAAG;IAC/B,GAAG,EAAE,MAAM,CAAC;CACb,CAAC;AAEF,MAAM,MAAM,qCAAqC,GAAG;IAClD,QAAQ,EAAE,CAAC,MAAM,EAAE,kBAAkB,KAAK,IAAI,CAAC;CAChD,CAAC;AAEF,MAAM,MAAM,kBAAkB,GAAG;IAC/B,KAAK,EAAE,MAAM,CAAC;CACf,CAAC;AAEF,MAAM,MAAM,kCAAkC,GAAG;IAC/C,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,CAAC,KAAK,EAAE;QAAE,WAAW,EAAE,kBAAkB,CAAA;KAAE,KAAK,IAAI,CAAC;IAC7D,KAAK,CAAC,EAAE,SAAS,CAAC,SAAS,CAAC,CAAC;CAC9B,CAAC"}

package/build/BitmovinPlayerReactNative.types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=BitmovinPlayerReactNative.types.js.map

package/build/BitmovinPlayerReactNative.types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"BitmovinPlayerReactNative.types.js","sourceRoot":"","sources":["../src/BitmovinPlayerReactNative.types.ts"],"names":[],"mappings":"","sourcesContent":["import type { StyleProp, ViewStyle } from 'react-native';\n\nexport type OnLoadEventPayload = {\n  url: string;\n};\n\nexport type BitmovinPlayerReactNativeModuleEvents = {\n  onChange: (params: ChangeEventPayload) => void;\n};\n\nexport type ChangeEventPayload = {\n  value: string;\n};\n\nexport type BitmovinPlayerReactNativeViewProps = {\n  url: string;\n  onLoad: (event: { nativeEvent: OnLoadEventPayload }) => void;\n  style?: StyleProp<ViewStyle>;\n};\n"]}

package/build/adaptationConfig.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Configures the adaptation logic.
+ */
+export interface AdaptationConfig {
+    /**
+     * The upper bitrate boundary in bits per second for approximate network bandwidth consumption of the played source.
+     * Can be set to `undefined` for no limitation.
+     */
+    maxSelectableBitrate?: number;
+    /**
+     * 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
+     * @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;
+}
+//# sourceMappingURL=adaptationConfig.d.ts.map

package/build/adaptationConfig.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"adaptationConfig.d.ts","sourceRoot":"","sources":["../src/adaptationConfig.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B;;;OAGG;IACH,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAE9B;;;;;OAKG;IACH,gCAAgC,CAAC,EAAE,MAAM,CAAC;CAC3C"}

package/build/adaptationConfig.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=adaptationConfig.js.map

package/build/adaptationConfig.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"adaptationConfig.js","sourceRoot":"","sources":["../src/adaptationConfig.ts"],"names":[],"mappings":"","sourcesContent":["/**\n * Configures the adaptation logic.\n */\nexport interface AdaptationConfig {\n  /**\n   * The upper bitrate boundary in bits per second for approximate network bandwidth consumption of the played source.\n   * Can be set to `undefined` for no limitation.\n   */\n  maxSelectableBitrate?: number;\n\n  /**\n   * 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.\n   *\n   * @remarks Platform: Android\n   * @see https://cdn.bitmovin.com/player/android/3/docs/player-core/com.bitmovin.player.api.media/-adaptation-config/initial-bandwidth-estimate-override.html\n   */\n  initialBandwidthEstimateOverride?: number;\n}\n"]}

package/build/advertising.d.ts

@@ -0,0 +1,175 @@
+/**
+ * Quartiles that can be reached during an ad playback.
+ */
+export declare enum AdQuartile {
+    /**
+     * Fist ad quartile.
+     */
+    FIRST = "first",
+    /**
+     * Mid ad quartile.
+     */
+    MID_POINT = "mid_point",
+    /**
+     * Third ad quartile.
+     */
+    THIRD = "third"
+}
+/**
+ * The possible types an `AdSource` can be.
+ */
+export declare enum AdSourceType {
+    /**
+     * Google Interactive Media Ads.
+     */
+    IMA = "ima",
+    /**
+     * Unknown ad source type.
+     */
+    UNKNOWN = "unknown",
+    /**
+     * Progressive ad type.
+     */
+    PROGRESSIVE = "progressive"
+}
+/**
+ * Represents an ad source which can be assigned to an `AdItem`. An `AdItem` can have multiple `AdSource`s
+ * as waterfalling option.
+ */
+export interface AdSource {
+    /**
+     * The ad tag / url to the ad manifest.
+     */
+    tag: string;
+    /**
+     * The `AdSourceType` of this `AdSource`.
+     */
+    type: AdSourceType;
+}
+/**
+ * Represents an ad break which can be scheduled for playback.
+ *
+ * One single `AdItem` can have multiple `AdSource`s where all but the first act as fallback ad sources
+ * if the first one fails to load. The start and end of an ad break are signaled via `AdBreakStartedEvent`
+ * and `AdBreakFinishedEvent`.
+ */
+export interface AdItem {
+    /**
+     * The playback position at which the ad break is scheduled to start. Default value is "pre".
+     *
+     * Possible values are:
+     *  • "pre": pre-roll ad (for VoD and Live streaming)
+     *  • "post": post-roll ad (for VoD streaming only)
+     *  • fractional seconds: "10", "12.5" (mid-roll ad, for VoD and Live streaming)
+     *  • percentage of the entire video duration: "25%", "50%" (mid-roll ad, for VoD streaming only)
+     *  • timecode hh:mm:ss.mmm: "00:10:30.000", "01:00:00.000" (mid-roll ad, for VoD streaming only)
+     */
+    position?: string;
+    /**
+     * The `AdSource`s that make up this `AdItem`. The first ad source in this array is used as the main ad.
+     * Subsequent ad sources act as a fallback, meaning that if the main ad source does not provide a
+     * valid response, the subsequent ad sources will be utilized one after another.
+     *
+     * The fallback ad sources need to have the same `AdSourceType` as the main ad source.
+     */
+    sources: AdSource[];
+    /**
+     * The amount of seconds the ad manifest is loaded in advance
+     * compared to when the ad break is scheduled for playback.
+     *
+     * Default value is 0.0
+     *
+     * @remarks Platform: Android
+     */
+    preloadOffset?: number;
+}
+/**
+ * Contains configuration values regarding the ads which should be played back by the player.
+ */
+export interface AdvertisingConfig {
+    /**
+     * The ad items that are scheduled when a new playback session is started via `Player.load()`.
+     */
+    schedule: AdItem[];
+}
+/**
+ * Contains the base configuration options for an ad.
+ */
+export interface AdConfig {
+    /**
+     * Specifies how many seconds of the main video content should be replaced by ad break(s).
+     */
+    replaceContentDuration: number;
+}
+/**
+ * Holds various additional ad data.
+ */
+export interface AdData {
+    /**
+     * The average bitrate of the progressive media file as defined in the VAST response.
+     */
+    bitrate?: number;
+    /**
+     * The maximum bitrate of the streaming media file as defined in the VAST response.
+     */
+    maxBitrate?: number;
+    /**
+     * The MIME type of the media file or creative as defined in the VAST response.
+     */
+    mimeType?: string;
+    /**
+     * The minimum bitrate of the streaming media file as defined in the VAST response.
+     */
+    minBitrate?: number;
+}
+/**
+ * Defines basic properties available for every ad type.
+ */
+export interface Ad {
+    /**
+     * The url the user should be redirected to when clicking the ad.
+     */
+    clickThroughUrl?: string;
+    /**
+     * Holds various additional `AdData`.
+     */
+    data?: AdData;
+    /**
+     * The height of the ad.
+     */
+    height: number;
+    /**
+     * Identifier for the ad. This might be autogenerated.
+     */
+    id?: string;
+    /**
+     * Determines whether an ad is linear, i.e. playback of main content needs to be paused for the ad.
+     */
+    isLinear: boolean;
+    /**
+     * The corresponding media file url for the ad.
+     */
+    mediaFileUrl?: string;
+    /**
+     * The width of the ad.
+     */
+    width: number;
+}
+/**
+ * Contains information about an ad break.
+ */
+export interface AdBreak {
+    /**
+     * The ads scheduled for this `AdBreak`.
+     */
+    ads: Ad[];
+    /**
+     * The id of the corresponding `AdBreakConfig`. This will be auto-generated.
+     */
+    id: string;
+    /**
+     * The time in seconds in the media timeline the `AdBreak` is scheduled for.
+     */
+    scheduleTime: number;
+}
+//# sourceMappingURL=advertising.d.ts.map