@capgo/capacitor-video-player 8.2.15 → 8.3.0

package/README.md

@@ -534,6 +534,7 @@ On web, the implementation returns `"web"`.
 | **`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`.                                                                                                                                                                                                                                                                                    |
+| **`chapters`**        | <code>VideoChapter[]</code>                                 | Chapter markers for long-form content (iOS, Android). Shown as a chapter list in the native fullscreen player; selecting a chapter seeks to `startTime`.                                                                                                                                                                                                                                  |
 | **`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                                                                                                                                                                                                                                                                                                                                                                      |
@@ -564,13 +565,31 @@ On web, the implementation returns `"web"`.
 | **`language`** | <code>string</code> | The language of the subtitle see https://github.com/libyal/libfwnt/wiki/Language-Code-identifiers |
 
 
+#### VideoChapter
+
+| Prop            | Type                | Description                                                                                                             |
+| --------------- | ------------------- | ----------------------------------------------------------------------------------------------------------------------- |
+| **`title`**     | <code>string</code> | Chapter title shown in the chapter list                                                                                 |
+| **`startTime`** | <code>number</code> | Start time in seconds                                                                                                   |
+| **`endTime`**   | <code>number</code> | End time in seconds (optional). Stored for future timeline markers; chapter jumps use `startTime` only in this release. |
+
+
 #### SubTitleOptions
 
-| Prop                  | Type                | Description                                           |
-| --------------------- | ------------------- | ----------------------------------------------------- |
-| **`foregroundColor`** | <code>string</code> | Foreground Color in RGBA (default rgba(255,255,255,1) |
-| **`backgroundColor`** | <code>string</code> | Background Color in RGBA (default rgba(0,0,0,1)       |
-| **`fontSize`**        | <code>number</code> | Font Size in pixels (default 16)                      |
+Optional styling for on-screen subtitles.
+
+On iOS, colors and font size are applied through `AVPlayerItem`
+`textStyleRules`, which Apple documents for WebVTT only. IMSC1 and other
+in-manifest timed text formats are not styled through this API.
+Inline WebVTT cue styles can take precedence over equivalent
+`subtitleOptions` values; the plugin sets text style rules as a platform
+fallback, not a guaranteed override of authored cue styling.
+
+| Prop                  | Type                | Description                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
+| --------------------- | ------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| **`foregroundColor`** | <code>string</code> | Foreground color in RGBA. On Android, when the plugin applies subtitle styling, omitted values fall back to `rgba(255,255,255,1)`. When `subtitleOptions` is absent, embedded cue colors from the media can override that fallback. On iOS, omitted colors are not set by the plugin; the platform uses the viewer's caption appearance settings instead of fixed plugin defaults.                                                                                                                                                                                                                                                                                                                                                                                                            |
+| **`backgroundColor`** | <code>string</code> | Background color in RGBA. On Android, when the plugin applies subtitle styling in fullscreen, omitted values fall back to `rgba(0,0,0,1)`. In picture-in-picture, omitted values fall back to transparent when the plugin applies its caption style (for example sidecar subtitles or non-empty `subtitleOptions` that include a color override). An empty `subtitleOptions` object alone does not select that fallback. With font-size-only options, embedded cue styles stay enabled, so authored cue backgrounds can remain visible in PiP. When `subtitleOptions` is absent, embedded cue colors from the media can override the fallback. On iOS, omitted colors are not set by the plugin; the platform uses the viewer's caption appearance settings instead of fixed plugin defaults. |
+| **`fontSize`**        | <code>number</code> | Font size in CSS pixels. On Android, supplied values are rounded to the nearest integer before applying. When omitted on embedded tracks without a sidecar subtitle URI, Android uses `SubtitleView.setUserDefaultTextSize()` (the user's system caption size), not a fixed 16 px size. Sidecar subtitles still use a fixed default size when this property is omitted. On iOS, values map to AVFoundation relative size where 16 equals the system default (100%).                                                                                                                                                                                                                                                                                                                           |
 
 
 #### DrmOptions

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

@@ -3,6 +3,7 @@ package com.capgo.videoplayer;
 import android.annotation.SuppressLint;
 import android.app.Activity;
 import android.app.ActivityManager;
+import android.app.AlertDialog;
 import android.app.PictureInPictureParams;
 import android.content.ContentUris;
 import android.content.Context;
@@ -78,11 +79,13 @@ import com.google.android.exoplayer2.ui.CaptionStyleCompat;
 import com.google.android.exoplayer2.ui.DefaultTimeBar;
 import com.google.android.exoplayer2.ui.PlayerControlView;
 import com.google.android.exoplayer2.ui.StyledPlayerView;
+import com.google.android.exoplayer2.ui.SubtitleView;
 import com.google.android.exoplayer2.upstream.DataSource;
 import com.google.android.exoplayer2.upstream.DefaultBandwidthMeter;
 import com.google.android.exoplayer2.upstream.DefaultDataSourceFactory;
 import com.google.android.exoplayer2.upstream.DefaultHttpDataSource;
 import com.google.android.exoplayer2.util.MimeTypes;
+import com.google.android.exoplayer2.util.Util;
 import com.google.android.gms.cast.MediaInfo;
 import com.google.android.gms.cast.MediaQueueItem;
 import com.google.android.gms.cast.MediaTrack;
@@ -99,6 +102,7 @@ import java.net.HttpURLConnection;
 import java.net.URL;
 import java.util.ArrayList;
 import java.util.Arrays;
+import java.util.Formatter;
 import java.util.HashMap;
 import java.util.List;
 import java.util.Locale;
@@ -115,6 +119,7 @@ public class FullscreenExoPlayerFragment extends Fragment {
     public Float videoRate;
     public String playerId;
     public List<VideoSubtitleTrack> subtitleTracks;
+    public List<VideoChapter> chapters = new ArrayList<>();
     public String subTitle;
     public String language;
     public JSObject subTitleOptions;
@@ -170,6 +175,7 @@ public class FullscreenExoPlayerFragment extends Fragment {
     private ProgressBar Pbar;
     private View view;
     private ImageButton closeBtn;
+    private ImageButton chaptersBtn;
     private ImageButton pipBtn;
     private ImageButton resizeBtn;
     private ConstraintLayout constLayout;
@@ -292,6 +298,7 @@ public class FullscreenExoPlayerFragment extends Fragment {
         }
 
         closeBtn = view.findViewById(R.id.exo_close);
+        chaptersBtn = view.findViewById(R.id.exo_chapters);
         pipBtn = view.findViewById(R.id.exo_pip);
         styledPlayerView.requestFocus();
         linearLayout.setVisibility(View.INVISIBLE);
@@ -338,6 +345,7 @@ public class FullscreenExoPlayerFragment extends Fragment {
                         linearLayout.setVisibility(View.INVISIBLE);
                         Log.v(TAG, "**** in ExoPlayer.STATE_READY firstReadyToPlay " + firstReadyToPlay);
                         updateSubtitleButtonVisibility(player.getCurrentTracks());
+                        updateChaptersButtonVisibility();
 
                         if (firstReadyToPlay) {
                             firstReadyToPlay = false;
@@ -367,6 +375,7 @@ public class FullscreenExoPlayerFragment extends Fragment {
                                 if (pipEnabled) {
                                     pipBtn.setVisibility(View.VISIBLE);
                                 }
+                                updateChaptersButtonVisibility();
                             } else {
                                 Log.v(TAG, "**** in ExoPlayer.STATE_READY going to notify playerItemPause ");
                                 NotificationCenter.defaultCenter().postNotification("playerItemPause", info);
@@ -408,6 +417,16 @@ public class FullscreenExoPlayerFragment extends Fragment {
             Toast.makeText(context, "Device is a TV ", Toast.LENGTH_SHORT).show();
         }
 
+        stForeColor = subTitleOptions != null ? subTitleOptions.optString("foregroundColor", "rgba(255,255,255,1)") : "rgba(255,255,255,1)";
+        stBackColor = subTitleOptions != null ? subTitleOptions.optString("backgroundColor", "rgba(0,0,0,1)") : "rgba(0,0,0,1)";
+        stFontSize = 16;
+        if (subTitleOptions != null && subTitleOptions.has("fontSize")) {
+            int fontSizeCandidate = (int) Math.round(subTitleOptions.optDouble("fontSize", 16));
+            if (fontSizeCandidate > 0) {
+                stFontSize = fontSizeCandidate;
+            }
+        }
+
         if (!isInternal) {
             uri = Uri.parse(videoPath);
             subtitleUris = new ArrayList<>();
@@ -427,15 +446,6 @@ public class FullscreenExoPlayerFragment extends Fragment {
                 subtitleLanguages.add(language != null ? language : "en");
             }
 
-            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);
@@ -506,6 +516,14 @@ public class FullscreenExoPlayerFragment extends Fragment {
                                 }
                             }
                         );
+                        chaptersBtn.setOnClickListener(
+                            new View.OnClickListener() {
+                                @Override
+                                public void onClick(View view) {
+                                    showChapterPicker();
+                                }
+                            }
+                        );
                         pipBtn.setOnClickListener(
                             new View.OnClickListener() {
                                 @Override
@@ -682,9 +700,7 @@ public class FullscreenExoPlayerFragment extends Fragment {
         }
 
         isInPictureInPictureMode = activity.isInPictureInPictureMode();
-        if (!subtitleUris.isEmpty()) {
-            setSubtitle(true);
-        }
+        applySubtitleAppearance(true);
         play();
         handler.postDelayed(mRunnable, 100);
     }
@@ -722,9 +738,7 @@ public class FullscreenExoPlayerFragment extends Fragment {
         if (inPictureInPictureMode) {
             linearLayout.setVisibility(View.INVISIBLE);
             styledPlayerView.setUseController(false);
-            if (!subtitleUris.isEmpty()) {
-                setSubtitle(true);
-            }
+            applySubtitleAppearance(true);
             return;
         }
 
@@ -732,9 +746,7 @@ public class FullscreenExoPlayerFragment extends Fragment {
         if (showControls) {
             styledPlayerView.setUseController(true);
         }
-        if (!subtitleUris.isEmpty()) {
-            setSubtitle(false);
-        }
+        applySubtitleAppearance(false);
     }
 
     private void checkPIPPermission() {
@@ -871,7 +883,10 @@ public class FullscreenExoPlayerFragment extends Fragment {
                 }
             }
             if (sturi != null) {
-                setSubtitle(false);
+                applySubtitleAppearance(false);
+                styledPlayerView.setShowSubtitleButton(true);
+            } else {
+                applySubtitleAppearance(false);
             }
         }
     }
@@ -955,7 +970,10 @@ public class FullscreenExoPlayerFragment extends Fragment {
             }
         };
         if (sturi != null) {
-            setSubtitle(false);
+            applySubtitleAppearance(false);
+            styledPlayerView.setShowSubtitleButton(true);
+        } else {
+            applySubtitleAppearance(false);
         }
         //Use Media Session Connector from the EXT library to enable MediaSession Controls in PIP.
         mediaSession = new MediaSessionCompat(context, "capacitorvideoplayer");
@@ -966,6 +984,69 @@ public class FullscreenExoPlayerFragment extends Fragment {
         NotificationCenter.defaultCenter().postNotification("initializePlayer", info);
     }
 
+    private boolean isActivePlayerReady() {
+        if (isCastSession) {
+            return castPlayer != null && castPlayer.getPlaybackState() == Player.STATE_READY;
+        }
+        return playerReady;
+    }
+
+    private void updateChaptersButtonVisibility() {
+        if (chaptersBtn == null) {
+            return;
+        }
+        boolean visible = chapters != null && !chapters.isEmpty() && isActivePlayerReady() && showControls;
+        chaptersBtn.setVisibility(visible ? View.VISIBLE : View.GONE);
+    }
+
+    private void showChapterPicker() {
+        if (chapters == null || chapters.isEmpty()) {
+            return;
+        }
+        if (player == null && !(isCastSession && castPlayer != null)) {
+            return;
+        }
+
+        CharSequence[] labels = new CharSequence[chapters.size()];
+        for (int i = 0; i < chapters.size(); i++) {
+            labels[i] = formatChapterLabel(chapters.get(i));
+        }
+
+        new AlertDialog.Builder(requireActivity())
+            .setTitle(R.string.chapters)
+            .setItems(labels, (dialog, which) -> seekToChapter(chapters.get(which)))
+            .show();
+    }
+
+    private String formatChapterLabel(VideoChapter chapter) {
+        long startMs = (long) (chapter.startTimeSeconds * 1000.0);
+        StringBuilder builder = new StringBuilder();
+        Formatter formatter = new Formatter(builder, Locale.getDefault());
+        String timeLabel = Util.getStringForTime(builder, formatter, startMs);
+        formatter.close();
+        if (chapter.title.isEmpty()) {
+            return timeLabel;
+        }
+        return chapter.title + " (" + timeLabel + ")";
+    }
+
+    private void seekToChapter(VideoChapter chapter) {
+        if (chapter == null) {
+            return;
+        }
+        long targetMs = (long) (chapter.startTimeSeconds * 1000.0);
+        if (isCastSession && castPlayer != null) {
+            castPlayer.seekTo(targetMs);
+            castPlayer.setPlayWhenReady(true);
+            return;
+        }
+        if (player == null) {
+            return;
+        }
+        player.seekTo(targetMs);
+        play();
+    }
+
     private void updateSubtitleButtonVisibility(Tracks tracks) {
         if (styledPlayerView == null) return;
         boolean hasSidecar = !subtitleUris.isEmpty() || sturi != null;
@@ -985,29 +1066,53 @@ public class FullscreenExoPlayerFragment extends Fragment {
         return false;
     }
 
-    private void setSubtitle(boolean transparent) {
-        int foreground;
-        int background;
-        if (!transparent) {
-            foreground = Color.WHITE;
-            background = Color.BLACK;
-            if (stForeColor.length() > 4 && stForeColor.substring(0, 4).equals("rgba")) {
-                foreground = getColorFromRGBA(stForeColor);
+    private void applySubtitleAppearance(boolean transparentBackground) {
+        SubtitleView subtitleView = styledPlayerView.getSubtitleView();
+        boolean hasSidecar = sturi != null;
+        boolean hasColorOverride = SubtitleOptionOverrides.hasColor(subTitleOptions);
+        boolean hasBackgroundColorOverride = SubtitleOptionOverrides.hasBackgroundColor(subTitleOptions);
+        boolean hasAnyOptions = SubtitleOptionOverrides.hasAny(subTitleOptions);
+        boolean shouldApplyCaptionStyle = hasColorOverride || hasSidecar || (transparentBackground && hasAnyOptions);
+
+        if (hasColorOverride) {
+            subtitleView.setApplyEmbeddedStyles(false);
+            subtitleView.setApplyEmbeddedFontSizes(false);
+        } else if (SubtitleOptionOverrides.hasFontSize(subTitleOptions)) {
+            subtitleView.setApplyEmbeddedStyles(true);
+            subtitleView.setApplyEmbeddedFontSizes(false);
+        }
+
+        if (shouldApplyCaptionStyle) {
+            int foreground = Color.WHITE;
+            if (hasColorOverride) {
+                Integer parsedForeground = SubtitleOptionOverrides.parseRgbaColor(stForeColor);
+                if (parsedForeground != null) {
+                    foreground = parsedForeground;
+                }
             }
-            if (stBackColor.length() > 4 && stBackColor.substring(0, 4).equals("rgba")) {
-                background = getColorFromRGBA(stBackColor);
+            int background;
+            if (transparentBackground && !hasBackgroundColorOverride) {
+                background = Color.TRANSPARENT;
+            } else {
+                background = Color.BLACK;
+                if (hasBackgroundColorOverride) {
+                    Integer parsedBackground = SubtitleOptionOverrides.parseRgbaColor(stBackColor);
+                    if (parsedBackground != null) {
+                        background = parsedBackground;
+                    }
+                }
             }
-        } else {
-            foreground = Color.TRANSPARENT;
-            background = Color.TRANSPARENT;
-        }
-        styledPlayerView
-            .getSubtitleView()
-            .setStyle(
+            subtitleView.setStyle(
                 new CaptionStyleCompat(foreground, background, Color.TRANSPARENT, CaptionStyleCompat.EDGE_TYPE_NONE, Color.WHITE, null)
             );
-        styledPlayerView.getSubtitleView().setFixedTextSize(TypedValue.COMPLEX_UNIT_DIP, stFontSize);
-        styledPlayerView.setShowSubtitleButton(true);
+        } else {
+            subtitleView.setUserDefaultStyle();
+        }
+        if (SubtitleOptionOverrides.shouldUseFixedTextSize(subTitleOptions, hasSidecar)) {
+            subtitleView.setFixedTextSize(TypedValue.COMPLEX_UNIT_DIP, stFontSize);
+        } else {
+            subtitleView.setUserDefaultTextSize();
+        }
     }
 
     /**
@@ -1126,20 +1231,6 @@ public class FullscreenExoPlayerFragment extends Fragment {
         }
     }
 
-    private int getColorFromRGBA(String rgbaColor) {
-        int ret = 0;
-        String color = rgbaColor.substring(rgbaColor.indexOf("(") + 1, rgbaColor.indexOf(")"));
-        List<String> colors = Arrays.asList(color.split(","));
-        if (colors.size() == 4) {
-            ret =
-                ((Math.round(Float.parseFloat(colors.get(3).trim()) * 255) & 0xff) << 24) |
-                ((Integer.parseInt(colors.get(0).trim()) & 0xff) << 16) |
-                ((Integer.parseInt(colors.get(1).trim()) & 0xff) << 8) |
-                (Integer.parseInt(colors.get(2).trim()) & 0xff);
-        }
-        return ret;
-    }
-
     private MediaSource getSubTitles(MediaSource mediaSource, List<Uri> subtitleUris, DataSource.Factory dataSourceFactory) {
         if (subtitleUris == null || subtitleUris.isEmpty()) {
             return mediaSource;
@@ -1564,6 +1655,7 @@ public class FullscreenExoPlayerFragment extends Fragment {
                                     };
                                     switch (state) {
                                         case CastPlayer.STATE_READY:
+                                            updateChaptersButtonVisibility();
                                             if (castPlayer.isPlaying()) {
                                                 NotificationCenter.defaultCenter().postNotification("playerItemPlay", info);
                                             } else {

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

@@ -0,0 +1,84 @@
+package com.capgo.videoplayer;
+
+import java.util.Arrays;
+import java.util.List;
+import org.json.JSONObject;
+
+final class SubtitleOptionOverrides {
+
+    private SubtitleOptionOverrides() {}
+
+    static boolean hasAny(JSONObject options) {
+        return options != null && options.length() > 0;
+    }
+
+    static boolean hasFontSize(JSONObject options) {
+        return hasFontSize(options != null && options.has("fontSize"), options != null ? options.optDouble("fontSize", 16) : 16);
+    }
+
+    static boolean hasFontSize(boolean hasFontSizeKey, double fontSizeValue) {
+        if (!hasFontSizeKey) {
+            return false;
+        }
+        return Math.round(fontSizeValue) > 0;
+    }
+
+    static boolean hasColor(JSONObject options) {
+        if (options == null) {
+            return false;
+        }
+        return hasColor(options.has("foregroundColor"), options.has("backgroundColor"));
+    }
+
+    static boolean hasColor(boolean hasForegroundColor, boolean hasBackgroundColor) {
+        return hasForegroundColor || hasBackgroundColor;
+    }
+
+    static boolean hasBackgroundColor(JSONObject options) {
+        return options != null && hasBackgroundColor(options.has("backgroundColor"));
+    }
+
+    static boolean hasBackgroundColor(boolean hasBackgroundColorKey) {
+        return hasBackgroundColorKey;
+    }
+
+    static boolean shouldUseFixedTextSize(JSONObject options, boolean hasSidecarUri) {
+        return hasFontSize(options) || hasSidecarUri;
+    }
+
+    static boolean shouldUseFixedTextSize(boolean hasFontSizeOverride, boolean hasSidecarUri) {
+        return hasFontSizeOverride || hasSidecarUri;
+    }
+
+    static Integer parseRgbaColor(String rgbaColor) {
+        if (rgbaColor == null || rgbaColor.length() < 5 || !rgbaColor.regionMatches(true, 0, "rgba", 0, 4)) {
+            return null;
+        }
+        int open = rgbaColor.indexOf('(');
+        int close = rgbaColor.indexOf(')');
+        if (open < 0 || close <= open) {
+            return null;
+        }
+        String inner = rgbaColor.substring(open + 1, close);
+        List<String> colors = Arrays.asList(inner.split(","));
+        if (colors.size() != 4) {
+            return null;
+        }
+        try {
+            int red = Integer.parseInt(colors.get(0).trim());
+            int green = Integer.parseInt(colors.get(1).trim());
+            int blue = Integer.parseInt(colors.get(2).trim());
+            float alpha = Float.parseFloat(colors.get(3).trim());
+            if (!Float.isFinite(alpha) || alpha < 0f || alpha > 1f) {
+                return null;
+            }
+            if (red < 0 || red > 255 || green < 0 || green > 255 || blue < 0 || blue > 255) {
+                return null;
+            }
+            int alphaInt = Math.round(alpha * 255f) & 0xff;
+            return (alphaInt << 24) | ((red & 0xff) << 16) | ((green & 0xff) << 8) | (blue & 0xff);
+        } catch (NumberFormatException exception) {
+            return null;
+        }
+    }
+}

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

@@ -0,0 +1,14 @@
+package com.capgo.videoplayer;
+
+public class VideoChapter {
+
+    public final String title;
+    public final double startTimeSeconds;
+    public final Double endTimeSeconds;
+
+    public VideoChapter(String title, double startTimeSeconds, Double endTimeSeconds) {
+        this.title = title != null ? title : "";
+        this.startTimeSeconds = startTimeSeconds;
+        this.endTimeSeconds = endTimeSeconds;
+    }
+}

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.ArrayList;
 import java.util.List;
 
 public class VideoPlayer {
@@ -24,6 +25,7 @@ public class VideoPlayer {
         Boolean showControls,
         String displayMode,
         List<VideoSubtitleTrack> subtitleTracks,
+        List<VideoChapter> chapters,
         JSObject subTitleOptions,
         JSObject headers,
         String title,
@@ -49,6 +51,7 @@ public class VideoPlayer {
         fsFragment.showControls = showControls;
         fsFragment.displayMode = displayMode;
         fsFragment.subtitleTracks = subtitleTracks;
+        fsFragment.chapters = chapters != null ? chapters : new ArrayList<>();
         fsFragment.subTitleOptions = subTitleOptions;
         fsFragment.headers = headers;
         fsFragment.title = title;

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

@@ -46,7 +46,7 @@ import org.json.JSONObject;
 )
 public class VideoPlayerPlugin extends Plugin {
 
-    private final String pluginVersion = "8.2.15";
+    private final String pluginVersion = "8.3.0";
 
     // Permission alias constants
     private static final String PERMISSION_DENIED_ERROR = "Unable to access media videos, user denied permission request";
@@ -90,6 +90,7 @@ public class VideoPlayerPlugin extends Plugin {
     private String subtitle = "";
     private String language = "";
     private List<VideoSubtitleTrack> subtitleTracks = new ArrayList<>();
+    private List<VideoChapter> chapters = new ArrayList<>();
     private JSObject subTitleOptions;
     private JSObject drmOptions;
     private final JSObject ret = new JSObject();
@@ -208,6 +209,7 @@ public class VideoPlayerPlugin extends Plugin {
                 language = call.getString("language");
             }
             subtitleTracks = parseSubtitleTracks(call);
+            chapters = parseChapters(call);
             subTitleOptions = new JSObject();
             if (call.getData().has("subtitleOptions")) {
                 subTitleOptions = call.getObject("subtitleOptions");
@@ -982,6 +984,7 @@ public class VideoPlayerPlugin extends Plugin {
                     showControls,
                     displayMode,
                     resolvedSubtitleTracks,
+                    chapters,
                     subTitleOptions,
                     headers,
                     title,
@@ -1144,7 +1147,8 @@ public class VideoPlayerPlugin extends Plugin {
                             showControls,
                             displayMode,
                             new ArrayList<>(),
-                            null,
+                            chapters,
+                            subTitleOptions,
                             headers,
                             title,
                             smallTitle,
@@ -1198,6 +1202,46 @@ public class VideoPlayerPlugin extends Plugin {
         return tracks;
     }
 
+    private List<VideoChapter> parseChapters(PluginCall call) {
+        List<VideoChapter> parsed = new ArrayList<>();
+        if (!call.getData().has("chapters")) {
+            return parsed;
+        }
+        JSArray chapterArray = call.getArray("chapters");
+        if (chapterArray == null) {
+            return parsed;
+        }
+        for (int i = 0; i < chapterArray.length(); i++) {
+            JSONObject entry = chapterArray.optJSONObject(i);
+            if (entry == null) {
+                Log.w(TAG, "Skipping malformed chapter entry at index " + i);
+                continue;
+            }
+            Object rawTitle = entry.opt("title");
+            if (!(rawTitle instanceof String)) {
+                continue;
+            }
+            String chapterTitle = (String) rawTitle;
+            if (chapterTitle.trim().isEmpty()) {
+                continue;
+            }
+            if (!entry.has("startTime")) {
+                continue;
+            }
+            double startTime = entry.optDouble("startTime", -1);
+            if (Double.isNaN(startTime) || Double.isInfinite(startTime) || startTime < 0) {
+                continue;
+            }
+            Double endTime = entry.has("endTime") ? entry.optDouble("endTime", -1) : null;
+            if (endTime != null && (Double.isNaN(endTime) || Double.isInfinite(endTime) || endTime <= startTime)) {
+                endTime = null;
+            }
+            parsed.add(new VideoChapter(chapterTitle.trim(), startTime, endTime));
+        }
+        parsed.sort((left, right) -> Double.compare(left.startTimeSeconds, right.startTimeSeconds));
+        return parsed;
+    }
+
     private List<VideoSubtitleTrack> resolveSubtitleTracks(List<VideoSubtitleTrack> tracks) {
         List<VideoSubtitleTrack> resolved = new ArrayList<>();
         if (tracks == null) {
@@ -1227,6 +1271,7 @@ public class VideoPlayerPlugin extends Plugin {
         Boolean showControls,
         String displayMode,
         List<VideoSubtitleTrack> subtitleTracks,
+        List<VideoChapter> chapters,
         JSObject subTitleOptions,
         JSObject headers,
         String title,
@@ -1253,6 +1298,7 @@ public class VideoPlayerPlugin extends Plugin {
             showControls,
             displayMode,
             subtitleTracks,
+            chapters,
             subTitleOptions,
             headers,
             title,

package/android/src/main/res/drawable/ic_chapters_white.xml

@@ -0,0 +1,10 @@
+<?xml version="1.0" encoding="utf-8"?>
+<vector xmlns:android="http://schemas.android.com/apk/res/android"
+    android:width="24dp"
+    android:height="24dp"
+    android:viewportWidth="24"
+    android:viewportHeight="24">
+    <path
+        android:fillColor="#FFFFFFFF"
+        android:pathData="M4,10.5c-0.83,0 -1.5,0.67 -1.5,1.5s0.67,1.5 1.5,1.5 1.5,-0.67 1.5,-1.5 -0.67,-1.5 -1.5,-1.5zM4,4.5c-0.83,0 -1.5,0.67 -1.5,1.5S3.17,7.5 4,7.5 5.5,6.83 5.5,6 4.83,4.5 4,4.5zM4,16.5c-0.83,0 -1.5,0.67 -1.5,1.5s0.67,1.5 1.5,1.5 1.5,-0.67 1.5,-1.5 -0.67,-1.5 -1.5,-1.5zM7,19h14v-2H7v2zM7,13h14v-2H7v2zM7,5v2h14V5H7z" />
+</vector>

package/android/src/main/res/layout/exo_playback_control_view.xml

@@ -115,6 +115,15 @@
           android:background="?actionBarItemBackground"
           android:visibility="gone"/>
 
+        <ImageButton
+          android:id="@+id/exo_chapters"
+          android:layout_width="48dp"
+          android:layout_height="48dp"
+          android:background="?actionBarItemBackground"
+          android:src="@drawable/ic_chapters_white"
+          android:visibility="gone"
+          android:contentDescription="@string/chapters_button"/>
+
         <ImageButton
           android:id="@+id/exo_pip"
           android:layout_width="48dp"

package/android/src/main/res/values/strings.xml

@@ -1,3 +1,5 @@
 <resources>
     <string name="my_string">Just a simple string</string>
+    <string name="chapters">Chapters</string>
+    <string name="chapters_button">Chapters button</string>
 </resources>