@abdurrahman-dev/react-native-ivs-broadcast 0.1.0

package/LICENSE

@@ -0,0 +1,22 @@
+MIT License
+
+Copyright (c) 2024
+
+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,296 @@
+# react-native-ivs-broadcast
+
+React Native için Amazon Interactive Video Service (IVS) Broadcast SDK köprü paketi. Bu paket, Amazon IVS Broadcast SDK'nın native yeteneklerini React Native projelerinde kullanmanızı sağlar.
+
+## Özellikler
+
+- ✅ Android 1.37.1 ve iOS 1.37.0 desteği
+- ✅ Broadcast başlatma/durdurma/duraklatma/devam ettirme
+- ✅ Kamera kontrolü (ön/arka kamera değiştirme)
+- ✅ Mikrofon kontrolü (sessize alma/açma)
+- ✅ Video ve ses konfigürasyonu
+- ✅ Network health monitoring
+- ✅ Real-time istatistikler (audio/video stats)
+- ✅ Event-based API
+
+## Kurulum
+
+### npm
+
+```bash
+npm install react-native-ivs-broadcast
+```
+
+### yarn
+
+```bash
+yarn add react-native-ivs-broadcast
+```
+
+## Platform Kurulumu
+
+### Android
+
+1. `android/app/build.gradle` dosyanıza aşağıdaki bağımlılığı ekleyin:
+
+```gradle
+dependencies {
+    implementation 'com.amazonaws:ivs-broadcast:1.37.1:stages@aar'
+}
+```
+
+2. `android/build.gradle` dosyanıza `mavenCentral()` repository'sini ekleyin:
+
+```gradle
+allprojects {
+    repositories {
+        mavenCentral()
+        // ... diğer repository'ler
+    }
+}
+```
+
+3. `AndroidManifest.xml` dosyanıza gerekli izinleri ekleyin (paket içinde zaten mevcut):
+
+```xml
+<uses-permission android:name="android.permission.CAMERA" />
+<uses-permission android:name="android.permission.RECORD_AUDIO" />
+<uses-permission android:name="android.permission.INTERNET" />
+```
+
+### iOS
+
+1. `ios/Podfile` dosyanıza aşağıdaki satırı ekleyin:
+
+```ruby
+pod 'AmazonIVSBroadcast', '1.37.0'
+```
+
+2. Pod'ları yükleyin:
+
+```bash
+cd ios && pod install && cd ..
+```
+
+3. `Info.plist` dosyanıza kamera ve mikrofon izinlerini ekleyin:
+
+```xml
+<key>NSCameraUsageDescription</key>
+<string>Kamerayı kullanmak için izin gerekiyor</string>
+<key>NSMicrophoneUsageDescription</key>
+<string>Mikrofonu kullanmak için izin gerekiyor</string>
+```
+
+## Kullanım
+
+### Temel Kullanım
+
+```typescript
+import IVSBroadcast from 'react-native-ivs-broadcast';
+
+// Session oluştur
+const session = await IVSBroadcast.createSession({
+  rtmpUrl: 'rtmp://your-stream-url.com',
+  streamKey: 'your-stream-key',
+  videoConfig: {
+    width: 1280,
+    height: 720,
+    bitrate: 2500000,
+    fps: 30,
+  },
+  audioConfig: {
+    bitrate: 128000,
+    sampleRate: 44100,
+    channels: 2,
+  },
+});
+
+// Event listener'ları ekle
+IVSBroadcast.addListener('onStateChanged', (state) => {
+  console.log('Broadcast state:', state);
+});
+
+IVSBroadcast.addListener('onError', (error) => {
+  console.error('Broadcast error:', error);
+});
+
+IVSBroadcast.addListener('onNetworkHealth', (health) => {
+  console.log('Network health:', health);
+});
+
+// Broadcast'i başlat
+await IVSBroadcast.startBroadcast(session.sessionId);
+
+// Kamera değiştir
+await IVSBroadcast.switchCamera(session.sessionId);
+
+// Mikrofonu sessize al
+await IVSBroadcast.setMuted(session.sessionId, true);
+
+// Broadcast'i durdur
+await IVSBroadcast.stopBroadcast(session.sessionId);
+
+// Session'ı yok et
+await IVSBroadcast.destroySession(session.sessionId);
+```
+
+### API Referansı
+
+#### `createSession(config: IVSBroadcastConfig): Promise<IVSBroadcastSession>`
+
+Yeni bir broadcast session oluşturur.
+
+**Parametreler:**
+- `config.rtmpUrl` (string, zorunlu): RTMP stream URL'i
+- `config.streamKey` (string, opsiyonel): Stream key
+- `config.videoConfig` (VideoConfig, opsiyonel): Video konfigürasyonu
+- `config.audioConfig` (AudioConfig, opsiyonel): Audio konfigürasyonu
+
+**Dönen değer:** `{ sessionId: string }`
+
+#### `startBroadcast(sessionId: string): Promise<void>`
+
+Broadcast'i başlatır.
+
+#### `stopBroadcast(sessionId: string): Promise<void>`
+
+Broadcast'i durdurur.
+
+#### `pauseBroadcast(sessionId: string): Promise<void>`
+
+Broadcast'i duraklatır.
+
+#### `resumeBroadcast(sessionId: string): Promise<void>`
+
+Duraklatılmış broadcast'i devam ettirir.
+
+#### `destroySession(sessionId: string): Promise<void>`
+
+Session'ı yok eder ve kaynakları temizler.
+
+#### `getState(sessionId: string): Promise<BroadcastState>`
+
+Broadcast durumunu alır.
+
+**Dönen değer:**
+```typescript
+{
+  isBroadcasting: boolean;
+  isPaused: boolean;
+  error?: string;
+}
+```
+
+#### `switchCamera(sessionId: string): Promise<void>`
+
+Kamerayı değiştirir (ön ↔ arka).
+
+#### `setCameraPosition(sessionId: string, position: 'front' | 'back'): Promise<void>`
+
+Kamera pozisyonunu ayarlar.
+
+#### `setMuted(sessionId: string, muted: boolean): Promise<void>`
+
+Mikrofonu sessize alır veya açar.
+
+#### `isMuted(sessionId: string): Promise<boolean>`
+
+Mikrofonun sessize alınıp alınmadığını kontrol eder.
+
+#### `updateVideoConfig(sessionId: string, config: VideoConfig): Promise<void>`
+
+Video konfigürasyonunu günceller.
+
+#### `updateAudioConfig(sessionId: string, config: AudioConfig): Promise<void>`
+
+Audio konfigürasyonunu günceller.
+
+### Event Listener'lar
+
+#### `onStateChanged`
+
+Broadcast durumu değiştiğinde tetiklenir.
+
+```typescript
+IVSBroadcast.addListener('onStateChanged', (state: BroadcastState) => {
+  console.log('State:', state);
+});
+```
+
+#### `onError`
+
+Hata oluştuğunda tetiklenir.
+
+```typescript
+IVSBroadcast.addListener('onError', (error: { message: string; code?: string }) => {
+  console.error('Error:', error);
+});
+```
+
+#### `onNetworkHealth`
+
+Network sağlık durumu güncellendiğinde tetiklenir.
+
+```typescript
+IVSBroadcast.addListener('onNetworkHealth', (health: NetworkHealth) => {
+  console.log('Network quality:', health.networkQuality);
+  console.log('Uplink bandwidth:', health.uplinkBandwidth);
+  console.log('RTT:', health.rtt);
+});
+```
+
+#### `onAudioStats`
+
+Audio istatistikleri güncellendiğinde tetiklenir.
+
+```typescript
+IVSBroadcast.addListener('onAudioStats', (stats: AudioStats) => {
+  console.log('Audio bitrate:', stats.bitrate);
+  console.log('Sample rate:', stats.sampleRate);
+});
+```
+
+#### `onVideoStats`
+
+Video istatistikleri güncellendiğinde tetiklenir.
+
+```typescript
+IVSBroadcast.addListener('onVideoStats', (stats: VideoStats) => {
+  console.log('Video bitrate:', stats.bitrate);
+  console.log('FPS:', stats.fps);
+  console.log('Resolution:', stats.width, 'x', stats.height);
+});
+```
+
+### Listener'ları Temizleme
+
+```typescript
+// Belirli bir listener'ı kaldır
+IVSBroadcast.removeListener('onStateChanged', callback);
+
+// Tüm listener'ları kaldır
+IVSBroadcast.removeAllListeners();
+```
+
+## Type Definitions
+
+Paket TypeScript desteği ile birlikte gelir. Tüm type tanımlamaları `types.ts` dosyasında bulunur.
+
+## Gereksinimler
+
+- React Native >= 0.60.0
+- Android: minSdkVersion 21
+- iOS: 11.0+
+
+## Lisans
+
+MIT
+
+## Katkıda Bulunma
+
+Katkılarınızı bekliyoruz! Lütfen pull request göndermeden önce mevcut kod stilini takip ettiğinizden emin olun.
+
+## Destek
+
+Sorunlarınız için GitHub Issues kullanabilirsiniz.
+

