Expose Android SurfaceType

untracked

CHANGELOG.md

@@ -6,6 +6,10 @@
 
 - Update Bitmovin's native iOS SDK version to `3.80.0`
 
+### Added
+
+- Android: `PlayerViewConfig.surfaceType` that allows to render video on a `TextureView`
+
 ## [0.35.0] - 2024-12-10
 
 ### Changed

android/src/main/java/com/bitmovin/player/reactnative/converter/JsonConverter.kt

@@ -51,6 +51,7 @@ import com.bitmovin.player.api.source.TimelineReferencePoint
 import com.bitmovin.player.api.ui.PlayerViewConfig
 import com.bitmovin.player.api.ui.ScalingMode
 import com.bitmovin.player.api.ui.StyleConfig
+import com.bitmovin.player.api.ui.SurfaceType
 import com.bitmovin.player.api.ui.UiConfig
 import com.bitmovin.player.reactnative.BitmovinCastManagerOptions
 import com.bitmovin.player.reactnative.PictureInPictureConfig
@@ -772,8 +773,15 @@ fun ReadableMap.toPictureInPictureConfig(): PictureInPictureConfig = PictureInPi
 fun ReadableMap.toPlayerViewConfig(): PlayerViewConfig = PlayerViewConfig(
     uiConfig = getMap("uiConfig")?.toUiConfig() ?: UiConfig.WebUi(),
     hideFirstFrame = getBooleanOrNull("hideFirstFrame") ?: false,
+    surfaceType = getString("surfaceType")?.toSurfaceType() ?: SurfaceType.SurfaceView,
 )
 
+private fun String.toSurfaceType(): SurfaceType? = when (this) {
+    "SurfaceView" -> SurfaceType.SurfaceView
+    "TextureView" -> SurfaceType.TextureView
+    else -> null
+}
+
 private fun ReadableMap.toUiConfig(): UiConfig {
     val variant = toVariant() ?: UiConfig.WebUi.Variant.SmallScreenUi
     val focusUiOnInitialization = getBooleanOrNull("focusUiOnInitialization")

src/components/PlayerView/playerViewConfig.ts

@@ -27,6 +27,18 @@ export interface PlayerViewConfig {
    * To reliably hide the first frame before a pre-roll ad, please ensure that you are using the {@link AdvertisingConfig} to schedule ads and not the {@link Player.scheduleAd} API call.
    */
   hideFirstFrame?: boolean;
+
+  /**
+   * Specify on which surface type the video should be rendered.
+   *
+   * See {@link https://developer.android.com/guide/topics/media/ui/playerview#surfacetype|Choosing a surface type}
+   * for more information.
+   *
+   * Default is {@link SurfaceType.SurfaceView}.
+   *
+   * @platform Android
+   */
+  surfaceType?: SurfaceType;
 }
 
 /**
@@ -97,3 +109,19 @@ export class CustomUi extends Variant {
     super(uiManagerFactoryFunction);
   }
 }
+
+/**
+ * The type of surface on which to render video.
+ *
+ * See {@link https://developer.android.com/guide/topics/media/ui/playerview#surfacetype|Choosing a surface type}
+ * for more information.
+ */
+export enum SurfaceType {
+  /**
+   * SurfaceView generally causes lower battery consumption,
+   * and has better handling for HDR and secure content.
+   */
+  SurfaceView,
+  /** TextureView is sometime needed for smooth animations. */
+  TextureView,
+}