npm - unified-video-framework - Versions diffs - 1.4.77 → 1.4.79 - Mend

unified-video-framework 1.4.77 → 1.4.79

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (23) hide show

package/package.json CHANGED Viewed

@@ -1,6 +1,6 @@
 {
   "name": "unified-video-framework",
-  "version": "1.4.77",
+  "version": "1.4.79",
   "description": "Cross-platform video player framework supporting iOS, Android, Web, Smart TVs (Samsung/LG), Roku, and more",
   "main": "packages/core/dist/index.js",
   "types": "packages/core/dist/index.d.ts",

package/packages/ios/README.md ADDED Viewed

@@ -0,0 +1,84 @@
+# UnifiedVideoPlayer (iOS SDK)
+A unified iOS video player SDK with:
+- HLS playback (AVPlayer)
+- FairPlay DRM (SPC/CKC)
+- Subtitles/audio track selection (AVMediaSelection)
+- Picture-in-Picture (AVPictureInPictureController)
+- AirPlay (AVRoutePickerView)
+- Remote Command Center + Now Playing (lock screen controls)
+- Background audio (AVAudioSession)
+## Installation
+### CocoaPods
+1) Ensure this SDK is in a public Git repository. Update the podspec `s.source` to point at that repo and tag.
+2) In your Podfile:
+```ruby
+platform :ios, '13.0'
+use_frameworks!
+target 'YourApp' do
+  pod 'UnifiedVideoPlayer', :git => 'https://github.com/yourcompany/unified-video-ios.git', :tag => '1.0.0'
+end
+```
+3) Run:
+```bash
+pod install
+```
+### Swift Package Manager
+Add the package at the repository URL or use Add Local Package pointing to `packages/ios`.
+## Quick Start
+```swift
+import UnifiedVideoPlayer
+let containerView = UIView(frame: .zero)
+let player = UnifiedVideoPlayer()
+let config = PlayerConfiguration()
+config.autoPlay = true
+player.initialize(container: containerView, configuration: config)
+let source = MediaSource(url: "https://example.com/stream.m3u8")
+source.metadata = ["title": "Demo Stream"]
+player.onReady = { print("ready") }
+player.onQualityChange = { br in print("bitrate: \(br)") }
+player.load(source: source)
+```
+### FairPlay DRM
+```swift
+let drm = DRMConfiguration(type: "fairplay", licenseUrl: "https://license.example.com/fps")
+drm.certificateUrl = "https://license.example.com/cert"
+drm.headers = ["X-Tenant-ID": "default"]
+let source = MediaSource(url: "https://cdn.example.com/protected/playlist.m3u8")
+source.drm = drm
+player.load(source: source)
+```
+### Tracks
+```swift
+let audios = player.audioTracks()      // [String]
+let subs = player.subtitleTracks()     // [String]
+player.selectAudioTrack(index: 0)
+player.selectSubtitleTrack(index: -1)  // off
+```
+### PiP & AirPlay
+```swift
+player.startPictureInPicture()
+player.stopPictureInPicture()
+let airPlay = player.makeAirPlayPickerView()
+```
+## Capabilities
+- Enable Background Modes > Audio
+- For DRM endpoints, configure ATS exceptions if necessary.
+## License
+MIT

package/packages/web/dist/WebPlayer.d.ts CHANGED Viewed

