@volcengine/react-native-live-push 1.1.3-rc.1 → 1.2.0-rc.0

package/lib/typescript/core/api.d.ts

@@ -1,2 +1,18 @@
-import { VeLiveAudioDevice, VeLiveAudioFrame, VeLiveCameraDevice, VeLiveMediaPlayer, VeLiveMixerManager, VeLivePusher as _VeLivePusher, VeLivePusherConfiguration, VeLiveVideoEffectManager, VeLiveVideoFrame } from '../codegen/pack/api';
-export { VeLiveAudioDevice, VeLiveAudioFrame, VeLiveCameraDevice, VeLiveMediaPlayer, VeLiveMixerManager, VeLivePusherConfiguration, VeLiveVideoEffectManager, VeLiveVideoFrame, _VeLivePusher as VeLivePusher, };
+import { VeLiveAudioDevice, VeLiveCameraDevice, VeLiveMediaPlayer, VeLivePusher as _VeLivePusher, VeLivePusherConfiguration, VeLiveVideoEffectManager } from '../codegen/pack/api';
+import { VeLiveAudioFrame, VeLiveVideoFrame } from '../codegen/pack/keytype';
+import { VeLiveMixerManager } from './mixer';
+declare module '../codegen/pack/api' {
+    interface VeLivePusher {
+        /** {zh}
+         * @detail api
+         * @brief 获取混流管理对象。
+         * @return <br>
+         *      混流管理对象 VeLiveMixerManager{@link #VeLiveMixerManager}。
+         * @order 51
+         *
+         */
+        
+        getMixerManager(): VeLiveMixerManager;
+    }
+}
+export { VeLiveAudioDevice, VeLiveAudioFrame, VeLiveCameraDevice, VeLiveMediaPlayer, VeLivePusherConfiguration, VeLiveVideoEffectManager, VeLiveVideoFrame, _VeLivePusher as VeLivePusher, };

package/lib/typescript/core/keytype.d.ts

@@ -1,2 +1,18 @@
 import { VeLiveAudioBufferType, VeLiveAudioCaptureConfiguration, VeLiveAudioCaptureType, VeLiveAudioChannel, VeLiveAudioEncoderConfiguration, VeLiveAudioFrameSource, VeLiveAudioMixType, VeLiveAudioPowerLevel, VeLiveAudioProfile, VeLiveAudioSampleRate, VeLiveFileRecorderConfiguration, VeLiveFirstFrameType, VeLiveMixAudioLayout, VeLiveMixVideoLayout, VeLiveNetworkQuality, VeLivePixelFormat, VeLivePusherLogLevel, VeLivePusherRenderMode, VeLivePusherStatistics, VeLivePusherStatus, VeLiveStreamMixDescription, VeLiveVideoBufferType, VeLiveVideoCaptureConfiguration, VeLiveVideoCaptureType, VeLiveVideoCodec, VeLiveVideoEffectLicenseConfiguration, VeLiveVideoEffectLicenseType, VeLiveVideoEncoderConfiguration, VeLiveVideoFrameSource, VeLiveVideoMirrorType, VeLiveVideoResolution, VeLiveVideoRotation, VeLiveOrientation } from '../codegen/pack/keytype';
+export interface MixConfig {
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+    alpha?: number;
+    zOrder?: number;
+    renderMode?: number;
+    captureMode?: 'onchange' | 'realtime' | 'auto' | 'manual';
+}
+export interface MixViewConfig {
+    renderMode?: number;
+    captureMode?: 'onchange' | 'realtime' | 'auto' | 'manual';
+    captureFramerate?: number;
+    autoSensitivity?: number;
+}
 export { VeLiveOrientation, VeLiveAudioBufferType, VeLiveAudioCaptureConfiguration, VeLiveAudioCaptureType, VeLiveAudioChannel, VeLiveAudioEncoderConfiguration, VeLiveAudioFrameSource, VeLiveAudioMixType, VeLiveAudioPowerLevel, VeLiveAudioProfile, VeLiveAudioSampleRate, VeLiveFileRecorderConfiguration, VeLiveFirstFrameType, VeLiveMixAudioLayout, VeLiveMixVideoLayout, VeLiveNetworkQuality, VeLivePixelFormat, VeLivePusherLogLevel, VeLivePusherRenderMode, VeLivePusherStatistics, VeLivePusherStatus, VeLiveStreamMixDescription, VeLiveVideoBufferType, VeLiveVideoCaptureConfiguration, VeLiveVideoCaptureType, VeLiveVideoCodec, VeLiveVideoEffectLicenseConfiguration, VeLiveVideoEffectLicenseType, VeLiveVideoEncoderConfiguration, VeLiveVideoFrameSource, VeLiveVideoMirrorType, VeLiveVideoResolution, VeLiveVideoRotation, };

