netender-web-sdk 1.0.0 → 1.0.1

package/dist/meeting-kit-lite/src/kit/interface/chatroom_manager.d.ts

@@ -0,0 +1,190 @@
+import { NEResult } from 'neroom-types';
+export type NERoomChatMessageType = 'text' | 'image' | 'audio' | 'video' | 'file' | 'geo' | 'custom' | 'tip' | 'notification';
+export interface Progress {
+    total?: string;
+    loaded?: string;
+    percentage: number;
+    percentageText?: string;
+}
+/**
+ * 房间内聊天消息
+ */
+export type NERoomChatMessage = {
+    /**
+     * 消息 id
+     */
+    messageUuid?: string;
+    /**
+     * 客户端类型
+     */
+    fromClientType: 'Android' | 'iOS' | 'PC' | 'Web' | 'Mac';
+    /**
+     * 消息类型
+     */
+    messageType: NERoomChatMessageType;
+    /**
+     * 发送端用户ID。如果为空字符串，则说明该用户可能未加入房间内。
+     */
+    fromUserUuid: string;
+    /**
+     * 发送端昵称
+     */
+    fromNick: string;
+    /**
+     * 接收端; 为空表示聊天室全体成员
+     */
+    toUserUuidList?: string[];
+    /**
+     * 消息时间戳
+     */
+    time: number;
+    /**
+     * 消息类型
+     */
+    type: string;
+    /**
+     * 文本内容
+     */
+    text: string;
+    /**
+     * 消息状态
+     */
+    status: string;
+    /**
+     * 附加信息
+     */
+    attach?: {
+        from: string;
+        fromNick: string;
+        type: string;
+        to: string[];
+        toNick: string[];
+        url: string;
+        name: string;
+        msgId: string;
+        msgTime: number;
+        id: number;
+        operator: string;
+    };
+    /**
+     * 消息来源
+     */
+    from: string;
+    /**
+     * 消息是否来自自己
+     */
+    isMe?: boolean;
+    /**
+     * 重发
+     */
+    resend?: boolean;
+    /**
+     * 客户端唯一ID
+     */
+    idClient: string;
+    /**
+     * 文件
+     */
+    file?: {
+        name: string;
+        ext: string;
+        size: number;
+        url: string;
+        filePath: string;
+        w: number;
+        h: number;
+    };
+    /**
+     * 自定义信息
+     */
+    custom?: string;
+    /**
+     * 0: 会内聊天室；1: 等候室
+     */
+    chatroomType?: number;
+    /**
+     *  临时文件，用于重发
+     */
+    tempFile?: File;
+    /**
+     * 是否是私聊
+     */
+    isPrivate?: boolean;
+    /**
+     * 发送给的昵称
+     */
+    toNickname?: string;
+    /**
+     * 头像
+     */
+    fromAvatar?: string;
+    progress: Progress;
+};
+export type NERoomChatMessageExt = {
+    url: string;
+    displayName: string;
+    size: number;
+    md5: string;
+    extension: string;
+    width: number;
+    height: number;
+    attachStr?: string;
+};
+export type FileEx = File & {
+    base64?: string;
+    url?: string;
+    filePath?: string;
+    height?: number;
+    width?: number;
+};
+export interface ChatroomManager {
+    /**
+     * 获取当前消息
+     */
+    getMessageList(): Promise<NEResult<NERoomChatMessage[]>>;
+    /**
+     * 获取历史消息
+     * @param meetingId 会议ID
+     */
+    fetchHistoryMessageList(meetingId?: number): Promise<NEResult<NERoomChatMessage[]>>;
+    /**
+     * 发送文本消息
+     * @param content 消息内容
+     * @param toUserUuids 私聊用户UUID（可选）
+     */
+    sendTextMessage(idClient: string, content: string, isWaitingRoom?: boolean, toUserUuids?: string[]): Promise<NEResult<NERoomChatMessage>>;
+    /**
+     * 发送文件图片消息
+     * @param type 文件类型
+     * @param file 文件对象
+     * @param toUserUuids 私聊用户UUID（可选）
+     */
+    sendFileMessage(idClient: string, type: 'image' | 'file', file: FileEx, isWaitingRoom?: boolean, toUserUuids?: string[]): Promise<NEResult<NERoomChatMessage>>;
+    /**
+     * 撤回消息
+     * @param messageId 消息ID
+     */
+    recallMessage(msg: NERoomChatMessage): Promise<NEResult<void>>;
+    /**
+     * 取消发送
+     * @param messageId 消息ID
+     */
+    cancelSendFileMessage(msg: NERoomChatMessage): Promise<NEResult<void>>;
+    /**
+     * 下载附件
+     * @param msg 消息
+     * @param path 保存路径
+     */
+    downloadAttachment(msg: NERoomChatMessage, path: string): Promise<NEResult<void>>;
+    /**
+     * 取消下载附件
+     * @param msg 消息
+     */
+    cancelDownloadAttachment(msg: NERoomChatMessage): Promise<NEResult<void>>;
+    /**
+     * 导出聊天历史
+     * @param meetingId 会议ID
+     */
+    exportChatroomHistoryMessageList(meetingId: string): Promise<NEResult<string>>;
+}
+export default ChatroomManager;