@@ -77,6 +77,8 @@ export declare class WebPlayer extends BasePlayer {
     exitFullscreen(): Promise<void>;
     enterPictureInPicture(): Promise<void>;
     exitPictureInPicture(): Promise<void>;
+    focusPlayer(): void;
+    attemptFullscreen(): Promise<boolean>;
     protected applySubtitleTrack(track: any): void;
     protected removeSubtitles(): void;
     private injectStyles;

package/packages/web/dist/WebPlayer.d.ts.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"WebPlayer.d.ts","sourceRoot":"","sources":["../src/WebPlayer.ts"],"names":[],"mappings":"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~~IA4BhC~~,cAAc,IAAI,OAAO,CAAC,IAAI,CAAC;~~IAuB~~/B,qBAAqB,IAAI,OAAO,CAAC,IAAI,CAAC;IAetC,oBAAoB,IAAI,OAAO,CAAC,IAAI,CAAC;~~IAW3C~~,SAAS,CAAC,kBAAkB,CAAC,KAAK,EAAE,GAAG,GAAG,IAAI;IAc9C,SAAS,CAAC,eAAe,IAAI,IAAI;IASjC,OAAO,CAAC,YAAY;IASpB,OAAO,CAAC,eAAe;~~IAm6CvB~~,OAAO,CAAC,oBAAoB;IA2O5B,OAAO,CAAC,2BAA2B;~~IA+RnC~~,SAAS,CAAC,sBAAsB,IAAI,IAAI;~~IAsIxC~~,SAAS,CAAC,cAAc,IAAI,IAAI;IAiDzB,gBAAgB,CAAC,MAAM,EAAE,GAAG;IA2CnC,OAAO,CAAC,eAAe;IAsBvB,OAAO,CAAC,sBAAsB;IAsDvB,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAetC,oBAAoB,IAAI,IAAI;IAO5B,kBAAkB,IAAI,IAAI;IAOjC,OAAO,CAAC,gBAAgB;IAYxB,OAAO,CAAC,kBAAkB;IAyB1B,OAAO,CAAC,oBAAoB;IAW5B,OAAO,CAAC,UAAU;IAclB,OAAO,CAAC,iBAAiB;IAUzB,OAAO,CAAC,YAAY;IASpB,OAAO,CAAC,YAAY;IAUpB,OAAO,CAAC,oBAAoB;IAa5B,OAAO,CAAC,YAAY;IAOpB,OAAO,CAAC,wBAAwB;IAuEhC,OAAO,CAAC,iBAAiB;IAczB,OAAO,CAAC,eAAe;IAQvB,OAAO,CAAC,qBAAqB;IA8FtB,yBAAyB,CAAC,IAAI,EAAE,SAAS,GAAG,SAAS,GAAG,SAAS,GAAG,IAAI;IAiBxE,0BAA0B,CAAC,OAAO,EAAE;QAAE,OAAO,CAAC,EAAE,MAAM,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI;IAwB1F,OAAO,CAAC,oCAAoC;IAqBrC,QAAQ,CAAC,KAAK,EAAE,GAAG,GAAG,IAAI;IA2DjC,OAAO,CAAC,SAAS;IA8BjB,OAAO,CAAC,YAAY;IAKpB,OAAO,CAAC,WAAW;IAUnB,OAAO,CAAC,OAAO;IAOf,OAAO,CAAC,YAAY;IAmBpB,OAAO,CAAC,QAAQ;IAahB,OAAO,CAAC,iBAAiB;YAgCX,SAAS;IAYvB,OAAO,CAAC,oBAAoB;IAS5B,OAAO,CAAC,gBAAgB;IA6BxB,OAAO,CAAC,uBAAuB;IAoB/B,OAAO,CAAC,wBAAwB;IAKhC,OAAO,CAAC,uBAAuB;IA6D/B,OAAO,CAAC,wBAAwB;IAoBhC,OAAO,CAAC,iBAAiB;IAezB,OAAO,CAAC,gBAAgB;IA6BxB,OAAO,CAAC,uBAAuB;IAqB/B,OAAO,CAAC,iBAAiB;IAazB,OAAO,CAAC,WAAW;YAoBL,QAAQ;YAqGR,UAAU;IAqBxB,OAAO,CAAC,gBAAgB;IA2CxB,OAAO,CAAC,gBAAgB;IAQxB,OAAO,CAAC,YAAY;IA6BpB,OAAO,CAAC,sBAAsB;IA6B9B,OAAO,CAAC,sBAAsB;IAiF9B,OAAO,CAAC,uBAAuB;IAuB/B,OAAO,CAAC,4BAA4B;IAoDpC,OAAO,CAAC,oBAAoB;IA+BrB,aAAa,IAAI,IAAI;IAarB,aAAa,IAAI,IAAI;IAYrB,UAAU,CAAC,OAAO,EAAE,GAAG,GAAG,IAAI;IAe9B,kBAAkB,IAAI,OAAO;YAKtB,OAAO;IAgBf,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;CAyC/B"}
1	+ {"version":3,"file":"WebPlayer.d.ts","sourceRoot":"","sources":["../src/WebPlayer.ts"],"names":[],"mappings":"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"}

