juggleim-rnsdk 0.1.6 → 0.1.9

package/src/call/CallConst.ts

@@ -0,0 +1,43 @@
+
+export enum CallStatus {
+    IDLE = 0,
+    INCOMING = 1,
+    OUTGOING = 2,
+    CONNECTING = 3,
+    CONNECTED = 4,
+    JOIN = 5,
+}
+
+export enum CallMediaType {
+    VOICE = 0,
+    VIDEO = 1,
+}
+
+export enum CallFinishReason {
+    UNKNOWN = 0,
+    HANGUP = 1,
+    DECLINE = 2,
+    BUSY = 3,
+    NO_RESPONSE = 4,
+    CANCEL = 5,
+    OTHER_SIDE_HANGUP = 6,
+    OTHER_SIDE_DECLINE = 7,
+    OTHER_SIDE_BUSY = 8,
+    OTHER_SIDE_NO_RESPONSE = 9,
+    OTHER_SIDE_CANCEL = 10,
+    ROOM_DESTROY = 11,
+    NETWORK_ERROR = 12,
+    ACCEPT_ON_OTHER_CLIENT = 13,
+    HANGUP_ON_OTHER_CLIENT = 14,
+}
+
+export enum CallErrorCode {
+    SUCCESS = 0,
+    CALL_EXIST = 1,
+    CANT_ACCEPT_WHILE_NOT_INVITED = 2,
+    ACCEPT_FAIL = 3,
+    JOIN_MEDIA_ROOM_FAIL = 4,
+    INVALID_PARAMETER = 5,
+    INVITE_FAIL = 6,
+    JOIN_ROOM_FAIL = 7,
+}

package/src/call/CallInfo.ts

@@ -0,0 +1,13 @@
+
+import { UserInfo } from '../index';
+import { CallMediaType } from './CallConst';
+import { CallMember } from './CallMember';
+
+export interface CallInfo {
+    callId: string;
+    isMultiCall: boolean;
+    mediaType: CallMediaType;
+    owner: UserInfo;
+    members: CallMember[];
+    extra: string;
+}

package/src/call/CallMember.ts

@@ -0,0 +1,12 @@
+
+import { UserInfo } from '../index';
+import { CallStatus } from './CallConst';
+
+export interface CallMember {
+    userInfo: UserInfo;
+    callStatus: CallStatus;
+    startTime: number;
+    connectTime: number;
+    finishTime: number;
+    inviter: UserInfo;
+}

package/src/call/CallSession.ts

