react-native-unified-player 0.2.0

package/LICENSE

@@ -0,0 +1,20 @@
+MIT License
+
+Copyright (c) 2025 Yaşar Özyurt
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,95 @@
+# react-native-unified-player
+
+Unified Player with VLC integration for enhanced codec and streaming protocol support.
+
+## Installation
+
+```sh
+npm install react-native-unified-player
+```
+
+### iOS Setup for VLC
+
+The iOS version of this player uses MobileVLCKit for advanced video playback capabilities. It supports a wide range of formats including RTSP, RTMP, HLS, and other protocols supported by VLC.
+
+The VLC dependencies are automatically installed via CocoaPods through the podspec file. After installing the package:
+
+1. Navigate to the iOS folder of your project:
+   ```sh
+   cd ios
+   ```
+
+2. Install pods:
+   ```sh
+   pod install
+   ```
+
+3. VLC requires "Bitcode" to be disabled in your Xcode project. This is handled automatically in the podspec file, but if you experience issues, check that your project's Build Settings have "Enable Bitcode" set to "No".
+
+4. Starting from iOS 14, you need to provide a message for the `NSLocalNetworkUsageDescription` key in your `Info.plist` if you're using external streaming sources. Add something like:
+   ```xml
+   <key>NSLocalNetworkUsageDescription</key>
+   <string>This app requires access to the local network to stream media content</string>
+   ```
+
+### Troubleshooting VLC Integration
+
+If you encounter build issues with VLC:
+
+1. **Compilation Errors**: If you see errors about missing properties or methods, it might be because the VLC API has changed. This package uses MobileVLCKit 3.3.17, which is compatible with the current implementation.
+
+2. **Playback Issues on iOS 14+**: VLC has known issues with certain RTSP streams on iOS 14. If you experience a black screen or playback failures specifically on newer iOS devices, try the following:
+   - Add additional media options in your code:
+     ```js
+     // Example: Adding network caching for better buffering
+     <UnifiedPlayerView 
+       videoUrl="rtsp://example.com/stream"
+       mediaOptions={["--network-caching=1500", "--live-caching=1500"]}
+     />
+     ```
+
+3. **Link Required Frameworks**: Make sure you have all required frameworks linked in your Xcode project:
+   - AudioToolbox.framework
+   - AVFoundation.framework
+   - CoreMedia.framework
+   - CoreVideo.framework
+   - libc++.tbd
+   - libiconv.tbd
+   - libz.tbd
+
+## Usage
+
+```js
+import { UnifiedPlayerView } from "react-native-unified-player";
+
+// ...
+
+<UnifiedPlayerView 
+  videoUrl="https://example.com/video.mp4" 
+  autoplay={true}
+  loop={false}
+  authToken="optional-auth-token"
+/>
+```
+
+### Supported Formats
+
+With VLC integration, the player supports a wide range of formats:
+
+- Network streams: RTSP, RTP, RTMP, HLS, MMS
+- Container formats: MP4, MKV, AVI, FLV, MOV, TS, and many more
+- Codec support: H.264, H.265, VP8, VP9, and many others
+- Audio: Multiple audio tracks support including 5.1
+- Subtitles: Support for various subtitle formats including SSA
+
+## Contributing
+
+See the [contributing guide](CONTRIBUTING.md) to learn how to contribute to the repository and the development workflow.
+
+## License
+
+MIT
+
+---
+
+Made with [create-react-native-library](https://github.com/callstack/react-native-builder-bob)

package/UnifiedPlayer.podspec

@@ -0,0 +1,32 @@
+require "json"
+
+package = JSON.parse(File.read(File.join(__dir__, "package.json")))
+
+Pod::Spec.new do |s|
+  s.name         = "UnifiedPlayer"
+  s.version      = package["version"]
+  s.summary      = package["description"]
+  s.homepage     = package["homepage"]
+  s.license      = package["license"]
+  s.authors      = package["author"]
+
+  s.platforms    = { :ios => min_ios_version_supported }
+  s.source       = { :git => "https://github.com/blueromans/react-native-unified-player.git", :tag => "#{s.version}" }
+
+  s.source_files = "ios/**/*.{h,m,mm}"
+
+# Use install_modules_dependencies helper to install the dependencies if React Native version >=0.71.0.
+# See https://github.com/facebook/react-native/blob/febf6b7f33fdb4904669f99d795eba4c0f95d7bf/scripts/cocoapods/new_architecture.rb#L79.
+if respond_to?(:install_modules_dependencies, true)
+  install_modules_dependencies(s)
+else
+  s.dependency "React-Core"
+end
+
+  # Add MobileVLCKit dependency with exact version to avoid compatibility issues
+  s.dependency "MobileVLCKit", "3.3.17"
+  
+  # Disable bitcode to match VLC requirements
+  s.pod_target_xcconfig = { "ENABLE_BITCODE" => "NO" }
+  s.user_target_xcconfig = { "ENABLE_BITCODE" => "NO" }
+end

package/android/build.gradle

@@ -0,0 +1,81 @@
+buildscript {
+  ext.getExtOrDefault = {name ->
+    return rootProject.ext.has(name) ? rootProject.ext.get(name) : project.properties['UnifiedPlayer_' + name]
+  }
+
+  repositories {
+    google()
+    mavenCentral()
+  }
+
+  dependencies {
+    classpath "com.android.tools.build:gradle:7.3.1"
+    // noinspection DifferentKotlinGradleVersion
+    classpath "org.jetbrains.kotlin:kotlin-gradle-plugin:1.8.0"
+  }
+}
+
+apply plugin: "com.android.library"
+apply plugin: "kotlin-android"
+
+def getExtOrIntegerDefault(name) {
+  return rootProject.ext.has(name) ? rootProject.ext.get(name) : (project.properties["UnifiedPlayer_" + name]).toInteger()
+}
+
+def supportsNamespace() {
+  def parsed = com.android.Version.ANDROID_GRADLE_PLUGIN_VERSION.tokenize('.')
+  def major = parsed[0].toInteger()
+  def minor = parsed[1].toInteger()
+
+  // Namespace support was added in 7.3.0
+  return (major == 7 && minor >= 3) || major >= 8
+}
+
+android {
+  if (supportsNamespace()) {
+    namespace "com.unifiedplayer"
+
+    sourceSets {
+      main {
+        manifest.srcFile "src/main/AndroidManifestNew.xml"
+      }
+    }
+  }
+
+  compileSdkVersion getExtOrIntegerDefault("compileSdkVersion")
+
+  defaultConfig {
+    minSdkVersion getExtOrIntegerDefault("minSdkVersion")
+    targetSdkVersion getExtOrIntegerDefault("targetSdkVersion")
+  }
+
+  buildTypes {
+    release {
+      minifyEnabled false
+    }
+  }
+
+  lintOptions {
+    disable "GradleCompatible"
+  }
+
+  compileOptions {
+    sourceCompatibility JavaVersion.VERSION_1_8
+    targetCompatibility JavaVersion.VERSION_1_8
+  }
+}
+
+repositories {
+  mavenCentral()
+  google()
+}
+
+def kotlin_version = getExtOrDefault("kotlinVersion")
+
+dependencies {
+  implementation "com.facebook.react:react-android"
+  implementation "org.jetbrains.kotlin:kotlin-stdlib:$kotlin_version"
+
+  implementation "com.google.android.exoplayer:exoplayer-core:2.18.1"
+  implementation "com.google.android.exoplayer:exoplayer-ui:2.18.1"
+}

package/android/gradle.properties

@@ -0,0 +1,5 @@
+UnifiedPlayer_kotlinVersion=2.0.21
+UnifiedPlayer_minSdkVersion=24
+UnifiedPlayer_targetSdkVersion=34
+UnifiedPlayer_compileSdkVersion=35
+UnifiedPlayer_ndkVersion=27.1.12297006

package/android/src/main/AndroidManifest.xml

@@ -0,0 +1,7 @@
+<manifest xmlns:android="http://schemas.android.com/apk/res/android"
+          package="com.unifiedplayer">
+    <uses-permission android:name="android.permission.INTERNET" />
+    <uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
+    <application android:hardwareAccelerated="true">
+    </application>
+</manifest>

package/android/src/main/AndroidManifestNew.xml

@@ -0,0 +1,4 @@
+<manifest xmlns:android="http://schemas.android.com/apk/res/android">
+    <uses-permission android:name="android.permission.INTERNET" />
+    <uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
+</manifest>

package/android/src/main/java/com/unifiedplayer/UnifiedPlayerEventEmitter.kt

@@ -0,0 +1,62 @@
+package com.unifiedplayer
+
+import com.facebook.react.bridge.ReactApplicationContext
+import com.facebook.react.bridge.ReactContextBaseJavaModule
+import com.facebook.react.bridge.ReactMethod
+import com.facebook.react.bridge.WritableMap
+import com.facebook.react.modules.core.DeviceEventManagerModule
+import android.util.Log
+
+class UnifiedPlayerEventEmitter(private val reactContext: ReactApplicationContext) : ReactContextBaseJavaModule(reactContext) {
+    companion object {
+        private const val TAG = "UnifiedPlayerEventEmitter"
+        
+        // Define all possible event types
+        const val EVENT_READY = "onReadyToPlay"
+        const val EVENT_ERROR = "onError"
+        const val EVENT_PROGRESS = "onProgress"
+        const val EVENT_COMPLETE = "onPlaybackComplete"
+        const val EVENT_STALLED = "onPlaybackStalled"
+        const val EVENT_RESUMED = "onPlaybackResumed"
+        
+        // Singleton instance for access from other classes
+        private var instance: UnifiedPlayerEventEmitter? = null
+        
+        fun getInstance(): UnifiedPlayerEventEmitter? {
+            return instance
+        }
+    }
+    
+    init {
+        instance = this
+    }
+    
+    override fun getName(): String {
+        return "UnifiedPlayerEvents"
+    }
+    
+    @ReactMethod
+    fun addListener(eventName: String) {
+        // Required for React Native event emitter
+    }
+    
+    @ReactMethod
+    fun removeListeners(count: Int) {
+        // Required for React Native event emitter
+    }
+    
+    fun sendEvent(eventName: String, params: WritableMap?) {
+        try {
+            reactContext
+                .getJSModule(DeviceEventManagerModule.RCTDeviceEventEmitter::class.java)
+                .emit(eventName, params)
+        } catch (e: Exception) {
+            Log.e(TAG, "Error sending event: $eventName - ${e.message}")
+        }
+    }
+    
+    override fun onCatalystInstanceDestroy() {
+        super.onCatalystInstanceDestroy()
+        instance = null
+    }
+} 

package/android/src/main/java/com/unifiedplayer/UnifiedPlayerModule.kt

@@ -0,0 +1,93 @@
+package com.unifiedplayer
+
+import com.facebook.react.bridge.ReactApplicationContext
+import com.facebook.react.bridge.ReactContextBaseJavaModule
+import com.facebook.react.bridge.ReactMethod
+import com.facebook.react.bridge.Promise
+import com.facebook.react.uimanager.UIManagerModule
+import android.util.Log
+
+class UnifiedPlayerModule(private val reactContext: ReactApplicationContext) : ReactContextBaseJavaModule(reactContext) {
+    companion object {
+        private const val TAG = "UnifiedPlayerModule"
+    }
+    
+    override fun getName(): String {
+        return "UnifiedPlayer"
+    }
+    
+    private fun getPlayerView(viewId: Int): UnifiedPlayerView? {
+        val uiManager = reactContext.getNativeModule(UIManagerModule::class.java)
+        val view = uiManager?.resolveView(viewId) as? UnifiedPlayerView
+        
+        if (view == null) {
+            Log.e(TAG, "Unable to find UnifiedPlayerView with id $viewId")
+        }
+        
+        return view
+    }
+    
+    @ReactMethod
+    fun play(viewId: Int) {
+        try {
+            Log.d(TAG, "Play command received for view $viewId")
+            reactContext.runOnUiQueueThread {
+                getPlayerView(viewId)?.play()
+            }
+        } catch (e: Exception) {
+            Log.e(TAG, "Error playing video: ${e.message}")
+        }
+    }
+    
+    @ReactMethod
+    fun pause(viewId: Int) {
+        try {
+            Log.d(TAG, "Pause command received for view $viewId")
+            reactContext.runOnUiQueueThread {
+                getPlayerView(viewId)?.pause()
+            }
+        } catch (e: Exception) {
+            Log.e(TAG, "Error pausing video: ${e.message}")
+        }
+    }
+    
+    @ReactMethod
+    fun seekTo(viewId: Int, time: Float) {
+        try {
+            Log.d(TAG, "Seek command received for view $viewId to time $time")
+            reactContext.runOnUiQueueThread {
+                getPlayerView(viewId)?.seekTo(time)
+            }
+        } catch (e: Exception) {
+            Log.e(TAG, "Error seeking: ${e.message}")
+        }
+    }
+    
+    @ReactMethod
+    fun getCurrentTime(viewId: Int, promise: Promise) {
+        try {
+            Log.d(TAG, "Get current time for view $viewId")
+            reactContext.runOnUiQueueThread {
+                val time = getPlayerView(viewId)?.getCurrentTime() ?: 0f
+                promise.resolve(time)
+            }
+        } catch (e: Exception) {
+            Log.e(TAG, "Error getting current time: ${e.message}")
+            promise.reject("ERROR", "Failed to get current time: ${e.message}")
+        }
+    }
+    
+    @ReactMethod
+    fun getDuration(viewId: Int, promise: Promise) {
+        try {
+            Log.d(TAG, "Get duration for view $viewId")
+            reactContext.runOnUiQueueThread {
+                val duration = getPlayerView(viewId)?.getDuration() ?: 0f
+                promise.resolve(duration)
+            }
+        } catch (e: Exception) {
+            Log.e(TAG, "Error getting duration: ${e.message}")
+            promise.reject("ERROR", "Failed to get duration: ${e.message}")
+        }
+    }
+} 

package/android/src/main/java/com/unifiedplayer/UnifiedPlayerPackage.kt

@@ -0,0 +1,20 @@
+package com.unifiedplayer
+
+import com.facebook.react.ReactPackage
+import com.facebook.react.bridge.NativeModule
+import com.facebook.react.bridge.ReactApplicationContext
+import com.facebook.react.uimanager.ViewManager
+
+
+class UnifiedPlayerPackage : ReactPackage {
+  override fun createNativeModules(reactContext: ReactApplicationContext): List<NativeModule> {
+    return listOf(
+      UnifiedPlayerModule(reactContext),
+      UnifiedPlayerEventEmitter(reactContext)
+    )
+  }
+
+  override fun createViewManagers(reactContext: ReactApplicationContext): List<ViewManager<*, *>> {
+    return listOf(UnifiedPlayerViewManager())
+  }
+}