@byteplus/react-native-live-push 1.1.3-rc.0 → 1.1.3-rc.2

package/lib/typescript/codegen/pack/api.d.ts

@@ -1,7 +1,7 @@
 import * as $p_a from '../android/index';
 import * as $p_i from '../ios/index';
 import { VeLivePusherObserver, VeLivePusherStatisticsObserver, VeLiveFileRecordingListener, VeLiveVideoFrameFilter, VeLiveAudioFrameFilter, VeLiveVideoFrameListener, VeLiveAudioFrameListener, VeLiveSnapshotListener, VeLiveMediaPlayerListener, VeLiveMediaPlayerFrameListener } from './callback';
-import { VeLivePusherRenderMode, VeLiveVideoMirrorType, VeLiveVideoCaptureType, VeLiveAudioCaptureType, VeLiveOrientation, VeLivePusherLogLevel, VeLiveVideoEncoderConfiguration, VeLiveAudioEncoderConfiguration, VeLiveFileRecorderConfiguration, VeLiveVideoCaptureConfiguration, VeLiveVideoEffectLicenseConfiguration, VeLiveStreamMixDescription, VeLiveAudioBufferType, VeLiveAudioSampleRate, VeLiveAudioChannel } from './keytype';
+import { VeLivePusherRenderMode, VeLiveVideoMirrorType, VeLiveVideoCaptureType, VeLiveAudioCaptureType, VeLiveOrientation, VeLivePusherLogLevel, VeLiveVideoEncoderConfiguration, VeLiveAudioEncoderConfiguration, VeLiveFileRecorderConfiguration, VeLiveVideoCaptureConfiguration, VeLiveVideoEffectLicenseConfiguration, VeLiveAudioBufferType, VeLiveAudioSampleRate, VeLiveAudioChannel } from './keytype';
 import { View, Bitmap, Matrix, ByteBuffer } from './types';
 
 export declare class VeLivePusher {
@@ -482,16 +482,6 @@ export declare class VeLivePusher {
      */
     createPlayer(): VeLiveMediaPlayer;
     
-    /** {en}
-     * @detail api
-     * @brief Gets the audio and video mixer.
-     * @return  <br>
-     *      The audio and video mixer. See VeLiveMixerManager {@link #VeLiveMixerManager} for details.
-     * @order 51
-     *
-     */
-    getMixerManager(): VeLiveMixerManager;
-    
     /** {en}
      * @platform android
      * @detail api
@@ -1675,128 +1665,6 @@ export declare class VeLiveVideoEffectManager {
     ios_setAlgoModelPath(path: string): number;
 }
 
-export declare class VeLiveMixerManager {
-    protected _instance: any;
-    protected __init(...args: any[]): void;
-    protected __new_instance(...args: any[]): any;
-    
-    /** {en}
-     * @detail api
-     * @brief Adds a video stream to the mixer.
-     * @return  <br>
-     *     The video stream ID.
-     * @order 79
-     *
-     */
-    addVideoStream(): number;
-    
-    /** {en}
-     * @platform android
-     * @detail api
-     * @brief Adds an audio stream to the mixer.
-     * @return  <br>
-     *     The audio stream ID.
-     * @order 80
-     *
-     */
-    android_addAudioStream_type(type: $p_a.VeLiveAudioMixType): number;
-    
-    /** {en}
-     * @detail api
-     * @brief Gets the ID of the primary video stream.
-     * @order 83
-     *
-     */
-    getOriginVideoStream(): number;
-    
-    /** {en}
-     * @detail api
-     * @brief Gets the ID of the primary audio stream.
-     * @order 84
-     *
-     */
-    getOriginAudioStream(): number;
-    
-    /** {en}
-     * @platform android
-     * @detail api
-     * @brief Gets the ID of the primary screen stream.
-     * @order 85
-     *
-     */
-    android_getOriginScreenStream(): number;
-    
-    /** {en}
-     * @platform android
-     * @detail api
-     * @brief Gets the ID of the primary system audio stream.
-     * @order 86
-     *
-     */
-    android_getOriginSystemAudioStream(): number;
-    
-    /** {en}
-     * @detail api
-     * @brief Sends a custom video frame with a specified stream ID.
-     * @param frame The custom video frame. See VeLiveVideoFrame {@link #VeLiveVideoFrame} for details.
-     * @param streamId The ID of the video stream to mix.
-     * @order 87
-     *
-     */
-    sendCustomVideoFrame(frame: VeLiveVideoFrame, streamId: number): void;
-    
-    /** {en}
-     * @detail api
-     * @brief Sends a custom audio frame with a specified stream ID.
-     * @param frame The custom audio frame. See VeLiveAudioFrame {@link #VeLiveAudioFrame} for details.
-     * @param streamId The ID of the audio stream to mix.
-     * @order 88
-     *
-     */
-    sendCustomAudioFrame(frame: VeLiveAudioFrame, streamId: number): void;
-    
-    /** {en}
-     * @detail api
-     * @brief Updates the configurations for audio and video mixing.
-     * @param mixDescription The updated configurations for audio and video mixing. See VeLiveStreamMixDescription {@link #VeLiveStreamMixDescription} for details.
-     *
-     */
-    updateStreamMixDescription(mixDescription: VeLiveStreamMixDescription): void;
-    
-    /** {en}
-     * @detail api
-     * @brief Removes a non-primary video stream from the mixer.
-     * @param streamId The ID of the video stream to remove.
-     * @order 80
-     *
-     */
-    removeVideoStream(streamId: number): void;
-    
-    /** {en}
-     * @detail api
-     * @brief Removes a non-primary audio stream from the mixer.
-     * @param streamId The ID of the audio stream to remove.
-     * @order 82
-     *
-     */
-    removeAudioStream(streamId: number): void;
-    
-    /** {en}
-     * @platform ios
-     * @detail api
-     * @brief Sets the volume of a non-primary audio stream. If you set VeLiveAudioMixType{@link #VeLiveAudioMixType} to `VeLiveAudioMixPlayAndPush`, this method takes effect on both the host and the audience sides.
-     * @param streamId The audio stream ID.
-     * @param volume The audio volume. The value range is [0.0,4.0].
-     * @order 70
-     */
-    ios_setAudioStream(streamId: number, volume: number): void;
-    
-    /** {en}
-     * @platform ios
-     */
-    ios_getAppAudioStream(): number;
-}
-
 export declare class VeLiveAudioFrame {
     constructor();
     constructor(sampleRate: VeLiveAudioSampleRate, channel: VeLiveAudioChannel, pts: number, buffer: ByteBuffer);

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

@@ -1,2 +1,17 @@
-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, VeLiveAudioFrame, VeLiveCameraDevice, VeLiveMediaPlayer, VeLivePusher as _VeLivePusher, VeLivePusherConfiguration, VeLiveVideoEffectManager, VeLiveVideoFrame } from '../codegen/pack/api';
+import { VeLiveMixerManager } from './mixer';
+declare module '../codegen/pack/api' {
+    interface VeLivePusher {
+        
+        /** {en}
+         * @detail api
+         * @brief Gets the audio and video mixer.
+         * @return  <br>
+         *      The audio and video mixer. See VeLiveMixerManager {@link #VeLiveMixerManager} for details.
+         * @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,17 @@
 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;
+    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/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": "@byteplus/react-native-live-push",
-  "version": "1.1.3-rc.0",
+  "version": "1.1.3-rc.2",
   "peerDependencies": {
     "react": "*",
     "react-native": "*"