trtc-cloud-js-sdk 2.12.2-beta.12 → 2.12.2-beta.14

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "trtc-cloud-js-sdk",
-  "version": "2.12.2-beta.12",
+  "version": "2.12.2-beta.14",
   "description": "Tencent Cloud RTC SDK for Web And Electron",
   "main": "trtc-cloud-js-sdk.js",
   "module": "trtc-cloud-js-sdk.esm.js",
@@ -19,6 +19,6 @@
   "author": "Tencent Cloud Client R&D Center",
   "license": "ISC",
   "dependencies": {
-    "trtc-sdk-v5": "5.18.2-beta.2"
+    "trtc-sdk-v5": "5.18.2-beta.4"
   }
 }

package/trtc-cloud-js-sdk.d.ts

@@ -963,12 +963,30 @@ declare type WhiteboardToolType = 'pen' | 'rect' | 'ellipse' | 'arrow' | 'laser'
  * @enum {String}
  */
 declare type WhiteboardOp = 'undo' | 'redo' | 'clearall' | 'clearself';
+/**
+ * Guest ACK 回路进入停滞状态的原因
+ */
+declare type WhiteboardSessionStalledReason = 'silence' | 'queue-full';
 /**
  * 白板事件名
  */
 declare enum TRTCWhiteboardEvent {
     /** 上行：本端笔迹/操作数据，需上层转发给远端 */
-    onSendWhiteboardCommand = "onSendWhiteboardCommand"
+    onSendWhiteboardCommand = "onSendWhiteboardCommand",
+    /** 白板会话就绪，可开始交互 */
+    STARTED = "started",
+    /** 白板会话终止 */
+    STOPPED = "stopped",
+    /** 白板会话过程中的异步异常 */
+    ERROR = "error",
+    /** Guest ACK 反馈回路进入停滞状态 */
+    SESSION_STALLED = "session-stalled",
+    /** Guest ACK 反馈回路从停滞中恢复 */
+    SESSION_RESUMED = "session-resumed",
+    /** 撤销栈可用性变更 */
+    UNDO_STATE_CHANGED = "undo-state-changed",
+    /** 重做栈可用性变更 */
+    REDO_STATE_CHANGED = "redo-state-changed"
 }
 /**
  * 工具配置
@@ -1060,6 +1078,36 @@ interface WhiteboardSendPayload {
     op?: WhiteboardOp;
 }
 declare const WhiteboardSendPayload: any;
+/**
+ * session-stalled 事件 payload
+ */
+interface WhiteboardSessionStalledInfo {
+    /** 目标 Host 用户 */
+    targetUser: string;
+    /** 待 ACK 队列中保留、等待 SESSION_START 批量重发的数量 */
+    pendingCount: number;
+    /** 停滞原因：Host 静默或队列保护 */
+    reason: WhiteboardSessionStalledReason;
+}
+declare const WhiteboardSessionStalledInfo: any;
+/**
+ * session-resumed 事件 payload
+ */
+interface WhiteboardSessionResumedInfo {
+    /** 目标 Host 用户 */
+    targetUser: string;
+    /** 从停滞状态恢复后重发的数量 */
+    resentCount: number;
+}
+declare const WhiteboardSessionResumedInfo: any;
+/**
+ * undo/redo 可用性变更事件 payload
+ */
+interface WhiteboardHistoryStateChangedInfo {
+    /** 当前是否可执行 undo/redo */
+    available: boolean;
+}
+declare const WhiteboardHistoryStateChangedInfo: any;
 /**
  * 白板上行数据回调通道 —— 与 Native `WhiteboardDelegate` 对齐。
  */
