@capgo/capacitor-video-player 8.1.25 → 8.2.1

package/README.md

@@ -482,8 +482,9 @@ Show again a previously hidden player UI (native fullscreen).
 | **`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                                                                                                                                               |
+| **`subtitle`**        | <code>string</code>                                         | The url of subtitle associated with the video Prefer `subtitles` when providing more than one track. Kept for backward compatibility.                                                                                                       |
+| **`language`**        | <code>string</code>                                         | The language of subtitle see https://github.com/libyal/libfwnt/wiki/Language-Code-identifiers Prefer `subtitles` when providing more than one track. Kept for backward compatibility.                                                       |
+| **`subtitles`**       | <code>VideoSubtitle[]</code>                                | Multiple subtitle tracks (iOS, Android). When provided, takes precedence over `subtitle` / `language`.                                                                                                                                      |
 | **`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                                                                                                                                                                                                                        |
@@ -506,6 +507,14 @@ Show again a previously hidden player UI (native fullscreen).
 | **`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`.                                   |
 
 
+#### VideoSubtitle
+
+| Prop           | Type                | Description                                                                                       |
+| -------------- | ------------------- | ------------------------------------------------------------------------------------------------- |
+| **`subtitle`** | <code>string</code> | The url of the subtitle file (vtt, srt, ...)                                                      |
+| **`language`** | <code>string</code> | The language of the subtitle see https://github.com/libyal/libfwnt/wiki/Language-Code-identifiers |
+
+
 #### SubTitleOptions
 
 | Prop                  | Type                | Description                                           |

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