package/dist/meeting-kit-lite/src/kit/interface/interpretation_manager.d.ts

@@ -0,0 +1,61 @@
+import { NEMeetingInterpreter } from '../../types';
+import { NEResult } from 'neroom-types';
+export interface NEInterpretationInfo {
+    started: boolean;
+    interpreters: Record<string, {
+        language: string;
+        name: string;
+    }>;
+    channels: Record<string, {
+        language: string;
+        name: string;
+    }>;
+}
+export interface NEInterpretationLanguage {
+    languageCode: string;
+    languageName: string;
+    isDefault?: boolean;
+}
+export interface InterpretationManager {
+    /**
+     * 开始/更新同声传译
+     * @param config 传译配置
+     */
+    startInterpretation(data: {
+        interpreters?: NEMeetingInterpreter[];
+    }): Promise<NEResult<void>>;
+    /**
+     * 关闭同声传译
+     */
+    stopInterpretation(): Promise<void>;
+    /**
+     * 获取同传信息
+     */
+    getInterpretation(): NEInterpretationInfo | undefined;
+    /**
+     * 是否正在同声传译
+     */
+    isInterpretationStarted(): boolean;
+    /**
+     * 本端是否为译员
+     */
+    isMySelfInterpreter(): boolean;
+    /**
+     * 调整原声音音量
+     * @param volume 音量值 (0-100)
+     */
+    adjustChannelPlaybackSignalVolume(volume?: number): void;
+    /**
+     * 静音主频道
+     * @param mute 是否静音
+     * @param volume 音量值 (0-100)
+     */
+    muteMajorAudio(mute: boolean, volume?: number): void;
+    /**
+     * 同时收听原声
+     * @param enable 是否启用
+     * @param majorVolume 音量值 (0-100)
+     */
+    listenToOriginalAudio(enable: boolean, majorVolume?: number): Promise<void>;
+}
+export default InterpretationManager;

package/dist/meeting-kit-lite/src/kit/interface/invite_manager.d.ts

@@ -0,0 +1,77 @@
+import { NEMember, NEESearchAccountInfo, NEAccountInfoListResponse } from '../../types';
+import { NEResult, NERoomSipCallResponse, NERoomSystemDevice } from 'neroom-types';
+export interface InviteInfo {
+    meetingNum: string;
+    meetingId: number;
+    subject: string;
+    password?: string;
+    inviteUrl: string;
+    shortInviteUrl: string;
+}
+export interface ContactInfo {
+    userUuid: string;
+    nickname: string;
+    avatar?: string;
+}
+export interface InviteManager {
+    /**
+     * 获取邀请中成员列表
+     */
+    getInInvitingMemberList(): NEMember[];
+    /**
+     * 根据昵称获取通讯录列表
+     * @param name 昵称关键词
+     */
+    searchContactListByName(name: string): Promise<NEESearchAccountInfo[]>;
+    /**
+     * 通讯录邀请
+     * @param userUuids 用户UUID列表
+     */
+    inviteByUserUuids(userUuids: string[]): Promise<NEResult<null>>;
+    /**
+     * 获取账号信息列表
+     * @param userUuids 用户UUID列表
+     */
+    getAccountInfoList(userUuids: string[]): Promise<NEAccountInfoListResponse>;
+    /**
+     * 根据手机号获取账号信息
+     * @param phone 手机号
+     */
+    searchAccountInfoByPhone(phone: string): Promise<NEESearchAccountInfo[]>;
+    /**
+     * 拨号呼叫
+     * @param number 电话号码
+     */
+    callByPhoneNumber(phoneNumber: string, countryCode: string, name?: string): Promise<NEResult<NERoomSipCallResponse> | undefined>;
+    /**
+     * 批量拨号呼叫
+     * @param userUuids 用户UUID列表
+     */
+    callByUserUuids(userUuids: string[]): Promise<NEResult<null>>;
+    /**
+     * 内部重新呼叫
+     * @param userUuid 用户UUID
+     */
+    callByUserUuid(userUuid: string): Promise<NEResult<null>>;
+    /**
+     * 会议室呼叫
+     * @param roomNumber 会议室号码
+     */
+    callOutRoomSystem(device: NERoomSystemDevice): Promise<NEResult<NERoomSipCallResponse>>;
+    /**
+     * 移除呼叫
+     * @param userUuid 呼叫ID
+     */
+    removeCall(userUuid: string): Promise<NEResult<null>>;
+    /**
+     * 取消呼叫
+     * @param userUuid 呼叫ID
+     */
+    cancelCall(userUuid: string): Promise<NEResult<null>>;
+    /**
+     * 挂断通话
+     * @param userUuid 呼叫ID
+     */
+    hangUpCall(userUuid: string): Promise<NEResult<null>>;
+}
+export default InviteManager;