@@ -1105,6 +1153,8 @@ declare class TRTCWhiteboardManager implements ITRTCWhiteboardManager {
     private trtcCloud;
     private eventEmitter;
     private delegate;
+    private pluginEventHandlers;
+    private boundPlugin;
     /** 白板插件是否已启动 */
     private started;
     /** 绑定交互事件的 view */
@@ -1141,6 +1191,10 @@ declare class TRTCWhiteboardManager implements ITRTCWhiteboardManager {
      * 执行本端操作（undo/redo/clearall）
      */
     private _applyLocalOp;
+    private _bindPluginEvents;
+    private _offPluginEvents;
+    private _getWhiteboardPlugin;
+    private _emitWhiteboardEvent;
     /**
      * 远端协同指令（带 owner_id）。
      *
@@ -2331,4 +2385,4 @@ declare class TRTC_Cloud extends EventEmitter {
     getAITranscriberManager(): AITranscriberManager;
 }
 
-export { AITranscriberListener, AudioMuteType, IAITranscriberManager, ITRTCMediaMixingEvent, ITRTCMediaMixingManager, ITRTCWhiteboardManager, InteractionOption, Rect, TRTCAppScene, TRTCAudioQuality, TRTCAudioSceneEx, TRTCBeautyStyle, TRTCCameraCaptureMode, TRTCCameraCaptureParams, TRTCDeviceInfo, TRTCDeviceState, TRTCDeviceType, TRTCImageBuffer, TRTCLocalStatistics, TRTCLogLevel, TRTCMediaMixingEncParam, TRTCMediaMixingErrorCode, TRTCMediaMixingEvent, TRTCMediaSource, TRTCMediaSourceType, TRTCMixInputType, TRTCMixUser, TRTCNetworkQosParam, TRTCParams, TRTCPublishCDNParam, TRTCQosControlMode, TRTCQuality, TRTCQualityInfo, TRTCRemoteStatistics, TRTCRenderParams, TRTCRoleType, TRTCScreenCaptureProperty, TRTCScreenCaptureSourceInfo, TRTCScreenCaptureSourceType, TRTCStatistics, TRTCTranscodingConfig, TRTCTranscodingConfigMode, TRTCVideoEncParam, TRTCVideoFillMode, TRTCVideoMirrorType, TRTCVideoQosPreference, TRTCVideoResolution, TRTCVideoResolutionMode, TRTCVideoRotation, TRTCVideoStreamType, TRTCVolumeInfo, TRTCWhiteboardEvent, TranscriberMessage, TranscriberParams, WhiteboardCanvasInfo, WhiteboardDelegate, WhiteboardOp, WhiteboardRecvCommand, WhiteboardSendPayload, WhiteboardToolConfig, WhiteboardToolType, TRTC_Cloud as default };
+export { AITranscriberListener, AudioMuteType, IAITranscriberManager, ITRTCMediaMixingEvent, ITRTCMediaMixingManager, ITRTCWhiteboardManager, InteractionOption, Rect, TRTCAppScene, TRTCAudioQuality, TRTCAudioSceneEx, TRTCBeautyStyle, TRTCCameraCaptureMode, TRTCCameraCaptureParams, TRTCDeviceInfo, TRTCDeviceState, TRTCDeviceType, TRTCImageBuffer, TRTCLocalStatistics, TRTCLogLevel, TRTCMediaMixingEncParam, TRTCMediaMixingErrorCode, TRTCMediaMixingEvent, TRTCMediaSource, TRTCMediaSourceType, TRTCMixInputType, TRTCMixUser, TRTCNetworkQosParam, TRTCParams, TRTCPublishCDNParam, TRTCQosControlMode, TRTCQuality, TRTCQualityInfo, TRTCRemoteStatistics, TRTCRenderParams, TRTCRoleType, TRTCScreenCaptureProperty, TRTCScreenCaptureSourceInfo, TRTCScreenCaptureSourceType, TRTCStatistics, TRTCTranscodingConfig, TRTCTranscodingConfigMode, TRTCVideoEncParam, TRTCVideoFillMode, TRTCVideoMirrorType, TRTCVideoQosPreference, TRTCVideoResolution, TRTCVideoResolutionMode, TRTCVideoRotation, TRTCVideoStreamType, TRTCVolumeInfo, TRTCWhiteboardEvent, TranscriberMessage, TranscriberParams, WhiteboardCanvasInfo, WhiteboardDelegate, WhiteboardHistoryStateChangedInfo, WhiteboardOp, WhiteboardRecvCommand, WhiteboardSendPayload, WhiteboardSessionResumedInfo, WhiteboardSessionStalledInfo, WhiteboardSessionStalledReason, WhiteboardToolConfig, WhiteboardToolType, TRTC_Cloud as default };