package/lib/typescript/core/mixer.d.ts

@@ -0,0 +1,26 @@
+import type { VeLivePusher } from './api';
+import { VeLiveMixerManager as AndroidVeLiveMixerManager } from '../platforms/android/mixer';
+import { VeLiveMixerManager as iOSVeLiveMixerManager } from '../platforms/ios/mixer';
+import type { MixConfig } from './keytype';
+export declare class VeLiveMixerManager {
+    private _pusher;
+    private _views;
+    protected _instance: AndroidVeLiveMixerManager | iOSVeLiveMixerManager;
+    protected __init(): void;
+    protected __new_instance(): AndroidVeLiveMixerManager | iOSVeLiveMixerManager;
+    constructor(pusher: VeLivePusher);
+    /**
+     * Add view to mixer - support hybrid-runtime way
+     * @param viewId viewId string
+     * @param config mixer configuration
+     */
+    addView(viewId: string, config: MixConfig): Promise<boolean>;
+    /**
+     * Update view configuration
+     */
+    updateView(viewId: string, config: Partial<MixConfig>): Promise<boolean>;
+    /**
+     * Remove view
+     */
+    removeView(viewId: string): Promise<boolean>;
+}

package/lib/typescript/core/pusher.d.ts

@@ -11,6 +11,3 @@ export interface InitOptions extends Partial<VeLivePusherConfiguration> {
 }
 export declare function initPusher(options: InitOptions): Promise<VeLivePusher>;
 export declare function relaunchPusher(options: InitOptions): Promise<VeLivePusher>;
-export declare function startScreenCapture(pusher: VeLivePusher, options: {
-    enableAppAudio: boolean;
-}): Promise<boolean>;

package/lib/typescript/index.d.ts

@@ -1,2 +1,3 @@
 export * from './component';
 export * from './core';
+export * from './view';

package/lib/typescript/platforms/android/extends.d.ts

@@ -0,0 +1,8 @@
+import { NativeView } from '@vcloud-lux/hybrid-runtime';
+export declare class SurfaceHolder {
+}
+export declare class NativeSurfaceView extends NativeView {
+    getHolder(): Promise<SurfaceHolder>;
+}
+export declare class AndroidView extends NativeView {
+}

package/lib/typescript/platforms/android/mixer.d.ts

@@ -0,0 +1,8 @@
+import type { VeLivePusher } from '../../codegen/android';
+import type { MixViewConfig } from '../../core/keytype';
+export declare class VeLiveMixerManager {
+    setPusher(pusher: VeLivePusher): void;
+    addView(viewId: string, config: MixViewConfig): Promise<boolean>;
+    updateView(viewId: string, config: MixViewConfig): Promise<boolean>;
+    removeView(viewId: string): Promise<boolean>;
+}

package/lib/typescript/platforms/ios/mixer.d.ts

@@ -0,0 +1,9 @@
+import type { VeLivePusher } from '../../codegen/ios';
+import type { MixViewConfig } from '../../core/keytype';
+export declare class VeLiveMixerManager {
+    setPusher(pusher: VeLivePusher): void;
+    addView(viewId: string, config: MixViewConfig): Promise<number>;
+    updateView(viewId: string, config: MixViewConfig): Promise<boolean>;
+    removeView(viewId: string): Promise<boolean>;
+    captureView(viewId: string): Promise<void>;
+}

package/lib/typescript/view/MixView.d.ts