package/dist/meeting-kit-lite/src/kit/interface/meeting_kit.d.ts

@@ -0,0 +1,143 @@
+import { NEGlobalEventListener, NERoomWhiteboardAppConfig, NEServerConfig, NEResult, Roomkit, NEIMServerConfig, NERtcServerConfig, NEWhiteboardServerConfig } from 'neroom-types';
+import { IM, NEMeetingAppNoticeTips, NEMeetingLanguage } from '../../types/type';
+import AccountManager from './account_manager';
+import MeetingManager from './meeting_manager';
+import AudioManager from './audio_manager';
+import VideoManager from './video_manager';
+import SecurityManager from './security_manager';
+import InviteManager from './invite_manager';
+import MemberManager from './member_manager';
+import ChatroomManager from './chatroom_manager';
+import ScreenShareManager from './screen_share_manager';
+import WhiteboardManager from './whiteboard_manager';
+import AnnotationManager from './annotation_manager';
+import RecordManager from './record_manager';
+import PluginManager from './plugin_manager';
+import NotificationManager from './notification_manager';
+import TranscriptionManager from './transcription_manager';
+import InterpretationManager from './interpretation_manager';
+import BreakoutManager from './breakout_manager';
+import QualityMonitorManager from './quality_monitor_manager';
+import { NEProps, PreMeetingManager } from '..';
+import { LogDebug } from '../../utils/logDebug';
+export type NEMeetingKitServerConfig = NEServerConfig;
+export type { NEMeetingLanguage };
+export type ExceptionHandler = {
+    onError: (code: number) => void;
+};
+export declare enum NEMeetingThemeType {
+    /**
+     * 跟随系统主题
+     */
+    SYSTEM = 0,
+    /**
+     * 浅色主题
+     */
+    LIGHT = 1,
+    /**
+     * 深色主题
+     */
+    DARK = 2
+}
+export type NEMeetingKitConfig = {
+    /**
+     * roomkit
+     */
+    roomkit: Roomkit;
+    domain?: string;
+};
+export type NEMeetingKitInitConfig = {
+    /**
+     * 是否开启日志打印(默认为true)
+     */
+    debug?: boolean;
+    /**
+     * 国际化语言
+     */
+    locale?: string;
+    /**
+     * 是否开启日志上(报默认为true)
+     */
+    eventTracking?: boolean;
+    /**
+     * 会议appKey
+     */
+    appKey: string;
+    /**
+     * IM私有化配置仅限于私有化配置时使用
+     */
+    imPrivateConf?: NEIMServerConfig;
+    /**
+     * G2 私有化配置仅私有化配置使用
+     */
+    neRtcServerAddresses?: NERtcServerConfig;
+    /**
+     * 白板私有化配置使用
+     */
+    whiteboardConfig?: NEWhiteboardServerConfig;
+    /**
+     * @ignore
+     */
+    globalEventListener?: Record<string, NEProps>;
+    /**
+     * @ignore
+     */
+    im?: IM;
+    /**
+     * 私有化配置使用，如果配置该字段则会从服务端对应接口拉取配置文件。但是优先级低于其他私有化配置字段，如果配置过其他字段则该配置不生效
+     */
+    serverUrl?: string;
+    /**
+     * 扩展字段
+     */
+    extras?: Record<string, NEProps>;
+    /**
+     * 是否读取私有化配置文件
+     */
+    useAssetServerConfig?: boolean;
+    /**
+     * 白板防盗链配置
+     */
+    whiteboardAppConfig?: NERoomWhiteboardAppConfig;
+    serverConfig?: NEServerConfig;
+    logger?: LogDebug;
+};
+interface NEMeetingKit {
+    readonly isInitialized: boolean;
+    /**
+     * 初始化
+     * @param config 配置信息
+     */
+    initialize(config: NEMeetingKitInitConfig): Promise<NEResult<void>>;
+    /**
+     * 反初始化
+     */
+    unInitialize(): Promise<NEResult<void>>;
+    getAccountManager(): AccountManager | undefined;
+    getMeetingManager(): MeetingManager | undefined;
+    getAudioManager(): AudioManager | undefined;
+    getVideoManager(): VideoManager | undefined;
+    getSecurityManager(): SecurityManager | undefined;
+    getInviteManager(): InviteManager | undefined;
+    getMemberManager(): MemberManager | undefined;
+    getChatroomManager(): ChatroomManager | undefined;
+    getScreenShareManager(): ScreenShareManager | undefined;
+    getWhiteboardManager(): WhiteboardManager | undefined;
+    getAnnotationManager(): AnnotationManager | undefined;
+    getRecordManager(): RecordManager | undefined;
+    getPluginManager(): PluginManager | undefined;
+    getNotificationManager(): NotificationManager | undefined;
+    getTranscriptionManager(): TranscriptionManager | undefined;
+    getInterpretationManager(): InterpretationManager | undefined;
+    getBreakoutManager(): BreakoutManager | undefined;
+    getQualityMonitorManager(): QualityMonitorManager | undefined;
+    getPreMeetingManager(): PreMeetingManager | undefined;
+    addGlobalEventListener: (listener: NEGlobalEventListener) => void;
+    removeGlobalEventListener: (listener: NEGlobalEventListener) => void;
+    getSDKLogPath(): Promise<NEResult<string>>;
+    getAppNoticeTips(): Promise<NEResult<NEMeetingAppNoticeTips>>;
+    setExceptionHandler(handler: ExceptionHandler): void;
+    startMarvel(): Promise<NEResult<void>>;
+    checkSystemRequirements(): boolean | undefined;
+}
+export default NEMeetingKit;

