@polyvharmony/live-scenes-sdk 1.4.0 → 1.6.0

package/src/main/ets/modules/linkmic/mediator/PLVLinkMicMediator.d.ets

@@ -18,58 +18,125 @@ import { PLVLinkMicPushResolutionRatio } from '../model/vo/PLVLinkMicPushResolut
 import { PLVLinkMicRTCEvent } from '../model/vo/PLVLinkMicRTCEvent';
 import { PLVLinkMicState } from '../model/vo/PLVLinkMicState';
 import { PLVLinkMicViewer } from '../model/vo/PLVLinkMicViewer';
+/**
+ * 模块内状态中介，集中保存跨用例共享状态并桥接外部模块
+ */
 export declare class PLVLinkMicMediator implements LifecycleAwareDependComponent {
+    /** 当前登录频道、用户、角色等全局频道数据。 */
     channelData: PLVChannelData | null;
+    /** 聊天室 socket 中介，用于监听和发送连麦协议事件。 */
     socketMediator: PLVSocketMediator | null;
+    /** 播放器中介，用于连麦时暂停/恢复播放器或同步播放状态。 */
     playerMediator: PLVPlayerMediator | null;
+    /** 成员模块中介，用于查找用户资料和复用成员模块的连麦操作。 */
     memberMediator: PLVMemberMediator | null;
+    /** 连麦模块初始化完成信号，外部动作需等待该 Promise 后再执行。 */
     readonly initFinish: {
         promise: Promise<void>;
         resolve: (value: void | PromiseLike<void>) => void;
         reject: (reason?: any) => void;
     };
+    /** 本地当前连麦状态。 */
     readonly linkmicState: MutableState<PLVLinkMicState>;
+    /** 观众申请连麦后的排队序号，-1 表示当前没有排队。 */
     readonly joinLinkMicWaitingQueueOrder: MutableState<number>;
+    /** 讲师邀请连麦的过期时间戳，用于 UI 倒计时。 */
     readonly invitationExpireTimestamp: MutableState<number>;
+    /** SDK 是否支持当前频道配置下的连麦能力。 */
     readonly sdkSupportChannelLinkMic: MutableState<boolean>;
+    /** SDK 是否支持当前频道配置下的屏幕分享能力。 */
+    readonly sdkSupportScreenCapture: MutableState<boolean>;
+    /** 本地是否正在进行屏幕分享。 */
+    readonly isStartScreenCapture: MutableState<boolean>;
+    /** 频道是否允许连麦能力。 */
     readonly channelAllowLinkMic: MutableState<boolean>;
+    /** 频道是否允许观众举手申请连麦。 */
     readonly channelAllowRequestHandsUpLinkMic: MutableState<boolean>;
+    /** 当前频道连麦模式，视频连麦或音频连麦。 */
     readonly channelLinkMicMode: MutableState<PLVLinkMicMode>;
+    /** 本地用户对应的连麦成员信息。 */
     readonly localLinkMicViewer: MutableState<PLVLinkMicViewer>;
+    /** 当前频道正在连麦的成员列表。 */
     readonly channelLinkMicViewers: MutableState<PLVLinkMicViewer[]>;
+    /** 当前第一画面用户的 linkMicId。 */
     readonly channelMainViewLinkMicId: MutableState<string>;
+    /** RTC 网络质量概览。 */
     readonly linkmicNetworkQuality: MutableState<PLVNetworkQuality>;
+    /** RTC 网络上下行统计信息。 */
     readonly linkmicNetworkStatistics: MutableState<PLVNetworkStatistics>;
+    /** 当前推流画面比例。 */
     readonly currentPushResolutionRatio: MutableState<PLVLinkMicPushResolutionRatio>;
+    /** 当前推流方向。 */
     readonly currentPushOrientation: MutableState<PLVPushOrientation>;
+    /** 当前推流清晰度档位。 */
     readonly currentBitRate: MutableState<PLVLinkMicBitRate>;
+    /** 频道支持的推流清晰度档位。 */
     readonly channelSupportBitRates: MutableState<PLVLinkMicBitRate[]>;
+    /** 当前清晰度对应的 RTC 编码参数。 */
     readonly currentBitRateEncodeParam: MutableState<PLVLinkMicBitRateEncodeParam>;
+    /** 频道支持的所有 RTC 编码参数。 */
     readonly channelSupportBitRateEncodeParams: MutableState<PLVLinkMicBitRateEncodeParam[]>;
+    /** 弱网时推流降级策略。 */
     readonly currentPushDowngradePreference: MutableState<PLVPushDowngradePreference>;
+    /** 当前使用的摄像头方向。 */
     readonly cameraFacing: MutableState<PLVLinkMicCameraFacing>;
+    /** 本地预览画面是否镜像。 */
     readonly localRenderMirror: MutableState<boolean>;
+    /** RTC 推流画面是否镜像。 */
     readonly currentPushMirror: MutableState<boolean>;
+    /** 是否使用新版连麦策略。新版策略会区分“讲师 RTC 能力”和“观众举手入口”。 */
     readonly isLinkMicStrategyV2: MutableState<boolean>;
+    /** RTC 层事件透出，例如远端用户发布/取消发布流。 */
     readonly rtcEvent: MutableEvent<PLVLinkMicRTCEvent>;
+    /** 讲师挂断本地连麦事件。 */
     readonly teacherHangUpLinkMicEvent: MutableEvent<number>;
+    /** 成员加入连麦事件。 */
     readonly viewerJoinLinkMicEvent: MutableEvent<PLVLinkMicViewer[]>;
+    /** 成员离开连麦事件。 */
     readonly viewerLeaveLinkMicEvent: MutableEvent<PLVLinkMicViewer[]>;
+    /** 观众响应讲师邀请事件。 */
     readonly viewerAnswerInvitationEvent: MutableEvent<PLVLinkMicAnswerInvitationEvent>;
+    /** 连麦模块统一错误事件。 */
     readonly errorEvent: MutableEvent<PLVLinkMicErrorEvent>;
+    /** 当前用户在 RTC/socket 协议中的连麦 ID。部分场景下它和 viewerId 不一致。 */
     linkmicId: string | undefined;
+    /** linkmicId 是否和 viewerId 不一致。为 true 时匹配自己需要同时兼容两个 ID。 */
     linkmicIdDifferFromViewerId: boolean;
+    /** 推流开始时由 streamer 模块回调，驱动讲师/嘉宾进入连麦状态。 */
     onStreamerStart: (() => void) | undefined;
+    /** 直播开始 socket 事件回调。 */
     onLiveStreamStart: (() => void) | undefined;
+    /** 直播停止 socket 事件回调。 */
     onLiveStreamStop: (() => void) | undefined;
+    /** 推流停止时由 streamer 模块回调，驱动连麦清理。 */
     onStreamerStop: (() => void) | undefined;
+    /** 推流模块回调到连麦编码用例，用于更新码率。 */
     setBitRate: ((bitRate: PLVLinkMicBitRate) => void) | undefined;
+    /** 推流模块回调到连麦编码用例，用于更新画面比例。 */
     setPushResolutionRatio: ((pushResolutionRatio: PLVLinkMicPushResolutionRatio) => void) | undefined;
+    /** 推流模块回调到连麦编码用例，用于更新推流方向。 */
     setPushOrientation: ((pushOrientation: PLVPushOrientation) => void) | undefined;
+    /** 推流模块回调到连麦编码用例，用于更新弱网降级策略。 */
     setPushDowngradePreference: ((preference: PLVPushDowngradePreference) => void) | undefined;
-    reportError(g20: number, h20: string): void;
-    isMySocketLinkMicId(d20: string | undefined | null): boolean;
-    findViewerByLinkMicId(b20?: string | null): PLVLinkMicViewer | undefined;
-    findViewerByViewerId(z19?: string | null): PLVLinkMicViewer | undefined;
+    /** 推流模块回调到连麦 RTC 用例，用于开始屏幕分享。 */
+    startScreenCapture: (() => number) | undefined;
+    /** 推流模块回调到连麦 RTC 用例，用于停止屏幕分享。 */
+    stopScreenCapture: (() => number) | undefined;
+    /**
+     * 统一上报模块错误事件，便于业务层监听和展示。
+     */
+    reportError(q21: number, r21: string): void;
+    isMySocketLinkMicId(n21: string | undefined | null): boolean;
+    /**
+     * 按 linkMicId 查找当前频道连麦成员。
+     */
+    findViewerByLinkMicId(l21?: string | null): PLVLinkMicViewer | undefined;
+    /**
+     * 按 viewerId 查找当前频道连麦成员。
+     */
+    findViewerByViewerId(j21?: string | null): PLVLinkMicViewer | undefined;
+    /**
+     * 释放当前对象持有的监听、定时器和临时状态，避免页面退出后继续收到回调。
+     */
     onDestroy(): void;
 }