package/android/build.gradle

@@ -0,0 +1,61 @@
+buildscript {
+    ext {
+        buildToolsVersion = "33.0.0"
+        minSdkVersion = 21
+        compileSdkVersion = 33
+        targetSdkVersion = 33
+        kotlinVersion = "1.7.0"
+    }
+    repositories {
+        google()
+        mavenCentral()
+    }
+    dependencies {
+        classpath("com.android.tools.build:gradle:7.3.1")
+        classpath("org.jetbrains.kotlin:kotlin-gradle-plugin:$kotlinVersion")
+    }
+}
+
+apply plugin: 'com.android.library'
+apply plugin: 'kotlin-android'
+
+android {
+    compileSdkVersion rootProject.ext.compileSdkVersion
+
+    defaultConfig {
+        minSdkVersion rootProject.ext.minSdkVersion
+        targetSdkVersion rootProject.ext.targetSdkVersion
+    }
+
+    buildTypes {
+        release {
+            minifyEnabled false
+        }
+    }
+
+    compileOptions {
+        sourceCompatibility JavaVersion.VERSION_1_8
+        targetCompatibility JavaVersion.VERSION_1_8
+    }
+
+    kotlinOptions {
+        jvmTarget = '1.8'
+    }
+}
+
+repositories {
+    mavenCentral()
+    google()
+    maven {
+        url "https://www.jitpack.io"
+    }
+}
+
+dependencies {
+    implementation "com.facebook.react:react-native:+"
+    implementation "org.jetbrains.kotlin:kotlin-stdlib:$kotlinVersion"
+    
+    // Amazon IVS Broadcast SDK
+    implementation 'com.amazonaws:ivs-broadcast:1.37.1:stages@aar'
+}
+

package/android/src/main/AndroidManifest.xml

@@ -0,0 +1,13 @@
+<manifest xmlns:android="http://schemas.android.com/apk/res/android"
+    package="com.reactnativeivsbroadcast">
+    
+    <uses-permission android:name="android.permission.CAMERA" />
+    <uses-permission android:name="android.permission.RECORD_AUDIO" />
+    <uses-permission android:name="android.permission.INTERNET" />
+    <uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
+    
+    <uses-feature android:name="android.hardware.camera" android:required="false" />
+    <uses-feature android:name="android.hardware.camera.autofocus" android:required="false" />
+    <uses-feature android:name="android.hardware.microphone" android:required="false" />
+</manifest>
+