@@ -0,0 +1,52 @@
+import React from 'react';
+import { type ViewProps } from 'react-native';
+import type { MixViewConfig } from '../core/keytype';
+export interface NativeMixViewProps extends ViewProps, Partial<MixViewConfig> {
+    children?: React.ReactNode;
+    /**
+     * Capture mode determines when to capture bitmap for mixing:
+     *
+     * - 'onchange': Capture only when view layout/content changes (DEFAULT)
+     *   Best for: static UI elements, text, static images
+     *   Performance: Optimal - minimal CPU usage
+     *
+     * - 'realtime': Capture at streaming framerate (e.g., 30fps)
+     *   Best for: WebView animations, GIF images, custom animations
+     *   Performance: Higher CPU usage but smooth animation
+     *
+     * - 'manual': User controls capture timing via ref methods
+     *   Best for: Custom scenarios where you want full control
+     *   Performance: Depends on user implementation
+     *
+     * - 'auto': Automatically detect based on content behavior (experimental)
+     *   Monitors view changes and switches between onchange/realtime
+     */
+    captureMode?: 'onchange' | 'realtime' | 'manual' | 'auto';
+    /**
+     * For realtime mode: custom framerate (default uses stream framerate)
+     */
+    captureFramerate?: number;
+    /**
+     * For auto mode: sensitivity threshold for switching to realtime
+     * Higher values = less sensitive to changes
+     */
+    autoSensitivity?: number;
+}
+export interface MixViewEventProps {
+    /**
+     * viewId, if not provided, will be generated automatically
+     */
+    viewId?: string;
+    /**
+     * onViewMount, called when the view is mounted
+     */
+    onViewMount?: (viewId: string) => void;
+    /**
+     * onViewUnmount, called when the view is unmounted
+     */
+    onViewUnmount?: (viewId: string) => void;
+}
+export interface MixViewProps extends MixViewEventProps, NativeMixViewProps {
+}
+export declare const NativeMixView: import("react-native").HostComponent<MixViewProps>;
+export declare const MixView: React.ForwardRefExoticComponent<MixViewProps & React.RefAttributes<any>>;

package/lib/typescript/view/VeImageView.d.ts

@@ -0,0 +1,19 @@
+import React from 'react';
+import { Image, type ImageProps } from 'react-native';
+import type { MixViewConfig } from '../core/keytype';
+import { type MixViewEventProps, type MixViewProps } from './MixView';
+export interface VeImageViewProps extends MixViewEventProps, ImageProps, Partial<MixViewConfig> {
+    children?: React.ReactNode;
+    /**
+     * Whether the image is animated (GIF, WebP, etc.)
+     * If true, will automatically use 'realtime' capture mode
+     */
+    animated?: boolean;
+    /**
+     * Override capture mode
+     * - If not specified and animated=true, uses 'realtime'
+     * - If not specified and animated=false/undefined, uses 'onchange'
+     */
+    captureMode?: MixViewProps['captureMode'];
+}
+export declare const VeImageView: React.ForwardRefExoticComponent<VeImageViewProps & React.RefAttributes<Image>>;

package/lib/typescript/view/VeTextView.d.ts

@@ -0,0 +1,7 @@
+import React from 'react';
+import { Text, type TextProps } from 'react-native';
+import type { MixViewConfig } from '../core/keytype';
+import { type MixViewEventProps } from './MixView';
+export interface VeTextViewProps extends MixViewEventProps, TextProps, MixViewConfig {
+}
+export declare const VeTextView: React.ForwardRefExoticComponent<VeTextViewProps & React.RefAttributes<Text>>;

package/lib/typescript/view/VeView.d.ts

@@ -0,0 +1,7 @@
+import React from 'react';
+import { View, type ViewProps } from 'react-native';
+import type { MixViewConfig } from '../core/keytype';
+import { type MixViewEventProps } from './MixView';
+export interface VeViewProps extends MixViewEventProps, ViewProps, MixViewConfig {
+}
+export declare const VeView: React.ForwardRefExoticComponent<VeViewProps & React.RefAttributes<View>>;

package/lib/typescript/view/VeWebView.d.ts

@@ -0,0 +1,7 @@
+import React from 'react';
+import { View, type ViewProps } from 'react-native';
+import type { MixViewConfig } from '../core/keytype';
+import { type MixViewEventProps } from './MixView';
+export interface VeWebViewProps extends MixViewEventProps, ViewProps, MixViewConfig {
+}
+export declare const VeWebView: React.ForwardRefExoticComponent<VeWebViewProps & React.RefAttributes<View>>;

