@capgo/capacitor-video-player 8.2.2 → 8.2.3

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.2";
+    private final String pluginVersion = "8.2.3";
 
     // Permission alias constants
     private static final String PERMISSION_DENIED_ERROR = "Unable to access media videos, user denied permission request";

package/ios/Sources/VideoPlayerPlugin/FullscreenVideoPlayer.swift

@@ -81,7 +81,7 @@ class FullscreenVideoPlayer: NSObject {
     }
 
     func setupPlayer(completion: @escaping () -> Void) {
-        guard let url = URL(string: videoUrl) else {
+        guard let url = Self.resolveMediaURL(videoUrl) else {
             completion()
             return
         }
@@ -100,8 +100,9 @@ class FullscreenVideoPlayer: NSObject {
             return
         }
 
-        // Prefer the resource-loader path for any video with sidecar subtitles.
-        // That exposes selectable tracks in AVPlayerViewController (composition does not).
+        // Prefer the resource-loader path when makeAsset can safely wrap the stream
+        // (HLS / remote progressive). Local progressive file:// sources return a nil
+        // loader and must use composition so playback still starts (#78).
         let assetResult = HLSVideoAssetFactory.makeAsset(
             videoURL: url,
             subtitleTracks: subtitleTracks
@@ -127,6 +128,17 @@ class FullscreenVideoPlayer: NSObject {
         }
     }
 
+    private static func resolveMediaURL(_ raw: String) -> URL? {
+        guard !raw.isEmpty else { return nil }
+        if let parsed = URL(string: raw), parsed.scheme != nil {
+            return parsed
+        }
+        if raw.hasPrefix("/") {
+            return URL(fileURLWithPath: raw)
+        }
+        return URL(string: raw)
+    }
+
     private func makeVideoAsset(url: URL, subtitleTracks: [VideoSubtitleTrack]) -> AVURLAsset {
         let result = HLSVideoAssetFactory.makeAsset(
             videoURL: url,

package/ios/Sources/VideoPlayerPlugin/HLSSubtitleResourceLoader.swift

@@ -32,6 +32,14 @@ enum HLSVideoAssetFactory {
             return (AVURLAsset(url: videoURL), nil)
         }
 
+        // Local progressive files cannot be wrapped in synthetic HLS playlists:
+        // AVPlayer will not fetch file:// media/subtitle segments from a custom-scheme
+        // master playlist, so playback never becomes ready (#78). Fall back to the
+        // composition path in FullscreenVideoPlayer instead.
+        if videoURL.isFileURL && !isHLSStream(videoURL) {
+            return (AVURLAsset(url: videoURL), nil)
+        }
+
         let resourceLoader = HLSSubtitleResourceLoader(
             videoURL: videoURL,
             subtitleTracks: resolvedTracks.map { HLSSubtitleTrack(url: $0.url, language: $0.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.2.2"
+    private let pluginVersion: String = "8.2.3"
     public let identifier = "VideoPlayerPlugin"
     public let jsName = "VideoPlayer"
     public let pluginMethods: [CAPPluginMethod] = [

package/ios/Sources/VideoPlayerPlugin/VideoSubtitleTrack.swift

@@ -6,6 +6,13 @@ struct VideoSubtitleTrack {
 
     var resolvedURL: URL? {
         guard !url.isEmpty else { return nil }
+        if let parsed = URL(string: url), parsed.scheme != nil {
+            return parsed
+        }
+        // Capacitor filesystem paths sometimes arrive without a file:// scheme.
+        if url.hasPrefix("/") {
+            return URL(fileURLWithPath: url)
+        }
         return URL(string: url)
     }
 }

package/ios/Tests/VideoPlayerPluginTests/HLSSubtitlePlaylistTests.swift

@@ -62,4 +62,30 @@ final class HLSSubtitlePlaylistTests: XCTestCase {
         XCTAssertNil(result.resourceLoader)
         XCTAssertEqual(result.asset.url, videoURL)
     }
+
+    func testMakeAssetSkipsResourceLoaderForLocalProgressiveSubtitles() {
+        let videoURL = URL(fileURLWithPath: "/var/mobile/Containers/Data/Application/video.mp4")
+        let tracks = [
+            VideoSubtitleTrack(url: "file:///var/mobile/Containers/Data/Application/subtitles-en.vtt", language: "en"),
+            VideoSubtitleTrack(url: "file:///var/mobile/Containers/Data/Application/subtitles-fr.vtt", language: "fr")
+        ]
+
+        let result = HLSVideoAssetFactory.makeAsset(videoURL: videoURL, subtitleTracks: tracks)
+
+        XCTAssertNil(result.resourceLoader)
+        XCTAssertEqual(result.asset.url, videoURL)
+        XCTAssertEqual(result.asset.url.scheme, "file")
+    }
+
+    func testMakeAssetUsesResourceLoaderForLocalHLSSubtitles() {
+        let videoURL = URL(fileURLWithPath: "/var/mobile/Containers/Data/Application/stream.m3u8")
+        let tracks = [
+            VideoSubtitleTrack(url: "file:///var/mobile/Containers/Data/Application/subtitles-en.vtt", language: "en")
+        ]
+
+        let result = HLSVideoAssetFactory.makeAsset(videoURL: videoURL, subtitleTracks: tracks)
+
+        XCTAssertNotNil(result.resourceLoader)
+        XCTAssertEqual(result.asset.url.scheme, HLSSubtitleResourceLoader.videoScheme)
+    }
 }

package/ios/Tests/VideoPlayerPluginTests/VideoPlayerPluginTests.swift

@@ -24,4 +24,10 @@ class VideoPlayerTests: XCTestCase {
         XCTAssertEqual(tracks[0].language, "en")
         XCTAssertEqual(tracks[1].language, "fr")
     }
+
+    func testSubtitleTrackResolvesBareFilePath() {
+        let track = VideoSubtitleTrack(url: "/var/mobile/Containers/Data/Application/subtitles-en.vtt", language: "en")
+        XCTAssertEqual(track.resolvedURL?.isFileURL, true)
+        XCTAssertEqual(track.resolvedURL?.path, "/var/mobile/Containers/Data/Application/subtitles-en.vtt")
+    }
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@capgo/capacitor-video-player",
-  "version": "8.2.2",
+  "version": "8.2.3",
   "description": "Capacitor plugin to play video in native player",
   "main": "dist/plugin.cjs.js",
   "module": "dist/esm/index.js",