@@ -0,0 +1,186 @@
+
+import { NativeModules, NativeEventEmitter, findNodeHandle, Component, Platform } from 'react-native';
+import { request, PERMISSIONS, RESULTS } from 'react-native-permissions';
+import { CallStatus, CallMediaType, CallFinishReason, CallErrorCode } from './CallConst';
+import { CallMember } from './CallMember';
+
+const { JuggleIMCallModule } = NativeModules;
+const eventEmitter = new NativeEventEmitter(JuggleIMCallModule);
+
+export interface CallVideoDenoiseParams {
+    // Add properties as needed
+}
+
+export interface CallSessionListener {
+    onCallConnect?(): void;
+    onCallFinish?(finishReason: CallFinishReason): void;
+    onErrorOccur?(errorCode: CallErrorCode): void;
+    onUsersInvite?(inviterId: string, userIdList: string[]): void;
+    onUsersConnect?(userIdList: string[]): void;
+    onUsersLeave?(userIdList: string[]): void;
+    onUserCameraEnable?(userId: string, enable: boolean): void;
+    onUserMicrophoneEnable?(userId: string, enable: boolean): void;
+    onSoundLevelUpdate?(soundLevels: { [userId: string]: number }): void;
+    onVideoFirstFrameRender?(userId: string): void;
+}
+
+export class CallSession {
+    callId: string;
+    isMultiCall: boolean;
+    mediaType: CallMediaType;
+    callStatus: CallStatus;
+    startTime: number;
+    connectTime: number;
+    finishTime: number;
+    owner: string;
+    inviter: string;
+    finishReason: CallFinishReason;
+    members: CallMember[];
+    currentMember: CallMember;
+    extra: string;
+
+    constructor(props: any) {
+        this.callId = props.callId;
+        this.isMultiCall = props.isMultiCall;
+        this.mediaType = props.mediaType;
+        this.callStatus = props.callStatus;
+        this.startTime = props.startTime;
+        this.connectTime = props.connectTime;
+        this.finishTime = props.finishTime;
+        this.owner = props.owner;
+        this.inviter = props.inviter;
+        this.finishReason = props.finishReason;
+        this.members = props.members;
+        this.currentMember = props.currentMember;
+        this.extra = props.extra;
+    }
+
+    addListener(listener: CallSessionListener): () => void {
+        const key = `CallSession_${this.callId}_${Date.now()}`;
+        JuggleIMCallModule.addSessionListener(this.callId, key);
+
+        // Using a simpler event listening approach might be needed if multiple listeners are attached.
+        // Ideally we filter events by callId
+        const subscriptions = [
+            eventEmitter.addListener('CallSession_onCallConnect', (event) => {
+                console.log('CallSession_onCallConnect', event);
+                if (event.callId === this.callId && listener.onCallConnect) listener.onCallConnect();
+            }),
+            eventEmitter.addListener('CallSession_onCallFinish', (event) => {
+                console.log('CallSession_onCallFinish', event);
+                if (event.callId === this.callId && listener.onCallFinish) listener.onCallFinish(event.finishReason);
+            }),
+            eventEmitter.addListener('CallSession_onErrorOccur', (event) => {
+                console.log('CallSession_onErrorOccur', event);
+                if (event.callId === this.callId && listener.onErrorOccur) listener.onErrorOccur(event.errorCode);
+            }),
+            eventEmitter.addListener('CallSession_onUsersInvite', (event) => {
+                console.log('CallSession_onUsersInvite', event);
+                if (event.callId === this.callId && listener.onUsersInvite) listener.onUsersInvite(event.inviterId, event.userIdList);
+            }),
+            eventEmitter.addListener('CallSession_onUsersConnect', (event) => {
+                console.log('CallSession_onUsersConnect', event);
+                if (event.callId === this.callId && listener.onUsersConnect) listener.onUsersConnect(event.userIdList);
+            }),
+            eventEmitter.addListener('CallSession_onUsersLeave', (event) => {
+                console.log('CallSession_onUsersLeave', event);
+                if (event.callId === this.callId && listener.onUsersLeave) listener.onUsersLeave(event.userIdList);
+            }),
+            eventEmitter.addListener('CallSession_onUserCameraEnable', (event) => {
+                console.log('CallSession_onUserCameraEnable', event);
+                if (event.callId === this.callId && listener.onUserCameraEnable) listener.onUserCameraEnable(event.userId, event.enable);
+            }),
+            eventEmitter.addListener('CallSession_onUserMicrophoneEnable', (event) => {
+                console.log('CallSession_onUserMicrophoneEnable', event);
+                if (event.callId === this.callId && listener.onUserMicrophoneEnable) listener.onUserMicrophoneEnable(event.userId, event.enable);
+            }),
+            eventEmitter.addListener('CallSession_onSoundLevelUpdate', (event) => {
+                if (event.callId === this.callId && listener.onSoundLevelUpdate) listener.onSoundLevelUpdate(event.soundLevels);
+            }),
+            eventEmitter.addListener('CallSession_onVideoFirstFrameRender', (event) => {
+                console.log('CallSession_onVideoFirstFrameRender', event);
+                if (event.callId === this.callId && listener.onVideoFirstFrameRender) listener.onVideoFirstFrameRender(event.userId);
+            }),
+        ];
+
+        return () => {
+            subscriptions.forEach(sub => sub.remove());
+            JuggleIMCallModule.removeSessionListener(this.callId, key);
+        };
+    }
+
+    accept() {
+        JuggleIMCallModule.accept(this.callId);
+    }
+
+    hangup() {
+        JuggleIMCallModule.hangup(this.callId);
+    }
+
+    enableCamera(enable: boolean) {
+        JuggleIMCallModule.enableCamera(this.callId, enable);
+    }
+
+    muteMicrophone(mute: boolean) {
+        JuggleIMCallModule.muteMicrophone(this.callId, mute);
+    }
+
+    muteSpeaker(mute: boolean) {
+        JuggleIMCallModule.muteSpeaker(this.callId, mute);
+    }
+
+    setSpeakerEnable(enable: boolean) {
+        JuggleIMCallModule.setSpeakerEnable(this.callId, enable);
+    }
+
+    useFrontCamera(enable: boolean) {
+        JuggleIMCallModule.useFrontCamera(this.callId, enable);
+    }
+
+    inviteUsers(userIdList: string[]) {
+        JuggleIMCallModule.inviteUsers(this.callId, userIdList);
+    }
+
+    enableAEC(enable: boolean) {
+        JuggleIMCallModule.enableAEC(this.callId, enable);
+    }
+
+    setVideoDenoiseParams(params: CallVideoDenoiseParams) {
+        JuggleIMCallModule.setVideoDenoiseParams(this.callId, params);
+    }
+
+    setVideoView(userId: string, view: Component | null): Promise<void> {
+        return JuggleIMCallModule.setVideoView(this.callId, userId, view);
+    }
+
+    async startPreview(view: Component | null): Promise<void> {
+        console.log('startPreview', this.callId, this.mediaType, Platform.OS, view);
+        try {
+            if (this.mediaType === CallMediaType.VIDEO) {
+                const cameraPerm = Platform.OS === 'ios' ? PERMISSIONS.IOS.CAMERA : PERMISSIONS.ANDROID.CAMERA;
+                const micPerm = Platform.OS === 'ios' ? PERMISSIONS.IOS.MICROPHONE : PERMISSIONS.ANDROID.RECORD_AUDIO;
+                const camRes = await request(cameraPerm);
+                const micRes = await request(micPerm);
+                console.log('startPreview', this.callId, this.mediaType, Platform.OS, camRes, micRes);
+                if (camRes !== RESULTS.GRANTED || micRes !== RESULTS.GRANTED) {
+                    console.warn('Camera or microphone permission not granted', camRes, micRes);
+                    return Promise.reject('Camera or microphone permission not granted');
+                }
+            } else if (this.mediaType === CallMediaType.VOICE) {
+                const micPerm = Platform.OS === 'ios' ? PERMISSIONS.IOS.MICROPHONE : PERMISSIONS.ANDROID.RECORD_AUDIO;
+                const micRes = await request(micPerm);
+                if (micRes !== RESULTS.GRANTED) {
+                    console.warn('Microphone permission not granted', micRes);
+                    return Promise.reject('Microphone permission not granted');
+                }
+            } else {
+                return Promise.reject('Unsupported media type');
+            }
+        } catch (e) {
+            console.warn('Permission request error', e);
+            return Promise.reject(e);
+        }
+
+        return JuggleIMCallModule.startPreview(this.callId, view);
+    }
+}