package/dist/meeting-kit-lite/src/kit/interface/meeting_manager.d.ts

@@ -0,0 +1,91 @@
+import { NERoomContext, NERoomListener, NEStatsListener, NEResult, NEMessageChannelListener } from 'neroom-types';
+import { NEMeetingCreateOptions, NEMeetingJoinOptions, NEMeetingConfig } from '../../types/type';
+import { NEMeetingSDKInfo } from '../../types';
+export interface MeetingManager {
+    /**
+     * 创建房间
+     * @param options 创建会议选项
+     */
+    createMeeting(options: NEMeetingCreateOptions): Promise<void>;
+    roomContext: NERoomContext | null;
+    /**
+     * 加入房间
+     * @param options 加入会议选项
+     */
+    joinMeeting(options: NEMeetingJoinOptions): Promise<void>;
+    /**
+     * 重新加入房间(被准入后重新加入房间)
+     */
+    rejoinAfterAdmittedToRoom(): Promise<void>;
+    /**
+     * 通过邀请加入房间
+     * @param options 加入会议选项
+     */
+    joinMeetingByAInvite(options: NEMeetingJoinOptions): Promise<void>;
+    /**
+     * 匿名加入房间
+     * @param options 加入会议选项
+     */
+    anonymousJoinMeeting(options: NEMeetingJoinOptions): Promise<NEResult<void>>;
+    /**
+     * 获取全局配置
+     */
+    getGlobalConfig(): Promise<NEMeetingConfig>;
+    /**
+     * 离开房间
+     * @param closeIfHost 是否结束会议
+     */
+    leaveMeeting(closeIfHost: boolean): Promise<void>;
+    /**
+     * 结束房间
+     */
+    endMeeting(): Promise<void>;
+    /**
+     * 获取应用信息
+     */
+    getAppInfo(): Promise<{
+        appName: string;
+    }>;
+    /**
+     * 获取会议信息
+     */
+    getMeetingInfo(): NEMeetingSDKInfo | null;
+    /**
+     * 获取是否允许成员使用字幕
+     */
+    getIsAllowParticipantsEnableCaption(): boolean;
+    /**
+     * 添加会议事件监听器
+     * @param listener 监听器
+     */
+    addMeetingListener(listener: NERoomListener): void;
+    /**
+     * 移除会议事件监听器
+     * @param listener 监听器
+     */
+    removeMeetingListener(listener?: NERoomListener): void;
+    /**
+     * 获取房间监Rtc听器
+     */
+    addRtcStatsListener(listener: NEStatsListener): void;
+    /**
+     * 移除房间Rtc监听器
+     * @param listener 监听器
+     */
+    removeRtcStatsListener(listener: NEStatsListener): void;
+    /**
+     * 添加自定义透传消息监听
+     * @param listener 消息监听器
+     */
+    addMessageChannelListener(listener: NEMessageChannelListener): void;
+    /**
+     * 移除自定义透传消息监听
+     * @param listener 消息监听器
+     */
+    removeMessageChannelListener(listener: NEMessageChannelListener): void;
+    /**
+     * 释放会议资源，监听到离开或者结束会议事件后需调用
+     */
+    releaseMeeting(): void;
+}
+export default MeetingManager;

