fcr-core 3.8.2 → 3.9.0-alpha

package/lib/type.d.ts

@@ -1,55 +1,42 @@
-import { AgoraRtcNetworkStats, AgoraRteNetworkQualityEvent, AgoraRtcDeviceInfo, AgoraRtcDisplayInfo, AgoraRtcWindowInfo, AgoraRtePerformanceInfo, AgoraRteScenePropertiesDeletedEvent, AgoraRteStreamEncryptionConfig, AgoraRteStreamJoinConfig, AgoraRteDualVideoStreamConfig, AgoraRteMessage, AgoraRteConnectionState, AgoraRteScenePropertiesUpdatedEvent, AgoraRteOperatCause, AgoraRteRenderView, AgoraRteUploadEvent, AgoraRteVideoEncoderConfig, FcrWhiteboardView } from './imports';
-import { FcrSharePermissionState } from './room-control/sharing-control/type';
-import { FcrUserRole } from './room-control/user-control/type';
+import { AgoraRtcDeviceInfo, AgoraRtcDisplayInfo, AgoraRtcNetworkStats, AgoraRtcWindowInfo, AgoraRteConnectionState, AgoraRteMessage, AgoraRteNetworkQualityEvent, AgoraRteOperatCause, AgoraRtePerformanceInfo, AgoraRteRenderView, AgoraRteScenePropertiesDeletedEvent, AgoraRteScenePropertiesUpdatedEvent, AgoraRteStreamEncryptionConfig, AgoraRteStreamJoinConfig, AgoraRteUploadEvent, FcrWhiteboardView } from './imports';
 import type { FcrAudioSourceType, FcrMediaSourceState, FcrRegion, FcrRoomConnectorType, FcrStreamType, FcrVideoSourceType } from '.';
+import { FcrSharePermissionState } from './room-control/sharing-control/type';
 import { FcrLineType, FcrRoomJoinOptions, FcrRoomType } from './room-control/type';
-import { FcrGroupCreateConfigSchema, FcrGroupUpdateOptionsSchema, FcrRenderConfigSchema, FcrRoomJoinOptionsWithTicketSchema, FcrSessionBaseSchema } from './schema';
+import { FcrUserRole } from './room-control/user-control/type';
 import { FcrRoomRoute } from './room-router/type';
+import { FcrGroupCreateConfigSchema, FcrGroupUpdateOptionsSchema, FcrRenderConfigSchema, FcrRoomJoinOptionsWithTicketSchema, FcrSessionBaseSchema } from './schema';
 export type { FcrBaseRoomControl, FcrRoomObserver } from './room-control/type';
-export type { FcrChatConnection, FcrChatConnectionObserver, FcrChatConnectionState, } from './chat-connection/type';
-export type FcrCoreEngineConfig = {
-    /** 应用唯一标识 */
-    appId: string;
-    /** 身份验证令牌 */
-    token: string;
-    /** 用户唯一标识 */
-    userId: string;
-    /** 服务区域 */
-    region: FcrRegion;
-    /** 双摄像头视频流配置 */
-    dualCameraVideoStreamConfig: AgoraRteDualVideoStreamConfig;
-    /** 双屏幕视频流配置 */
-    dualScreenVideoStreamConfig: AgoraRteDualVideoStreamConfig;
-    /** 额外参数配置 */
-    parameters?: Record<string, unknown>;
-};
-export { AgoraRteRegion as FcrRegion, AgoraRteMediaStreamType as FcrStreamType, AgoraRteUserUpdatedReason as FcrUserUpdatedReason, AgoraRteRoomConnectorType as FcrRoomConnectorType, AgoraRtcVideoSourceType as FcrVideoSourceType, AgoraRtcAudioSourceType as FcrAudioSourceType, AgoraRtcMediaSourceState as FcrMediaSourceState, AgoraRtcRenderMode as FcrVideoRenderMode, AgoraRtcVideoStreamType as FcrVideoStreamType, AgoraRtcCapability as FcrCapability, AgoraRtcAiDenoiseLevel as FcrAiDenoiseLevel, AgoraRteStreamPrivilegeOperation as FcrStreamPrivilegeOperation, AgoraRteStreamPrivilegeVideoSourceType as FcrStreamPrivilegeVideoSourceType, AgoraRteStreamPrivilegeAudioSourceType as FcrStreamPrivilegeAudioSourceType, AgoraRteConnectionState as FcrConnectionState, AgoraRteLatencyLevel as FcrStreamLatencyLevel, AgoraRteScreenCaptureType as FcrScreenCaptureType, AgoraRteVideoOrientation as FcrVideoOrientation, FcrCoreEngine, registerPlugin, } from './imports';
-export type FcrDualVideoStreamConfig = AgoraRteDualVideoStreamConfig;
+export type { FcrChatConnector, FcrChatConnectionObserver, FcrChatConnectionState, } from './chat-connector/type';
+export { AgoraRtcAiDenoiseLevel as FcrAiDenoiseLevel, AgoraRtcAudioSourceType as FcrAudioSourceType, AgoraRtcCapability as FcrCapability, AgoraRteConnectionState as FcrConnectionState, AgoraRtcMediaSourceState as FcrMediaSourceState, AgoraRteRegion as FcrRegion, AgoraRteRoomConnectorType as FcrRoomConnectorType, AgoraRteScreenCaptureType as FcrScreenCaptureType, AgoraRteLatencyLevel as FcrStreamLatencyLevel, AgoraRteStreamPrivilegeAudioSourceType as FcrStreamPrivilegeAudioSourceType, AgoraRteStreamPrivilegeOperation as FcrStreamPrivilegeOperation, AgoraRteStreamPrivilegeVideoSourceType as FcrStreamPrivilegeVideoSourceType, AgoraRteMediaStreamType as FcrStreamType, AgoraRteUserUpdatedReason as FcrUserUpdatedReason, AgoraRteVideoOrientation as FcrVideoOrientation, AgoraRtcRenderMode as FcrVideoRenderMode, AgoraRtcVideoSourceType as FcrVideoSourceType, AgoraRtcVideoStreamType as FcrVideoStreamType, registerPlugin, } from './imports';
+import { FcrDualVideoStreamConfig } from './utilities/dual-video-stream-config';
+import { FcrVideoEncoderConfig } from './utilities/video-encoder-config';
+export { FcrDualVideoStreamConfig };
 export type FcrMessage = AgoraRteMessage;
 export type FcrRenderView = AgoraRteRenderView;