@@ -114,6 +114,7 @@ public class FullscreenExoPlayerFragment extends Fragment {
     public String chromecastUrl;
     public Float videoRate;
     public String playerId;
+    public List<VideoSubtitleTrack> subtitleTracks;
     public String subTitle;
     public String language;
     public JSObject subTitleOptions;
@@ -154,6 +155,7 @@ public class FullscreenExoPlayerFragment extends Fragment {
     private long playbackPosition = 0;
     private Uri uri = null;
     private Uri sturi = null;
+    private List<Uri> subtitleUris = new ArrayList<>();
     private ProgressBar Pbar;
     private View view;
     private ImageButton closeBtn;
@@ -397,15 +399,31 @@ public class FullscreenExoPlayerFragment extends Fragment {
 
         if (!isInternal) {
             uri = Uri.parse(videoPath);
-            sturi = subTitle != null ? Uri.parse(subTitle) : null;
+            subtitleUris = new ArrayList<>();
+            if (subtitleTracks != null) {
+                for (VideoSubtitleTrack track : subtitleTracks) {
+                    if (track != null && track.url != null && !track.url.isEmpty()) {
+                        subtitleUris.add(Uri.parse(track.url));
+                    }
+                }
+            }
+            sturi = subtitleUris.isEmpty() ? null : subtitleUris.get(0);
+            if (sturi == null && subTitle != null && !subTitle.isEmpty()) {
+                sturi = Uri.parse(subTitle);
+                subtitleUris.add(sturi);
+            }
 
-            stForeColor = subTitleOptions.has("foregroundColor") ? subTitleOptions.getString("foregroundColor") : "rgba(255,255,255,1)";
-            stBackColor = subTitleOptions.has("backgroundColor") ? subTitleOptions.getString("backgroundColor") : "rgba(0,0,0,1)";
-            stFontSize = subTitleOptions.has("fontSize") ? subTitleOptions.getInteger("fontSize") : 16;
+            stForeColor = subTitleOptions != null && subTitleOptions.has("foregroundColor")
+                ? subTitleOptions.getString("foregroundColor")
+                : "rgba(255,255,255,1)";
+            stBackColor = subTitleOptions != null && subTitleOptions.has("backgroundColor")
+                ? subTitleOptions.getString("backgroundColor")
+                : "rgba(0,0,0,1)";
+            stFontSize = subTitleOptions != null && subTitleOptions.has("fontSize") ? subTitleOptions.getInteger("fontSize") : 16;
             // get video type
             vType = getVideoType(uri);
             Log.v(TAG, "display url: " + uri);
-            Log.v(TAG, "display subtitle url: " + sturi);
+            Log.v(TAG, "display subtitle urls: " + subtitleUris.size());
             Log.v(TAG, "display isTV: " + isTV);
             Log.v(TAG, "display vType: " + vType);
         }
@@ -648,7 +666,7 @@ public class FullscreenExoPlayerFragment extends Fragment {
         }
 
         isInPictureInPictureMode = activity.isInPictureInPictureMode();
-        if (sturi != null) {
+        if (!subtitleUris.isEmpty()) {
             setSubtitle(true);
         }
         play();
@@ -688,7 +706,7 @@ public class FullscreenExoPlayerFragment extends Fragment {
         if (inPictureInPictureMode) {
             linearLayout.setVisibility(View.INVISIBLE);
             styledPlayerView.setUseController(false);
-            if (sturi != null) {
+            if (!subtitleUris.isEmpty()) {
                 setSubtitle(true);
             }
             return;
@@ -698,7 +716,7 @@ public class FullscreenExoPlayerFragment extends Fragment {
         if (showControls) {
             styledPlayerView.setUseController(true);
         }
-        if (sturi != null) {
+        if (!subtitleUris.isEmpty()) {
             setSubtitle(false);
         }
     }
@@ -979,8 +997,8 @@ public class FullscreenExoPlayerFragment extends Fragment {
         DataSource.Factory dataSourceFactory = new DefaultDataSourceFactory(context, "jeep-exoplayer-plugin");
         mediaSource = new ProgressiveMediaSource.Factory(dataSourceFactory).createMediaSource(MediaItem.fromUri(uri));
         // Get the subtitles if any
-        if (sturi != null) {
-            mediaSource = getSubTitle(mediaSource, sturi, dataSourceFactory);
+        if (!subtitleUris.isEmpty()) {
+            mediaSource = getSubTitles(mediaSource, subtitleUris, dataSourceFactory);
         }
         return mediaSource;
     }
@@ -1045,8 +1063,8 @@ public class FullscreenExoPlayerFragment extends Fragment {
             mediaSource = new SsMediaSource.Factory(dataSourceFactory).createMediaSource(mediaItem);
         }
         // Get the subtitles if any
-        if (sturi != null) {
-            mediaSource = getSubTitle(mediaSource, sturi, dataSourceFactory);
+        if (!subtitleUris.isEmpty()) {
+            mediaSource = getSubTitles(mediaSource, subtitleUris, dataSourceFactory);
         }
         return mediaSource;
     }
@@ -1101,22 +1119,22 @@ public class FullscreenExoPlayerFragment extends Fragment {
         return ret;
     }
 
-    private MediaSource getSubTitle(MediaSource mediaSource, Uri sturi, DataSource.Factory dataSourceFactory) {
-        // Create mediaSource with subtitle
-        MediaSource[] mediaSources = new MediaSource[2];
-        mediaSources[0] = mediaSource;
-        String mimeType = getMimeType(sturi);
+    private MediaSource getSubTitles(MediaSource mediaSource, List<Uri> subtitleUris, DataSource.Factory dataSourceFactory) {
+        if (subtitleUris == null || subtitleUris.isEmpty()) {
+            return mediaSource;
+        }
 
-        MediaItem.SubtitleConfiguration subConfig = buildSubtitleConfiguration(sturi, mimeType);
-        SingleSampleMediaSource subtitleSource = new SingleSampleMediaSource.Factory(dataSourceFactory).createMediaSource(
-            subConfig,
-            C.TIME_UNSET
-        );
+        MediaSource[] mediaSources = new MediaSource[subtitleUris.size() + 1];
+        mediaSources[0] = mediaSource;
 
-        mediaSources[1] = subtitleSource;
+        for (int i = 0; i < subtitleUris.size(); i++) {
+            Uri trackUri = subtitleUris.get(i);
+            String mimeType = getMimeType(trackUri);
+            MediaItem.SubtitleConfiguration subConfig = buildSubtitleConfiguration(trackUri, mimeType, i);
+            mediaSources[i + 1] = new SingleSampleMediaSource.Factory(dataSourceFactory).createMediaSource(subConfig, C.TIME_UNSET);
+        }
 
-        mediaSource = new MergingMediaSource(mediaSources);
-        return mediaSource;
+        return new MergingMediaSource(mediaSources);
     }
 
     private String getMimeType(Uri sturi) {
@@ -1573,8 +1591,9 @@ public class FullscreenExoPlayerFragment extends Fragment {
         if (mimeType != null) {
             builder.setMimeType(mimeType);
         }
-        if (sturi != null && isNetworkUri(sturi)) {
-            builder.setSubtitleConfigurations(Arrays.asList(buildSubtitleConfiguration(sturi, getMimeType(sturi))));
+        List<MediaItem.SubtitleConfiguration> castSubtitles = buildSubtitleConfigurationsForCast();
+        if (!castSubtitles.isEmpty()) {
+            builder.setSubtitleConfigurations(castSubtitles);
         }
         return builder.build();
     }
@@ -1591,16 +1610,45 @@ public class FullscreenExoPlayerFragment extends Fragment {
         return artwork != null && !artwork.isEmpty();
     }
 
-    private MediaItem.SubtitleConfiguration buildSubtitleConfiguration(Uri subtitleUri, String mimeType) {
-        String languageLabel = Locale.forLanguageTag(language).getDisplayLanguage();
+    private List<MediaItem.SubtitleConfiguration> buildSubtitleConfigurationsForCast() {
+        List<MediaItem.SubtitleConfiguration> configurations = new ArrayList<>();
+        for (int i = 0; i < subtitleUris.size(); i++) {
+            Uri trackUri = subtitleUris.get(i);
+            if (trackUri != null && isNetworkUri(trackUri)) {
+                configurations.add(buildSubtitleConfiguration(trackUri, getMimeType(trackUri), i));
+            }
+        }
+        return configurations;
+    }
+
+    private String languageForTrack(int index) {
+        if (subtitleTracks != null && index >= 0 && index < subtitleTracks.size()) {
+            String trackLanguage = subtitleTracks.get(index).language;
+            if (trackLanguage != null && !trackLanguage.isEmpty()) {
+                return trackLanguage;
+            }
+        }
+        if (language != null && !language.isEmpty()) {
+            return language;
+        }
+        return "en";
+    }
+
+    private MediaItem.SubtitleConfiguration buildSubtitleConfiguration(Uri subtitleUri, String mimeType, int index) {
+        String trackLanguage = languageForTrack(index);
+        String languageLabel = Locale.forLanguageTag(trackLanguage).getDisplayLanguage();
+        if (languageLabel == null || languageLabel.isEmpty()) {
+            languageLabel = trackLanguage;
+        }
+        int selectionFlags = index == 0 ? C.SELECTION_FLAG_DEFAULT : 0;
         return new MediaItem.SubtitleConfiguration.Builder(subtitleUri)
             .setMimeType(mimeType)
             .setUri(subtitleUri)
-            .setId(subTitle)
+            .setId(subtitleUri.toString())
             .setLabel(languageLabel)
             .setRoleFlags(C.ROLE_FLAG_CAPTION)
-            .setSelectionFlags(C.SELECTION_FLAG_DEFAULT)
-            .setLanguage(language)
+            .setSelectionFlags(selectionFlags)
+            .setLanguage(trackLanguage)
             .build();
     }
 

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

@@ -3,6 +3,7 @@ package com.capgo.videoplayer;
 import android.content.Context;
 import com.capgo.videoplayer.PickerVideo.PickerVideoFragment;
 import com.getcapacitor.JSObject;
+import java.util.List;
 
 public class VideoPlayer {
 
@@ -22,8 +23,7 @@ public class VideoPlayer {
         Boolean bkModeEnabled,
         Boolean showControls,
         String displayMode,
-        String subTitle,
-        String language,
+        List<VideoSubtitleTrack> subtitleTracks,
         JSObject subTitleOptions,
         JSObject headers,
         String title,
@@ -48,8 +48,7 @@ public class VideoPlayer {
         fsFragment.bkModeEnabled = bkModeEnabled;
         fsFragment.showControls = showControls;
         fsFragment.displayMode = displayMode;
-        fsFragment.subTitle = subTitle;
-        fsFragment.language = language;
+        fsFragment.subtitleTracks = subtitleTracks;
         fsFragment.subTitleOptions = subTitleOptions;
         fsFragment.headers = headers;
         fsFragment.title = title;

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

@@ -21,6 +21,7 @@ import com.capgo.videoplayer.PickerVideo.PickerVideoFragment;
 import com.capgo.videoplayer.Utilities.FilesUtils;
 import com.capgo.videoplayer.Utilities.FragmentUtils;
 import com.getcapacitor.Bridge;
+import com.getcapacitor.JSArray;
 import com.getcapacitor.JSObject;
 import com.getcapacitor.PermissionState;
 import com.getcapacitor.Plugin;
@@ -29,8 +30,12 @@ import com.getcapacitor.PluginMethod;
 import com.getcapacitor.annotation.CapacitorPlugin;
 import com.getcapacitor.annotation.Permission;
 import com.getcapacitor.annotation.PermissionCallback;
+import java.util.ArrayList;
 import java.util.HashMap;
+import java.util.List;
 import java.util.Map;
+import org.json.JSONException;
+import org.json.JSONObject;
 
 @CapacitorPlugin(
     name = "VideoPlayer",
@@ -41,7 +46,7 @@ import java.util.Map;
 )
 public class VideoPlayerPlugin extends Plugin {
 
-    private final String pluginVersion = "8.1.25";
+    private final String pluginVersion = "8.2.1";
 
     // Permission alias constants
     private static final String PERMISSION_DENIED_ERROR = "Unable to access media videos, user denied permission request";
@@ -84,6 +89,7 @@ public class VideoPlayerPlugin extends Plugin {
     private String playerId;
     private String subtitle = "";
     private String language = "";
+    private List<VideoSubtitleTrack> subtitleTracks = new ArrayList<>();
     private JSObject subTitleOptions;
     private JSObject drmOptions;
     private final JSObject ret = new JSObject();
@@ -201,6 +207,7 @@ public class VideoPlayerPlugin extends Plugin {
             if (call.getData().has("language")) {
                 language = call.getString("language");
             }
+            subtitleTracks = parseSubtitleTracks(call);
             subTitleOptions = new JSObject();
             if (call.getData().has("subtitleOptions")) {
                 subTitleOptions = call.getObject("subtitleOptions");
@@ -988,14 +995,16 @@ public class VideoPlayerPlugin extends Plugin {
         } else {
             // get the videoPath
             videoPath = filesUtils.getFilePath(url);
-            // get the subTitlePath if any
-            if (subtitle != null && subtitle.length() > 0) {
-                subTitlePath = filesUtils.getFilePath(subtitle);
-            } else {
-                subTitlePath = null;
+            List<VideoSubtitleTrack> resolvedSubtitleTracks = resolveSubtitleTracks(subtitleTracks);
+            if (resolvedSubtitleTracks.isEmpty() && subtitle != null && subtitle.length() > 0) {
+                String path = filesUtils.getFilePath(subtitle);
+                if (path != null) {
+                    resolvedSubtitleTracks.add(new VideoSubtitleTrack(path, language));
+                }
             }
+            subTitlePath = resolvedSubtitleTracks.isEmpty() ? null : resolvedSubtitleTracks.get(0).url;
             Log.v(TAG, "*** calculated videoPath: " + videoPath);
-            Log.v(TAG, "*** calculated subTitlePath: " + subTitlePath);
+            Log.v(TAG, "*** calculated subtitleTracks: " + resolvedSubtitleTracks.size());
             if (videoPath != null) {
                 createFullScreenFragment(
                     call,
@@ -1008,8 +1017,7 @@ public class VideoPlayerPlugin extends Plugin {
                     bkModeEnabled,
                     showControls,
                     displayMode,
-                    subTitlePath,
-                    language,
+                    resolvedSubtitleTracks,
                     subTitleOptions,
                     headers,
                     title,
@@ -1175,8 +1183,7 @@ public class VideoPlayerPlugin extends Plugin {
                             bkModeEnabled,
                             showControls,
                             displayMode,
-                            null,
-                            null,
+                            new ArrayList<>(),
                             null,
                             headers,
                             title,
@@ -1205,6 +1212,49 @@ public class VideoPlayerPlugin extends Plugin {
         );
     }
 
+    private List<VideoSubtitleTrack> parseSubtitleTracks(PluginCall call) {
+        List<VideoSubtitleTrack> tracks = new ArrayList<>();
+        if (call.getData().has("subtitles")) {
+            try {
+                JSArray subtitles = call.getArray("subtitles");
+                if (subtitles != null) {
+                    for (int i = 0; i < subtitles.length(); i++) {
+                        JSONObject entry = subtitles.getJSONObject(i);
+                        String trackUrl = entry.optString("subtitle", "");
+                        if (trackUrl == null || trackUrl.isEmpty()) {
+                            continue;
+                        }
+                        String trackLanguage = entry.optString("language", "");
+                        tracks.add(new VideoSubtitleTrack(trackUrl, trackLanguage));
+                    }
+                }
+            } catch (JSONException e) {
+                Log.w(TAG, "Failed to parse subtitles array", e);
+            }
+        }
+        if (tracks.isEmpty() && subtitle != null && subtitle.length() > 0) {
+            tracks.add(new VideoSubtitleTrack(subtitle, language));
+        }
+        return tracks;
+    }
+
+    private List<VideoSubtitleTrack> resolveSubtitleTracks(List<VideoSubtitleTrack> tracks) {
+        List<VideoSubtitleTrack> resolved = new ArrayList<>();
+        if (tracks == null) {
+            return resolved;
+        }
+        for (VideoSubtitleTrack track : tracks) {
+            if (track == null || track.url == null || track.url.isEmpty()) {
+                continue;
+            }
+            String resolvedPath = filesUtils.getFilePath(track.url);
+            if (resolvedPath != null) {
+                resolved.add(new VideoSubtitleTrack(resolvedPath, track.language));
+            }
+        }
+        return resolved;
+    }
+
     private void createFullScreenFragment(
         final PluginCall call,
         String videoPath,
@@ -1216,8 +1266,7 @@ public class VideoPlayerPlugin extends Plugin {
         Boolean bkModeEnabled,
         Boolean showControls,
         String displayMode,
-        String subTitle,
-        String language,
+        List<VideoSubtitleTrack> subtitleTracks,
         JSObject subTitleOptions,
         JSObject headers,
         String title,
@@ -1243,8 +1292,7 @@ public class VideoPlayerPlugin extends Plugin {
             bkModeEnabled,
             showControls,
             displayMode,
-            subTitle,
-            language,
+            subtitleTracks,
             subTitleOptions,
             headers,
             title,

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

@@ -0,0 +1,12 @@
+package com.capgo.videoplayer;
+
+public class VideoSubtitleTrack {
+
+    public final String url;
+    public final String language;
+
+    public VideoSubtitleTrack(String url, String language) {
+        this.url = url;
+        this.language = language != null ? language : "";
+    }
+}

package/dist/docs.json

@@ -396,17 +396,26 @@
         {
           "name": "subtitle",
           "tags": [],
-          "docs": "The url of subtitle associated with the video",
+          "docs": "The url of subtitle associated with the video\n\nPrefer `subtitles` when providing more than one track.\nKept for backward compatibility.",
           "complexTypes": [],
           "type": "string | undefined"
         },
         {
           "name": "language",
           "tags": [],
-          "docs": "The language of subtitle\nsee https://github.com/libyal/libfwnt/wiki/Language-Code-identifiers",
+          "docs": "The language of subtitle\nsee https://github.com/libyal/libfwnt/wiki/Language-Code-identifiers\n\nPrefer `subtitles` when providing more than one track.\nKept for backward compatibility.",
           "complexTypes": [],
           "type": "string | undefined"
         },
+        {
+          "name": "subtitles",
+          "tags": [],
+          "docs": "Multiple subtitle tracks (iOS, Android).\nWhen provided, takes precedence over `subtitle` / `language`.",
+          "complexTypes": [
+            "VideoSubtitle"
+          ],
+          "type": "VideoSubtitle[] | undefined"
+        },
         {
           "name": "subtitleOptions",
           "tags": [],
@@ -553,6 +562,29 @@
         }
       ]
     },
+    {
+      "name": "VideoSubtitle",
+      "slug": "videosubtitle",
+      "docs": "",
+      "tags": [],
+      "methods": [],
+      "properties": [
+        {
+          "name": "subtitle",
+          "tags": [],
+          "docs": "The url of the subtitle file (vtt, srt, ...)",
+          "complexTypes": [],
+          "type": "string"
+        },
+        {
+          "name": "language",
+          "tags": [],
+          "docs": "The language of the subtitle\nsee https://github.com/libyal/libfwnt/wiki/Language-Code-identifiers",
+          "complexTypes": [],
+          "type": "string | undefined"
+        }
+      ]
+    },
     {
       "name": "SubTitleOptions",
       "slug": "subtitleoptions",

package/dist/esm/definitions.d.ts

@@ -121,13 +121,24 @@ export interface capVideoPlayerOptions {
     chromecastUrl?: string;
     /**
      * The url of subtitle associated with the video
+     *
+     * Prefer `subtitles` when providing more than one track.
+     * Kept for backward compatibility.
      */
     subtitle?: string;
     /**
      * The language of subtitle
      * see https://github.com/libyal/libfwnt/wiki/Language-Code-identifiers
+     *
+     * Prefer `subtitles` when providing more than one track.
+     * Kept for backward compatibility.
      */
     language?: string;
+    /**
+     * Multiple subtitle tracks (iOS, Android).
+     * When provided, takes precedence over `subtitle` / `language`.
+     */
+    subtitles?: VideoSubtitle[];
     /**
      * SubTitle Options
      */
@@ -319,6 +330,17 @@ export interface capVideoPlayerResult {
      */
     message?: string;
 }
+export interface VideoSubtitle {
+    /**
+     * The url of the subtitle file (vtt, srt, ...)
+     */
+    subtitle: string;
+    /**
+     * The language of the subtitle
+     * see https://github.com/libyal/libfwnt/wiki/Language-Code-identifiers
+     */
+    language?: string;
+}
 export interface SubTitleOptions {
     /**
      * Foreground Color in RGBA (default rgba(255,255,255,1)

package/dist/esm/definitions.js.map

@@ -1 +1 @@
-{"version":3,"file":"definitions.js","sourceRoot":"","sources":["../../src/definitions.ts"],"names":[],"mappings":"","sourcesContent":["export interface VideoPlayerPlugin {\n  /**\n   * Initialize a video player\n   *\n   */\n  initPlayer(options: capVideoPlayerOptions): Promise<capVideoPlayerResult>;\n  /**\n   * Return if a given playerId is playing\n   *\n   */\n  isPlaying(options: capVideoPlayerIdOptions): Promise<capVideoPlayerResult>;\n  /**\n   * Play the current video from a given playerId\n   *\n   */\n  play(options: capVideoPlayerIdOptions): Promise<capVideoPlayerResult>;\n  /**\n   * Pause the current video from a given playerId\n   *\n   */\n  pause(options: capVideoPlayerIdOptions): Promise<capVideoPlayerResult>;\n  /**\n   * Get the duration of the current video from a given playerId\n   *\n   */\n  getDuration(options: capVideoPlayerIdOptions): Promise<capVideoPlayerResult>;\n  /**\n   * Get the current time of the current video from a given playerId\n   *\n   */\n  getCurrentTime(options: capVideoPlayerIdOptions): Promise<capVideoPlayerResult>;\n  /**\n   * Set the current time to seek the current video to from a given playerId\n   *\n   */\n  setCurrentTime(options: capVideoTimeOptions): Promise<capVideoPlayerResult>;\n  /**\n   * Get the volume of the current video from a given playerId\n   *\n   */\n  getVolume(options: capVideoPlayerIdOptions): Promise<capVideoPlayerResult>;\n  /**\n   * Set the volume of the current video to from a given playerId\n   *\n   */\n  setVolume(options: capVideoVolumeOptions): Promise<capVideoPlayerResult>;\n  /**\n   * Get the muted of the current video from a given playerId\n   *\n   */\n  getMuted(options: capVideoPlayerIdOptions): Promise<capVideoPlayerResult>;\n  /**\n   * Set the muted of the current video to from a given playerId\n   *\n   */\n  setMuted(options: capVideoMutedOptions): Promise<capVideoPlayerResult>;\n  /**\n   * Set the rate of the current video from a given playerId\n   *\n   */\n  setRate(options: capVideoRateOptions): Promise<capVideoPlayerResult>;\n  /**\n   * Get the rate of the current video from a given playerId\n   *\n   */\n  getRate(options: capVideoPlayerIdOptions): Promise<capVideoPlayerResult>;\n  /**\n   * Stop all players playing\n   *\n   */\n  stopAllPlayers(): Promise<capVideoPlayerResult>;\n  /**\n   * Show controller\n   *\n   */\n  showController(): Promise<capVideoPlayerResult>;\n  /**\n   * isControllerIsFullyVisible\n   *\n   */\n  isControllerIsFullyVisible(): Promise<capVideoPlayerResult>;\n  /**\n   * Exit player\n   *\n   */\n  exitPlayer(): Promise<capVideoPlayerResult>;\n  /**\n   * Hide the currently presented player UI without stopping playback (native fullscreen).\n   *\n   * Call `showPlayer()` to show it again.\n   */\n  hidePlayer(): Promise<capVideoPlayerResult>;\n  /**\n   * Show again a previously hidden player UI (native fullscreen).\n   */\n  showPlayer(): Promise<capVideoPlayerResult>;\n}\nexport interface capEchoOptions {\n  /**\n   *  String to be echoed\n   */\n\n  value?: string;\n}\nexport interface capVideoPlayerOptions {\n  /**\n   * Player mode\n   *  - \"fullscreen\"\n   *  - \"embedded\" (Web only)\n   */\n  mode?: string;\n  /**\n   * The url of the video to play\n   */\n  url?: string;\n  /**\n   * Optional override URL used when casting to Chromecast (iOS, Android).\n   *\n   * This lets you cast an alternative rendition/manifest (e.g. MPEG-DASH + Widevine)\n   * while keeping the on-device playback URL unchanged (e.g. HLS + FairPlay on iOS).\n   */\n  chromecastUrl?: string;\n  /**\n   * The url of subtitle associated with the video\n   */\n  subtitle?: string;\n  /**\n   * The language of subtitle\n   * see https://github.com/libyal/libfwnt/wiki/Language-Code-identifiers\n   */\n  language?: string;\n  /**\n   * SubTitle Options\n   */\n  subtitleOptions?: SubTitleOptions;\n  /**\n   * Id of DIV Element parent of the player\n   */\n  playerId?: string;\n  /**\n   * Initial playing rate\n   */\n  rate?: number;\n  /**\n   * Exit on VideoEnd (iOS, Android)\n   * default: true\n   */\n  exitOnEnd?: boolean;\n  /**\n   * Loop on VideoEnd when exitOnEnd false (iOS, Android)\n   * default: false\n   */\n  loopOnEnd?: boolean;\n  /**\n   * Picture in Picture Enable (iOS, Android)\n   * default: true\n   */\n  pipEnabled?: boolean;\n  /**\n   * Background Mode Enable (iOS, Android)\n   * default: true\n   */\n  bkmodeEnabled?: boolean;\n  /**\n   * 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\n   * default: \"ambient\"\n   */\n  audioCategory?: 'ambient' | 'playback' | 'moviePlayback';\n  /**\n   * Show Controls Enable (iOS, Android)\n   * default: true\n   */\n  showControls?: boolean;\n  /**\n   * Display Mode [\"all\", \"portrait\", \"landscape\"] (iOS, Android)\n   * default: \"all\"\n   */\n  displayMode?: string;\n  /**\n   * Component Tag or DOM Element Tag (React app)\n   */\n  componentTag?: string;\n  /**\n   * Player Width (mode \"embedded\" only)\n   */\n  width?: number;\n  /**\n   * Player height (mode \"embedded\" only)\n   */\n  height?: number;\n  /**\n   * Headers for the request (iOS, Android)\n   * by Manuel García Marín (https://github.com/PhantomPainX)\n   */\n  headers?: {\n    [key: string]: string;\n  };\n  /**\n   * Title shown in the player and Chromecast metadata (iOS, Android)\n   * by Manuel García Marín (https://github.com/PhantomPainX)\n   */\n  title?: string;\n  /**\n   * Subtitle shown below the title in the player and Chromecast metadata (iOS, Android)\n   * by Manuel García Marín (https://github.com/PhantomPainX)\n   */\n  smallTitle?: string;\n  /**\n   * ExoPlayer Progress Bar and Spinner color (Android)\n   * by Manuel García Marín (https://github.com/PhantomPainX)\n   * Must be a valid hex color code\n   * default: #FFFFFF\n   */\n  accentColor?: string;\n  /**\n   * Chromecast enable/disable (iOS, Android)\n   * iOS requires Google Cast SDK setup and local network Info.plist keys.\n   * by Manuel García Marín (https://github.com/PhantomPainX)\n   * default: true\n   */\n  chromecast?: boolean;\n  /**\n   * Artwork url to be shown in Chromecast player (iOS, Android)\n   * by Manuel García Marín (https://github.com/PhantomPainX)\n   * default: \"\"\n   */\n  artwork?: string;\n  /**\n   * DRM configuration for protected content (iOS: FairPlay, Android: Widevine)\n   *\n   * When casting, Widevine's `certificateUrl` (license URL) is also forwarded to Chromecast\n   * receivers as `media.customData.laurl`.\n   */\n  drm?: DrmOptions;\n}\nexport interface capVideoPlayerIdOptions {\n  /**\n   * Id of DIV Element parent of the player\n   */\n  playerId?: string;\n}\nexport interface capVideoRateOptions {\n  /**\n   * Id of DIV Element parent of the player\n   */\n  playerId?: string;\n  /**\n   * Rate value\n   */\n  rate?: number;\n}\nexport interface capVideoVolumeOptions {\n  /**\n   * Id of DIV Element parent of the player\n   */\n  playerId?: string;\n  /**\n   * Volume value between [0 - 1]\n   */\n  volume?: number;\n}\nexport interface capVideoTimeOptions {\n  /**\n   * Id of DIV Element parent of the player\n   */\n  playerId?: string;\n  /**\n   * Video time value you want to seek to\n   */\n  seektime?: number;\n}\nexport interface capVideoMutedOptions {\n  /**\n   * Id of DIV Element parent of the player\n   */\n  playerId?: string;\n  /**\n   * Muted value true or false\n   */\n  muted?: boolean;\n}\nexport interface capVideoListener {\n  /**\n   * Id of DIV Element parent of the player\n   */\n  playerId?: string;\n  /**\n   * Video current time when listener triggered\n   */\n  currentTime?: number;\n}\nexport interface capExitListener {\n  /**\n   * Dismiss value true or false\n   */\n  dismiss?: boolean;\n  /**\n   * Video current time when listener triggered\n   */\n  currentTime?: number;\n}\nexport interface capVideoPlayerResult {\n  /**\n   * result set to true when successful else false\n   */\n  result?: boolean;\n  /**\n   * method name\n   */\n  method?: string;\n  /**\n   * value returned\n   */\n  value?: any;\n  /**\n   * message string\n   */\n  message?: string;\n}\nexport interface SubTitleOptions {\n  /**\n   * Foreground Color in RGBA (default rgba(255,255,255,1)\n   */\n  foregroundColor?: string;\n  /**\n   * Background Color in RGBA (default rgba(0,0,0,1)\n   */\n  backgroundColor?: string;\n  /**\n   * Font Size in pixels (default 16)\n   */\n  fontSize?: number;\n\n  /**\n   * Get the native Capacitor plugin version\n   *\n   * @returns {Promise<{ id: string }>} an Promise with version for this device\n   * @throws An error if the something went wrong\n   */\n  getPluginVersion(): Promise<{ version: string }>;\n}\nexport interface FairPlayDrmOptions {\n  /**\n   * The URL to fetch the FairPlay certificate\n   */\n  certificateUrl?: string;\n  /**\n   * The URL to send the SPC and receive the CKC license (FairPlay license server URL)\n   */\n  contentKeySpcUrl?: string;\n  /**\n   * Optional FairPlay asset identifier used when generating the SPC.\n   * Defaults to the `skd://` content identifier from the key request.\n   */\n  assetId?: string;\n}\nexport interface PlayreadyDrmOptions {\n  /**\n   * The URL to fetch the PlayReady license\n   */\n  certificateUrl?: string;\n}\nexport interface WidevineDrmOptions {\n  /**\n   * The URL to fetch the Widevine license\n   */\n  certificateUrl?: string;\n}\nexport interface DrmOptions {\n  /**\n   * FairPlay DRM configuration (iOS)\n   */\n  fairplay?: FairPlayDrmOptions;\n  /**\n   * PlayReady DRM configuration\n   */\n  playready?: PlayreadyDrmOptions;\n  /**\n   * Widevine DRM configuration (Android)\n   */\n  widevine?: WidevineDrmOptions;\n}\n"]}
+{"version":3,"file":"definitions.js","sourceRoot":"","sources":["../../src/definitions.ts"],"names":[],"mappings":"","sourcesContent":["export interface VideoPlayerPlugin {\n  /**\n   * Initialize a video player\n   *\n   */\n  initPlayer(options: capVideoPlayerOptions): Promise<capVideoPlayerResult>;\n  /**\n   * Return if a given playerId is playing\n   *\n   */\n  isPlaying(options: capVideoPlayerIdOptions): Promise<capVideoPlayerResult>;\n  /**\n   * Play the current video from a given playerId\n   *\n   */\n  play(options: capVideoPlayerIdOptions): Promise<capVideoPlayerResult>;\n  /**\n   * Pause the current video from a given playerId\n   *\n   */\n  pause(options: capVideoPlayerIdOptions): Promise<capVideoPlayerResult>;\n  /**\n   * Get the duration of the current video from a given playerId\n   *\n   */\n  getDuration(options: capVideoPlayerIdOptions): Promise<capVideoPlayerResult>;\n  /**\n   * Get the current time of the current video from a given playerId\n   *\n   */\n  getCurrentTime(options: capVideoPlayerIdOptions): Promise<capVideoPlayerResult>;\n  /**\n   * Set the current time to seek the current video to from a given playerId\n   *\n   */\n  setCurrentTime(options: capVideoTimeOptions): Promise<capVideoPlayerResult>;\n  /**\n   * Get the volume of the current video from a given playerId\n   *\n   */\n  getVolume(options: capVideoPlayerIdOptions): Promise<capVideoPlayerResult>;\n  /**\n   * Set the volume of the current video to from a given playerId\n   *\n   */\n  setVolume(options: capVideoVolumeOptions): Promise<capVideoPlayerResult>;\n  /**\n   * Get the muted of the current video from a given playerId\n   *\n   */\n  getMuted(options: capVideoPlayerIdOptions): Promise<capVideoPlayerResult>;\n  /**\n   * Set the muted of the current video to from a given playerId\n   *\n   */\n  setMuted(options: capVideoMutedOptions): Promise<capVideoPlayerResult>;\n  /**\n   * Set the rate of the current video from a given playerId\n   *\n   */\n  setRate(options: capVideoRateOptions): Promise<capVideoPlayerResult>;\n  /**\n   * Get the rate of the current video from a given playerId\n   *\n   */\n  getRate(options: capVideoPlayerIdOptions): Promise<capVideoPlayerResult>;\n  /**\n   * Stop all players playing\n   *\n   */\n  stopAllPlayers(): Promise<capVideoPlayerResult>;\n  /**\n   * Show controller\n   *\n   */\n  showController(): Promise<capVideoPlayerResult>;\n  /**\n   * isControllerIsFullyVisible\n   *\n   */\n  isControllerIsFullyVisible(): Promise<capVideoPlayerResult>;\n  /**\n   * Exit player\n   *\n   */\n  exitPlayer(): Promise<capVideoPlayerResult>;\n  /**\n   * Hide the currently presented player UI without stopping playback (native fullscreen).\n   *\n   * Call `showPlayer()` to show it again.\n   */\n  hidePlayer(): Promise<capVideoPlayerResult>;\n  /**\n   * Show again a previously hidden player UI (native fullscreen).\n   */\n  showPlayer(): Promise<capVideoPlayerResult>;\n}\nexport interface capEchoOptions {\n  /**\n   *  String to be echoed\n   */\n\n  value?: string;\n}\nexport interface capVideoPlayerOptions {\n  /**\n   * Player mode\n   *  - \"fullscreen\"\n   *  - \"embedded\" (Web only)\n   */\n  mode?: string;\n  /**\n   * The url of the video to play\n   */\n  url?: string;\n  /**\n   * Optional override URL used when casting to Chromecast (iOS, Android).\n   *\n   * This lets you cast an alternative rendition/manifest (e.g. MPEG-DASH + Widevine)\n   * while keeping the on-device playback URL unchanged (e.g. HLS + FairPlay on iOS).\n   */\n  chromecastUrl?: string;\n  /**\n   * The url of subtitle associated with the video\n   *\n   * Prefer `subtitles` when providing more than one track.\n   * Kept for backward compatibility.\n   */\n  subtitle?: string;\n  /**\n   * The language of subtitle\n   * see https://github.com/libyal/libfwnt/wiki/Language-Code-identifiers\n   *\n   * Prefer `subtitles` when providing more than one track.\n   * Kept for backward compatibility.\n   */\n  language?: string;\n  /**\n   * Multiple subtitle tracks (iOS, Android).\n   * When provided, takes precedence over `subtitle` / `language`.\n   */\n  subtitles?: VideoSubtitle[];\n  /**\n   * SubTitle Options\n   */\n  subtitleOptions?: SubTitleOptions;\n  /**\n   * Id of DIV Element parent of the player\n   */\n  playerId?: string;\n  /**\n   * Initial playing rate\n   */\n  rate?: number;\n  /**\n   * Exit on VideoEnd (iOS, Android)\n   * default: true\n   */\n  exitOnEnd?: boolean;\n  /**\n   * Loop on VideoEnd when exitOnEnd false (iOS, Android)\n   * default: false\n   */\n  loopOnEnd?: boolean;\n  /**\n   * Picture in Picture Enable (iOS, Android)\n   * default: true\n   */\n  pipEnabled?: boolean;\n  /**\n   * Background Mode Enable (iOS, Android)\n   * default: true\n   */\n  bkmodeEnabled?: boolean;\n  /**\n   * 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\n   * default: \"ambient\"\n   */\n  audioCategory?: 'ambient' | 'playback' | 'moviePlayback';\n  /**\n   * Show Controls Enable (iOS, Android)\n   * default: true\n   */\n  showControls?: boolean;\n  /**\n   * Display Mode [\"all\", \"portrait\", \"landscape\"] (iOS, Android)\n   * default: \"all\"\n   */\n  displayMode?: string;\n  /**\n   * Component Tag or DOM Element Tag (React app)\n   */\n  componentTag?: string;\n  /**\n   * Player Width (mode \"embedded\" only)\n   */\n  width?: number;\n  /**\n   * Player height (mode \"embedded\" only)\n   */\n  height?: number;\n  /**\n   * Headers for the request (iOS, Android)\n   * by Manuel García Marín (https://github.com/PhantomPainX)\n   */\n  headers?: {\n    [key: string]: string;\n  };\n  /**\n   * Title shown in the player and Chromecast metadata (iOS, Android)\n   * by Manuel García Marín (https://github.com/PhantomPainX)\n   */\n  title?: string;\n  /**\n   * Subtitle shown below the title in the player and Chromecast metadata (iOS, Android)\n   * by Manuel García Marín (https://github.com/PhantomPainX)\n   */\n  smallTitle?: string;\n  /**\n   * ExoPlayer Progress Bar and Spinner color (Android)\n   * by Manuel García Marín (https://github.com/PhantomPainX)\n   * Must be a valid hex color code\n   * default: #FFFFFF\n   */\n  accentColor?: string;\n  /**\n   * Chromecast enable/disable (iOS, Android)\n   * iOS requires Google Cast SDK setup and local network Info.plist keys.\n   * by Manuel García Marín (https://github.com/PhantomPainX)\n   * default: true\n   */\n  chromecast?: boolean;\n  /**\n   * Artwork url to be shown in Chromecast player (iOS, Android)\n   * by Manuel García Marín (https://github.com/PhantomPainX)\n   * default: \"\"\n   */\n  artwork?: string;\n  /**\n   * DRM configuration for protected content (iOS: FairPlay, Android: Widevine)\n   *\n   * When casting, Widevine's `certificateUrl` (license URL) is also forwarded to Chromecast\n   * receivers as `media.customData.laurl`.\n   */\n  drm?: DrmOptions;\n}\nexport interface capVideoPlayerIdOptions {\n  /**\n   * Id of DIV Element parent of the player\n   */\n  playerId?: string;\n}\nexport interface capVideoRateOptions {\n  /**\n   * Id of DIV Element parent of the player\n   */\n  playerId?: string;\n  /**\n   * Rate value\n   */\n  rate?: number;\n}\nexport interface capVideoVolumeOptions {\n  /**\n   * Id of DIV Element parent of the player\n   */\n  playerId?: string;\n  /**\n   * Volume value between [0 - 1]\n   */\n  volume?: number;\n}\nexport interface capVideoTimeOptions {\n  /**\n   * Id of DIV Element parent of the player\n   */\n  playerId?: string;\n  /**\n   * Video time value you want to seek to\n   */\n  seektime?: number;\n}\nexport interface capVideoMutedOptions {\n  /**\n   * Id of DIV Element parent of the player\n   */\n  playerId?: string;\n  /**\n   * Muted value true or false\n   */\n  muted?: boolean;\n}\nexport interface capVideoListener {\n  /**\n   * Id of DIV Element parent of the player\n   */\n  playerId?: string;\n  /**\n   * Video current time when listener triggered\n   */\n  currentTime?: number;\n}\nexport interface capExitListener {\n  /**\n   * Dismiss value true or false\n   */\n  dismiss?: boolean;\n  /**\n   * Video current time when listener triggered\n   */\n  currentTime?: number;\n}\nexport interface capVideoPlayerResult {\n  /**\n   * result set to true when successful else false\n   */\n  result?: boolean;\n  /**\n   * method name\n   */\n  method?: string;\n  /**\n   * value returned\n   */\n  value?: any;\n  /**\n   * message string\n   */\n  message?: string;\n}\nexport interface VideoSubtitle {\n  /**\n   * The url of the subtitle file (vtt, srt, ...)\n   */\n  subtitle: string;\n  /**\n   * The language of the subtitle\n   * see https://github.com/libyal/libfwnt/wiki/Language-Code-identifiers\n   */\n  language?: string;\n}\nexport interface SubTitleOptions {\n  /**\n   * Foreground Color in RGBA (default rgba(255,255,255,1)\n   */\n  foregroundColor?: string;\n  /**\n   * Background Color in RGBA (default rgba(0,0,0,1)\n   */\n  backgroundColor?: string;\n  /**\n   * Font Size in pixels (default 16)\n   */\n  fontSize?: number;\n\n  /**\n   * Get the native Capacitor plugin version\n   *\n   * @returns {Promise<{ id: string }>} an Promise with version for this device\n   * @throws An error if the something went wrong\n   */\n  getPluginVersion(): Promise<{ version: string }>;\n}\nexport interface FairPlayDrmOptions {\n  /**\n   * The URL to fetch the FairPlay certificate\n   */\n  certificateUrl?: string;\n  /**\n   * The URL to send the SPC and receive the CKC license (FairPlay license server URL)\n   */\n  contentKeySpcUrl?: string;\n  /**\n   * Optional FairPlay asset identifier used when generating the SPC.\n   * Defaults to the `skd://` content identifier from the key request.\n   */\n  assetId?: string;\n}\nexport interface PlayreadyDrmOptions {\n  /**\n   * The URL to fetch the PlayReady license\n   */\n  certificateUrl?: string;\n}\nexport interface WidevineDrmOptions {\n  /**\n   * The URL to fetch the Widevine license\n   */\n  certificateUrl?: string;\n}\nexport interface DrmOptions {\n  /**\n   * FairPlay DRM configuration (iOS)\n   */\n  fairplay?: FairPlayDrmOptions;\n  /**\n   * PlayReady DRM configuration\n   */\n  playready?: PlayreadyDrmOptions;\n  /**\n   * Widevine DRM configuration (Android)\n   */\n  widevine?: WidevineDrmOptions;\n}\n"]}

package/ios/Sources/VideoPlayerPlugin/FullscreenVideoPlayer.swift

@@ -3,6 +3,7 @@ import AVKit
 import AVFoundation
 import UIKit
 
+// swiftlint:disable:next type_body_length
 class FullscreenVideoPlayer: NSObject {
     private var player: AVPlayer?
     private var playerViewController: AVPlayerViewController?
@@ -35,8 +36,7 @@ class FullscreenVideoPlayer: NSObject {
     private var contentKeySession: AVContentKeySession?
     private var castController: VideoPlayerCastController?
     private weak var presentingViewController: UIViewController?
-    private var subtitleUrl: String?
-    private var subtitleLanguage: String?
+    private var subtitleTracks: [VideoSubtitleTrack] = []
     private var hlsResourceLoader: HLSSubtitleResourceLoader?
 
     init(
@@ -52,8 +52,7 @@ class FullscreenVideoPlayer: NSObject {
         title: String? = nil,
         smallTitle: String? = nil,
         artwork: String? = nil,
-        subtitleUrl: String? = nil,
-        subtitleLanguage: String? = nil,
+        subtitleTracks: [VideoSubtitleTrack] = [],
         fairplayCertificateUrl: String? = nil,
         fairplayContentKeySpcUrl: String? = nil,
         fairplayAssetId: String? = nil,
@@ -72,8 +71,7 @@ class FullscreenVideoPlayer: NSObject {
         self.title = title
         self.smallTitle = smallTitle
         self.artwork = artwork
-        self.subtitleUrl = subtitleUrl
-        self.subtitleLanguage = subtitleLanguage
+        self.subtitleTracks = subtitleTracks
         self.fairplayCertificateUrl = fairplayCertificateUrl
         self.fairplayContentKeySpcUrl = fairplayContentKeySpcUrl
         self.fairplayAssetId = fairplayAssetId
@@ -90,28 +88,30 @@ class FullscreenVideoPlayer: NSObject {
 
         configureAudioSession()
 
-        guard let subtitleUrlString = subtitleUrl,
-              !subtitleUrlString.isEmpty,
-              let subtitleURL = URL(string: subtitleUrlString) else {
-            let asset = makeVideoAsset(url: url, subtitleURL: nil)
+        let resolvedTracks = subtitleTracks.compactMap { track -> (URL, String?)? in
+            guard let subtitleURL = track.resolvedURL else { return nil }
+            return (subtitleURL, track.language)
+        }
+
+        guard !resolvedTracks.isEmpty else {
+            let asset = makeVideoAsset(url: url, subtitleTracks: [])
             configurePlayer(with: AVPlayerItem(asset: asset))
             completion()
             return
         }
 
         if HLSVideoAssetFactory.isHLSStream(url) {
-            let asset = makeVideoAsset(url: url, subtitleURL: subtitleURL)
+            let asset = makeVideoAsset(url: url, subtitleTracks: subtitleTracks)
             configurePlayer(with: AVPlayerItem(asset: asset))
             completion()
             return
         }
 
         Task {
-            let asset = makeVideoAsset(url: url, subtitleURL: nil)
+            let asset = makeVideoAsset(url: url, subtitleTracks: [])
             let item = await ProgressiveVideoPlayerItemFactory.createPlayerItem(
                 videoAsset: asset,
-                subtitleURL: subtitleURL,
-                subtitleLanguage: subtitleLanguage
+                subtitleTracks: subtitleTracks
             )
             await MainActor.run {
                 self.configurePlayer(with: item)
@@ -120,11 +120,10 @@ class FullscreenVideoPlayer: NSObject {
         }
     }
 
-    private func makeVideoAsset(url: URL, subtitleURL: URL?) -> AVURLAsset {
+    private func makeVideoAsset(url: URL, subtitleTracks: [VideoSubtitleTrack]) -> AVURLAsset {
         let result = HLSVideoAssetFactory.makeAsset(
             videoURL: url,
-            subtitleURL: subtitleURL,
-            language: subtitleLanguage ?? "en"
+            subtitleTracks: subtitleTracks
         )
         hlsResourceLoader = result.resourceLoader
         let asset = result.asset

package/ios/Sources/VideoPlayerPlugin/HLSSubtitleResourceLoader.swift

@@ -16,17 +16,21 @@ enum HLSVideoAssetFactory {
 
     static func makeAsset(
         videoURL: URL,
-        subtitleURL: URL?,
-        language: String
+        subtitleTracks: [VideoSubtitleTrack]
     ) -> (asset: AVURLAsset, resourceLoader: HLSSubtitleResourceLoader?) {
-        guard let subtitleURL, isHLSStream(videoURL) else {
+        var resolvedTracks: [(url: URL, language: String)] = []
+        for track in subtitleTracks {
+            guard let subtitleURL = track.resolvedURL else { continue }
+            resolvedTracks.append((url: subtitleURL, language: track.language ?? "en"))
+        }
+
+        guard !resolvedTracks.isEmpty, isHLSStream(videoURL) else {
             return (AVURLAsset(url: videoURL), nil)
         }
 
         let resourceLoader = HLSSubtitleResourceLoader(
             videoURL: videoURL,
-            subtitleURL: subtitleURL,
-            language: language
+            subtitleTracks: resolvedTracks.map { HLSSubtitleTrack(url: $0.url, language: $0.language) }
         )
         guard let assetURL = HLSSubtitleResourceLoader.assetURL(for: videoURL) else {
             return (AVURLAsset(url: videoURL), nil)
@@ -38,6 +42,11 @@ enum HLSVideoAssetFactory {
     }
 }
 
+struct HLSSubtitleTrack {
+    let url: URL
+    let language: String
+}
+
 /// Injects external WebVTT subtitles into HLS master playlists via AVAssetResourceLoaderDelegate.
 /// AVMutableComposition cannot demux HLS tracks, so sidecar subtitles must be wired through the manifest.
 final class HLSSubtitleResourceLoader: NSObject, AVAssetResourceLoaderDelegate {
@@ -47,18 +56,16 @@ final class HLSSubtitleResourceLoader: NSObject, AVAssetResourceLoaderDelegate {
     private static let mpegURLContentType = UTType.m3uPlaylist.identifier
 
     private let originalVideoURL: URL
-    private let subtitleURL: URL
-    private let language: String
+    private let subtitleTracks: [HLSSubtitleTrack]
 
     private struct LoadedResource {
         let data: Data
         let contentType: String?
     }
 
-    init(videoURL: URL, subtitleURL: URL, language: String) {
+    init(videoURL: URL, subtitleTracks: [HLSSubtitleTrack]) {
         self.originalVideoURL = videoURL
-        self.subtitleURL = subtitleURL
-        self.language = language
+        self.subtitleTracks = subtitleTracks
     }
 
     static func assetURL(for videoURL: URL) -> URL? {
@@ -69,11 +76,14 @@ final class HLSSubtitleResourceLoader: NSObject, AVAssetResourceLoaderDelegate {
         return components.url
     }
 
-    static func subtitlePlaylistURL(for videoURL: URL) -> URL? {
+    static func subtitlePlaylistURL(for videoURL: URL, index: Int) -> URL? {
         guard var components = URLComponents(url: videoURL, resolvingAgainstBaseURL: false) else {
             return nil
         }
         components.scheme = subtitlePlaylistScheme
+        var queryItems = components.queryItems ?? []
+        queryItems.append(URLQueryItem(name: "capgoSubIndex", value: String(index)))
+        components.queryItems = queryItems
         return components.url
     }
 
@@ -99,7 +109,9 @@ final class HLSSubtitleResourceLoader: NSObject, AVAssetResourceLoaderDelegate {
 
     private func loadData(for requestURL: URL) async throws -> LoadedResource {
         if requestURL.scheme == Self.subtitlePlaylistScheme {
-            let data = Data(subtitleMediaPlaylist().utf8)
+            let index = subtitleIndex(from: requestURL) ?? 0
+            let track = subtitleTracks[min(max(index, 0), subtitleTracks.count - 1)]
+            let data = Data(subtitleMediaPlaylist(for: track.url).utf8)
             return LoadedResource(data: data, contentType: Self.mpegURLContentType)
         }
 
@@ -116,19 +128,21 @@ final class HLSSubtitleResourceLoader: NSObject, AVAssetResourceLoaderDelegate {
             return LoadedResource(data: data, contentType: contentType)
         }
 
-        guard let subtitlePlaylistURI = Self.subtitlePlaylistURL(for: originalVideoURL)?.absoluteString else {
-            let contentType = Self.contentTypeIdentifier(from: response) ?? Self.mpegURLContentType
-            return LoadedResource(data: data, contentType: contentType)
-        }
-
-        let modified = injectSubtitle(
+        let modified = injectSubtitles(
             into: manifest,
-            subtitlePlaylistURI: subtitlePlaylistURI,
             baseURL: response.url ?? fetchURL
         )
         return LoadedResource(data: Data(modified.utf8), contentType: Self.mpegURLContentType)
     }
 
+    private func subtitleIndex(from requestURL: URL) -> Int? {
+        guard let components = URLComponents(url: requestURL, resolvingAgainstBaseURL: false),
+              let value = components.queryItems?.first(where: { $0.name == "capgoSubIndex" })?.value else {
+            return nil
+        }
+        return Int(value)
+    }
+
     private func originalURL(for requestURL: URL) -> URL {
         guard var components = URLComponents(url: requestURL, resolvingAgainstBaseURL: false),
               components.scheme == Self.videoScheme else {
@@ -158,20 +172,31 @@ final class HLSSubtitleResourceLoader: NSObject, AVAssetResourceLoaderDelegate {
         return url.absoluteString
     }
 
-    private func injectSubtitle(into manifest: String, subtitlePlaylistURI: String, baseURL: URL) -> String {
-        let mediaTag = """
-        #EXT-X-MEDIA:TYPE=SUBTITLES,GROUP-ID="\(Self.subtitleGroupID)",NAME="Subtitles",DEFAULT=YES,AUTOSELECT=YES,FORCED=NO,LANGUAGE="\(language)",URI="\(subtitlePlaylistURI)"
-        """
+    private func injectSubtitles(into manifest: String, baseURL: URL) -> String {
+        let mediaTags = subtitleTracks.enumerated().compactMap { index, track -> String? in
+            guard let subtitlePlaylistURI = Self.subtitlePlaylistURL(for: originalVideoURL, index: index)?.absoluteString else {
+                return nil
+            }
+            let isDefault = index == 0 ? "YES" : "NO"
+            let displayName = Locale(identifier: track.language).localizedString(forLanguageCode: track.language)
+                ?? track.language
+            return """
+            #EXT-X-MEDIA:TYPE=SUBTITLES,GROUP-ID="\(Self.subtitleGroupID)",NAME="\(displayName)",DEFAULT=\(isDefault),AUTOSELECT=YES,FORCED=NO,LANGUAGE="\(track.language)",URI="\(subtitlePlaylistURI)"
+            """
+        }
+
+        guard !mediaTags.isEmpty else {
+            return manifest
+        }
 
-        var lines = manifest.components(separatedBy: .newlines)
         var result: [String] = []
         var insertedMediaTag = false
         var expectingVariantURI = false
 
-        for line in lines {
+        for line in manifest.components(separatedBy: .newlines) {
             if line.hasPrefix("#EXT-X-STREAM-INF") || line.hasPrefix("#EXT-X-I-FRAME-STREAM-INF") {
                 if !insertedMediaTag {
-                    result.append(mediaTag)
+                    result.append(contentsOf: mediaTags)
                     insertedMediaTag = true
                 }
 
@@ -195,13 +220,13 @@ final class HLSSubtitleResourceLoader: NSObject, AVAssetResourceLoaderDelegate {
         }
 
         if !insertedMediaTag, let extm3uIndex = result.firstIndex(where: { $0.hasPrefix("#EXTM3U") }) {
-            result.insert(mediaTag, at: extm3uIndex + 1)
+            result.insert(contentsOf: mediaTags, at: extm3uIndex + 1)
         }
 
         return result.joined(separator: "\n")
     }
 
-    private func subtitleMediaPlaylist() -> String {
+    private func subtitleMediaPlaylist(for subtitleURL: URL) -> String {
         """
         #EXTM3U
         #EXT-X-VERSION:3

package/ios/Sources/VideoPlayerPlugin/ProgressiveVideoPlayerItemFactory.swift

@@ -4,10 +4,16 @@ import Foundation
 enum ProgressiveVideoPlayerItemFactory {
     static func createPlayerItem(
         videoAsset: AVURLAsset,
-        subtitleURL: URL,
-        subtitleLanguage: String?
+        subtitleTracks: [VideoSubtitleTrack]
     ) async -> AVPlayerItem {
-        let subtitleAsset = AVURLAsset(url: subtitleURL)
+        let resolvedTracks = subtitleTracks.compactMap { track -> (URL, String?)? in
+            guard let url = track.resolvedURL else { return nil }
+            return (url, track.language)
+        }
+
+        guard !resolvedTracks.isEmpty else {
+            return AVPlayerItem(asset: videoAsset)
+        }
 
         do {
             let videoDuration = try await videoAsset.load(.duration)
@@ -27,9 +33,14 @@ enum ProgressiveVideoPlayerItemFactory {
                 return AVPlayerItem(asset: videoAsset)
             }
 
+            var preferredLanguage: String?
             var subtitleAdded = false
-            let subtitleTracks = try await subtitleAsset.loadTracks(withMediaType: .text)
-            if let subtitleTrack = subtitleTracks.first {
+
+            for (index, track) in resolvedTracks.enumerated() {
+                let subtitleAsset = AVURLAsset(url: track.0)
+                let subtitleMediaTracks = try await subtitleAsset.loadTracks(withMediaType: .text)
+                guard let subtitleTrack = subtitleMediaTracks.first else { continue }
+
                 let compositionTrack = composition.addMutableTrack(
                     withMediaType: .text,
                     preferredTrackID: kCMPersistentTrackID_Invalid
@@ -41,13 +52,25 @@ enum ProgressiveVideoPlayerItemFactory {
                     of: subtitleTrack,
                     at: CMTime.zero
                 )
+
+                if let language = track.1, !language.isEmpty {
+                    compositionTrack?.extendedLanguageTag = language
+                    if preferredLanguage == nil {
+                        preferredLanguage = language
+                    }
+                }
+
+                // Keep first track as default selection preference
+                if index == 0, preferredLanguage == nil {
+                    preferredLanguage = track.1
+                }
                 subtitleAdded = true
             }
 
             let playerItem = AVPlayerItem(asset: composition)
 
             if subtitleAdded {
-                selectSubtitle(in: playerItem, language: subtitleLanguage)
+                selectSubtitle(in: playerItem, language: preferredLanguage)
             }
 
             return playerItem
@@ -101,5 +124,4 @@ enum ProgressiveVideoPlayerItemFactory {
                 || option.locale?.languageCode == language
         }
     }
-
 }

package/ios/Sources/VideoPlayerPlugin/VideoPlayerPlugin.swift

@@ -8,7 +8,7 @@ import AVKit
  */
 @objc(VideoPlayerPlugin)
 public class VideoPlayerPlugin: CAPPlugin, CAPBridgedPlugin {
-    private let pluginVersion: String = "8.1.25"
+    private let pluginVersion: String = "8.2.1"
     public let identifier = "VideoPlayerPlugin"
     public let jsName = "VideoPlayer"
     public let pluginMethods: [CAPPluginMethod] = [
@@ -83,17 +83,8 @@ extension VideoPlayerPlugin {
         let artwork = call.getString("artwork")
         let chromecastUrl = call.getString("chromecastUrl")
         let audioCategory = call.getString("audioCategory")
-        let subtitle = call.getString("subtitle")
-        let language = call.getString("language")
-
-        // Extract FairPlay DRM options if provided
-        let drm = call.getObject("drm")
-        let fairplay = drm?["fairplay"] as? [String: Any]
-        let fairplayCertificateUrl = fairplay?["certificateUrl"] as? String
-        let fairplayContentKeySpcUrl = fairplay?["contentKeySpcUrl"] as? String
-        let fairplayAssetId = fairplay?["assetId"] as? String
-        let widevine = drm?["widevine"] as? [String: Any]
-        let widevineLicenseUrl = widevine?["certificateUrl"] as? String
+        let subtitleTracks = Self.parseSubtitleTracks(from: call)
+        let drmOptions = Self.parseDrmOptions(from: call)
 
         // Create video player
         let player = FullscreenVideoPlayer(
@@ -109,12 +100,11 @@ extension VideoPlayerPlugin {
             title: title,
             smallTitle: smallTitle,
             artwork: artwork,
-            subtitleUrl: subtitle,
-            subtitleLanguage: language,
-            fairplayCertificateUrl: fairplayCertificateUrl,
-            fairplayContentKeySpcUrl: fairplayContentKeySpcUrl,
-            fairplayAssetId: fairplayAssetId,
-            widevineLicenseUrl: widevineLicenseUrl,
+            subtitleTracks: subtitleTracks,
+            fairplayCertificateUrl: drmOptions.fairplayCertificateUrl,
+            fairplayContentKeySpcUrl: drmOptions.fairplayContentKeySpcUrl,
+            fairplayAssetId: drmOptions.fairplayAssetId,
+            widevineLicenseUrl: drmOptions.widevineLicenseUrl,
             audioCategory: audioCategory
         )
 
@@ -147,6 +137,43 @@ extension VideoPlayerPlugin {
         }
     }
 
+    private static func parseSubtitleTracks(from call: CAPPluginCall) -> [VideoSubtitleTrack] {
+        let subtitlesArray = call.getArray("subtitles", JSObject.self)?.map { entry -> [String: Any] in
+            var dict: [String: Any] = [:]
+            if let subtitleUrl = entry["subtitle"] as? String {
+                dict["subtitle"] = subtitleUrl
+            }
+            if let lang = entry["language"] as? String {
+                dict["language"] = lang
+            }
+            return dict
+        }
+        return VideoSubtitleTrackParser.parse(
+            from: subtitlesArray,
+            legacySubtitle: call.getString("subtitle"),
+            legacyLanguage: call.getString("language")
+        )
+    }
+
+    private struct ParsedDrmOptions {
+        let fairplayCertificateUrl: String?
+        let fairplayContentKeySpcUrl: String?
+        let fairplayAssetId: String?
+        let widevineLicenseUrl: String?
+    }
+
+    private static func parseDrmOptions(from call: CAPPluginCall) -> ParsedDrmOptions {
+        let drm = call.getObject("drm")
+        let fairplay = drm?["fairplay"] as? [String: Any]
+        let widevine = drm?["widevine"] as? [String: Any]
+        return ParsedDrmOptions(
+            fairplayCertificateUrl: fairplay?["certificateUrl"] as? String,
+            fairplayContentKeySpcUrl: fairplay?["contentKeySpcUrl"] as? String,
+            fairplayAssetId: fairplay?["assetId"] as? String,
+            widevineLicenseUrl: widevine?["certificateUrl"] as? String
+        )
+    }
+
     private func configureCallbacks(for player: FullscreenVideoPlayer, playerId: String) {
         player.setOnPlay { [weak self] in
             self?.notifyListeners("jeepCapVideoPlayerPlay", data: [

package/ios/Sources/VideoPlayerPlugin/VideoSubtitleTrack.swift

@@ -0,0 +1,31 @@
+import Foundation
+
+struct VideoSubtitleTrack {
+    let url: String
+    let language: String?
+
+    var resolvedURL: URL? {
+        guard !url.isEmpty else { return nil }
+        return URL(string: url)
+    }
+}
+
+enum VideoSubtitleTrackParser {
+    static func parse(from callSubtitles: [[String: Any]]?, legacySubtitle: String?, legacyLanguage: String?) -> [VideoSubtitleTrack] {
+        if let callSubtitles, !callSubtitles.isEmpty {
+            return callSubtitles.compactMap { entry in
+                guard let subtitle = entry["subtitle"] as? String, !subtitle.isEmpty else {
+                    return nil
+                }
+                let language = entry["language"] as? String
+                return VideoSubtitleTrack(url: subtitle, language: language)
+            }
+        }
+
+        guard let legacySubtitle, !legacySubtitle.isEmpty else {
+            return []
+        }
+
+        return [VideoSubtitleTrack(url: legacySubtitle, language: legacyLanguage)]
+    }
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@capgo/capacitor-video-player",
-  "version": "8.1.25",
+  "version": "8.2.1",
   "description": "Capacitor plugin to play video in native player",
   "main": "dist/plugin.cjs.js",
   "module": "dist/esm/index.js",
@@ -49,7 +49,8 @@
     "prepublishOnly": "bun run build",
     "check:wiring": "node scripts/check-capacitor-plugin-wiring.mjs",
     "example:install": "cd example-app && bun install --frozen-lockfile",
-    "example:build": "bun run build && cd example-app && bun install --frozen-lockfile && bun run build"
+    "example:build": "bun run build && cd example-app && bun install --frozen-lockfile && bun run build",
+    "changelog:ai": "node scripts/generate-ai-changelog.mjs"
   },
   "devDependencies": {
     "@capacitor/android": "^8.0.0",