package/dist/meeting-kit-lite/src/kit/interface/member_manager.d.ts

@@ -0,0 +1,125 @@
+import { NEMember, Role } from '../../types';
+import { NEResult } from 'neroom-types';
+export interface MemberInfo {
+    userUuid: string;
+    nickname: string;
+    avatar?: string;
+    role: 'host' | 'coHost' | 'attendee';
+    isAudioMuted: boolean;
+    isVideoMuted: boolean;
+    isScreenSharing: boolean;
+    isWhiteboardSharing: boolean;
+    isInWaitingRoom: boolean;
+    isFocus: boolean;
+}
+export interface MemberManager {
+    /**
+     * 获取成员列表
+     */
+    getMemberList(): NEMember[];
+    /**
+     * 改名
+     * @param userUuid 用户UUID
+     * @param nickName 新名称
+     */
+    changeMemberName(params: {
+        userUuid?: string;
+        nickName: string;
+    }): Promise<NEResult<null>>;
+    /**
+     * 静音
+     * @param userUuid 用户UUID
+     */
+    muteMemberAudio(userUuid: string): Promise<NEResult<void>>;
+    /**
+     * 关闭视频
+     * @param userUuid 用户UUID
+     */
+    muteMemberVideo(userUuid: string): Promise<NEResult<void>>;
+    /**
+     * 解除静音
+     * @param userUuid 用户UUID
+     */
+    unmuteMemberAudio(userUuid: string): Promise<NEResult<void>>;
+    /**
+     * 开启视频
+     * @param userUuid 用户UUID
+     */
+    unmuteMemberVideo(userUuid: string): Promise<NEResult<void>>;
+    /**
+     * 关闭音视频
+     * @param userUuid 用户UUID
+     */
+    muteVideoAndAudio(userUuid: string): Promise<NEResult<void>>;
+    /**
+     * 开启音视频
+     * @param userUuid 用户UUID
+     */
+    unmuteVideoAndAudio(userUuid: string): Promise<NEResult<void>>;
+    /**
+     * 设置焦点视频
+     * @param userUuid 用户UUID
+     */
+    setFocus(userUuid: string): Promise<NEResult<void>>;
+    /**
+     * 取消设置焦点
+     */
+    unsetFocus(): Promise<NEResult<void>>;
+    /**
+     * 移交主持人
+     * @param userUuid 用户UUID
+     */
+    handOverMyRole(userUuid: string, resign?: boolean): Promise<NEResult<void>>;
+    /**
+     * 设置/取消联席主持人
+     * @param userUuid 用户UUID
+     * @param role 角色
+     */
+    changeMemberRole(userUuid: string, role: Role): Promise<NEResult<void>>;
+    /**
+     * 移除成员
+     * @param userUuid 用户UUID
+     * @param toBlacklist 是否移除进黑名单
+     */
+    kickMemberOut(userUuid: string, toBlacklist?: boolean): Promise<NEResult<void>>;
+    /**
+     * 全部静音
+     */
+    muteAllAudio(): Promise<NEResult<void>>;
+    /**
+     * 解除全部静音
+     */
+    unmuteAllAudio(): Promise<NEResult<void>>;
+    /**
+     * 全体开启视频
+     */
+    unmuteAllVideo(): Promise<NEResult<void>>;
+    /**
+     * 全体关闭视频
+     */
+    muteAllVideo(): Promise<NEResult<void>>;
+    /**
+     * 关闭屏幕共享
+     * @param userUuid 用户UUID
+     */
+    stopMemberScreenShare(userUuid: string): Promise<NEResult<void>>;
+    /**
+     * 关闭白板
+     * @param userUuid 用户UUID
+     */
+    closeWhiteShare(userUuid: string): Promise<NEResult<void>>;
+    /**
+     * 手放下所有成员
+     */
+    handsDownAll(): Promise<void>;
+    /**
+     * 手放下单个成员
+     * @param userUuid 用户UUID 如果为空默认为自己
+     */
+    handsDown(userUuid?: string): Promise<NEResult<null>>;
+    /**
+     * 举手
+     */
+    handsUp(): Promise<NEResult<null>>;
+}
+export default MemberManager;