-export type { FcrAudioOutputRouting, FcrDesktopMediaObserver, FcrDesktopMediaControl, FcrMobileMediaControl, FcrMobileMediaObserver, } from './media-control/type';
+export type { FcrAudioOutputRouting, FcrDesktopMediaControl, FcrDesktopMediaObserver, FcrMobileMediaControl, FcrMobileMediaObserver, } from './media-control/type';
 export type { FcrMonitorControl, FcrMonitorObserver } from './monitor-control/type';
 export type { FcrPeerSessionControl, FcrPeerSessionObserver } from './peer-session/type';
-export type { FcrAbilityControl } from './room-control/ability-control/type';
 export { FcrAbility } from './room-control/ability-control/type';
-export type { FcrChatRoomControl, FcrChatRoomObserver, FcrChatRoomControlInitConfig, FcrChatRoomSendBaseMessage, FcrChatRoomSendTextMessage, FcrChatRoomReceivedTextMessage, FcrChatRoomReceivedBaseMessage, FcrChatRoomFile, FcrChatRoomReceivedImageMessage, FcrChatRoomSendImageMessage, FcrChatRoomReceiveCustomMessage, } from './room-control/chatroom-control/type';
+export type { FcrAbilityControl } from './room-control/ability-control/type';
 export { FcrChatRoomConnectionState, FcrChatRoomMessageType, } from './room-control/chatroom-control/type';
-export type { FcrInterpreterState, FcrInterpreterUsersParams, FcrInterpreterRoomInfo, FcrLanguageChannelInfo, FcrInterpreterObserver, FcrInterpreterRoomControl, } from './room-control/interpreter-control/types';
-export { FcrLanguage, FcrInterpreterActionType } from './room-control/interpreter-control/types';
-export type { FcrPrivilegeControl, FcrPrivilegeObserver, FcrSecurityObj, FcrSecurityInfo, FcrSecuritySendChatPayload, FcrSecuritySharePayload, FcrSecurityWriteBoardPayload, FcrSecurityPrivateChatConfig, FcrSecurityInfoUpdatedEvent, FcrPermissionInfoAddedEvent, FcrPermissionInfoDeletedEvent, FcrPermission, FcrPermissionInfo, } from './room-control/privilege-control/type';
-export { FcrPrivilegeUserRole, FcrPermissionAction, FcrOperatePermissionType, FcrChatPermissionType, FcrSecurityAction, FcrWatermarkPermissionState, FcrPrivilegeUserRoleToStringMap, FcrPrivilegeUserStringToRoleMap, } from './room-control/privilege-control/type';
-export type { FcrRoomConnectorControl, FcrRoomConnectorObserver, FcrRoomConnectorPhoneInfo, FcrRoomConnectorIpInfo, FcrPhoneConnectorSessionParams, FcrIPConnectorSessionParams, FcrPhoneConnectorSession, FcrIPConnectorSession, } from './room-control/room-connector-control/type';
-export { FcrIPConnectorSessionType, FcrRoomConnectorSessionReason, FcrRoomConnectorSessionState, FcrRoomConnectorPhoneRegion, } from './room-control/room-connector-control/type';
-export type { FcrRoomSessionControl, FcrRoomSessionObserver, FcrRoomSessionParams, FcrRoomSession, } from './room-control/room-session/type';
-export type { FcrSharingControl, FcrSharingObserver } from './room-control/sharing-control/type';
+export type { FcrChatRoomControl, FcrChatRoomControlInitConfig, FcrChatRoomFile, FcrChatRoomObserver, FcrChatRoomReceiveCustomMessage, FcrChatRoomReceivedBaseMessage, FcrChatRoomReceivedImageMessage, FcrChatRoomReceivedTextMessage, FcrChatRoomSendBaseMessage, FcrChatRoomSendImageMessage, FcrChatRoomSendTextMessage, } from './room-control/chatroom-control/type';
+export { FcrInterpreterActionType, FcrLanguage } from './room-control/interpreter-control/types';
+export type { FcrInterpreterObserver, FcrInterpreterRoomControl, FcrInterpreterRoomInfo, FcrInterpreterState, FcrInterpreterUsersParams, FcrLanguageChannelInfo, } from './room-control/interpreter-control/types';
+export type { FcrPermission, FcrPermissionInfo, FcrPermissionInfoAddedEvent, FcrPermissionInfoDeletedEvent, FcrPrivilegeControl, FcrPrivilegeObserver, FcrSecurityInfo, FcrSecurityInfoUpdatedEvent, FcrSecurityObj, FcrSecurityPrivateChatConfig, FcrSecuritySendChatPayload, FcrSecuritySharePayload, FcrSecurityWriteBoardPayload, } from './room-control/privilege-control/type';
+export { FcrChatPermissionType, FcrOperatePermissionType, FcrPermissionAction, FcrPrivilegeUserRole, FcrPrivilegeUserRoleToStringMap, FcrPrivilegeUserStringToRoleMap, FcrSecurityAction, FcrWatermarkPermissionState, } from './room-control/privilege-control/type';
+export { FcrIPConnectorSessionType, FcrRoomConnectorPhoneRegion, FcrRoomConnectorSessionReason, FcrRoomConnectorSessionState, } from './room-control/room-connector-control/type';
+export type { FcrIPConnectorSession, FcrIPConnectorSessionParams, FcrPhoneConnectorSession, FcrPhoneConnectorSessionParams, FcrRoomConnectorControl, FcrRoomConnectorIpInfo, FcrRoomConnectorObserver, FcrRoomConnectorPhoneInfo, } from './room-control/room-connector-control/type';
+export type { FcrRoomSession, FcrRoomSessionControl, FcrRoomSessionObserver, FcrRoomSessionParams, } from './room-control/room-session/type';
 export { FcrScreenSharingState, FcrWhiteboardState } from './room-control/sharing-control/type';
