@capgo/capacitor-video-player 8.2.14 → 8.3.0

package/ios/Sources/VideoPlayerPlugin/VideoPlayerPlugin.swift

@@ -8,7 +8,7 @@ import AVKit
  */
 @objc(VideoPlayerPlugin)
 public class VideoPlayerPlugin: CAPPlugin, CAPBridgedPlugin {
-    private let pluginVersion: String = "8.2.14"
+    private let pluginVersion: String = "8.3.0"
     public let identifier = "VideoPlayerPlugin"
     public let jsName = "VideoPlayer"
     public let pluginMethods: [CAPPluginMethod] = [
@@ -76,6 +76,7 @@ extension VideoPlayerPlugin {
         let exitOnEnd = call.getBool("exitOnEnd") ?? true
         let loopOnEnd = call.getBool("loopOnEnd") ?? false
         let pipEnabled = call.getBool("pipEnabled") ?? true
+        let bkmodeEnabled = call.getBool("bkmodeEnabled") ?? true
         let showControls = call.getBool("showControls") ?? true
         let chromecast = call.getBool("chromecast") ?? true
         let title = call.getString("title")
@@ -84,6 +85,8 @@ extension VideoPlayerPlugin {
         let chromecastUrl = call.getString("chromecastUrl")
         let audioCategory = call.getString("audioCategory")
         let subtitleTracks = Self.parseSubtitleTracks(from: call)
+        let subtitleStyleOptions = Self.parseSubtitleStyleOptions(from: call)
+        let chapters = Self.parseChapters(from: call)
         let drmOptions = Self.parseDrmOptions(from: call)
 
         // Create video player
@@ -94,6 +97,7 @@ extension VideoPlayerPlugin {
             exitOnEnd: exitOnEnd,
             loopOnEnd: loopOnEnd,
             pipEnabled: pipEnabled,
+            bkmodeEnabled: bkmodeEnabled,
             showControls: showControls,
             chromecast: chromecast,
             chromecastUrl: chromecastUrl,
@@ -101,6 +105,8 @@ extension VideoPlayerPlugin {
             smallTitle: smallTitle,
             artwork: artwork,
             subtitleTracks: subtitleTracks,
+            subtitleStyleOptions: subtitleStyleOptions,
+            chapters: chapters,
             fairplayCertificateUrl: drmOptions.fairplayCertificateUrl,
             fairplayContentKeySpcUrl: drmOptions.fairplayContentKeySpcUrl,
             fairplayAssetId: drmOptions.fairplayAssetId,
@@ -137,6 +143,48 @@ extension VideoPlayerPlugin {
         }
     }
 
+    private static func parseSubtitleStyleOptions(from call: CAPPluginCall) -> SubtitleStyleOptions? {
+        guard let options = call.getObject("subtitleOptions") else {
+            return nil
+        }
+
+        let fontSize: Double?
+        if let number = options["fontSize"] as? NSNumber {
+            fontSize = number.doubleValue
+        } else {
+            fontSize = nil
+        }
+
+        return SubtitleStyleOptions(
+            foregroundColor: options["foregroundColor"] as? String,
+            backgroundColor: options["backgroundColor"] as? String,
+            fontSize: fontSize
+        )
+    }
+
+    private static func parseChapters(from call: CAPPluginCall) -> [VideoChapter] {
+        guard let entries = call.getArray("chapters") else {
+            return []
+        }
+        var parsed: [VideoChapter] = []
+        for (index, entry) in entries.enumerated() {
+            guard let jsObject = entry as? JSObject else {
+                print("VideoPlayerPlugin: skipping invalid chapter at index \(index)")
+                continue
+            }
+            var dictionary: [String: Any] = [:]
+            for (key, value) in jsObject {
+                dictionary[key] = value
+            }
+            if let chapter = VideoChapter(dictionary: dictionary) {
+                parsed.append(chapter)
+            } else {
+                print("VideoPlayerPlugin: skipping invalid chapter at index \(index)")
+            }
+        }
+        return parsed.sorted { $0.startTime < $1.startTime }
+    }
+
     private static func parseSubtitleTracks(from call: CAPPluginCall) -> [VideoSubtitleTrack] {
         let subtitlesArray = call.getArray("subtitles", JSObject.self)?.map { entry -> [String: Any] in
             var dict: [String: Any] = [:]

package/ios/Tests/VideoPlayerPluginTests/VideoChapterTests.swift

@@ -0,0 +1,30 @@
+import XCTest
+@testable import VideoPlayerPlugin
+
+class VideoChapterTests: XCTestCase {
+    func testRejectsBooleanStartTime() {
+        XCTAssertNil(VideoChapter(dictionary: [
+            "title": "Intro",
+            "startTime": NSNumber(value: true)
+        ]))
+        XCTAssertNil(VideoChapter(dictionary: [
+            "title": "Intro",
+            "startTime": NSNumber(value: false)
+        ]))
+    }
+
+    func testAcceptsNumericStartTime() {
+        let chapter = VideoChapter(dictionary: [
+            "title": "Intro",
+            "startTime": NSNumber(value: 12.5)
+        ])
+        XCTAssertEqual(chapter?.startTime, 12.5)
+    }
+
+    func testRejectsStartTimeAtOrAboveIntMaxDouble() {
+        XCTAssertNil(VideoChapter(dictionary: [
+            "title": "Edge",
+            "startTime": Double(Int.max)
+        ]))
+    }
+}

package/ios/Tests/VideoPlayerPluginTests/VideoPlayerAudioSessionCategoryPolicyTests.swift

@@ -0,0 +1,52 @@
+import XCTest
+@testable import VideoPlayerPlugin
+
+final class VideoPlayerAudioSessionCategoryPolicyTests: XCTestCase {
+    func testPerPlayerCategoryUsesExplicitCategoryWhenSet() {
+        let needs = VideoPlayerAudioSessionNeeds(
+            explicitCategory: "moviePlayback",
+            needsBackgroundOrPipPlayback: false
+        )
+        XCTAssertEqual(VideoPlayerAudioSessionCategoryPolicy.category(for: needs), "moviePlayback")
+    }
+
+    func testPerPlayerCategoryUsesPlaybackForBackgroundOrPip() {
+        let needs = VideoPlayerAudioSessionNeeds(
+            explicitCategory: nil,
+            needsBackgroundOrPipPlayback: true
+        )
+        XCTAssertEqual(VideoPlayerAudioSessionCategoryPolicy.category(for: needs), "playback")
+    }
+
+    func testUnionCategoryStaysAmbientWhenNoPlayerNeedsPlayback() {
+        let ambient = VideoPlayerAudioSessionNeeds(
+            explicitCategory: nil,
+            needsBackgroundOrPipPlayback: false
+        )
+        XCTAssertEqual(VideoPlayerAudioSessionCategoryPolicy.unionCategory(for: [ambient, ambient]), "ambient")
+    }
+
+    func testUnionCategoryUpgradesToPlaybackWhenAnyPlayerNeedsBackgroundOrPip() {
+        let ambient = VideoPlayerAudioSessionNeeds(
+            explicitCategory: nil,
+            needsBackgroundOrPipPlayback: false
+        )
+        let pip = VideoPlayerAudioSessionNeeds(
+            explicitCategory: nil,
+            needsBackgroundOrPipPlayback: true
+        )
+        XCTAssertEqual(VideoPlayerAudioSessionCategoryPolicy.unionCategory(for: [ambient, pip]), "playback")
+    }
+
+    func testUnionCategoryPrefersMoviePlaybackOverPlayback() {
+        let movie = VideoPlayerAudioSessionNeeds(
+            explicitCategory: "moviePlayback",
+            needsBackgroundOrPipPlayback: false
+        )
+        let pip = VideoPlayerAudioSessionNeeds(
+            explicitCategory: nil,
+            needsBackgroundOrPipPlayback: true
+        )
+        XCTAssertEqual(VideoPlayerAudioSessionCategoryPolicy.unionCategory(for: [movie, pip]), "moviePlayback")
+    }
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@capgo/capacitor-video-player",
-  "version": "8.2.14",
+  "version": "8.3.0",
   "description": "Capacitor plugin to play video in native player",
   "main": "dist/plugin.cjs.js",
   "module": "dist/esm/index.js",
@@ -53,7 +53,8 @@
     "check:cap9-deprecated": "node scripts/check-cap9-deprecated.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",
-    "changelog:ai": "node scripts/generate-ai-changelog.mjs"
+    "changelog:ai": "node scripts/generate-ai-changelog.mjs",
+    "screenshots:pr-108": "node docs/pr-108-screenshots/capture.mjs"
   },
   "devDependencies": {
     "@capacitor/android": "^8.0.0",
@@ -69,13 +70,14 @@
     "eslint": "^10.0.0",
     "eslint-plugin-import": "^2.31.0",
     "hls.js": "^1.5.18",
+    "playwright": "1.49.1",
     "prettier": "^3.6.2",
     "prettier-plugin-java": "^2.7.7",
+    "prettier-pretty-check": "^0.2.0",
     "rimraf": "^6.1.0",
     "rollup": "^4.53.2",
     "swiftlint": "^2.0.0",
-    "typescript": "^6.0.3",
-    "prettier-pretty-check": "^0.2.0"
+    "typescript": "^6.0.3"
   },
   "peerDependencies": {
     "@capacitor/core": ">=8.0.0",