feat: implement phase2 player isolation and media config

README.md

@@ -63,6 +63,7 @@ A feature-rich, modern video player library built with React, TypeScript, and Vi
 - `P` - Picture-in-Picture
 - `0-9` - Jump to percentage (10%-90%)
 - `Home` / `End` - Jump to start/end
+- Shortcuts only work for the currently active/focused player instance
 
 ### 📱 Touch Gestures
 - **Tap** - Play/Pause
@@ -165,6 +166,15 @@ function App() {
 />
 ```
 
+### Force Protocol (Override Auto Detection)
+
+```tsx
+<VideoPlayer
+  src="https://cdn.example.com/video"
+  protocol="hls"
+/>
+```
+
 ### IPTV Streaming
 
 ```tsx
@@ -310,12 +320,17 @@ video-player/
 |------|------|---------|-------------|
 | `src` | `string` | **required** | Video source URL (MP4, WebM, HLS, IPTV .ts) |
 | `poster` | `string` | - | Poster image URL |
+| `protocol` | `'auto' \| 'native' \| 'hls' \| 'rtmp' \| 'dash' \| 'mpegts'` | `'auto'` | Force playback engine instead of URL auto-detection |
 | `autoplay` | `boolean` | `false` | Auto-play video on load |
 | `loop` | `boolean` | `false` | Loop video playback |
 | `muted` | `boolean` | `false` | Start muted |
 | `volume` | `number` | - | Initial volume (0-1) |
 | `playbackRate` | `number` | - | Playback speed (0.25, 0.5, 1, 1.5, 2, etc.) |
 | `currentTime` | `number` | - | Initial playback position in seconds |
+| `crossOrigin` | `'' \| 'anonymous' \| 'use-credentials'` | - | Sets the video `crossOrigin` attribute |
+| `preload` | `'none' \| 'metadata' \| 'auto'` | `'metadata'` | Sets the video preload strategy |
+| `playsInline` | `boolean` | `true` | Enables inline playback on mobile browsers |
+| `controlsList` | `string` | - | Passes `controlsList` attribute to the video element |
 | `controls` | `boolean` | `true` | Show player controls |
 | `subtitles` | `SubtitleTrack[]` | `[]` | Subtitle tracks |
 | `theme` | `PlayerTheme` | - | Custom theme colors |