-export type { FcrStreamControl, FcrStreamObserver, FcrLocalStreamCreateConfig, FcrStreamCreateConfig, FcrUpdateStreamPrivilege, FcrUpdateStreamPrivilegeScope, FcrLocalVideoStats, FcrLocalAudioStats, FcrRemoteVideoStats, FcrRemoteAudioStats, FcrSize, FcrDimensions, FcrSnapshotInfo, FcrStreamEvent, } from './room-control/stream-control/type';
-export type { FcrUserControl, FcrUserObserver, FcrUserPageParams, FcrUserPageResponse, FcrUserJoinedEvent, FcrUserLeftEvent, FcrUserUpdatedEvent, FcrUserPropertiesUpdatedEvent, FcrUserPropertiesDeletedEvent, FcrUserKickedOutEvent, } from './room-control/user-control/type';
-export { FcrUserLeftReason, FcrUserKickedOutType, FcrUserRole, } from './room-control/user-control/type';
-export type { FcrAnnotationControl, FcrAnnotationConfig, } from './room-control/whiteboard-control-v2/annotation-control/type';
-export type { FcrWhiteboardControl, FcrWhiteboardObserver, FcrBoardConfig, } from './room-control/whiteboard-control-v2/whiteboard-control/type';
-export type { FcrRoomControlType, FcrRoomRouterObserver, FcrRoomRoute, FcrRoomRouter, FcrRoomControlImplType, } from './room-router/type';
+export type { FcrSharingControl, FcrSharingObserver } from './room-control/sharing-control/type';
+export type { FcrDimensions, FcrLocalAudioStats, FcrLocalStreamCreateConfig, FcrLocalVideoStats, FcrRemoteAudioStats, FcrRemoteVideoStats, FcrSize, FcrSnapshotInfo, FcrStreamControl, FcrStreamCreateConfig, FcrStreamEvent, FcrStreamObserver, FcrUpdateStreamPrivilege, FcrUpdateStreamPrivilegeScope, } from './room-control/stream-control/type';
+export { FcrUserKickedOutType, FcrUserLeftReason, FcrUserRole, } from './room-control/user-control/type';
+export type { FcrUserControl, FcrUserJoinedEvent, FcrUserKickedOutEvent, FcrUserLeftEvent, FcrUserObserver, FcrUserPageParams, FcrUserPageResponse, FcrUserPropertiesDeletedEvent, FcrUserPropertiesUpdatedEvent, FcrUserUpdatedEvent, } from './room-control/user-control/type';
+export type { FcrAnnotationConfig, FcrAnnotationControl, } from './room-control/whiteboard-control-v2/annotation-control/type';
+export type { FcrBoardConfig, FcrWhiteboardControl, FcrWhiteboardObserver, } from './room-control/whiteboard-control-v2/whiteboard-control/type';
+export type { FcrRoomControlImplType, FcrRoomControlType, FcrRoomRoute, FcrRoomRouter, FcrRoomRouterObserver, } from './room-router/type';
 export type { FcrChatRoomTokenResData, FcrCheckInParams } from './service/type';
