expo-nodemediaclient 0.1.2 → 0.2.1

package/CHANGELOG.md

@@ -1,2 +1,12 @@
+## [0.2.1] 2026-01-05
+- SDK更新到4.1
+- 添加推流静音,镜头缩放,补光灯开关api
+
+## [0.2.0] 2025-12-31
+- SDK更新到4.0
+- 添加推流实现
+
+## [0.1.2] 2025-10-13
+
 ## [0.1.1] 2025-07-25
 - 实现播放功能

package/CLAUDE.md

@@ -0,0 +1,55 @@
+# CLAUDE.md
+
+This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
+
+## Project Overview
+
+This is **expo-nodemediaclient**, an Expo native module providing live streaming capabilities using the NodeMedia SDK 4.0. It enables RTMP/RTSP/HLS/HTTP-FLV video playback and RTMP live streaming (publishing) for React Native applications using Expo's Continuous Native Generation (CNG) workflow.
+
+## Architecture
+
+The module follows Expo's custom native module pattern with three main components:
+
+- **NodeMediaClient** (`ExpoNodeMediaClientModule.tsx`) - SDK license management, requires separate license keys for iOS and Android
+- **NodePlayer** (`ExpoNodePlayerView.tsx`) - Video playback component using `requireNativeViewManager`
+- **NodePublisher** (`ExpoNodePublisherView.tsx`) - Camera capture and streaming component using `requireNativeViewManager`
+
+The native implementations are in:
+- `ios/ExpoNodemediaclient/` - iOS native code (Objective-C/Swift)
+- `android/src/main/java/` - Android native code (Java)
+
+Module configuration is in `expo-module.config.json` which maps platform-specific module names.
+
+## Development Commands
+
+```bash
+npm run build          # Build the module (TypeScript -> build/)
+npm run clean          # Clean build artifacts
+npm run lint           # Run linting
+npm run test           # Run tests
+npm run prepare        # Prepare module for development
+npm run prepublishOnly # Prepare for publishing
+npm run open:ios       # Open example iOS project in Xcode
+npm run open:android   # Open example Android project in Android Studio
+```
+
+The example app in `example/` demonstrates both Player and Publisher functionality with navigation between screens.
+
+## Key Constants
+
+NodePublisher exposes these important constants:
+- `NMC_CODEC_ID_AAC`, `NMC_CODEC_ID_H264`, `NMC_CODEC_ID_H265` - Codec identifiers
+- `NMC_PROFILE_AUTO` - Auto profile selection
+- `VIDEO_ORIENTATION_PORTRAIT`, `VIDEO_ORIENTATION_LANDSCAPE` - Video orientation
+- `EFFECTOR_STYLE_ID_FAIRSKIN` - Beauty filter style
+
+## Event Callbacks
+
+Both NodePlayer and NodePublisher support `onEventCallback` that receives `{ nativeEvent: { event: number, msg: string } }`. The `event` code indicates status changes (connection, buffering, error, etc.).
+
+## Important Notes
+
+- **License Required**: NodeMedia SDK requires separate license keys for iOS and Android from https://www.nodemedia.cn
+- **CNG Required**: Projects must use Expo's Continuous Native Generation - run `npx expo prebuild` if using managed workflow
+- **Permissions**: Publisher requires camera and microphone permissions; use `expo-camera` plugin for permission handling
+- **SDK Version**: Currently on NodeMedia SDK 4.0 (updated in v0.2.0)

package/README.md

@@ -39,6 +39,7 @@ if (Platform.OS === 'ios') {
 ```
 
 ### 播放
+
 ```js
 import { NodePlayer, NodePlayerRef } from 'expo-nodemediaclient';
 import { useRef, useState } from 'react';
@@ -71,36 +72,219 @@ export default function App() {
     </SafeAreaView>
   );
 }