package/packages/web/dist/WebPlayer.js CHANGED Viewed

@@ -646,43 +646,80 @@ export class WebPlayer extends BasePlayer {
         if (!this.playerWrapper)
             return;
         try {
+            if (!document.fullscreenEnabled &&
+                !document.webkitFullscreenEnabled &&
+                !document.mozFullScreenEnabled &&
+                !document.msFullscreenEnabled) {
+                this.debugWarn('Fullscreen not supported by browser');
+                return;
+            }
+            if (document.fullscreenElement ||
+                document.webkitFullscreenElement ||
+                document.mozFullScreenElement ||
+                document.msFullscreenElement) {
+                this.debugLog('Already in fullscreen mode');
+                return;
+            }
             const element = this.playerWrapper;
             if (element.requestFullscreen) {
-                await element.requestFullscreen();
+                await element.requestFullscreen().catch(err => {
+                    this.debugWarn('Fullscreen request failed:', err.message);
+                });
             }
             else if (element.webkitRequestFullscreen) {
-                await element.webkitRequestFullscreen();
+                await element.webkitRequestFullscreen().catch((err) => {
+                    this.debugWarn('WebKit fullscreen request failed:', err.message);
+                });
             }
             else if (element.mozRequestFullScreen) {
-                await element.mozRequestFullScreen();
+                await element.mozRequestFullScreen().catch((err) => {
+                    this.debugWarn('Mozilla fullscreen request failed:', err.message);
+                });
             }
             else if (element.msRequestFullscreen) {
-                await element.msRequestFullscreen();
+                await element.msRequestFullscreen().catch((err) => {
+                    this.debugWarn('MS fullscreen request failed:', err.message);
+                });
             }
             else {
-                throw new Error('Fullscreen API not supported');
+                this.debugWarn('Fullscreen API not supported by this browser');
+                return;
             }
             this.playerWrapper.classList.add('uvf-fullscreen');
             this.emit('onFullscreenChanged', true);
         }
         catch (error) {
-            console.error('Failed to enter fullscreen:', error);
-            throw error;
+            this.debugWarn('Failed to enter fullscreen:', error.message);
         }
     }
     async exitFullscreen() {
         try {
+            if (!document.fullscreenElement &&
+                !document.webkitFullscreenElement &&
+                !document.mozFullScreenElement &&
+                !document.msFullscreenElement) {
+                this.debugLog('Not in fullscreen mode');
+                return;
+            }
             if (document.exitFullscreen) {
-                await document.exitFullscreen();
+                await document.exitFullscreen().catch(err => {
+                    this.debugWarn('Exit fullscreen failed:', err.message);
+                });
             }
             else if (document.webkitExitFullscreen) {
-                await document.webkitExitFullscreen();
+                await document.webkitExitFullscreen().catch((err) => {
+                    this.debugWarn('WebKit exit fullscreen failed:', err.message);
+                });
             }
             else if (document.mozCancelFullScreen) {
-                await document.mozCancelFullScreen();
+                await document.mozCancelFullScreen().catch((err) => {
+                    this.debugWarn('Mozilla exit fullscreen failed:', err.message);
+                });
             }
             else if (document.msExitFullscreen) {
-                await document.msExitFullscreen();
+                await document.msExitFullscreen().catch((err) => {
+                    this.debugWarn('MS exit fullscreen failed:', err.message);
+                });
             }
             if (this.playerWrapper) {
                 this.playerWrapper.classList.remove('uvf-fullscreen');
@@ -690,8 +727,7 @@ export class WebPlayer extends BasePlayer {
             this.emit('onFullscreenChanged', false);
         }
         catch (error) {
-            console.error('Failed to exit fullscreen:', error);
-            throw error;
+            this.debugWarn('Failed to exit fullscreen:', error.message);
         }
     }
     async enterPictureInPicture() {
@@ -717,8 +753,32 @@ export class WebPlayer extends BasePlayer {
             }
         }
         catch (error) {
-            console.error('Failed to exit PiP:', error);
-            throw error;
+            this.debugWarn('Failed to exit PiP:', error.message);
+        }
+    }
+    focusPlayer() {
+        if (this.playerWrapper) {
+            this.playerWrapper.focus();
+            this.debugLog('Player focused programmatically');
+        }
+    }
+    async attemptFullscreen() {
+        try {
+            await this.enterFullscreen();
+            return true;
+        }
+        catch (error) {
+            const errorMessage = error.message;
+            if (errorMessage.includes('user gesture') || errorMessage.includes('user activation')) {
+                this.showShortcutIndicator('Click the fullscreen button');
+                this.debugWarn('Fullscreen requires user interaction. Please click the fullscreen button or press F while the video area is focused.');
+                this.focusPlayer();
+                return false;
+            }
+            else {
+                this.debugWarn('Fullscreen failed:', errorMessage);
+                return false;
+            }
         }
     }
     applySubtitleTrack(track) {
@@ -779,6 +839,21 @@ export class WebPlayer extends BasePlayer {
         --uvf-firefox-scrollbar-color: rgba(255,255,255,0.25);
       }
+      /* Player focus styles for better UX */
+      .uvf-player-wrapper:focus {
+        outline: 2px solid var(--uvf-accent-1);
+        outline-offset: -2px;
+      }
+      .uvf-player-wrapper:focus-visible {
+        outline: 2px solid var(--uvf-accent-1);
+        outline-offset: -2px;
+      }
+      .uvf-player-wrapper:focus:not(:focus-visible) {
+        outline: none;
+      }
       /* Responsive Container Styles */
       .uvf-responsive-container {
         width: 100%;
@@ -2533,10 +2608,14 @@ export class WebPlayer extends BasePlayer {
         });
         fullscreenBtn?.addEventListener('click', () => {
             if (this.isFullscreen()) {
-                this.exitFullscreen();
+                this.exitFullscreen().catch(err => {
+                    this.debugWarn('Exit fullscreen button failed:', err.message);
+                });
             }
             else {
-                this.enterFullscreen();
+                this.enterFullscreen().catch(err => {
+                    this.debugWarn('Fullscreen button failed:', err.message);
+                });
             }
         });
         const updateFullscreenIcon = () => {
@@ -2675,12 +2754,37 @@ export class WebPlayer extends BasePlayer {
                     break;
                 case 'f':
                     e.preventDefault();
+                    const isLikelyUserGesture = e.isTrusted &&
+                        (e.target === document.body ||
+                            e.target === this.playerWrapper ||
+                            e.target === this.video);
                     if (!document.fullscreenElement) {
-                        this.enterFullscreen();
+                        if (isLikelyUserGesture || target.tagName !== 'BUTTON') {
+                            this.attemptFullscreen().then(success => {
+                                if (success) {
+                                    this.showShortcutIndicator('Fullscreen');
+                                }
+                            });
+                        }
+                        else {
+                            const fullscreenBtn = document.getElementById('uvf-fullscreen-btn');
+                            if (fullscreenBtn) {
+                                this.debugLog('Triggering fullscreen button click instead of direct API call');
+                                fullscreenBtn.click();
+                                return;
+                            }
+                            else {
+                                this.debugWarn('Fullscreen keyboard shortcut not available from button elements. Click the fullscreen button instead.');
+                                this.showShortcutIndicator('Click Fullscreen Button');
+                                return;
+                            }
+                        }
                         shortcutText = 'Fullscreen';
                     }
                     else {
-                        this.exitFullscreen();
+                        this.exitFullscreen().catch(err => {
+                            this.debugWarn('Exit fullscreen shortcut failed:', err.message);
+                        });
                         shortcutText = 'Exit Fullscreen';
                     }
                     break;
@@ -2722,6 +2826,15 @@ export class WebPlayer extends BasePlayer {
         if (this.playerWrapper) {
             this.playerWrapper.addEventListener('keydown', handleKeydown);
             this.playerWrapper.setAttribute('tabindex', '0');
+            this.playerWrapper.addEventListener('focus', () => {
+                this.debugLog('Player focused - keyboard shortcuts available');
+            });
+            this.playerWrapper.addEventListener('click', (e) => {
+                const target = e.target;
+                if (!target.closest('.uvf-controls')) {
+                    this.playerWrapper?.focus();
+                }
+            });
         }
         if (this.video) {
             this.video.addEventListener('keydown', handleKeydown);