package/src/call/JuggleIMCall.ts

@@ -0,0 +1,136 @@
+
+import { NativeModules, NativeEventEmitter } from 'react-native';
+import { CallSession } from './CallSession';
+import { CallMediaType } from './CallConst';
+import { CallInfo } from './CallInfo';
+import { Conversation } from '../types';
+
+const { JuggleIMCallModule } = NativeModules;
+const eventEmitter = new NativeEventEmitter(JuggleIMCallModule);
+
+export interface CallReceiveListener {
+    /**
+     * 收到通话请求的回调
+     * @param callSession 通话会话对象
+     */
+    onCallReceive(callSession: CallSession): void;
+}
+
+export interface ConversationCallListener {
+    /**
+     * 会话中通话信息更新的回调
+     * @param callInfo 通话信息
+     * @param conversation 所属会话
+     * @param isFinished 通话是否已结束
+     */
+    onCallInfoUpdate(callInfo: CallInfo, conversation: Conversation, isFinished: boolean): void;
+}
+
+export default class JuggleIMCall {
+    /**
+     * 初始化 Zego 引擎
+     * @param appId Zego App ID
+     */
+    static initZegoEngine(appId: number): void {
+        JuggleIMCallModule.initZegoEngine(appId);
+    }
+
+    /**
+     * 初始化 LiveKit 引擎
+     */
+    static initLiveKitEngine(): void {
+        JuggleIMCallModule.initLiveKitEngine();
+    }
+
+    /**
+     * 初始化 Agora 引擎
+     * @param appId Agora App ID
+     */
+    static initAgoraEngine(appId: string): void {
+        JuggleIMCallModule.initAgoraEngine(appId);
+    }
+
+    /**
+     * 发起单人通话
+     * @param userId 对方用户 ID
+     * @param mediaType 通话媒体类型 (音频/视频)
+     * @param extra 扩展信息
+     * @returns Promise<CallSession> 通话会话对象
+     */
+    static startSingleCall(userId: string, mediaType: CallMediaType, extra?: string): Promise<CallSession> {
+        return JuggleIMCallModule.startSingleCall(userId, mediaType, extra || "")
+            .then((session: any) => new CallSession(session));
+    }
+
+    /**
+     * 发起群组/多人通话
+     * @param userIdList 参与者用户 ID 列表
+     * @param mediaType 通话媒体类型 (音频/视频)
+     * @param extra 扩展信息
+     * @param conversation 关联的会话信息 (可选)
+     * @returns Promise<CallSession> 通话会话对象
+     */
+    static startMultiCall(userIdList: string[], mediaType: CallMediaType, extra?: string, conversation?: Conversation): Promise<CallSession> {
+        return JuggleIMCallModule.startMultiCall(userIdList, mediaType, extra || "", conversation)
+            .then((session: any) => new CallSession(session));
+    }
+
+    /**
+     * 加入通话
+     * @param callId 通话 ID
+     * @returns Promise<CallSession> 通话会话对象
+     */
+    static joinCall(callId: string): Promise<CallSession> {
+        return JuggleIMCallModule.joinCall(callId)
+            .then((session: any) => new CallSession(session));
+    }
+
+    /**
+     * 获取通话会话实例
+     * @param callId 通话 ID
+     * @returns Promise<CallSession | null> 通话会话对象，如果不存在则返回 null
+     */
+    static getCallSession(callId: string): Promise<CallSession | null> {
+        return JuggleIMCallModule.getCallSession(callId)
+            .then((session: any) => session ? new CallSession(session) : null);
+    }
+
+    /**
+     * 添加收到通话请求的监听器
+     * 在全局或者应用首页添加，用于处理收到的通话请求
+     * @param listener 监听器回调
+     * @returns 取消监听的函数
+     */
+    static addReceiveListener(listener: CallReceiveListener): () => void {
+        const key = `CallManager_Receive_${Date.now()}`;
+        JuggleIMCallModule.addReceiveListener(key);
+        const sub = eventEmitter.addListener('CallManager_onCallReceive', (event) => {
+            if (event.key === key) {
+                listener.onCallReceive(new CallSession(event.callSession));
+            }
+        });
+        return () => {
+            sub.remove();
+            JuggleIMCallModule.removeReceiveListener(key);
+        };
+    }
+
+    /**
+     * 添加会话通话信息监听器
+     * @param listener 监听器回调
+     * @returns 取消监听的函数
+     */
+    static addConversationCallListener(listener: ConversationCallListener): () => void {
+        const key = `CallManager_Conversation_${Date.now()}`;
+        JuggleIMCallModule.addConversationCallListener(key);
+        const sub = eventEmitter.addListener('CallManager_onCallInfoUpdate', (event) => {
+            if (event.key === key) {
+                listener.onCallInfoUpdate(event.callInfo, event.conversation, event.isFinished);
+            }
+        });
+        return () => {
+            sub.remove();
+            JuggleIMCallModule.removeConversationCallListener(key);
+        };
+    }
+}

package/src/call/ZegoSurfaceView.tsx

@@ -0,0 +1,24 @@
+
+import React from 'react';
+import {
+    requireNativeComponent,
+    ViewProps,
+    Platform,
+    View
+} from 'react-native';
+
+
+export interface SurfaceViewProps extends ViewProps {
+    zOrderMediaOverlay?: boolean;
+    zOrderOnTop?: boolean;
+}
+
+const ZegoSurfaceViewManager = Platform.select<React.ComponentType<SurfaceViewProps>>({
+    ios: requireNativeComponent<SurfaceViewProps>('ZegoSurfaceView'),
+    android: requireNativeComponent<SurfaceViewProps>('RCTZegoSurfaceView'),  // * android.view.SurfaceView
+})!;
+
+
+export const ZegoSurfaceView: React.FC<SurfaceViewProps> = (props) => {
+    return <ZegoSurfaceViewManager {...props} />;
+};

package/src/call/index.ts

@@ -0,0 +1,8 @@
+
+export * from './CallConst';
+export * from './CallInfo';
+export * from './CallMember';
+export * from './CallSession';
+import JuggleIMCall from './JuggleIMCall';
+export * from './ZegoSurfaceView';
+export { JuggleIMCall };