adding prop useTextureView={true}

Author: Gurdeep99

android/src/main/java/com/video/PlayerCore.kt

@@ -86,6 +86,18 @@ object PlayerCore {
   private var player: ExoPlayer? = null
   private var playerView: PlayerView? = null
 
+  /**
+   * Surface type for the singleton PlayerView, set via [setUseTextureView]
+   * before [initialize] first inflates it. surface_type is only settable via
+   * layout attrs, hence the two layouts. Changing this after the view exists
+   * has no effect until the app restarts.
+   */
+  private var useTextureView = true
+
+  fun setUseTextureView(value: Boolean) {
+    useTextureView = value
+  }
+
   // Second engine: a re-parentable WebView running the YouTube IFrame API.
   private enum class Engine { EXO, WEB }
   private var engine = Engine.EXO
@@ -171,8 +183,10 @@ object PlayerCore {
     player = exo
 
     // Inflated from XML because surface_type can only be set via attrs.
+    val layoutRes =
+      if (useTextureView) R.layout.video_player_view else R.layout.video_player_view_surface
     val view = LayoutInflater.from(context.applicationContext)
-      .inflate(R.layout.video_player_view, null) as PlayerView
+      .inflate(layoutRes, null) as PlayerView
     view.player = exo
     playerView = view
   }

android/src/main/java/com/video/VideoModule.kt

@@ -35,6 +35,10 @@ class VideoModule(reactContext: ReactApplicationContext) :
     }
   }
 
+  override fun setUseTextureView(useTextureView: Boolean) {
+    PlayerCore.setUseTextureView(useTextureView)
+  }
+
   override fun releasePlayer() {
     UiThreadUtil.runOnUiThread {
       PlayerCore.release()

android/src/main/res/layout/video_player_view_surface.xml

@@ -0,0 +1,11 @@
+<?xml version="1.0" encoding="utf-8"?>
+<!-- SurfaceView variant, opted into via setUseTextureView(false). Cheaper to
+     render than a TextureView but can't be transformed/animated and tends to
+     black-flash across a re-parent; only used when the app asks for it. -->
+<androidx.media3.ui.PlayerView
+    xmlns:android="http://schemas.android.com/apk/res/android"
+    xmlns:app="http://schemas.android.com/apk/res-auto"
+    android:layout_width="match_parent"
+    android:layout_height="match_parent"
+    app:surface_type="surface_view"
+    app:use_controller="false" />

ios/Video.mm

@@ -69,6 +69,12 @@ - (void)releasePlayer
   });
 }
 
+- (void)setUseTextureView:(BOOL)useTextureView
+{
+  // TextureView vs. SurfaceView is an Android-only concept (AVPlayerLayer
+  // has no equivalent choice) — nothing to do on iOS.
+}
+
 #pragma mark - Source
 
 - (void)setSource:(NativeVideoSource &)source autoplay:(BOOL)autoplay

scripts/postinstall.js

@@ -16,14 +16,15 @@
 const force =
   process.argv.includes('--force') || process.env.AU_VIDEO_BANNER === '1';
 
-const BANNER = `
-  ________                 .___                       _________.__               .__     
- /  _____/ __ _________  __| _/____   ____ ______    /   _____/|__| ____    ____ |  |__  
-/   \  ___|  |  \_  __ \/ __ |/ __ \_/ __ \\____ \   \_____  \ |  |/    \  / ___\|  |  \ 
-\    \_\  \  |  /|  | \/ /_/ \  ___/\  ___/|  |_> >  /        \|  |   |  \/ /_/  >   Y  \
- \______  /____/ |__|  \____ |\___  >\___  >   __/  /_______  /|__|___|  /\___  /|___|  /
-        \/                  \/    \/     \/|__|             \/         \//_____/      \/          
-        `;
+const BANNER = String.raw`
+ __   __  ______      _______  ___   __    _  _______  __   __ 
+|  |_|  ||    _ |    |       ||   | |  |  | ||       ||  | |  |
+|       ||   | ||    |  _____||   | |   |_| ||    ___||  |_|  |
+|       ||   |_||_   | |_____ |   | |       ||   | __ |       |
+|       ||    __  |  |_____  ||   | |  _    ||   ||  ||       |
+| ||_|| ||   |  | |   _____| ||   | | | |   ||   |_| ||   _   |
+|_|   |_||___|  |_|  |_______||___| |_|  |__||_______||__| |__|
+`;
 
 try {
   const quiet = process.env.CI || process.env.npm_config_loglevel === 'silent';

src/NativeVideo.ts

@@ -64,6 +64,16 @@ export interface Spec extends TurboModule {
   /** Idempotent. Creates the singleton native player if needed. */
   nativeInit(): void;
 
+  /**
+   * Android only (no-op on iOS): back the player view with a TextureView
+   * (default) or a SurfaceView. Must be called before `nativeInit()` creates
+   * the singleton player view — later calls are ignored until the app
+   * restarts. TextureView re-parents cleanly across surfaces (floating
+   * window, feed cells) at a small performance cost; SurfaceView is cheaper
+   * but can't be animated/transformed and misbehaves when re-parented.
+   */
+  setUseTextureView(useTextureView: boolean): void;
+
   /**
    * Load a source into the engine. If the currently loaded source has the
    * same `id`, this is a no-op (same-video handoff) and playback continues.

src/core/VideoManager.ts

@@ -154,6 +154,7 @@ export class VideoManager {
     liveAutoRetry: true,
     resumeOnFocus: true,
     debug: false,
+    useTextureView: true,
   };
   /** Last non-reserved surface, restored after fullscreen/floating exits. */
   private lastInlineSurfaceId: string | null = null;
@@ -271,6 +272,9 @@ export class VideoManager {
       return;
     }
     this.initialized = true;
+    // Must precede nativeInit(): it decides which surface type Android
+    // inflates the singleton PlayerView with, and that only happens once.
+    NativeVideo.setUseTextureView(this.config.useTextureView);
     NativeVideo.nativeInit();
     this.subscribeNative();
     this.setupNetInfo();

src/types/video.ts

@@ -168,4 +168,17 @@ export interface VideoProviderConfig {
    * invisible from the outside. Off by default.
    */
   debug?: boolean;
+  /**
+   * Android only (ignored on iOS). Back the player view with a TextureView
+   * (default) or a SurfaceView.
+   *
+   * TextureView is what makes the player re-parent cleanly between surfaces
+   * (inline -> fullscreen -> floating, feed cells) without a black flash, at
+   * a small rendering-performance cost. SurfaceView is cheaper but can't be
+   * animated or transformed and tends to show a black frame across a
+   * re-parent — only worth it if the app never moves the player between
+   * surfaces. Applied once, at provider init; changing it later has no
+   * effect until the app restarts. Default true.
+   */
+  useTextureView?: boolean;
 }