+export { FcrVideoEncoderConfig };
 export type FcrCoreEngineObserver = {
     /** 连接状态更新回调 */
     onConnectionStateUpdated?(state: FcrConnectionState): void;
@@ -205,7 +192,6 @@ export type FcrSessionResponse = {
 };
 export type FcrOperateCause = AgoraRteOperatCause;
 export type FcrStreamEncryptionConfig = AgoraRteStreamEncryptionConfig;
-export type FcrVideoEncoderConfig = AgoraRteVideoEncoderConfig;
 export type FcrDeviceInfo = AgoraRtcDeviceInfo;
 export type FcrWindowInfo = AgoraRtcWindowInfo;
 export type FcrDisplayInfo = AgoraRtcDisplayInfo;
@@ -241,6 +227,10 @@ export declare const FcrUserStringToRoleMap: {
     observer: FcrUserRole;
     robot: FcrUserRole;
 };
+export declare enum FcrReturnCode {
+    UNDEFINED = -1,
+    SUCCESS = 0
+}
 export declare enum FcrLiveStreamingLayoutType {
     GALLERY = 1,// 画廊模式
     SPEAKER = 2
@@ -278,13 +268,13 @@ export declare enum RoomMessageKey {
     USER_WAITING_ROOM_JOINED = "USER_WAITING_ROOM_JOINED"
 }
 export type FcrMonitorUploadEvent = AgoraRteUploadEvent;
-export { FcrLineType } from './room-control/type';
 export { FcrDeviceType } from './media-control/type';
+export { FcrLineType } from './room-control/type';
+export { FcrError } from './utilities/error';
 export declare enum FcrStreamState {
     UNPUBLISH = 0,
     PUBLISH = 1
 }
-export { FcrError } from './utilities/error';
 export type FcrWhiteboardParameters = {
     cursor?: boolean;
     syncMode?: boolean;
@@ -294,7 +284,36 @@ export type FcrWhiteboardParameters = {
     floatBar?: unknown;
     containerElement?: FcrWhiteboardView;
 };
-export { FcrBoardToolType, FcrBoardShape } from './room-control/whiteboard-control-v2/enum';
+export type { FcrLanguageConfig } from './room-control/stt-control/type';
+export { FcrBoardShape, FcrBoardToolType } from './room-control/whiteboard-control-v2/enum';
 export type { FcrBoardMainWindow, FcrBoardMainWindowObserver, } from './room-control/whiteboard-control-v2/type';
 export type { FcrColor } from './room-control/whiteboard-control/type';
-export type { FcrLanguageConfig } from './room-control/stt-control/type';
+/** 引擎配置类 */
+export declare class FcrCoreEngineConfig {
+    /** 应用唯一标识 */
+    appId: string;
+    /** 身份验证令牌 */
+    token: string;
+    /** 用户唯一标识 */
+    userId: string;
+    /** 服务区域 */
+    region: FcrRegion;
+    /** 双摄像头视频流配置 */
+    dualCameraVideoStreamConfig: FcrDualVideoStreamConfig;
+    /** 双屏幕视频流配置 */
+    dualScreenVideoStreamConfig: FcrDualVideoStreamConfig;
+    /** 额外参数配置 */
+    parameters?: Record<string, unknown>;
+    constructor(params: {
+        appId: string;
+        token: string;
+        userId: string;
+        region: FcrRegion;
+        dualCameraVideoStreamConfig: FcrDualVideoStreamConfig;
+        dualScreenVideoStreamConfig: FcrDualVideoStreamConfig;
+        parameters?: Record<string, unknown>;
+    });
+    static createDefaultConfig(appId: string, token: string, region: FcrRegion, userId: string, parameters?: Record<string, unknown>): FcrCoreEngineConfig;
+    private _prependInternalParameters;
+}
+export type { FcrCoreEngine } from './engine/type';

package/lib/type.js

@@ -64,16 +64,17 @@ Object.defineProperty(exports, "FcrConnectionState", {
     return _imports.AgoraRteConnectionState;
   }
 });
-Object.defineProperty(exports, "FcrCoreEngine", {
+exports.FcrCoreEngineConfig = void 0;
+Object.defineProperty(exports, "FcrDeviceType", {
   enumerable: true,
   get: function () {
-    return _imports.FcrCoreEngine;
+    return _type7.FcrDeviceType;
   }
 });
-Object.defineProperty(exports, "FcrDeviceType", {
+Object.defineProperty(exports, "FcrDualVideoStreamConfig", {
   enumerable: true,
   get: function () {
-    return _type8.FcrDeviceType;
+    return _dualVideoStreamConfig.FcrDualVideoStreamConfig;
   }
 });
 Object.defineProperty(exports, "FcrError", {
@@ -103,7 +104,7 @@ Object.defineProperty(exports, "FcrLanguage", {
 Object.defineProperty(exports, "FcrLineType", {
   enumerable: true,
   get: function () {
-    return _type7.FcrLineType;
+    return _type8.FcrLineType;
   }
 });
 exports.FcrLiveStreamingState = exports.FcrLiveStreamingLayoutType = void 0;
@@ -151,6 +152,7 @@ Object.defineProperty(exports, "FcrRegion", {
     return _imports.AgoraRteRegion;
   }
 });
+exports.FcrReturnCode = void 0;
 Object.defineProperty(exports, "FcrRoomConnectorPhoneRegion", {
   enumerable: true,
   get: function () {
@@ -250,6 +252,12 @@ Object.defineProperty(exports, "FcrUserUpdatedReason", {
     return _imports.AgoraRteUserUpdatedReason;
   }
 });
+Object.defineProperty(exports, "FcrVideoEncoderConfig", {
+  enumerable: true,
+  get: function () {
+    return _videoEncoderConfig.FcrVideoEncoderConfig;
+  }
+});
 Object.defineProperty(exports, "FcrVideoOrientation", {
   enumerable: true,
   get: function () {
@@ -294,22 +302,24 @@ Object.defineProperty(exports, "registerPlugin", {
   }
 });
 var _type = require("./room-control/user-control/type");
+var _parameters = require("./utilities/parameters");
 var _imports = require("./imports");
+var _dualVideoStreamConfig = require("./utilities/dual-video-stream-config");
+var _videoEncoderConfig = require("./utilities/video-encoder-config");
 var _type2 = require("./room-control/ability-control/type");
 var _type3 = require("./room-control/chatroom-control/type");
 var _types = require("./room-control/interpreter-control/types");
 var _type4 = require("./room-control/privilege-control/type");
 var _type5 = require("./room-control/room-connector-control/type");
 var _type6 = require("./room-control/sharing-control/type");
-var _type7 = require("./room-control/type");
-var _type8 = require("./media-control/type");
+var _type7 = require("./media-control/type");
+var _type8 = require("./room-control/type");
 var _error = require("./utilities/error");
 var _enum = require("./room-control/whiteboard-control-v2/enum");
 // 基础导入类型（集中管理第三方依赖类型别名）
 // 内部枚举与基础类型导入
 // 模块类型导出（按功能模块分组）
 // 聊天连接模块
-// 引擎核心配置
 // 第三方类型别名（统一前缀避免冲突）
 // 基础类型别名（简化常用类型引用）
 // 媒体控制模块
@@ -395,8 +405,11 @@ const FcrUserStringToRoleMap = exports.FcrUserStringToRoleMap = {
   observer: _type.FcrUserRole.OBSERVER,
   robot: _type.FcrUserRole.ROBOT
 };
-
-// 直播相关类型
+let FcrReturnCode = exports.FcrReturnCode = /*#__PURE__*/function (FcrReturnCode) {
+  FcrReturnCode[FcrReturnCode["UNDEFINED"] = -1] = "UNDEFINED";
+  FcrReturnCode[FcrReturnCode["SUCCESS"] = 0] = "SUCCESS";
+  return FcrReturnCode;
+}({}); // 直播相关类型
 let FcrLiveStreamingLayoutType = exports.FcrLiveStreamingLayoutType = /*#__PURE__*/function (FcrLiveStreamingLayoutType) {
   FcrLiveStreamingLayoutType[FcrLiveStreamingLayoutType["GALLERY"] = 1] = "GALLERY";
   // 画廊模式
@@ -417,4 +430,56 @@ let FcrStreamState = exports.FcrStreamState = /*#__PURE__*/function (FcrStreamSt
   FcrStreamState[FcrStreamState["UNPUBLISH"] = 0] = "UNPUBLISH";
   FcrStreamState[FcrStreamState["PUBLISH"] = 1] = "PUBLISH";
   return FcrStreamState;
-}({});
+}({});
+/** 引擎配置类 */
+class FcrCoreEngineConfig {
+  /** 应用唯一标识 */
+
+  /** 身份验证令牌 */
+
+  /** 用户唯一标识 */
+
+  /** 服务区域 */
+
+  /** 双摄像头视频流配置 */
+
+  /** 双屏幕视频流配置 */
+
+  /** 额外参数配置 */
+
+  constructor(params) {
+    this.appId = params.appId;
+    this.token = params.token;
+    this.userId = params.userId;
+    this.region = params.region;
+    this.dualCameraVideoStreamConfig = params.dualCameraVideoStreamConfig;
+    this.dualScreenVideoStreamConfig = params.dualScreenVideoStreamConfig;
+    this.parameters = params.parameters;
+    this._prependInternalParameters();
+  }
+  static createDefaultConfig(appId, token, region, userId, parameters) {
+    return new FcrCoreEngineConfig({
+      appId,
+      token,
+      userId,
+      region,
+      dualCameraVideoStreamConfig: _dualVideoStreamConfig.FcrDualVideoStreamConfig.createDefaultCameraConfig(),
+      dualScreenVideoStreamConfig: _dualVideoStreamConfig.FcrDualVideoStreamConfig.createDefaultScreenConfig(),
+      parameters
+    });
+  }
+  _prependInternalParameters() {
+    const rtcPresetParameters = (0, _parameters.getRtcPresetParameters)();
+    if (!this.parameters) {
+      this.parameters = {
+        rtc: rtcPresetParameters
+      };
+    } else if (!this.parameters.rtc) {
+      this.parameters.rtc = rtcPresetParameters;
+    } else {
+      // 将内部参数插入到数组前列
+      this.parameters.rtc.unshift(...rtcPresetParameters);
+    }
+  }
+}
+exports.FcrCoreEngineConfig = FcrCoreEngineConfig;

package/lib/utilities/abortable-retry.d.ts

@@ -0,0 +1,38 @@
+export type RetryOptions = {
+    retriesMax: number;
+};
+/**
+ * Creates an abortable retry operation that can be cancelled at any time.
+ *
+ * The handler function will be retried up to `retriesMax` times if it fails.
+ * The operation can be cancelled by calling the returned abort function,
+ * which will cause the promise to reject with an AbortError.
+ *
+ * @example
+ * ```typescript
+ * const [abort, promise] = abortableRetry(async (signal) => {
+ *   await asyncFunction1();
+ *   // Check if aborted after each async operation
+ *   signal.throwIfAborted();
+ *
+ *   await asyncFunction2();
+ *   signal.throwIfAborted();
+ *
+ *   return result;
+ * }, { retriesMax: 10 });
+ *
+ * // Cancel the operation at any time
+ * setTimeout(() => abort(), 5000);
+ *
+ * const [err, result] = await promise;
+ * if (err?.name === 'AbortError') {
+ *   console.log('Operation was cancelled');
+ * }
+ * ```
+ *
+ * @param handler - Async function that receives an AbortSignal.
+ *                  Should call `signal.throwIfAborted()` periodically to check for cancellation.
+ * @param options - Retry configuration
+ * @returns Tuple of [abort function, result promise]. The promise resolves to [error, result].
+ */
+export declare const abortableRetry: <T>(handler: (signal: AbortSignal) => Promise<T>, options: RetryOptions) => readonly [() => void, Promise<[Error | null, T]>];

package/lib/utilities/abortable-retry.js

@@ -0,0 +1,61 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.abortableRetry = void 0;
+require("core-js/modules/web.dom-exception.stack.js");
+var _imports = require("../imports");
+/**
+ * Creates an abortable retry operation that can be cancelled at any time.
+ *
+ * The handler function will be retried up to `retriesMax` times if it fails.
+ * The operation can be cancelled by calling the returned abort function,
+ * which will cause the promise to reject with an AbortError.
+ *
+ * @example
+ * ```typescript
+ * const [abort, promise] = abortableRetry(async (signal) => {
+ *   await asyncFunction1();
+ *   // Check if aborted after each async operation
+ *   signal.throwIfAborted();
+ *
+ *   await asyncFunction2();
+ *   signal.throwIfAborted();
+ *
+ *   return result;
+ * }, { retriesMax: 10 });
+ *
+ * // Cancel the operation at any time
+ * setTimeout(() => abort(), 5000);
+ *
+ * const [err, result] = await promise;
+ * if (err?.name === 'AbortError') {
+ *   console.log('Operation was cancelled');
+ * }
+ * ```
+ *
+ * @param handler - Async function that receives an AbortSignal.
+ *                  Should call `signal.throwIfAborted()` periodically to check for cancellation.
+ * @param options - Retry configuration
+ * @returns Tuple of [abort function, result promise]. The promise resolves to [error, result].
+ */
+const abortableRetry = (handler, options) => {
+  const abortController = new AbortController();
+  const promise = (0, _imports.to)((0, _imports.retryAttempt)(async () => {
+    abortController.signal.throwIfAborted();
+    const result = await handler(abortController.signal);
+    abortController.signal.throwIfAborted();
+    return result;
+  }, [], {
+    retriesMax: options.retriesMax
+  }).fail(async options => {
+    if (abortController.signal.aborted) {
+      throw new DOMException('Operation aborted', 'AbortError');
+    }
+    await options.timeFn();
+    return true;
+  }).exec());
+  return [() => abortController.abort(), promise];
+};
+exports.abortableRetry = abortableRetry;

package/lib/utilities/dual-video-stream-config.d.ts

@@ -0,0 +1,6 @@
+import { AgoraRteDualVideoStreamConfig } from '../imports';
+export type FcrDualVideoStreamConfig = AgoraRteDualVideoStreamConfig;
+export declare namespace FcrDualVideoStreamConfig {
+    function createDefaultCameraConfig(): FcrDualVideoStreamConfig;
+    function createDefaultScreenConfig(): FcrDualVideoStreamConfig;
+}

package/lib/utilities/dual-video-stream-config.js

@@ -0,0 +1,25 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.FcrDualVideoStreamConfig = void 0;
+var _videoEncoderConfig = require("./video-encoder-config");
+let FcrDualVideoStreamConfig = exports.FcrDualVideoStreamConfig = void 0;
+(function (_FcrDualVideoStreamConfig) {
+  function createDefaultCameraConfig() {
+    return {
+      highVideoEncoderConfig: _videoEncoderConfig.FcrVideoEncoderConfig.createDefaultHighCameraConfig(),
+      lowVideoEncoderConfig: _videoEncoderConfig.FcrVideoEncoderConfig.createDefaultLowCameraConfig(),
+      enableDualStreamMode: true
+    };
+  }
+  _FcrDualVideoStreamConfig.createDefaultCameraConfig = createDefaultCameraConfig;
+  function createDefaultScreenConfig() {
+    return {
+      highVideoEncoderConfig: _videoEncoderConfig.FcrVideoEncoderConfig.createDefaultClarityScreenConfig(),
+      enableDualStreamMode: false
+    };
+  }
+  _FcrDualVideoStreamConfig.createDefaultScreenConfig = createDefaultScreenConfig;
+})(FcrDualVideoStreamConfig || (exports.FcrDualVideoStreamConfig = FcrDualVideoStreamConfig = {}));

package/lib/utilities/error-helpers.d.ts

@@ -3,7 +3,8 @@
  *
  * 提供统一的错误创建和处理机制，支持实例化配置
  */
-import { FcrError, FcrErrorModuleCode } from './error';
+import { ErrorModuleCode } from '../imports';
+import { FcrError } from './error';
 /**
  * 控制器类型枚举
  */
@@ -26,7 +27,7 @@ export declare enum ControllerType {
  */
 export interface FcrErrorHelperConfig {
     /** 默认模块代码 */
-    defaultModuleCode?: FcrErrorModuleCode;
+    defaultModuleCode?: ErrorModuleCode;
     /** 是否启用详细错误信息 */
     enableDetailedMessages?: boolean;
     /** 错误日志前缀 */
@@ -46,7 +47,7 @@ export declare class FcrErrorHelper {
      * @param moduleCode 模块错误码
      * @returns FcrError
      */
-    createControllerNotInitializedError(controllerType: ControllerType, moduleCode?: FcrErrorModuleCode): FcrError;
+    createControllerNotInitializedError(controllerType: ControllerType, moduleCode?: ErrorModuleCode): FcrError;
     /**
      * 生成操作冲突错误
      * @param operation 操作名称
@@ -54,21 +55,21 @@ export declare class FcrErrorHelper {
      * @param moduleCode 模块错误码
      * @returns FcrError
      */
-    createOperationConflictError(operation: string, reason: string, moduleCode?: FcrErrorModuleCode): FcrError;
+    createOperationConflictError(operation: string, reason: string, moduleCode?: ErrorModuleCode): FcrError;
     /**
      * 生成操作取消错误
      * @param operation 操作名称
      * @param moduleCode 模块错误码
      * @returns FcrError
      */
-    createOperationCanceledError(operation: string, moduleCode?: FcrErrorModuleCode): FcrError;
+    createOperationCanceledError(operation: string, moduleCode?: ErrorModuleCode): FcrError;
     /**
      * 生成消息发送错误
      * @param originalError 原始错误
      * @param moduleCode 模块错误码
      * @returns FcrError
      */
-    createSendMessageError(originalError: Error, moduleCode?: FcrErrorModuleCode): FcrError;
+    createSendMessageError(originalError: Error, moduleCode?: ErrorModuleCode): FcrError;
     /**
      * 生成通用操作错误
      * @param operation 操作类型
@@ -76,14 +77,14 @@ export declare class FcrErrorHelper {
      * @param moduleCode 模块错误码
      * @returns FcrError
      */
-    createOperationError(operation: string, originalError?: Error, moduleCode?: FcrErrorModuleCode): FcrError;
+    createOperationError(operation: string, originalError?: Error, moduleCode?: ErrorModuleCode): FcrError;
     /**
      * 生成网络请求相关错误
      * @param message 错误消息
      * @param moduleCode 模块错误码
      * @returns FcrError
      */
-    createNetworkError(message: string, moduleCode?: FcrErrorModuleCode): FcrError;
+    createNetworkError(message: string, moduleCode?: ErrorModuleCode): FcrError;
     /**
      * 生成参数无效错误
      * @param paramName 参数名
@@ -91,7 +92,7 @@ export declare class FcrErrorHelper {
      * @param moduleCode 模块错误码
      * @returns FcrError
      */
-    createInvalidParamsError(paramName: string, reason: string, moduleCode?: FcrErrorModuleCode): FcrError;
+    createInvalidParamsError(paramName: string, reason: string, moduleCode?: ErrorModuleCode): FcrError;
     /**
      * 生成房间加入冲突错误的便捷方法
      */

package/lib/utilities/error-helpers.js

@@ -4,6 +4,7 @@ Object.defineProperty(exports, "__esModule", {
   value: true
 });
 exports.roomControlErrorHelper = exports.liveStreamingErrorHelper = exports.engineErrorHelper = exports.defaultErrorHelper = exports.FcrErrorHelper = exports.ControllerType = void 0;
+var _imports = require("../imports");
 var _error = require("./error");
 /**
  * 通用错误处理辅助工具
@@ -37,7 +38,7 @@ let ControllerType = exports.ControllerType = /*#__PURE__*/function (ControllerT
 class FcrErrorHelper {
   constructor(config = {}) {
     this.config = {
-      defaultModuleCode: _error.FcrErrorModuleCode.ROOM,
+      defaultModuleCode: _imports.ErrorModuleCode.FCR_ROOM,
       enableDetailedMessages: true,
       logPrefix: 'FCR',
       autoLog: false,
@@ -53,7 +54,7 @@ class FcrErrorHelper {
   createControllerNotInitializedError(controllerType, moduleCode) {
     const module = moduleCode ?? this.config.defaultModuleCode;
     const message = this.config.enableDetailedMessages ? `[${this.config.logPrefix}] The ${controllerType} controller is not initialized, please join the room first` : `${controllerType} controller not initialized`;
-    const error = (0, _error.generateFcrCoreClientErrorNew)(module, _error.FcrErrorCode.NOT_JOINED_ROOM, message);
+    const error = (0, _error.generateFcrCoreClientError)(module, _imports.DetailErrorCode.NOT_JOINED_ROOM, message);
     if (this.config.autoLog) {
       console.error(`${this.config.logPrefix}: ${message}`);
     }
@@ -70,7 +71,7 @@ class FcrErrorHelper {
   createOperationConflictError(operation, reason, moduleCode) {
     const module = moduleCode ?? this.config.defaultModuleCode;
     const message = this.config.enableDetailedMessages ? `[${this.config.logPrefix}] Failed to ${operation}: ${reason}` : `${operation} failed: ${reason}`;
-    const error = (0, _error.generateFcrCoreClientErrorNew)(module, _error.FcrErrorCode.JOIN_CONFLICT, message);
+    const error = (0, _error.generateFcrCoreClientError)(module, _imports.DetailErrorCode.JOIN_CONFLICT, message);
     if (this.config.autoLog) {
       console.error(`${this.config.logPrefix}: ${message}`);
     }
@@ -86,7 +87,7 @@ class FcrErrorHelper {
   createOperationCanceledError(operation, moduleCode) {
     const module = moduleCode ?? this.config.defaultModuleCode;
     const message = this.config.enableDetailedMessages ? `[${this.config.logPrefix}] ${operation} operation has been cancelled` : `${operation} cancelled`;
-    const error = (0, _error.generateFcrCoreClientErrorNew)(module, _error.FcrErrorCode.NOT_JOINED_ROOM, message);
+    const error = (0, _error.generateFcrCoreClientError)(module, _imports.DetailErrorCode.NOT_JOINED_ROOM, message);
     if (this.config.autoLog) {
       console.error(`${this.config.logPrefix}: ${message}`);
     }
@@ -102,7 +103,7 @@ class FcrErrorHelper {
   createSendMessageError(originalError, moduleCode) {
     const module = moduleCode ?? this.config.defaultModuleCode;
     const message = this.config.enableDetailedMessages ? `[${this.config.logPrefix}] Send message failed: ${originalError.message}` : 'send message failed';
-    const error = (0, _error.generateFcrCoreClientErrorNew)(module, _error.FcrErrorCode.UNDEFINED_ERROR, message);
+    const error = (0, _error.generateFcrCoreClientError)(module, _imports.DetailErrorCode.UNDEFINED_ERROR, message);
     if (this.config.autoLog) {
       console.error(`${this.config.logPrefix}: ${message}`, originalError);
     }
@@ -119,7 +120,7 @@ class FcrErrorHelper {
   createOperationError(operation, originalError, moduleCode) {
     const module = moduleCode ?? this.config.defaultModuleCode;
     const message = this.config.enableDetailedMessages ? `[${this.config.logPrefix}] ${operation} failed${originalError ? `: ${originalError.message}` : ''}` : `${operation} failed`;
-    const error = (0, _error.generateFcrCoreClientErrorNew)(module, _error.FcrErrorCode.NOT_JOINED_ROOM, message);
+    const error = (0, _error.generateFcrCoreClientError)(module, _imports.DetailErrorCode.NOT_JOINED_ROOM, message);
     if (this.config.autoLog) {
       console.error(`${this.config.logPrefix}: ${message}`, originalError);
     }
@@ -135,7 +136,7 @@ class FcrErrorHelper {
   createNetworkError(message, moduleCode) {
     const module = moduleCode ?? this.config.defaultModuleCode;
     const formattedMessage = this.config.enableDetailedMessages ? `[${this.config.logPrefix}] Network error: ${message}` : message;
-    const error = (0, _error.generateFcrCoreClientErrorNew)(module, _error.FcrErrorCode.LOCAL_HTTP_REQUEST_FAILED, formattedMessage);
+    const error = (0, _error.generateFcrCoreClientError)(module, _imports.DetailErrorCode.LOCAL_HTTP_REQUEST_FAILED, formattedMessage);
     if (this.config.autoLog) {
       console.error(`${this.config.logPrefix}: ${formattedMessage}`);
     }
@@ -152,7 +153,7 @@ class FcrErrorHelper {
   createInvalidParamsError(paramName, reason, moduleCode) {
     const module = moduleCode ?? this.config.defaultModuleCode;
     const message = this.config.enableDetailedMessages ? `[${this.config.logPrefix}] Invalid parameter '${paramName}': ${reason}` : `Invalid parameter '${paramName}': ${reason}`;
-    const error = (0, _error.generateFcrCoreClientErrorNew)(module, _error.FcrErrorCode.INVALID_PARAMS, message);
+    const error = (0, _error.generateFcrCoreClientError)(module, _imports.DetailErrorCode.INVALID_PARAMS, message);
     if (this.config.autoLog) {
       console.error(`${this.config.logPrefix}: ${message}`);
     }
@@ -179,7 +180,7 @@ class FcrErrorHelper {
    */
   static forRoomControl() {
     return new FcrErrorHelper({
-      defaultModuleCode: _error.FcrErrorModuleCode.ROOM,
+      defaultModuleCode: _imports.ErrorModuleCode.FCR_ROOM,
       logPrefix: 'RoomControl',
       enableDetailedMessages: true
     });
@@ -190,7 +191,7 @@ class FcrErrorHelper {
    */
   static forEngine() {
     return new FcrErrorHelper({
-      defaultModuleCode: _error.FcrErrorModuleCode.ENGINE,
+      defaultModuleCode: _imports.ErrorModuleCode.FCR_ENGINE,
       logPrefix: 'Engine',
       enableDetailedMessages: true
     });
@@ -201,7 +202,7 @@ class FcrErrorHelper {
    */
   static forLiveStreaming() {
     return new FcrErrorHelper({
-      defaultModuleCode: _error.FcrErrorModuleCode.ROOM_LIVE_STREAMING,
+      defaultModuleCode: _imports.ErrorModuleCode.FCR_ROOM_LIVE_STREAMING,
       logPrefix: 'LiveStreaming',
       enableDetailedMessages: true
     });