@capgo/capacitor-video-player 8.1.22 → 8.1.24

package/README.md

@@ -152,6 +152,8 @@ Picture in Picture on Android requires your app activity to declare PiP support
 * [`showController()`](#showcontroller)
 * [`isControllerIsFullyVisible()`](#iscontrollerisfullyvisible)
 * [`exitPlayer()`](#exitplayer)
+* [`hidePlayer()`](#hideplayer)
+* [`showPlayer()`](#showplayer)
 * [Interfaces](#interfaces)
 
 </docgen-index>
@@ -432,6 +434,34 @@ Exit player
 --------------------
 
 
+### hidePlayer()
+
+```typescript
+hidePlayer() => Promise<capVideoPlayerResult>
+```
+
+Hide the currently presented player UI without stopping playback (native fullscreen).
+
+Call `showPlayer()` to show it again.
+
+**Returns:** <code>Promise&lt;<a href="#capvideoplayerresult">capVideoPlayerResult</a>&gt;</code>
+
+--------------------
+
+
+### showPlayer()
+
+```typescript
+showPlayer() => Promise<capVideoPlayerResult>
+```
+
+Show again a previously hidden player UI (native fullscreen).
+
+**Returns:** <code>Promise&lt;<a href="#capvideoplayerresult">capVideoPlayerResult</a>&gt;</code>
+
+--------------------
+
+
 ### Interfaces
 
 
@@ -447,31 +477,33 @@ Exit player
 
 #### capVideoPlayerOptions
 
-| Prop                  | Type                                                        | Description                                                                                                                                                                           |
-| --------------------- | ----------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| **`mode`**            | <code>string</code>                                         | Player mode - "fullscreen" - "embedded" (Web only)                                                                                                                                    |
-| **`url`**             | <code>string</code>                                         | The url of the video to play                                                                                                                                                          |
-| **`subtitle`**        | <code>string</code>                                         | The url of subtitle associated with the video                                                                                                                                         |
-| **`language`**        | <code>string</code>                                         | The language of subtitle see https://github.com/libyal/libfwnt/wiki/Language-Code-identifiers                                                                                         |
-| **`subtitleOptions`** | <code><a href="#subtitleoptions">SubTitleOptions</a></code> | SubTitle Options                                                                                                                                                                      |
-| **`playerId`**        | <code>string</code>                                         | Id of DIV Element parent of the player                                                                                                                                                |
-| **`rate`**            | <code>number</code>                                         | Initial playing rate                                                                                                                                                                  |
-| **`exitOnEnd`**       | <code>boolean</code>                                        | Exit on VideoEnd (iOS, Android) default: true                                                                                                                                         |
-| **`loopOnEnd`**       | <code>boolean</code>                                        | Loop on VideoEnd when exitOnEnd false (iOS, Android) default: false                                                                                                                   |
-| **`pipEnabled`**      | <code>boolean</code>                                        | Picture in Picture Enable (iOS, Android) default: true                                                                                                                                |
-| **`bkmodeEnabled`**   | <code>boolean</code>                                        | Background Mode Enable (iOS, Android) default: true                                                                                                                                   |
-| **`showControls`**    | <code>boolean</code>                                        | Show Controls Enable (iOS, Android) default: true                                                                                                                                     |
-| **`displayMode`**     | <code>string</code>                                         | Display Mode ["all", "portrait", "landscape"] (iOS, Android) default: "all"                                                                                                           |
-| **`componentTag`**    | <code>string</code>                                         | Component Tag or DOM Element Tag (React app)                                                                                                                                          |
-| **`width`**           | <code>number</code>                                         | Player Width (mode "embedded" only)                                                                                                                                                   |
-| **`height`**          | <code>number</code>                                         | Player height (mode "embedded" only)                                                                                                                                                  |
-| **`headers`**         | <code>{ [key: string]: string; }</code>                     | Headers for the request (iOS, Android) by Manuel García Marín (https://github.com/PhantomPainX)                                                                                       |
-| **`title`**           | <code>string</code>                                         | Title shown in the player and Chromecast metadata (iOS, Android) by Manuel García Marín (https://github.com/PhantomPainX)                                                             |
-| **`smallTitle`**      | <code>string</code>                                         | Subtitle shown below the title in the player and Chromecast metadata (iOS, Android) by Manuel García Marín (https://github.com/PhantomPainX)                                          |
-| **`accentColor`**     | <code>string</code>                                         | ExoPlayer Progress Bar and Spinner color (Android) by Manuel García Marín (https://github.com/PhantomPainX) Must be a valid hex color code default: #FFFFFF                           |
-| **`chromecast`**      | <code>boolean</code>                                        | Chromecast enable/disable (iOS, Android) iOS requires Google Cast SDK setup and local network Info.plist keys. by Manuel García Marín (https://github.com/PhantomPainX) default: true |
-| **`artwork`**         | <code>string</code>                                         | Artwork url to be shown in Chromecast player (iOS, Android) by Manuel García Marín (https://github.com/PhantomPainX) default: ""                                                      |
-| **`drm`**             | <code><a href="#drmoptions">DrmOptions</a></code>           | DRM configuration for protected content (iOS: FairPlay, Android: Widevine)                                                                                                            |
+| Prop                  | Type                                                        | Description                                                                                                                                                                                                                                 |
+| --------------------- | ----------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| **`mode`**            | <code>string</code>                                         | Player mode - "fullscreen" - "embedded" (Web only)                                                                                                                                                                                          |
+| **`url`**             | <code>string</code>                                         | The url of the video to play                                                                                                                                                                                                                |
+| **`chromecastUrl`**   | <code>string</code>                                         | Optional override URL used when casting to Chromecast (iOS, Android). This lets you cast an alternative rendition/manifest (e.g. MPEG-DASH + Widevine) while keeping the on-device playback URL unchanged (e.g. HLS + FairPlay on iOS).     |
+| **`subtitle`**        | <code>string</code>                                         | The url of subtitle associated with the video                                                                                                                                                                                               |
+| **`language`**        | <code>string</code>                                         | The language of subtitle see https://github.com/libyal/libfwnt/wiki/Language-Code-identifiers                                                                                                                                               |
+| **`subtitleOptions`** | <code><a href="#subtitleoptions">SubTitleOptions</a></code> | SubTitle Options                                                                                                                                                                                                                            |
+| **`playerId`**        | <code>string</code>                                         | Id of DIV Element parent of the player                                                                                                                                                                                                      |
+| **`rate`**            | <code>number</code>                                         | Initial playing rate                                                                                                                                                                                                                        |
+| **`exitOnEnd`**       | <code>boolean</code>                                        | Exit on VideoEnd (iOS, Android) default: true                                                                                                                                                                                               |
+| **`loopOnEnd`**       | <code>boolean</code>                                        | Loop on VideoEnd when exitOnEnd false (iOS, Android) default: false                                                                                                                                                                         |
+| **`pipEnabled`**      | <code>boolean</code>                                        | Picture in Picture Enable (iOS, Android) default: true                                                                                                                                                                                      |
+| **`bkmodeEnabled`**   | <code>boolean</code>                                        | Background Mode Enable (iOS, Android) default: true                                                                                                                                                                                         |
+| **`audioCategory`**   | <code>'ambient' \| 'playback' \| 'moviePlayback'</code>     | iOS audio session category behavior (iOS). - "ambient": respects the iPhone silent switch (default) - "playback": ignores the iPhone silent switch - "moviePlayback": playback optimized for video and long-form AirPlay default: "ambient" |
+| **`showControls`**    | <code>boolean</code>                                        | Show Controls Enable (iOS, Android) default: true                                                                                                                                                                                           |
+| **`displayMode`**     | <code>string</code>                                         | Display Mode ["all", "portrait", "landscape"] (iOS, Android) default: "all"                                                                                                                                                                 |
+| **`componentTag`**    | <code>string</code>                                         | Component Tag or DOM Element Tag (React app)                                                                                                                                                                                                |
+| **`width`**           | <code>number</code>                                         | Player Width (mode "embedded" only)                                                                                                                                                                                                         |
+| **`height`**          | <code>number</code>                                         | Player height (mode "embedded" only)                                                                                                                                                                                                        |
+| **`headers`**         | <code>{ [key: string]: string; }</code>                     | Headers for the request (iOS, Android) by Manuel García Marín (https://github.com/PhantomPainX)                                                                                                                                             |
+| **`title`**           | <code>string</code>                                         | Title shown in the player and Chromecast metadata (iOS, Android) by Manuel García Marín (https://github.com/PhantomPainX)                                                                                                                   |
+| **`smallTitle`**      | <code>string</code>                                         | Subtitle shown below the title in the player and Chromecast metadata (iOS, Android) by Manuel García Marín (https://github.com/PhantomPainX)                                                                                                |
+| **`accentColor`**     | <code>string</code>                                         | ExoPlayer Progress Bar and Spinner color (Android) by Manuel García Marín (https://github.com/PhantomPainX) Must be a valid hex color code default: #FFFFFF                                                                                 |
+| **`chromecast`**      | <code>boolean</code>                                        | Chromecast enable/disable (iOS, Android) iOS requires Google Cast SDK setup and local network Info.plist keys. by Manuel García Marín (https://github.com/PhantomPainX) default: true                                                       |
+| **`artwork`**         | <code>string</code>                                         | Artwork url to be shown in Chromecast player (iOS, Android) by Manuel García Marín (https://github.com/PhantomPainX) default: ""                                                                                                            |
+| **`drm`**             | <code><a href="#drmoptions">DrmOptions</a></code>           | DRM configuration for protected content (iOS: FairPlay, Android: Widevine) When casting, Widevine's `certificateUrl` (license URL) is also forwarded to Chromecast receivers as `media.customData.laurl`.                                   |
 
 
 #### SubTitleOptions
@@ -498,10 +530,11 @@ Exit player
 
 #### FairPlayDrmOptions
 
-| Prop                   | Type                | Description                                                                       |
-| ---------------------- | ------------------- | --------------------------------------------------------------------------------- |
-| **`certificateUrl`**   | <code>string</code> | The URL to fetch the FairPlay certificate                                         |
-| **`contentKeySpcUrl`** | <code>string</code> | The URL to send the SPC and receive the CKC license (FairPlay license server URL) |
+| Prop                   | Type                | Description                                                                                                                        |
+| ---------------------- | ------------------- | ---------------------------------------------------------------------------------------------------------------------------------- |
+| **`certificateUrl`**   | <code>string</code> | The URL to fetch the FairPlay certificate                                                                                          |
+| **`contentKeySpcUrl`** | <code>string</code> | The URL to send the SPC and receive the CKC license (FairPlay license server URL)                                                  |
+| **`assetId`**          | <code>string</code> | Optional FairPlay asset identifier used when generating the SPC. Defaults to the `skd://` content identifier from the key request. |
 
 
 #### PlayreadyDrmOptions

package/android/src/main/AndroidManifest.xml

@@ -1,3 +1,7 @@
-<manifest xmlns:android="http://schemas.android.com/apk/res/android"
-    >
+<manifest xmlns:android="http://schemas.android.com/apk/res/android">
+    <application>
+        <meta-data
+            android:name="com.google.android.gms.cast.framework.OPTIONS_PROVIDER_CLASS_NAME"
+            android:value="com.capgo.videoplayer.VideoPlayerCastOptionsProvider" />
+    </application>
 </manifest>

package/android/src/main/java/com/capgo/videoplayer/FullscreenExoPlayerFragment.java

@@ -55,6 +55,7 @@ import com.google.android.exoplayer2.MediaItem;
 import com.google.android.exoplayer2.MediaMetadata;
 import com.google.android.exoplayer2.PlaybackParameters;
 import com.google.android.exoplayer2.Player;
+import com.google.android.exoplayer2.Tracks;
 import com.google.android.exoplayer2.audio.AudioAttributes;
 import com.google.android.exoplayer2.ext.cast.CastPlayer;
 import com.google.android.exoplayer2.ext.cast.DefaultMediaItemConverter;
@@ -110,6 +111,7 @@ import org.json.JSONObject;
 public class FullscreenExoPlayerFragment extends Fragment {
 
     public String videoPath;
+    public String chromecastUrl;
     public Float videoRate;
     public String playerId;
     public String subTitle;
@@ -207,6 +209,10 @@ public class FullscreenExoPlayerFragment extends Fragment {
     private CastStateListener castStateListener = null;
     private Boolean playerReady = false;
 
+    private boolean isChromecastEnabled() {
+        return Boolean.TRUE.equals(chromecast);
+    }
+
     /**
      * Create Fragment View
      * @param inflater
@@ -254,7 +260,7 @@ public class FullscreenExoPlayerFragment extends Fragment {
             styledPlayerView.setUseController(true);
         }
 
-        if (!chromecast) {
+        if (!isChromecastEnabled()) {
             mediaRouteButton.setVisibility(View.GONE);
         } else {
             initializeCastService();
@@ -318,6 +324,7 @@ public class FullscreenExoPlayerFragment extends Fragment {
                         }
                         linearLayout.setVisibility(View.INVISIBLE);
                         Log.v(TAG, "**** in ExoPlayer.STATE_READY firstReadyToPlay " + firstReadyToPlay);
+                        updateSubtitleButtonVisibility(player.getCurrentTracks());
 
                         if (firstReadyToPlay) {
                             firstReadyToPlay = false;
@@ -377,6 +384,11 @@ public class FullscreenExoPlayerFragment extends Fragment {
                         break;
                 }
             }
+
+            @Override
+            public void onTracksChanged(Tracks tracks) {
+                updateSubtitleButtonVisibility(tracks);
+            }
         };
 
         if (isTV) {
@@ -708,7 +720,7 @@ public class FullscreenExoPlayerFragment extends Fragment {
 
         if (styledPlayerView != null) {
             // If cast is playing then it doesn't start the local player once get backs from background
-            if (castContext != null && chromecast && castPlayer.isCastSessionAvailable()) return;
+            if (isChromecastEnabled() && castContext != null && castPlayer != null && castPlayer.isCastSessionAvailable()) return;
 
             initializePlayer();
             if (player.getCurrentPosition() != 0) {
@@ -746,7 +758,7 @@ public class FullscreenExoPlayerFragment extends Fragment {
     @Override
     public void onDestroy() {
         super.onDestroy();
-        if (chromecast) mRouter.removeCallback(mCallback);
+        if (isChromecastEnabled() && mRouter != null) mRouter.removeCallback(mCallback);
         releasePlayer();
     }
 
@@ -756,7 +768,9 @@ public class FullscreenExoPlayerFragment extends Fragment {
     @Override
     public void onPause() {
         super.onPause();
-        if (chromecast) castContext.removeCastStateListener(castStateListener);
+        if (isChromecastEnabled() && castContext != null && castStateListener != null) castContext.removeCastStateListener(
+            castStateListener
+        );
         boolean isAppBackground = false;
         if (bkModeEnabled) isAppBackground = isApplicationSentToBackground(context);
 
@@ -792,7 +806,7 @@ public class FullscreenExoPlayerFragment extends Fragment {
             player = null;
             showSystemUI();
             resetVariables();
-            if (chromecast) {
+            if (isChromecastEnabled() && castPlayer != null) {
                 castPlayer.release();
                 castPlayer = null;
             }
@@ -871,6 +885,7 @@ public class FullscreenExoPlayerFragment extends Fragment {
         }
 
         styledPlayerView.setPlayer(player);
+        updateSubtitleButtonVisibility(player.getCurrentTracks());
 
         MediaSource mediaSource;
         if (!isInternal) {
@@ -911,6 +926,26 @@ public class FullscreenExoPlayerFragment extends Fragment {
         NotificationCenter.defaultCenter().postNotification("initializePlayer", info);
     }
 
+    private void updateSubtitleButtonVisibility(Tracks tracks) {
+        if (styledPlayerView == null) return;
+        if (sturi != null) {
+            styledPlayerView.setShowSubtitleButton(true);
+            return;
+        }
+        styledPlayerView.setShowSubtitleButton(hasSupportedTextTrack(tracks));
+    }
+
+    private boolean hasSupportedTextTrack(Tracks tracks) {
+        if (tracks == null) return false;
+        for (Tracks.Group group : tracks.getGroups()) {
+            if (group.getType() != C.TRACK_TYPE_TEXT) continue;
+            for (int i = 0; i < group.length; i++) {
+                if (group.isTrackSupported(i)) return true;
+            }
+        }
+        return false;
+    }
+
     private void setSubtitle(boolean transparent) {
         int foreground;
         int background;
@@ -1508,7 +1543,10 @@ public class FullscreenExoPlayerFragment extends Fragment {
                         mRouter.addCallback(mSelector, mCallback, MediaRouter.CALLBACK_FLAG_REQUEST_DISCOVERY);
                     } else {
                         Exception e = task.getException();
-                        e.printStackTrace();
+                        Log.e(TAG, "Failed to initialize Chromecast", e);
+                        if (mediaRouteButton != null) {
+                            mediaRouteButton.setVisibility(View.GONE);
+                        }
                     }
                 }
             }
@@ -1518,6 +1556,9 @@ public class FullscreenExoPlayerFragment extends Fragment {
     private final class EmptyCallback extends MediaRouter.Callback {}
 
     private Uri getCastUri() {
+        if (chromecastUrl != null && !chromecastUrl.isEmpty()) {
+            return Uri.parse(chromecastUrl);
+        }
         return uri != null ? uri : Uri.parse(videoPath);
     }
 
@@ -1594,6 +1635,7 @@ public class FullscreenExoPlayerFragment extends Fragment {
 
         private static final String KEY_MEDIA_ITEM = "mediaItem";
         private static final String KEY_PLAYER_CONFIG = "exoPlayerConfig";
+        private static final String KEY_WIDEVINE_LICENSE_URL = "laurl";
         private static final String KEY_MEDIA_ID = "mediaId";
         private static final String KEY_URI = "uri";
         private static final String KEY_TITLE = "title";
@@ -1712,6 +1754,11 @@ public class FullscreenExoPlayerFragment extends Fragment {
                 if (playerConfig != null) {
                     customData.put(KEY_PLAYER_CONFIG, playerConfig);
                 }
+                MediaItem.LocalConfiguration localConfiguration = mediaItem.localConfiguration;
+                MediaItem.DrmConfiguration drmConfiguration = localConfiguration != null ? localConfiguration.drmConfiguration : null;
+                if (drmConfiguration != null && C.WIDEVINE_UUID.equals(drmConfiguration.scheme) && drmConfiguration.licenseUri != null) {
+                    customData.put(KEY_WIDEVINE_LICENSE_URL, drmConfiguration.licenseUri.toString());
+                }
                 return customData;
             } catch (JSONException e) {
                 throw new RuntimeException(e);

package/android/src/main/java/com/capgo/videoplayer/VideoPlayer.java

@@ -14,6 +14,7 @@ public class VideoPlayer {
 
     public FullscreenExoPlayerFragment createFullScreenFragment(
         String videoPath,
+        String chromecastUrl,
         Float videoRate,
         Boolean exitOnEnd,
         Boolean loopOnEnd,
@@ -39,6 +40,7 @@ public class VideoPlayer {
         FullscreenExoPlayerFragment fsFragment = new FullscreenExoPlayerFragment();
 
         fsFragment.videoPath = videoPath;
+        fsFragment.chromecastUrl = chromecastUrl;
         fsFragment.videoRate = videoRate;
         fsFragment.exitOnEnd = exitOnEnd;
         fsFragment.loopOnEnd = loopOnEnd;

package/android/src/main/java/com/capgo/videoplayer/VideoPlayerCastOptionsProvider.java

@@ -0,0 +1,26 @@
+package com.capgo.videoplayer;
+
+import android.content.Context;
+import com.google.android.gms.cast.CastMediaControlIntent;
+import com.google.android.gms.cast.framework.CastOptions;
+import com.google.android.gms.cast.framework.OptionsProvider;
+import com.google.android.gms.cast.framework.SessionProvider;
+import com.google.android.gms.cast.framework.media.CastMediaOptions;
+import com.google.android.gms.cast.framework.media.NotificationOptions;
+import java.util.List;
+
+public class VideoPlayerCastOptionsProvider implements OptionsProvider {
+
+    @Override
+    public CastOptions getCastOptions(Context context) {
+        return new CastOptions.Builder()
+            .setReceiverApplicationId(CastMediaControlIntent.DEFAULT_MEDIA_RECEIVER_APPLICATION_ID)
+            .setCastMediaOptions(new CastMediaOptions.Builder().setNotificationOptions(new NotificationOptions.Builder().build()).build())
+            .build();
+    }
+
+    @Override
+    public List<SessionProvider> getAdditionalSessionProviders(Context context) {
+        return null;
+    }
+}

package/android/src/main/java/com/capgo/videoplayer/VideoPlayerPlugin.java

@@ -9,7 +9,9 @@ import android.content.res.Configuration;
 import android.content.res.Configuration;
 import android.os.Build;
 import android.util.Log;
+import android.view.View;
 import android.view.ViewGroup;
+import android.view.WindowManager;
 import android.widget.FrameLayout;
 import android.widget.Toast;
 import androidx.fragment.app.Fragment;
@@ -39,7 +41,7 @@ import java.util.Map;
 )
 public class VideoPlayerPlugin extends Plugin {
 
-    private final String pluginVersion = "8.1.22";
+    private final String pluginVersion = "8.1.24";
 
     // Permission alias constants
     private static final String PERMISSION_DENIED_ERROR = "Unable to access media videos, user denied permission request";
@@ -78,6 +80,7 @@ public class VideoPlayerPlugin extends Plugin {
     private Boolean chromecast = true;
     private String artwork;
     private String url;
+    private String chromecastUrl;
     private String playerId;
     private String subtitle = "";
     private String language = "";
@@ -187,6 +190,11 @@ public class VideoPlayerPlugin extends Plugin {
                 call.resolve(ret);
                 return;
             }
+            String _chromecastUrl = null;
+            if (call.getData().has("chromecastUrl")) {
+                _chromecastUrl = call.getString("chromecastUrl");
+            }
+            chromecastUrl = _chromecastUrl;
             if (call.getData().has("subtitle")) {
                 subtitle = call.getString("subtitle");
             }
@@ -898,6 +906,76 @@ public class VideoPlayerPlugin extends Plugin {
             );
     }
 
+    @PluginMethod
+    public void hidePlayer(PluginCall call) {
+        this.call = call;
+        bridge
+            .getActivity()
+            .runOnUiThread(
+                new Runnable() {
+                    @Override
+                    public void run() {
+                        JSObject ret = new JSObject();
+                        ret.put("method", "hidePlayer");
+                        FrameLayout frameLayoutView = getBridge().getActivity().findViewById(frameLayoutViewId);
+                        if (frameLayoutView != null && fsFragment != null) {
+                            frameLayoutView.setVisibility(View.GONE);
+                            Activity activity = getBridge().getActivity();
+                            activity.getWindow().clearFlags(WindowManager.LayoutParams.FLAG_FULLSCREEN);
+                            activity.getWindow().clearFlags(WindowManager.LayoutParams.FLAG_KEEP_SCREEN_ON);
+                            activity.getWindow().getDecorView().setSystemUiVisibility(View.SYSTEM_UI_FLAG_VISIBLE);
+                            ret.put("result", true);
+                            ret.put("value", true);
+                        } else {
+                            ret.put("result", false);
+                            ret.put("message", "Fullscreen player is not defined");
+                        }
+                        call.resolve(ret);
+                    }
+                }
+            );
+    }
+
+    @PluginMethod
+    public void showPlayer(PluginCall call) {
+        this.call = call;
+        bridge
+            .getActivity()
+            .runOnUiThread(
+                new Runnable() {
+                    @Override
+                    public void run() {
+                        JSObject ret = new JSObject();
+                        ret.put("method", "showPlayer");
+                        FrameLayout frameLayoutView = getBridge().getActivity().findViewById(frameLayoutViewId);
+                        if (frameLayoutView != null && fsFragment != null) {
+                            frameLayoutView.setVisibility(View.VISIBLE);
+                            Activity activity = getBridge().getActivity();
+                            activity.getWindow().addFlags(WindowManager.LayoutParams.FLAG_FULLSCREEN);
+                            activity.getWindow().addFlags(WindowManager.LayoutParams.FLAG_KEEP_SCREEN_ON);
+                            activity
+                                .getWindow()
+                                .getDecorView()
+                                .setSystemUiVisibility(
+                                    View.SYSTEM_UI_FLAG_LOW_PROFILE |
+                                        View.SYSTEM_UI_FLAG_FULLSCREEN |
+                                        View.SYSTEM_UI_FLAG_LAYOUT_STABLE |
+                                        View.SYSTEM_UI_FLAG_IMMERSIVE_STICKY |
+                                        View.SYSTEM_UI_FLAG_LAYOUT_HIDE_NAVIGATION |
+                                        View.SYSTEM_UI_FLAG_HIDE_NAVIGATION
+                                );
+                            ret.put("result", true);
+                            ret.put("value", true);
+                        } else {
+                            ret.put("result", false);
+                            ret.put("message", "Fullscreen player is not defined");
+                        }
+                        call.resolve(ret);
+                    }
+                }
+            );
+    }
+
     public boolean isDeviceTV(Context context) {
         UiModeManager uiManager = (UiModeManager) context.getSystemService(Context.UI_MODE_SERVICE);
         return uiManager != null && uiManager.getCurrentModeType() == Configuration.UI_MODE_TYPE_TELEVISION;
@@ -922,6 +1000,7 @@ public class VideoPlayerPlugin extends Plugin {
                 createFullScreenFragment(
                     call,
                     videoPath,
+                    chromecastUrl,
                     videoRate,
                     exitOnEnd,
                     loopOnEnd,
@@ -1088,6 +1167,7 @@ public class VideoPlayerPlugin extends Plugin {
                         createFullScreenFragment(
                             call,
                             videoPath,
+                            chromecastUrl,
                             videoRate,
                             exitOnEnd,
                             loopOnEnd,
@@ -1128,6 +1208,7 @@ public class VideoPlayerPlugin extends Plugin {
     private void createFullScreenFragment(
         final PluginCall call,
         String videoPath,
+        String chromecastUrl,
         Float videoRate,
         Boolean exitOnEnd,
         Boolean loopOnEnd,
@@ -1154,6 +1235,7 @@ public class VideoPlayerPlugin extends Plugin {
 
         fsFragment = implementation.createFullScreenFragment(
             videoPath,
+            chromecastUrl,
             videoRate,
             exitOnEnd,
             loopOnEnd,

package/dist/docs.json

@@ -299,6 +299,30 @@
           "capVideoPlayerResult"
         ],
         "slug": "exitplayer"
+      },
+      {
+        "name": "hidePlayer",
+        "signature": "() => Promise<capVideoPlayerResult>",
+        "parameters": [],
+        "returns": "Promise<capVideoPlayerResult>",
+        "tags": [],
+        "docs": "Hide the currently presented player UI without stopping playback (native fullscreen).\n\nCall `showPlayer()` to show it again.",
+        "complexTypes": [
+          "capVideoPlayerResult"
+        ],
+        "slug": "hideplayer"
+      },
+      {
+        "name": "showPlayer",
+        "signature": "() => Promise<capVideoPlayerResult>",
+        "parameters": [],
+        "returns": "Promise<capVideoPlayerResult>",
+        "tags": [],
+        "docs": "Show again a previously hidden player UI (native fullscreen).",
+        "complexTypes": [
+          "capVideoPlayerResult"
+        ],
+        "slug": "showplayer"
       }
     ],
     "properties": []
@@ -362,6 +386,13 @@
           "complexTypes": [],
           "type": "string | undefined"
         },
+        {
+          "name": "chromecastUrl",
+          "tags": [],
+          "docs": "Optional override URL used when casting to Chromecast (iOS, Android).\n\nThis lets you cast an alternative rendition/manifest (e.g. MPEG-DASH + Widevine)\nwhile keeping the on-device playback URL unchanged (e.g. HLS + FairPlay on iOS).",
+          "complexTypes": [],
+          "type": "string | undefined"
+        },
         {
           "name": "subtitle",
           "tags": [],
@@ -427,6 +458,13 @@
           "complexTypes": [],
           "type": "boolean | undefined"
         },
+        {
+          "name": "audioCategory",
+          "tags": [],
+          "docs": "iOS audio session category behavior (iOS).\n- \"ambient\": respects the iPhone silent switch (default)\n- \"playback\": ignores the iPhone silent switch\n- \"moviePlayback\": playback optimized for video and long-form AirPlay\ndefault: \"ambient\"",
+          "complexTypes": [],
+          "type": "'ambient' | 'playback' | 'moviePlayback' | undefined"
+        },
         {
           "name": "showControls",
           "tags": [],
@@ -507,7 +545,7 @@
         {
           "name": "drm",
           "tags": [],
-          "docs": "DRM configuration for protected content (iOS: FairPlay, Android: Widevine)",
+          "docs": "DRM configuration for protected content (iOS: FairPlay, Android: Widevine)\n\nWhen casting, Widevine's `certificateUrl` (license URL) is also forwarded to Chromecast\nreceivers as `media.customData.laurl`.",
           "complexTypes": [
             "DrmOptions"
           ],
@@ -621,6 +659,13 @@
           "docs": "The URL to send the SPC and receive the CKC license (FairPlay license server URL)",
           "complexTypes": [],
           "type": "string | undefined"
+        },
+        {
+          "name": "assetId",
+          "tags": [],
+          "docs": "Optional FairPlay asset identifier used when generating the SPC.\nDefaults to the `skd://` content identifier from the key request.",
+          "complexTypes": [],
+          "type": "string | undefined"
         }
       ]
     },

package/dist/esm/definitions.d.ts

@@ -84,6 +84,16 @@ export interface VideoPlayerPlugin {
      *
      */
     exitPlayer(): Promise<capVideoPlayerResult>;
+    /**
+     * Hide the currently presented player UI without stopping playback (native fullscreen).
+     *
+     * Call `showPlayer()` to show it again.
+     */
+    hidePlayer(): Promise<capVideoPlayerResult>;
+    /**
+     * Show again a previously hidden player UI (native fullscreen).
+     */
+    showPlayer(): Promise<capVideoPlayerResult>;
 }
 export interface capEchoOptions {
     /**
@@ -102,6 +112,13 @@ export interface capVideoPlayerOptions {
      * The url of the video to play
      */
     url?: string;
+    /**
+     * Optional override URL used when casting to Chromecast (iOS, Android).
+     *
+     * This lets you cast an alternative rendition/manifest (e.g. MPEG-DASH + Widevine)
+     * while keeping the on-device playback URL unchanged (e.g. HLS + FairPlay on iOS).
+     */
+    chromecastUrl?: string;
     /**
      * The url of subtitle associated with the video
      */
@@ -143,6 +160,14 @@ export interface capVideoPlayerOptions {
      * default: true
      */
     bkmodeEnabled?: boolean;
+    /**
+     * iOS audio session category behavior (iOS).
+     * - "ambient": respects the iPhone silent switch (default)
+     * - "playback": ignores the iPhone silent switch
+     * - "moviePlayback": playback optimized for video and long-form AirPlay
+     * default: "ambient"
+     */
+    audioCategory?: 'ambient' | 'playback' | 'moviePlayback';
     /**
      * Show Controls Enable (iOS, Android)
      * default: true
@@ -204,6 +229,9 @@ export interface capVideoPlayerOptions {
     artwork?: string;
     /**
      * DRM configuration for protected content (iOS: FairPlay, Android: Widevine)
+     *
+     * When casting, Widevine's `certificateUrl` (license URL) is also forwarded to Chromecast
+     * receivers as `media.customData.laurl`.
      */
     drm?: DrmOptions;
 }
@@ -323,6 +351,11 @@ export interface FairPlayDrmOptions {
      * The URL to send the SPC and receive the CKC license (FairPlay license server URL)
      */
     contentKeySpcUrl?: string;
+    /**
+     * Optional FairPlay asset identifier used when generating the SPC.
+     * Defaults to the `skd://` content identifier from the key request.
+     */
+    assetId?: string;
 }
 export interface PlayreadyDrmOptions {
     /**