package/lib/typescript/view/index.d.ts

@@ -0,0 +1,5 @@
+export { VeView, type VeViewProps } from './VeView';
+export { VeTextView, type VeTextViewProps } from './VeTextView';
+export { VeImageView, type VeImageViewProps } from './VeImageView';
+export { VeWebView, type VeWebViewProps } from './VeWebView';
+export { MixView, NativeMixView, type MixViewProps } from './MixView';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@volcengine/react-native-live-push",
-  "version": "1.1.3-rc.1",
+  "version": "1.2.0-rc.0",
   "peerDependencies": {
     "react": "*",
     "react-native": "*"

package/react-native-velive-push.podspec

@@ -49,7 +49,7 @@ Pod::Spec.new do |s|
     end
   end
   
-  s.dependency 'VolcApiEngine', '1.2.3'   
-  s.dependency 'TTSDKFramework/Core', '1.41.3.7-premium'
-  s.dependency 'TTSDKFramework/LivePush-RTS', '1.41.3.7-premium'
+  s.dependency 'VolcApiEngine', '1.6.2'
+  s.dependency 'TTSDKFramework/Core', '1.46.3.9-premium'
+  s.dependency 'TTSDKFramework/LivePush-RTS', '1.46.3.9-premium'
 end

package/android/src/main/java/com/volcengine/velive/rn/push/ScreenCaptureHelper.java

@@ -1,73 +0,0 @@
-package com.volcengine.velive.rn.push;
-
-import static android.content.Context.MEDIA_PROJECTION_SERVICE;
-
-import static com.volcengine.VolcApiEngine.runtime.NativeVariableManager.*;
-
-import android.app.Activity;
-import android.content.Intent;
-import android.media.projection.MediaProjectionManager;
-
-import androidx.annotation.NonNull;
-import androidx.annotation.Nullable;
-import androidx.appcompat.app.AppCompatActivity;
-
-import com.facebook.react.bridge.ActivityEventListener;
-import com.facebook.react.bridge.ReactApplicationContext;
-
-public class ScreenCaptureHelper {
-  static final int SCREEN_RECORD_REQUEST_CODE = 1010;
-  
-  private final ReactApplicationContext reactApplicationContext;
-  
-  private AsyncVariableGetterCallback<Intent> mCallback;
-
-  ScreenCaptureHelper(ReactApplicationContext reactApplicationContext) {
-    this.reactApplicationContext = reactApplicationContext;
-  }
-
-  ReactApplicationContext getReactApplicationContext() {
-    return this.reactApplicationContext;
-  }
-  
-  public void setup() {
-    getReactApplicationContext().addActivityEventListener(new ActivityEventListener() {
-      @Override
-      public void onActivityResult(Activity activity, int requestCode, int resultCode, @Nullable Intent intent) {
-        if (requestCode != SCREEN_RECORD_REQUEST_CODE) {
-          return;
-        }
-
-        // success
-        if (resultCode == AppCompatActivity.RESULT_OK) {
-          if (mCallback != null) {
-            mCallback.resolve(null, intent);
-            mCallback = null;
-          }
-          return;
-        } 
-        
-        // error        
-        if (mCallback != null) {
-          mCallback.resolve(new Exception("permission error"), null);
-          mCallback = null;
-        }
-      }
-
-      @Override
-      public void onNewIntent(Intent intent) {
-      }
-    });
-  }
-
-  public void getScreenIntent(Object[] args, @NonNull AsyncVariableGetterCallback cb) {
-    this.mCallback = cb;
-    this.requestPermission();
-  }
-  
-  private void requestPermission() {
-    MediaProjectionManager mediaProjectionManager = (MediaProjectionManager) getReactApplicationContext().getSystemService(MEDIA_PROJECTION_SERVICE);
-    Intent permissionIntent =  mediaProjectionManager.createScreenCaptureIntent();
-    getReactApplicationContext().getCurrentActivity().startActivityForResult(permissionIntent, SCREEN_RECORD_REQUEST_CODE);
-  }
-}