+```
+
+### 组件属性
+
+| 属性 | 类型 | 说明 |
+|------|------|------|
+| `url` | `string` | 播放地址 (支持 RTMP、RTSP、HLS、HTTP-FLV) |
+| `bufferTime` | `number` | 缓冲时间 (毫秒)，默认 1000 |
+| `scaleMode` | `number` | 缩放模式，`0`=填充，`1`=适应，`2`=拉伸 |
+| `volume` | `number` | 音量 (0.0 - 1.0)，默认 1.0 |
+| `onEventCallback` | `(event) => void` | 事件回调 |
+
+### 常用方法
 
+```js
+// 开始播放
+playerRef.current?.start(url);
+
+// 停止播放
+playerRef.current?.stop();
 ```
 
-### 进入页面自动播放
+### 事件回调
+
 ```js
-export default function App() {
-  const [url, setUrl] = useState('rtmp://192.168.0.2/live/bbb');
-  const [bufferTime, setBufferTime] = useState(0);
-  const [scaleMode, setScaleMode] = useState(2);
-  const playerRef = useRef<NodePlayerRef>(null);
-  
-  useEffect(() => {
-    playerRef.current?.start(url);
-    return () => {
-      playerRef.current?.stop();
-    };
-  }, []);
+const handleEvent = (event: { nativeEvent: NodePlayerEventCallback }) => {
+  console.log('事件码:', event.nativeEvent.event);
+  console.log('消息:', event.nativeEvent.msg);
+};
+
+<NodePlayer
+  onEventCallback={handleEvent}
+  // ...其他属性
+/>
+```
+
+
+## 推流
+
+### 基本用法
+
+```js
+import { NodePublisher, NodePublisherRef } from 'expo-nodemediaclient';
+import { useRef, useState } from 'react';
+
+export default function PublisherScreen() {
+  const [url, setUrl] = useState('rtmp://192.168.0.2/live/stream');
+  const [isPublishing, setIsPublishing] = useState(false);
+  const publisherRef = useRef<NodePublisherRef>(null);
+
+  const handleTogglePublish = () => {
+    if (!isPublishing) {
+      setIsPublishing(true);
+      publisherRef.current?.start(url);
+    } else {
+      setIsPublishing(false);
+      publisherRef.current?.stop();
+    }
+  };
 
   return (
     <SafeAreaView style={{ flex: 1 }}>
-      <NodePlayer
-        ref={playerRef}
+      <NodePublisher
+        ref={publisherRef}
+        style={{ flex: 1, backgroundColor: '#000' }}
         url={url}
-        bufferTime={bufferTime}
-        scaleMode={scaleMode}
-        style={{ backgroundColor: '#000000', height: 300 }}
+        audioParam={{
+          codecid: NodePublisher.NMC_CODEC_ID_AAC,
+          profile: NodePublisher.NMC_PROFILE_AUTO,
+          channels: 2,
+          samplingRate: 44100,
+          bitrate: 64_000,
+        }}
+        videoParam={{
+          codecid: NodePublisher.NMC_CODEC_ID_H264,
+          profile: NodePublisher.NMC_PROFILE_AUTO,
+          width: 720,
+          height: 1280,
+          fps: 30,
+          bitrate: 2000_000,
+        }}
+      />
+      <Button
+        title={isPublishing ? "停止" : "推流"}
+        onPress={handleTogglePublish}
       />
     </SafeAreaView>
   );
 }
 ```
 
-## 推流
+### 组件属性
+
+| 属性 | 类型 | 说明 |
+|------|------|------|
+| `url` | `string` | 推流地址 (RTMP) |
+| `audioParam` | `AudioParam` | 音频编码参数 |
+| `videoParam` | `VideoParam` | 视频编码参数 |
+| `videoOrientation` | `number` | 视频方向，`NodePublisher.VIDEO_ORIENTATION_PORTRAIT` 或 `NodePublisher.VIDEO_ORIENTATION_LANDSCAPE` |
+| `keyFrameInterval` | `number` | 关键帧间隔 (秒)，默认 2 |
+| `frontCamera` | `boolean` | 是否使用前置摄像头，默认 false |
+| `cameraFrontMirror` | `boolean` | 前置摄像头是否镜像，默认 true |
+| `HWAccelEnable` | `boolean` | 是否启用硬件加速，默认 true |
+| `denoiseEnable` | `boolean` | 是否启用降噪，默认 true |
+| `colorStyleId` | `number` | 色彩风格ID，如 `NodePublisher.EFFECTOR_STYLE_ID_FAIRSKIN` |
+| `colorStyleIntensity` | `number` | 色彩强度 (0.0 - 1.0) |
+| `smoothskinIntensity` | `number` | 磨皮强度 (0.0 - 1.0) |
+| `onEventCallback` | `(event) => void` | 事件回调 |
+
+### AudioParam
+
+| 属性 | 类型 | 说明 |
+|------|------|------|
+| `codecid` | `number` | 编码ID，`NodePublisher.NMC_CODEC_ID_AAC` |
+| `profile` | `number` | 编码profile，`NodePublisher.NMC_PROFILE_AUTO` |
+| `channels` | `number` | 声道数，1 或 2 |
+| `samplingRate` | `number` | 采样率，如 44100 |
+| `bitrate` | `number` | 比特率，如 64000 |
+
+### VideoParam
+
+| 属性 | 类型 | 说明 |
+|------|------|------|
+| `codecid` | `number` | 编码ID，`NodePublisher.NMC_CODEC_ID_H264` 或 `NodePublisher.NMC_CODEC_ID_H265` |
+| `profile` | `number` | 编码profile，`NodePublisher.NMC_PROFILE_AUTO` |
+| `width` | `number` | 视频宽度 |
+| `height` | `number` | 视频高度 |
+| `fps` | `number` | 帧率 |
+| `bitrate` | `number` | 比特率，如 2000000 |
+
+### 常用方法
+
+```js
+// 开始推流
+publisherRef.current?.start(url);
+
+// 停止推流
+publisherRef.current?.stop();
+```
+
+### 事件回调
+
+```js
+const handleEvent = (event: { nativeEvent: NodePlayerEventCallback }) => {
+  console.log('事件码:', event.nativeEvent.event);
+  console.log('消息:', event.nativeEvent.msg);
+};
+
+<NodePublisher
+  onEventCallback={handleEvent}
+  // ...其他属性
+/>
+```
+
+### 权限说明
+
+使用推流功能需要摄像头和麦克风权限，建议使用 `expo-camera` 来申请权限。
+
+首先安装依赖：
+
+```bash
+npm install expo-camera
+```
+
+在 `app.json` 中配置 `expo-camera` 插件：
+
+```json
+{
+  "expo": {
+    "plugins": [
+      [
+        "expo-camera",
+        {
+          "cameraPermission": "Allow $(PRODUCT_NAME) to access your camera",
+          "microphonePermission": "Allow $(PRODUCT_NAME) to access your microphone",
+          "recordAudioAndroid": true
+        }
+      ]
+    ],
+    "ios": {
+      "infoPlist": {
+        "NSCameraUsageDescription": "需要访问摄像头以进行直播推流",
+        "NSMicrophoneUsageDescription": "需要访问麦克风以进行直播推流"
+      }
+    },
+    "android": {
+      "permissions": [
+        "android.permission.CAMERA",
+        "android.permission.RECORD_AUDIO",
+        "android.permission.INTERNET"
+      ]
+    }
+  }
+}
+```
+
+在代码中申请权限：
+
+```js
+import { useCameraPermissions, useMicrophonePermissions } from 'expo-camera';
+import { useEffect } from 'react';
+
+export default function App() {
+  const [cameraPermission, requestCameraPermission] = useCameraPermissions();
+  const [microphonePermission, requestMicrophonePermission] = useMicrophonePermissions();
+
+  useEffect(() => {
+    requestCameraPermission();
+    requestMicrophonePermission();
+  }, []);
+
+  const hasPermission = cameraPermission?.granted && microphonePermission?.granted;
+
+  // ...
+}
+```

package/android/build.gradle

@@ -1,7 +1,6 @@
 apply plugin: 'com.android.library'
 
 group = 'expo.modules.nodemediaclient'
-version = '0.1.1'
 
 def expoModulesCorePlugin = new File(project(":expo-modules-core").projectDir.absolutePath, "ExpoModulesCorePlugin.gradle")
 apply from: expoModulesCorePlugin
@@ -23,10 +22,10 @@ if (useManagedAndroidSdkVersions) {
     }
   }
   project.android {
-    compileSdkVersion safeExtGet("compileSdkVersion", 34)
+    compileSdkVersion safeExtGet("compileSdkVersion", 36)
     defaultConfig {
-      minSdkVersion safeExtGet("minSdkVersion", 21)
-      targetSdkVersion safeExtGet("targetSdkVersion", 34)
+      minSdkVersion safeExtGet("minSdkVersion", 24)
+      targetSdkVersion safeExtGet("targetSdkVersion", 36)
     }
   }
 }
@@ -34,13 +33,13 @@ if (useManagedAndroidSdkVersions) {
 android {
   namespace "expo.modules.nodemediaclient"
   defaultConfig {
-    versionCode 1
-    versionName "0.1.1"
+    versionCode 201
+    versionName "0.2.1"
   }
   lintOptions {
     abortOnError false
   }
   dependencies {
-    implementation 'com.github.NodeMedia:NodeMediaClient-Android:3.2.12'
+    implementation 'com.github.NodeMedia:NodeMediaClient-Android:4.1.0'
   }
 }

package/android/src/main/java/expo/modules/nodemediaclient/ExpoNodeMediaClientModule.kt

@@ -20,4 +20,4 @@ class ExpoNodeMediaClientModule : Module() {
       LICENSE_KEY = license
     }
   }
-}
+}

package/android/src/main/java/expo/modules/nodemediaclient/ExpoNodePlayerView.kt

@@ -1,30 +1,22 @@
-//
-//  Copyright (c) 2025 NodeMedia Technology Co., Ltd.
-//  Created by Chen Mingliang on 2025-07-22.
-//  All rights reserved.
-//
-
 package expo.modules.nodemediaclient
 
 import android.content.Context
-import android.util.Log
-import android.webkit.WebView
-import android.webkit.WebViewClient
-import android.widget.FrameLayout
 import expo.modules.kotlin.AppContext
 import expo.modules.kotlin.viewevent.EventDispatcher
 import expo.modules.kotlin.views.ExpoView
-import cn.nodemedia.NodePlayer;
+
+import android.util.Log
+import android.widget.FrameLayout
+import cn.nodemedia.NodePlayer
 
 class ExpoNodePlayerView(context: Context, appContext: AppContext) : ExpoView(context, appContext) {
-    // Creates and initializes an event dispatcher for the `onLoad` event.
-    // The name of the event is inferred from the value and needs to match the event name defined in the module.
-    private val onLoad by EventDispatcher()
     private val TAG = "ExpoNodePlayerView"
     private var np: NodePlayer? = null
+    private val onEventCallback by EventDispatcher()
+
     var url = ""
     var cryptoKey = "" // Add this property
-        set(value)  {
+        set(value) {
             field = value
             np?.setCryptoKey(value)
         }
@@ -60,7 +52,7 @@ class ExpoNodePlayerView(context: Context, appContext: AppContext) : ExpoView(co
             np?.setRTSPTransport(value)
         }
 
-    var HWAccelEnable= true
+    var HWAccelEnable = true
         set(value) {
             field = value
             np?.setHWAccelEnable(value)
@@ -76,6 +68,9 @@ class ExpoNodePlayerView(context: Context, appContext: AppContext) : ExpoView(co
     override fun onAttachedToWindow() {
         super.onAttachedToWindow()
         np = NodePlayer(context, LICENSE_KEY)
+        np?.setOnNodePlayerEventListener { obj, event, msg ->
+            onEventCallback(mapOf("event" to event, "msg" to msg))
+        }
         np?.attachView(videoView)
     }
 
@@ -86,8 +81,8 @@ class ExpoNodePlayerView(context: Context, appContext: AppContext) : ExpoView(co
         super.onDetachedFromWindow()
     }
 
-    fun start(url: String?){
-        if(!url.isNullOrEmpty()) {
+    fun start(url: String?) {
+        if (!url.isNullOrEmpty()) {
             this.url = url
         }
         np?.setVolume(this.volume)
@@ -101,7 +96,7 @@ class ExpoNodePlayerView(context: Context, appContext: AppContext) : ExpoView(co
         np?.start(this.url)
     }
 
-    fun stop(){
+    fun stop() {
         np?.stop()
     }
-}
+}

package/android/src/main/java/expo/modules/nodemediaclient/ExpoNodePlayerViewModule.kt

@@ -0,0 +1,58 @@
+package expo.modules.nodemediaclient
+
+import expo.modules.kotlin.modules.Module
+import expo.modules.kotlin.modules.ModuleDefinition
+
+class ExpoNodePlayerViewModule : Module() {
+    override fun definition() = ModuleDefinition {
+        Name("ExpoNodePlayerView")
+
+        View(ExpoNodePlayerView::class) {
+            Events("onEventCallback")
+
+            Prop("url") { view: ExpoNodePlayerView, url: String ->
+                view.url = url
+            }
+
+            Prop("volume") { view: ExpoNodePlayerView, volume: Float ->
+                view.volume = volume
+            }
+
+            Prop("cryptoKey") { view: ExpoNodePlayerView, cryptoKey: String ->
+                view.cryptoKey = cryptoKey
+            }
+
+            Prop("scaleMode") { view: ExpoNodePlayerView, scaleMode: Int ->
+                view.scaleMode = scaleMode
+            }
+
+            Prop("bufferTime") { view: ExpoNodePlayerView, bufferTime: Int ->
+                view.bufferTime = bufferTime
+            }
+
+            Prop("HTTPReferer") { view: ExpoNodePlayerView, HTTPReferer: String ->
+                view.HTTPReferer = HTTPReferer
+            }
+
+            Prop("HTTPUserAgent") { view: ExpoNodePlayerView, HTTPUserAgent: String ->
+                view.HTTPUserAgent = HTTPUserAgent
+            }
+
+            Prop("RTSPTransport") { view: ExpoNodePlayerView, RTSPTransport: String ->
+                view.RTSPTransport = RTSPTransport
+            }
+
+            Prop("HWAccelEnable") { view: ExpoNodePlayerView, HWAccelEnable: Boolean ->
+                view.HWAccelEnable = HWAccelEnable
+            }
+
+            AsyncFunction("start") { view: ExpoNodePlayerView, url: String? ->
+                view.start(url)
+            }
+
+            AsyncFunction("stop") { view: ExpoNodePlayerView ->
+                view.stop()
+            }
+        }
+    }
+}

package/android/src/main/java/expo/modules/nodemediaclient/ExpoNodePublisherView.kt

@@ -0,0 +1,175 @@
+package expo.modules.nodemediaclient
+
+import android.content.Context
+import expo.modules.kotlin.AppContext
+import expo.modules.kotlin.views.ExpoView
+
+import android.widget.FrameLayout
+import cn.nodemedia.NodePublisher
+import expo.modules.kotlin.viewevent.EventDispatcher
+
+class ExpoNodePublisherView(context: Context, appContext: AppContext) :
+    ExpoView(context, appContext) {
+    private val TAG = "ExpoNodePublisherView"
+    private var np: NodePublisher? = null
+    private val onEventCallback by EventDispatcher()
+
+    var url = ""
+    var cryptoKey = ""
+    var HWAccelEnable = true
+    var denoiseEnable = true
+
+    var zoomRatio: Float? = null
+        set(value) {
+            field = value
+            value?.let { np?.setZoomRatio(it) }
+        }
+
+    var volume: Float? = null
+        set(value) {
+            field = value
+            value?.let { np?.setVolume(it) }
+        }
+
+    var torchEnable: Boolean? = null
+        set(value) {
+            field = value
+            value?.let { np?.setTorchEnable(it) }
+        }
+
+    // Color and effect parameters
+    var colorStyleId: Int? = null
+        set(value) {
+            field = value
+            value?.let { np?.setEffectStyle(it) }
+        }
+
+    var colorStyleIntensity: Float? = null
+        set(value) {
+            field = value
+            value?.let { np?.setEffectParameter("style", it) }
+        }
+
+    var smoothskinIntensity: Float? = null
+        set(value) {
+            field = value
+            value?.let { np?.setEffectParameter("smoothskin", it) }
+        }
+
+    // Audio parameters
+    var audioCodecId = NodePublisher.NMC_CODEC_ID_AAC
+    var audioProfile = NodePublisher.NMC_PROFILE_AUTO
+    var audioChannels = 2
+    var audioSamplingRate = 44100
+    var audioBitrate = 64000
+
+    // Video parameters
+    var videoCodecId = NodePublisher.NMC_CODEC_ID_H264
+    var videoProfile = NodePublisher.NMC_PROFILE_AUTO
+    var videoWidth = 720
+    var videoHeight = 1280
+    var videoFps = 30
+    var videoBitrate = 2000000
+
+    var frontCamera: Boolean? = null
+        set(value) {
+            field = value
+            value?.let {
+                np?.closeCamera()
+                np?.openCamera(if (it) NodePublisher.NMC_CAMERA_FRONT else NodePublisher.NMC_CAMERA_BACK)
+            }
+        }
+
+    // Other parameters
+    var keyFrameInterval = 2
+    var videoOrientation = 1
+
+    var cameraFrontMirror: Boolean? = null
+        set(value) {
+            field = value
+            value?.let { np?.setCameraFrontMirror(it) }
+        }
+
+    private val videoView = FrameLayout(context).apply {
+        layoutParams = LayoutParams(LayoutParams.MATCH_PARENT, LayoutParams.MATCH_PARENT)
+    }
+
+    init {
+        addView(videoView)
+    }
+
+    override fun onAttachedToWindow() {
+        super.onAttachedToWindow()
+        np = NodePublisher(context, LICENSE_KEY)
+        np?.setOnNodePublisherEventListener { obj, event, msg ->
+            onEventCallback(mapOf("event" to event, "msg" to msg))
+        }
+        // Apply audio and video params
+        applyAudioParams()
+        applyVideoParams()
+
+        // Apply crypto key and HWAccelEnable
+        np?.setCryptoKey(this.cryptoKey)
+        np?.setHWAccelEnable(this.HWAccelEnable)
+        np?.setDenoiseEnable(this.denoiseEnable)
+        
+        // Apply color and effect params if set
+        colorStyleId?.let { np?.setEffectStyle(it) }
+        colorStyleIntensity?.let { np?.setEffectParameter("style", it) }
+        smoothskinIntensity?.let { np?.setEffectParameter("smoothskin", it) }
+
+        // Apply volume if set
+        volume?.let { np?.setVolume(it) }
+
+        // opencamera and attachview
+        np?.openCamera(if (frontCamera == true) 0 else 1)
+        np?.attachView(videoView)
+
+        np?.setZoomRatio(zoomRatio ?: 1f)
+    }
+
+    override fun onDetachedFromWindow() {
+        np?.stop()
+        np?.closeCamera()
+        np?.detachView()
+        np = null
+        super.onDetachedFromWindow()
+    }
+
+    private fun applyAudioParams() {
+        np?.setAudioCodecParam(
+            audioCodecId, audioProfile,
+            audioSamplingRate, audioChannels, audioBitrate
+        )
+    }
+
+    private fun applyVideoParams() {
+        np?.setVideoCodecParam(
+            videoCodecId,
+            videoProfile, videoWidth, videoHeight, videoFps, videoBitrate
+        )
+    }
+
+    fun start(url: String?) {
+        if (!url.isNullOrEmpty()) {
+            this.url = url
+        }
+        np?.start(this.url)
+    }
+
+    fun stop() {
+        np?.stop()
+    }
+
+    fun setEffectParameter(key: String, value: Float) {
+        np?.setEffectParameter(key, value)
+    }
+
+    fun setEffectStyle(style: Int) {
+        np?.setEffectStyle(style)
+    }
+
+    fun startFocusAndMeteringCenter() {
+        np?.startFocusAndMeteringCenter()
+    }
+}