package/src/main/ets/modules/linkmic/mediator/PLVLinkMicRTCEventCallback.d.ets

@@ -2,15 +2,20 @@
 // @ts-nocheck
 import { PLVRTCConfig, PLVRTCEngineEventCallback, PLVRTCMediaState, PLVRTCNetworkQuality, PLVRTCNetworkStatistics } from '@polyvharmony/rtc-sdk';
 import { PLVLinkMicMediator } from './PLVLinkMicMediator';
+/**
+ * 业务模型，承载当前模块内的结构化数据
+ */
 export declare class PLVLinkMicRTCEventCallback extends PLVRTCEngineEventCallback {
     private readonly mediator;
-    constructor(c21: PLVLinkMicMediator);
-    onJoinChannelSuccess(z20: PLVRTCConfig, a21: string): void;
-    onUserMediaStateChanged(w20: string, x20: PLVRTCMediaState): void;
-    onTokenExpired(t20: string | undefined, u20: PLVRTCConfig): void;
-    onNetworkQuality(p20: string, q20: PLVRTCNetworkQuality, r20: PLVRTCNetworkQuality): void;
-    onNetworkStatistics(n20: PLVRTCNetworkStatistics): void;
-    onKickOut(l20: number): void;
-    onError(j20: number, k20: string): void;
+    constructor(m22: PLVLinkMicMediator);
+    onJoinChannelSuccess(j22: PLVRTCConfig, k22: string): void;
+    onScreenCaptureStarted(): void;
+    onScreenCaptureStoped(): void;
+    onUserMediaStateChanged(g22: string, h22: PLVRTCMediaState): void;
+    onTokenExpired(d22: string | undefined, e22: PLVRTCConfig): void;
+    onNetworkQuality(z21: string, a22: PLVRTCNetworkQuality, b22: PLVRTCNetworkQuality): void;
+    onNetworkStatistics(x21: PLVRTCNetworkStatistics): void;
+    onKickOut(v21: number): void;
+    onError(t21: number, u21: string): void;
     private convertNetworkQuality;
 }

package/src/main/ets/modules/linkmic/model/PLVLinkMicRepo.d.ets

@@ -6,12 +6,18 @@ import { PLVLinkMicNetworkDataSource } from './datasource/PLVLinkMicNetworkDataS
 import { PLVRTCClientRole, PLVRTCMediaState, PLVRTCRenderViewParam, PLVRTCVideoEncodeParam, PLVRTCVideoRenderParam } from '@polyvharmony/rtc-sdk';
 import { PLVLinkMicChannelStatus } from './vo/PLVLinkMicChannelStatus';
 import { PLVLiveViewLogVO } from '../../business/model/PLVLiveViewLogVO';
+/**
+ * 模块数据仓库，封装 mediator、网络数据源、本地数据源和 RTC 依赖的访问入口
+ */
 export declare class PLVLinkMicRepo implements LifecycleAwareDependComponent {
     readonly mediator: PLVLinkMicMediator;
     private readonly networkDataSource;
     private readonly rtcConfig;
     private rtcEngine;
-    constructor(v23: PLVLinkMicMediator, w23: PLVLinkMicNetworkDataSource);
+    constructor(p25: PLVLinkMicMediator, q25: PLVLinkMicNetworkDataSource);
+    /**
+     * 初始化当前用例或模块，注册依赖、状态监听和 socket/RTC 回调。
+     */
     init(): Promise<void>;
     private initLinkMicId;
     private initRtcEngine;
@@ -19,18 +25,23 @@ export declare class PLVLinkMicRepo implements LifecycleAwareDependComponent {
     private initLinkMicStrategy;
     getChannelLinkMicStatus(): Promise<PLVLinkMicChannelStatus>;
     sendLinkMicIdRelation(): Promise<void>;
-    sendLiveViewLog(z22: PLVLiveViewLogVO): Promise<void>;
+    sendLiveViewLog(t24: PLVLiveViewLogVO): Promise<void>;
     joinRTCChannel(): void;
-    switchRTCRole(w22: PLVRTCClientRole): void;
-    enableLocalVideo(v22: boolean): void;
-    enableLocalAudio(u22: boolean): void;
+    switchRTCRole(q24: PLVRTCClientRole): void;
+    startScreenCapture(): number;
+    stopScreenCapture(): number;
+    enableLocalVideo(p24: boolean): void;
+    enableLocalAudio(o24: boolean): void;
     switchCamera(): void;
-    setLocalVideoEncodeParam(t22: PLVRTCVideoEncodeParam): void;
-    setVideoRender(s22: PLVRTCVideoRenderParam): void;
-    getVideoRenderParam(r22: string): PLVRTCVideoRenderParam | null;
-    createRenderViewParam(q22: string): PLVRTCRenderViewParam | undefined;
-    getRemoteViewerMediaState(p22: string): PLVRTCMediaState | undefined;
+    setLocalVideoEncodeParam(n24: PLVRTCVideoEncodeParam): void;
+    setVideoRender(m24: PLVRTCVideoRenderParam): void;
+    getVideoRenderParam(l24: string): PLVRTCVideoRenderParam | null;
+    createRenderViewParam(k24: string): PLVRTCRenderViewParam | undefined;
+    getRemoteViewerMediaState(j24: string): PLVRTCMediaState | undefined;
     renewToken(): Promise<void>;
     leaveRTCChannel(): void;
+    /**
+     * 释放当前对象持有的监听、定时器和临时状态，避免页面退出后继续收到回调。
+     */
     onDestroy(): Promise<void>;
 }

package/src/main/ets/modules/linkmic/model/datasource/PLVLinkMicNetworkDataSource.d.ets

@@ -4,15 +4,19 @@ import { PLVLinkMicMediator } from '../../mediator/PLVLinkMicMediator';
 import { PLVRTCAppToken } from '@polyvharmony/rtc-sdk';
 import { PLVLinkMicChannelStatus } from '../vo/PLVLinkMicChannelStatus';
 import { PLVLiveViewLogVO } from '../../../business/model/PLVLiveViewLogVO';
+/**
+ * 网络数据源，负责调用服务端接口并屏蔽接口细节
+ */
 export declare class PLVLinkMicNetworkDataSource {
     private readonly mediator;
-    constructor(n22: PLVLinkMicMediator);
-    getChannelLinkMicStatus(h22: string, i22: string): Promise<PLVLinkMicChannelStatus>;
+    constructor(h24: PLVLinkMicMediator);
+    getChannelLinkMicStatus(b24: string, c24: string): Promise<PLVLinkMicChannelStatus>;
     getLinkMicToken(): Promise<PLVRTCAppToken>;
-    sendLinkMicIdRelation(a22: string, b22: string, c22: string): Promise<void>;
-    sendLiveViewLog(z21: PLVLiveViewLogVO): Promise<void>;
+    sendLinkMicIdRelation(u23: string, v23: string, w23: string): Promise<void>;
+    sendLiveViewLog(t23: PLVLiveViewLogVO): Promise<void>;
     private getARTCLinkMicToken;
     private getTRTCLinkMicToken;
+    private getVRTCLinkMicToken;
     private createLinkMicStatisticsData;
     private get api_polyv_net();
     private get rtas_videocc_net();

package/src/main/ets/modules/linkmic/model/vo/PLVLinkMicBitRate.d.ets

@@ -1,9 +1,12 @@
 // @keepTs
 // @ts-nocheck
+/**
+ * 码率档位模型，描述频道支持的推流清晰度档位
+ */
 export declare class PLVLinkMicBitRate {
     readonly index: number;
     readonly name: string | Resource;
-    constructor(x23: number, y23: string | Resource);
+    constructor(r25: number, s25: string | Resource);
     get nameString(): string;
     static STANDARD: PLVLinkMicBitRate;
     static HIGH: PLVLinkMicBitRate;

package/src/main/ets/modules/linkmic/model/vo/PLVLinkMicBitRateEncodeParam.d.ets

@@ -1,6 +1,9 @@
 // @keepTs
 // @ts-nocheck
 import { PLVLinkMicBitRate } from './PLVLinkMicBitRate';
+/**
+ * 码率编码参数模型，描述 RTC 推流所需的视频编码配置
+ */
 export declare class PLVLinkMicBitRateEncodeParam {
     readonly bitRate: PLVLinkMicBitRate;
     readonly videoFps: number;
@@ -13,6 +16,6 @@ export declare class PLVLinkMicBitRateEncodeParam {
     readonly screenWidth: number;
     readonly screenHeight: number;
     readonly screenBitrate: number;
-    constructor(z23: PLVLinkMicBitRate, a24: number, b24: number, c24: number, d24: number, e24: number, f24: number, g24: number, h24: number, i24: number, j24: number);
+    constructor(t25: PLVLinkMicBitRate, u25: number, v25: number, w25: number, x25: number, y25: number, z25: number, a26: number, b26: number, c26: number, d26: number);
 }
 export declare const DEFAULT_BITRATE_ENCODE_PARAM_TABLE: PLVLinkMicBitRateEncodeParam[];

package/src/main/ets/modules/linkmic/model/vo/PLVLinkMicCameraFacing.d.ets

@@ -1,5 +1,8 @@
 // @keepTs
 // @ts-nocheck
+/**
+ * 业务模型，承载当前模块内的结构化数据
+ */
 export declare class PLVLinkMicCameraFacing {
     private constructor();
     /**

package/src/main/ets/modules/linkmic/model/vo/PLVLinkMicChannelStatus.d.ets

@@ -1,5 +1,8 @@
 // @keepTs
 // @ts-nocheck
+/**
+ * 业务模型，承载当前模块内的结构化数据
+ */
 export declare class PLVLinkMicChannelStatus {
     master?: string | null;
     microphoneStatus?: string | null;

package/src/main/ets/modules/linkmic/model/vo/PLVLinkMicErrorEvent.d.ets

@@ -1,5 +1,8 @@
 // @keepTs
 // @ts-nocheck
+/**
+ * 错误事件枚举，定义模块内部向外透出的错误类型
+ */
 export declare class PLVLinkMicErrorEvent {
     /**
      * 连麦模块初始化失败
@@ -15,5 +18,5 @@ export declare class PLVLinkMicErrorEvent {
     static readonly RTC_ENGINE_ERROR = 10;
     readonly code: number;
     readonly message: string;
-    constructor(k24: number, l24: string);
+    constructor(e26: number, f26: string);
 }

package/src/main/ets/modules/linkmic/model/vo/PLVLinkMicInteractEvent.d.ets

@@ -1,8 +1,11 @@
 // @keepTs
 // @ts-nocheck
 import { PLVMemberChannelViewer } from "../../../member/model/vo/PLVMemberChannelViewer";
+/**
+ * 连麦交互事件模型，描述邀请、响应等 UI 可感知事件
+ */
 export declare class PLVLinkMicAnswerInvitationEvent {
     readonly viewer: PLVMemberChannelViewer;
     readonly accept: boolean;
-    constructor(m24: PLVMemberChannelViewer, n24: boolean);
+    constructor(g26: PLVMemberChannelViewer, h26: boolean);
 }

package/src/main/ets/modules/linkmic/model/vo/PLVLinkMicMode.d.ets

@@ -1,5 +1,8 @@
 // @keepTs
 // @ts-nocheck
+/**
+ * 模式枚举，定义业务可选工作模式
+ */
 export declare enum PLVLinkMicMode {
     /**
      * 音频连麦

package/src/main/ets/modules/linkmic/model/vo/PLVLinkMicPushResolutionRatio.d.ets

@@ -1,10 +1,13 @@
 // @keepTs
 // @ts-nocheck
+/**
+ * 业务模型，承载当前模块内的结构化数据
+ */
 export declare class PLVLinkMicPushResolutionRatio {
     readonly width: number;
     readonly height: number;
     readonly ratio: number;
-    constructor(o24: number, p24: number);
+    constructor(i26: number, j26: number);
     static RATIO_16_9: PLVLinkMicPushResolutionRatio;
     static RATIO_4_3: PLVLinkMicPushResolutionRatio;
 }

package/src/main/ets/modules/linkmic/model/vo/PLVLinkMicRTCEvent.d.ets

@@ -1,16 +1,28 @@
 // @keepTs
 // @ts-nocheck
 import { PLVRTCConfig } from '@polyvharmony/rtc-sdk';
+/**
+ * 业务模型，承载当前模块内的结构化数据
+ */
 export declare class PLVLinkMicRTCEvent {
 }
+/**
+ * 业务模型，承载当前模块内的结构化数据
+ */
 export declare class PLVLinkMicRTCJoinSuccess extends PLVLinkMicRTCEvent {
     rtcConfig?: PLVRTCConfig;
     channelId?: string;
 }
+/**
+ * 业务模型，承载当前模块内的结构化数据
+ */
 export declare class PLVLinkMicRTCTokenExpired extends PLVLinkMicRTCEvent {
     rtcConfig?: PLVRTCConfig;
     channelId?: string;
 }
+/**
+ * 业务模型，承载当前模块内的结构化数据
+ */
 export declare class PLVLinkMicRTCKickOut extends PLVLinkMicRTCEvent {
     code?: number;
 }

package/src/main/ets/modules/linkmic/model/vo/PLVLinkMicRTCType.d.ets

@@ -1,6 +1,10 @@
 // @keepTs
 // @ts-nocheck
+/**
+ * 业务模型，承载当前模块内的结构化数据
+ */
 export declare enum PLVLinkMicRTCType {
     ARTC = "agora",
-    TRTC = "trtc"
+    TRTC = "trtc",
+    VRTC = "volc"
 }

package/src/main/ets/modules/linkmic/model/vo/PLVLinkMicSocketEvent.d.ets

@@ -1,41 +1,65 @@
 // @keepTs
 // @ts-nocheck
 import { PLVSocketUserRecv, PLVSocketUserSend } from '../../../socket/model/PLVSocketUserBean';
+/**
+ * 观众响应连麦邀请发送模型
+ */
 export declare class PLVLinkMicSocketJoinAnswerSend {
     user?: PLVSocketUserSend | null;
     roomId?: string | null;
     status?: number | null;
 }
+/**
+ * 观众响应连麦邀请接收模型
+ */
 export declare class PLVLinkMicSocketJoinAnswerRecv {
     status?: number | null;
     userId?: string | null;
     result?: boolean | null;
     isAutoAnswer?: boolean | null;
 }
+/**
+ * 连麦邀请倒计时/过期时间发送模型
+ */
 export declare class PLVLinkMicSocketJoinAnswerTTLSend {
     userId?: string | null;
     roomId?: string | null;
     sessionId?: string | null;
 }
+/**
+ * 成员离开连麦接收模型
+ */
 export declare class PLVLinkMicSocketJoinLeaveRecv {
     user?: PLVSocketUserRecv | null;
     isLeaveMic?: number | null;
     requestIndex?: number | null;
     roomId?: string | null;
 }
+/**
+ * 成员离开连麦发送模型
+ */
 export declare class PLVLinkMicSocketJoinLeaveSend {
     user?: PLVSocketUserSend | null;
     roomId?: string | null;
 }
+/**
+ * 观众举手申请连麦接收模型
+ */
 export declare class PLVLinkMicSocketJoinRequestRecv {
     user?: PLVSocketUserRecv | null;
     requestIndex?: number | null;
     roomId?: string | null;
 }
+/**
+ * 观众举手申请连麦发送模型
+ */
 export declare class PLVLinkMicSocketJoinRequestSend {
     user?: PLVSocketUserSend | null;
     roomId?: string | null;
 }
+/**
+ * 讲师接受或拒绝连麦申请接收模型
+ */
 export declare class PLVLinkMicSocketJoinResponseRecv {
     user?: PLVSocketUserRecv | null;
     roomId?: string | null;
@@ -45,6 +69,9 @@ export declare class PLVLinkMicSocketJoinResponseRecv {
     needAnswer?: number | boolean | string | null;
     isNeedAnswer(): boolean;
 }
+/**
+ * 讲师接受或拒绝连麦申请发送模型
+ */
 export declare class PLVLinkMicSocketJoinResponseSend {
     user?: PLVSocketUserSend | null;
     roomId?: string | null;
@@ -52,23 +79,35 @@ export declare class PLVLinkMicSocketJoinResponseSend {
     toEmitAll?: number | null;
     needAnswer?: number | null;
 }
+/**
+ * 成员成功加入连麦接收模型
+ */
 export declare class PLVLinkMicSocketJoinSuccessRecv {
     user?: PLVSocketUserRecv | null;
     roomId?: string | null;
     sessionId?: string | null;
     requestIndex?: number | null;
 }
+/**
+ * 成员成功加入连麦发送模型
+ */
 export declare class PLVLinkMicSocketJoinSuccessSend {
     user?: PLVSocketUserSend | null;
     roomId?: string | null;
     sessionId?: string | null;
 }
+/**
+ * 频道连麦开关和连麦模式同步接收模型
+ */
 export declare class PLVLinkMicSocketOpenMicrophoneRecv {
     roomId?: string | null;
     status?: string | null;
     type?: string | null;
     userId?: string | null;
 }
+/**
+ * 频道连麦开关和连麦模式同步发送模型
+ */
 export declare class PLVLinkMicSocketOpenMicrophoneSend {
     EVENT: string;
     roomId?: string | null;
@@ -77,12 +116,21 @@ export declare class PLVLinkMicSocketOpenMicrophoneSend {
     userId?: string | null;
     type?: string | null;
 }
+/**
+ * 连麦邀请倒计时/过期时间确认回包模型
+ */
 export declare class PLVLinkMicSocketJoinAnswerTTLAck {
     message?: number[] | null;
 }
+/**
+ * PLVLinkMicSocketMicSettingSend 发送模型
+ */
 export declare class PLVLinkMicSocketMicSettingSend {
     EVENT: string;
 }
+/**
+ * PLVLinkMicSocketMicSettingAck 确认回包模型
+ */
 export declare class PLVLinkMicSocketMicSettingAck {
     message?: PLVLinkMicSocketMicSettingAckMessage[] | null;
 }
@@ -96,23 +144,35 @@ declare class PLVLinkMicSocketMicSettingAckMessageData {
     status?: string | null;
     type?: string | null;
 }
+/**
+ * 第一画面切换接收模型
+ */
 export declare class PLVLinkMicSocketSwitchViewRecv {
     socketId?: string | null;
     roomId?: string | null;
     userId?: string | null;
 }
+/**
+ * 第一画面切换发送模型
+ */
 export declare class PLVLinkMicSocketSwitchViewSend {
     emitMode?: number | null;
     roomId?: string | null;
     userId?: string | null;
     socketId?: string | null;
 }
+/**
+ * PLVLinkMicSocketMuteUserMicroRecv 接收模型
+ */
 export declare class PLVLinkMicSocketMuteUserMicroRecv {
     socketId?: string | null;
     userId?: string | null;
     type?: string | null;
     mute?: boolean | null;
 }
+/**
+ * 讲师控制成员摄像头或麦克风开关发送模型
+ */
 export declare class PLVLinkMicSocketMuteUserMediaSend {
     EVENT: string;
     sessionId?: string | null;
@@ -121,6 +181,9 @@ export declare class PLVLinkMicSocketMuteUserMediaSend {
     userId?: string | null;
     type?: string | null;
 }
+/**
+ * 讲师授予或收回成员权限发送模型
+ */
 export declare class PLVLinkMicSocketTeacherSetPermissionSend {
     EVENT: string;
     roomId?: string | null;
@@ -132,6 +195,9 @@ export declare class PLVLinkMicSocketTeacherSetPermissionSend {
     toAll?: boolean | null;
     sign?: string | null;
 }
+/**
+ * 讲师授予或收回成员权限接收模型
+ */
 export declare class PLVLinkMicSocketTeacherSetPermissionRecv {
     roomId?: string | null;
     userId?: string | null;
@@ -142,6 +208,9 @@ export declare class PLVLinkMicSocketTeacherSetPermissionRecv {
     toDelete?: boolean | null;
     toJoinMicList?: boolean | null;
 }
+/**
+ * PLVLinkMicSocketSwitchJoinVoiceRecv 接收模型
+ */
 export declare class PLVLinkMicSocketSwitchJoinVoiceRecv {
     status?: number | null;
     currentTime?: number | null;

package/src/main/ets/modules/linkmic/model/vo/PLVLinkMicState.d.ets

@@ -1,5 +1,8 @@
 // @keepTs
 // @ts-nocheck
+/**
+ * 状态枚举，定义模块核心业务状态
+ */
 export declare enum PLVLinkMicState {
     /**
      * 未连麦状态

package/src/main/ets/modules/linkmic/model/vo/PLVLinkMicVideoRenderParam.d.ets

@@ -1,5 +1,8 @@
 // @keepTs
 // @ts-nocheck
+/**
+ * 视频渲染参数模型，描述远端画面渲染所需的用户和视图信息
+ */
 export declare class PLVLinkMicVideoRenderParam {
     /**
      * 连麦ID
@@ -9,5 +12,5 @@ export declare class PLVLinkMicVideoRenderParam {
      * XComponent 视图ID，null 解除渲染绑定
      */
     readonly xcomponentId: string | null;
-    constructor(q24: string, r24: string | null);
+    constructor(k26: string, l26: string | null);
 }

package/src/main/ets/modules/linkmic/model/vo/PLVLinkMicViewer.d.ets

@@ -1,6 +1,9 @@
 // @keepTs
 // @ts-nocheck
 import { MutableState } from '@polyvharmony/media-player-sdk';
+/**
+ * 连麦用户模型，描述本地或频道内连麦成员的关键 RTC 信息
+ */
 export declare class PLVLinkMicViewer {
     readonly channelId: string;
     readonly linkmicId: string;
@@ -18,5 +21,5 @@ export declare class PLVLinkMicViewer {
     viewerActor?: string;
     isMyself: boolean;
     linkmicStartTimestamp: number;
-    constructor(s24: string, t24: string, u24: string, v24: string);
+    constructor(m26: string, n26: string, o26: string, p26: string);
 }