@polyvharmony/live-scenes-sdk 1.5.0 → 1.6.0

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

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;

package/src/main/ets/modules/linkmic/viewmodel/PLVLinkMicViewModel.d.ets

@@ -5,32 +5,91 @@ import { PLVLinkMicRepo } from '../model/PLVLinkMicRepo';
 import { PLVLinkMicMode } from '../model/vo/PLVLinkMicMode';
 import { PLVLinkMicVideoRenderParam } from '../model/vo/PLVLinkMicVideoRenderParam';
 import { PLVLinkMicUseCases } from './usecase/PLVLinkMicUseCases';
+/**
+ * 模块视图模型，承接 Manager 调用并分发到具体 UseCase
+ */
 export declare class PLVLinkMicViewModel {
     private readonly repo;
     private readonly useCases;
     constructor(i28: PLVLinkMicRepo, j28: PLVLinkMicUseCases);
+    /**
+     * 初始化当前用例或模块，注册依赖、状态监听和 socket/RTC 回调。
+     */
     init(): Promise<void>;
+    /**
+     * 申请加入连麦，实际行为由当前登录角色对应的状态用例决定。
+     */
     requestLinkMic(): void;
+    /**
+     * 接受讲师连麦邀请，并进入当前角色对应的上麦流程。
+     */
     acceptLinkMicInvitation(): void;
+    /**
+     * 拒绝讲师连麦邀请，同时向聊天室同步拒绝结果。
+     */
     refuseLinkMicInvitation(): void;
+    /**
+     * 主动离开连麦，内部会按角色执行退房和状态清理。
+     */
     leaveLinkMic(): void;
+    /**
+     * 设置频道连麦模式。新版策略下切换模式可能需要关闭或重开举手入口。
+     */
     setLinkMicMode(h28: PLVLinkMicMode): Promise<boolean>;
+    /**
+     * 开启连麦入口，允许观众或嘉宾按当前频道策略申请上麦。
+     */
     openLinkMic(): Promise<boolean>;
+    /**
+     * 关闭连麦入口，并按策略决定是否保留讲师自身的连麦能力。
+     */
     closeLinkMic(): Promise<boolean>;
+    /**
+     * 讲师接受指定观众的连麦申请。
+     */
     acceptViewerLinkMicRequest(g28: string): void;
+    /**
+     * 讲师邀请指定观众上麦，可选择是否需要对方确认。
+     */
     inviteViewerLinkMic(e28: string, f28: boolean): void;
+    /**
+     * 讲师挂断指定观众的连麦。
+     */
     hangupViewerLinkMic(d28: string): void;
+    /**
+     * 讲师发起全体下麦。
+     */
     hangupAllViewersLinkMic(): void;
+    /**
+     * 讲师控制指定观众摄像头开关。
+     */
     setViewerEnableCamera(b28: string, c28: boolean): void;
+    /**
+     * 讲师控制指定观众麦克风开关。
+     */
     setViewerEnableMicrophone(z27: string, a28: boolean): void;
+    /**
+     * 授予指定观众主讲权限，并同步主画面。
+     */
     grantSpeaker(y27: string): void;
+    /**
+     * 收回主讲权限，将主讲和主画面切回讲师。
+     */
     revokeSpeaker(x27: string): void;
+    /**
+     * 设置频道主画面用户。
+     */
     setMainView(w27: string): void;
     enableCamera(v27: boolean): void;
     enableMicrophone(u27: boolean): void;
     enableCameraMicrophoneToLastState(): void;
     switchCamera(): void;
+    startScreenCapture(): number;
+    stopScreenCapture(): number;
     setLocalMirror(t27: boolean): void;
+    /**
+     * 设置当前推流方向。
+     */
     setPushOrientation(s27: PLVPushOrientation): void;
     setupVideoRender(r27: PLVLinkMicVideoRenderParam): void;
     removeVideoRender(q27: PLVLinkMicVideoRenderParam): void;

package/src/main/ets/modules/linkmic/viewmodel/usecase/LinkMicEncodeParamUseCase.d.ets

@@ -5,14 +5,34 @@ import { ILinkMicEncodeParamUseCase } from './roles/base/ILinkMicEncodeParamUseC
 import { PLVLinkMicBitRate } from '../../model/vo/PLVLinkMicBitRate';
 import { PLVLinkMicPushResolutionRatio } from '../../model/vo/PLVLinkMicPushResolutionRatio';
 import { PLVPushDowngradePreference, PLVPushOrientation } from '@polyvharmony/rtc-sdk';
-export declare class LinkMicEncodeParamUseCase implements ILinkMicEncodeParamUseCase {
+import { LifecycleAwareDependComponent } from '@polyvharmony/media-player-sdk';
+/**
+ * 编码参数用例，负责根据频道配置和当前设置计算 RTC 推流编码参数
+ */
+export declare class LinkMicEncodeParamUseCase implements ILinkMicEncodeParamUseCase, LifecycleAwareDependComponent {
     private readonly repo;
     private impl;
     constructor(u28: PLVLinkMicRepo);
+    /**
+     * 初始化当前用例或模块，注册依赖、状态监听和 socket/RTC 回调。
+     */
     init(): void;
+    /**
+     * 设置当前推流码率档位。
+     */
     setBitRate(s28: PLVLinkMicBitRate): void;
+    /**
+     * 设置当前推流画面比例。
+     */
     setPushResolutionRatio(r28: PLVLinkMicPushResolutionRatio): void;
+    /**
+     * 设置当前推流方向。
+     */
     setPushOrientation(q28: PLVPushOrientation): void;
     setPushMirror(p28: boolean): void;
+    /**
+     * 设置弱网场景下优先保清晰度还是保流畅度。
+     */
     setPushDowngradePreference(o28: PLVPushDowngradePreference): void;
+    onDestroy(): void;
 }

package/src/main/ets/modules/linkmic/viewmodel/usecase/LinkMicHandleQueueOrderUseCase.d.ets

@@ -2,6 +2,9 @@
 // @ts-nocheck
 import { PLVLinkMicRepo } from '../../model/PLVLinkMicRepo';
 import { PLVLinkMicSocketJoinLeaveRecv, PLVLinkMicSocketJoinRequestRecv, PLVLinkMicSocketJoinSuccessRecv } from '../../model/vo/PLVLinkMicSocketEvent';
+/**
+ * 连麦排队序号用例，负责维护观众申请连麦后的等待位置
+ */
 export declare class LinkMicHandleQueueOrderUseCase {
     private readonly repo;
     constructor(h29: PLVLinkMicRepo);

package/src/main/ets/modules/linkmic/viewmodel/usecase/LinkMicHandleRTCUseCase.d.ets

@@ -5,22 +5,39 @@ import { PLVRTCClientRole } from '@polyvharmony/rtc-sdk';
 import { PLVLinkMicRepo } from '../../model/PLVLinkMicRepo';
 import { PLVLinkMicVideoRenderParam } from '../../model/vo/PLVLinkMicVideoRenderParam';
 import { ILinkMicHandleRTCUseCase } from './roles/base/ILinkMicHandleRTCUseCase';
+/**
+ * RTC 处理用例，封装连麦 RTC 加房、退房、发布、订阅和媒体控制
+ */
 export declare class LinkMicHandleRTCUseCase implements ILinkMicHandleRTCUseCase, LifecycleAwareDependComponent {
     private readonly repo;
     private observers;
     private impl;
     constructor(q29: PLVLinkMicRepo);
+    /**
+     * 初始化当前用例或模块，注册依赖、状态监听和 socket/RTC 回调。
+     */
     init(): void;
+    /**
+     * 加入 RTC 房间并根据角色发布或订阅音视频流。
+     */
     joinChannel(): void;
+    /**
+     * 退出 RTC 房间并清理本地/远端媒体状态。
+     */
     leaveChannel(): void;
     switchRole(n29: PLVRTCClientRole): void;
     enableCamera(m29: boolean): void;
     enableMicrophone(l29: boolean): void;
     enableCameraMicrophoneToLastState(): void;
     switchCamera(): void;
+    startScreenCapture(): number;
+    stopScreenCapture(): number;
     setLocalRenderMirror(k29: boolean): void;
     setupVideoRender(j29: PLVLinkMicVideoRenderParam): void;
     removeVideoRender(i29: PLVLinkMicVideoRenderParam): void;
+    /**
+     * 释放当前对象持有的监听、定时器和临时状态，避免页面退出后继续收到回调。
+     */
     onDestroy(): void;
     private renewToken;
 }

package/src/main/ets/modules/linkmic/viewmodel/usecase/LinkMicHandleStateUseCase.d.ets

@@ -7,6 +7,9 @@ import { LinkMicHandleQueueOrderUseCase } from './LinkMicHandleQueueOrderUseCase
 import { LinkMicHandleRTCUseCase } from './LinkMicHandleRTCUseCase';
 import { LinkMicUpdateChannelViewerUseCase } from './LinkMicUpdateChannelViewerUseCase';
 import { PLVLinkMicMode } from '../../model/vo/PLVLinkMicMode';
+/**
+ * 连麦/推流状态处理用例，负责角色相关的状态流转和 socket 协议交互
+ */
 export declare class LinkMicHandleStateUseCase implements ILinkMicHandleStateUseCase, LifecycleAwareDependComponent {
     private readonly repo;
     private readonly handleQueueOrderUseCase;
@@ -14,27 +17,72 @@ export declare class LinkMicHandleStateUseCase implements ILinkMicHandleStateUse
     private readonly updateChannelViewerUseCase;
     private impl;
     constructor(e30: PLVLinkMicRepo, f30: LinkMicHandleQueueOrderUseCase, g30: LinkMicHandleRTCUseCase, h30: LinkMicUpdateChannelViewerUseCase);
+    /**
+     * 初始化当前用例或模块，注册依赖、状态监听和 socket/RTC 回调。
+     */
     init(): void;
     requestJoinLinkMic(): Promise<void>;
     acceptInvitation(): Promise<void>;
     refuseInvitation(): void;
+    /**
+     * 主动离开连麦，内部会按角色执行退房和状态清理。
+     */
     leaveLinkMic(): void;
     onStreamerStart(): void;
     onLiveStreamStart(): void;
+    /**
+     * 设置频道连麦模式。新版策略下切换模式可能需要关闭或重开举手入口。
+     */
     setLinkMicMode(c30: PLVLinkMicMode): Promise<boolean>;
+    /**
+     * 开启连麦入口，允许观众或嘉宾按当前频道策略申请上麦。
+     */
     openLinkMic(): Promise<boolean>;
+    /**
+     * 关闭连麦入口，并按策略决定是否保留讲师自身的连麦能力。
+     */
     closeLinkMic(): Promise<boolean>;
+    /**
+     * 讲师接受指定观众的连麦申请。
+     */
     acceptViewerLinkMicRequest(b30: string): void;
+    /**
+     * 讲师邀请指定观众上麦，可选择是否需要对方确认。
+     */
     inviteViewerLinkMic(z29: string, a30: boolean): void;
+    /**
+     * 讲师挂断指定观众的连麦。
+     */
     hangupViewerLinkMic(y29: string): void;
+    /**
+     * 讲师发起全体下麦。
+     */
     hangupAllViewersLinkMic(): void;
+    /**
+     * 讲师控制指定观众摄像头开关。
+     */
     setViewerEnableCamera(w29: string, x29: boolean): void;
+    /**
+     * 讲师控制指定观众麦克风开关。
+     */
     setViewerEnableMicrophone(u29: string, v29: boolean): void;
+    /**
+     * 授予指定观众主讲权限，并同步主画面。
+     */
     grantSpeaker(t29: string): void;
+    /**
+     * 收回主讲权限，将主讲和主画面切回讲师。
+     */
     revokeSpeaker(s29: string): void;
+    /**
+     * 设置频道主画面用户。
+     */
     setMainView(r29: string): void;
     onLiveStreamStop(): void;
     onStreamerStop(): void;
     updateInvitationExpireTime(): void;
+    /**
+     * 释放当前对象持有的监听、定时器和临时状态，避免页面退出后继续收到回调。
+     */
     onDestroy(): void;
 }

package/src/main/ets/modules/linkmic/viewmodel/usecase/LinkMicUpdateChannelViewerUseCase.d.ets

@@ -4,24 +4,45 @@ import { LifecycleAwareDependComponent } from '@polyvharmony/media-player-sdk';
 import { PLVLinkMicRepo } from '../../model/PLVLinkMicRepo';
 import { PLVLinkMicSocketJoinLeaveRecv, PLVLinkMicSocketJoinSuccessRecv, PLVLinkMicSocketSwitchViewRecv, PLVLinkMicSocketTeacherSetPermissionRecv } from '../../model/vo/PLVLinkMicSocketEvent';
 import { PLVLinkMicViewer } from '../../model/vo/PLVLinkMicViewer';
+/**
+ * 频道连麦成员刷新用例，负责拉取并合并当前频道连麦成员列表
+ */
 export declare class LinkMicUpdateChannelViewerUseCase implements LifecycleAwareDependComponent {
     private readonly repo;
     private taskUpdateChannelLinkMicViewers;
     private observers;
     constructor(q32: PLVLinkMicRepo);
+    /**
+     * 初始化当前用例或模块，注册依赖、状态监听和 socket/RTC 回调。
+     */
     init(): void;
+    /**
+     * 合并频道连麦成员增删变化，并同步到状态和事件。
+     */
     handleChannelLinkMicViewersUpdate(z31: UpdateChannelLinkMicViewerPayload): void;
     sortChannelLinkMicViewers(): void;
     onEventJoinSuccess(r31: PLVLinkMicSocketJoinSuccessRecv): void;
     onEventJoinLeave(o31: PLVLinkMicSocketJoinLeaveRecv): void;
     onEventTeacherSetPermission(j31: PLVLinkMicSocketTeacherSetPermissionRecv): void;
     onEventSwitchView(i31: PLVLinkMicSocketSwitchViewRecv): void;
+    /**
+     * 启动轮询刷新频道连麦成员列表。
+     */
     startUpdateChannelLinkMicViewersInterval(): void;
+    /**
+     * 停止轮询刷新频道连麦成员列表。
+     */
     stopUpdateChannelLinkMicViewersInterval(): void;
     private updateByChannelLinkMicStatus;
+    /**
+     * 释放当前对象持有的监听、定时器和临时状态，避免页面退出后继续收到回调。
+     */
     onDestroy(): void;
     private getViewerSortOrder;
 }
+/**
+ * 频道连麦成员刷新用例，负责拉取并合并当前频道连麦成员列表
+ */
 export declare class UpdateChannelLinkMicViewerPayload {
     add?: (PLVLinkMicViewer | undefined)[];
     remove?: (PLVLinkMicViewer | undefined)[];

package/src/main/ets/modules/linkmic/viewmodel/usecase/LinkMicViewLogUseCase.d.ets

@@ -2,6 +2,9 @@
 // @ts-nocheck
 import { LifecycleAwareDependComponent } from '@polyvharmony/media-player-sdk';
 import { PLVLinkMicRepo } from '../../model/PLVLinkMicRepo';
+/**
+ * 连麦观看日志用例，负责上报连麦过程中的统计数据
+ */
 export declare class LinkMicViewLogUseCase implements LifecycleAwareDependComponent {
     private readonly repo;
     private viewLogTask;
@@ -10,10 +13,16 @@ export declare class LinkMicViewLogUseCase implements LifecycleAwareDependCompon
     private playDuration;
     private observers;
     constructor(v32: PLVLinkMicRepo);
+    /**
+     * 初始化当前用例或模块，注册依赖、状态监听和 socket/RTC 回调。
+     */
     init(): void;
     private startViewLogTask;
     private stopViewLogTask;
     private onViewLogTaskInterval;
     private sendViewLog;
+    /**
+     * 释放当前对象持有的监听、定时器和临时状态，避免页面退出后继续收到回调。
+     */
     onDestroy(): void;
 }

package/src/main/ets/modules/linkmic/viewmodel/usecase/PLVLinkMicUseCases.d.ets

@@ -6,6 +6,9 @@ import { LinkMicHandleRTCUseCase } from './LinkMicHandleRTCUseCase';
 import { LinkMicHandleStateUseCase } from './LinkMicHandleStateUseCase';
 import { LinkMicUpdateChannelViewerUseCase } from './LinkMicUpdateChannelViewerUseCase';
 import { LinkMicViewLogUseCase } from './LinkMicViewLogUseCase';
+/**
+ * UseCase 聚合对象，按角色和职责组合模块业务能力
+ */
 export declare class PLVLinkMicUseCases {
     readonly handleQueueOrderUseCase: LinkMicHandleQueueOrderUseCase;
     readonly handleRTCUseCase: LinkMicHandleRTCUseCase;
@@ -14,5 +17,8 @@ export declare class PLVLinkMicUseCases {
     readonly viewLogUseCase: LinkMicViewLogUseCase;
     readonly encodeParamUseCase: LinkMicEncodeParamUseCase;
     constructor(w32: LinkMicHandleQueueOrderUseCase, x32: LinkMicHandleRTCUseCase, y32: LinkMicHandleStateUseCase, z32: LinkMicUpdateChannelViewerUseCase, a33: LinkMicViewLogUseCase, b33: LinkMicEncodeParamUseCase);
+    /**
+     * 初始化当前用例或模块，注册依赖、状态监听和 socket/RTC 回调。
+     */
     init(): void;
 }

package/src/main/ets/modules/linkmic/viewmodel/usecase/roles/base/ILinkMicEncodeParamUseCase.d.ets

@@ -3,11 +3,30 @@
 import { PLVPushDowngradePreference, PLVPushOrientation } from '@polyvharmony/rtc-sdk';
 import { PLVLinkMicBitRate } from '../../../../model/vo/PLVLinkMicBitRate';
 import { PLVLinkMicPushResolutionRatio } from '../../../../model/vo/PLVLinkMicPushResolutionRatio';
+/**
+ * 编码参数用例，负责根据频道配置和当前设置计算 RTC 推流编码参数
+ */
 export interface ILinkMicEncodeParamUseCase {
+    /**
+     * 初始化当前用例或模块，注册依赖、状态监听和 socket/RTC 回调。
+     */
     init(): void;
+    /**
+     * 设置当前推流码率档位。
+     */
     setBitRate(bitRate: PLVLinkMicBitRate): void;
+    /**
+     * 设置当前推流画面比例。
+     */
     setPushResolutionRatio(pushResolutionRatio: PLVLinkMicPushResolutionRatio): void;
+    /**
+     * 设置当前推流方向。
+     */
     setPushOrientation(pushOrientation: PLVPushOrientation): void;
     setPushMirror(isMirror: boolean): void;
+    /**
+     * 设置弱网场景下优先保清晰度还是保流畅度。
+     */
     setPushDowngradePreference(preference: PLVPushDowngradePreference): void;
+    onDestroy(): void;
 }

package/src/main/ets/modules/linkmic/viewmodel/usecase/roles/base/ILinkMicHandleRTCUseCase.d.ets

@@ -2,17 +2,34 @@
 // @ts-nocheck
 import { PLVRTCClientRole } from '@polyvharmony/rtc-sdk';
 import { PLVLinkMicVideoRenderParam } from '../../../../model/vo/PLVLinkMicVideoRenderParam';
+/**
+ * RTC 处理用例，封装连麦 RTC 加房、退房、发布、订阅和媒体控制
+ */
 export interface ILinkMicHandleRTCUseCase {
+    /**
+     * 初始化当前用例或模块，注册依赖、状态监听和 socket/RTC 回调。
+     */
     init(): void;
+    /**
+     * 加入 RTC 房间并根据角色发布或订阅音视频流。
+     */
     joinChannel(): void;
+    /**
+     * 退出 RTC 房间并清理本地/远端媒体状态。
+     */
     leaveChannel(): void;
     switchRole(role: PLVRTCClientRole): void;
     enableCamera(enable: boolean): void;
     enableMicrophone(enable: boolean): void;
     enableCameraMicrophoneToLastState(): void;
     switchCamera(): void;
+    startScreenCapture(): number;
+    stopScreenCapture(): number;
     setLocalRenderMirror(isMirror: boolean): void;
     setupVideoRender(renderParam: PLVLinkMicVideoRenderParam): void;
     removeVideoRender(renderParam: PLVLinkMicVideoRenderParam): void;
+    /**
+     * 释放当前对象持有的监听、定时器和临时状态，避免页面退出后继续收到回调。
+     */
     onDestroy(): void;
 }

package/src/main/ets/modules/linkmic/viewmodel/usecase/roles/base/ILinkMicHandleStateUseCase.d.ets

@@ -1,28 +1,76 @@
 // @keepTs
 // @ts-nocheck
 import { PLVLinkMicMode } from '../../../../model/vo/PLVLinkMicMode';
+/**
+ * 连麦/推流状态处理用例，负责角色相关的状态流转和 socket 协议交互
+ */
 export interface ILinkMicHandleStateUseCase {
+    /**
+     * 初始化当前用例或模块，注册依赖、状态监听和 socket/RTC 回调。
+     */
     init(): void;
     requestJoinLinkMic(): Promise<void>;
     acceptInvitation(): Promise<void>;
     refuseInvitation(): void;
+    /**
+     * 主动离开连麦，内部会按角色执行退房和状态清理。
+     */
     leaveLinkMic(): void;
     onStreamerStart(): void;
     onLiveStreamStart(): void;
+    /**
+     * 设置频道连麦模式。新版策略下切换模式可能需要关闭或重开举手入口。
+     */
     setLinkMicMode(linkmicMode: PLVLinkMicMode): Promise<boolean>;
+    /**
+     * 开启连麦入口，允许观众或嘉宾按当前频道策略申请上麦。
+     */
     openLinkMic(): Promise<boolean>;
+    /**
+     * 关闭连麦入口，并按策略决定是否保留讲师自身的连麦能力。
+     */
     closeLinkMic(): Promise<boolean>;
+    /**
+     * 讲师接受指定观众的连麦申请。
+     */
     acceptViewerLinkMicRequest(viewerId: string): void;
+    /**
+     * 讲师邀请指定观众上麦，可选择是否需要对方确认。
+     */
     inviteViewerLinkMic(viewerId: string, needAnswer: boolean): void;
+    /**
+     * 讲师挂断指定观众的连麦。
+     */
     hangupViewerLinkMic(viewerId: string): void;
+    /**
+     * 讲师发起全体下麦。
+     */
     hangupAllViewersLinkMic(): void;
+    /**
+     * 讲师控制指定观众摄像头开关。
+     */
     setViewerEnableCamera(viewerId: string, enable: boolean): void;
+    /**
+     * 讲师控制指定观众麦克风开关。
+     */
     setViewerEnableMicrophone(viewerId: string, enable: boolean): void;
+    /**
+     * 授予指定观众主讲权限，并同步主画面。
+     */
     grantSpeaker(viewerId: string): void;
+    /**
+     * 收回主讲权限，将主讲和主画面切回讲师。
+     */
     revokeSpeaker(viewerId: string): void;
+    /**
+     * 设置频道主画面用户。
+     */
     setMainView(viewerId: string): void;
     onLiveStreamStop(): void;
     onStreamerStop(): void;
     updateInvitationExpireTime(): void;
+    /**
+     * 释放当前对象持有的监听、定时器和临时状态，避免页面退出后继续收到回调。
+     */
     onDestroy(): void;
 }

package/src/main/ets/modules/linkmic/viewmodel/usecase/roles/guest/LinkMicGuestEncodeParamUseCase.d.ets

@@ -5,15 +5,35 @@ import { PLVLinkMicRepo } from '../../../../model/PLVLinkMicRepo';
 import { PLVLinkMicBitRate } from '../../../../model/vo/PLVLinkMicBitRate';
 import { PLVLinkMicPushResolutionRatio } from '../../../../model/vo/PLVLinkMicPushResolutionRatio';
 import { ILinkMicEncodeParamUseCase } from '../base/ILinkMicEncodeParamUseCase';
+/**
+ * 编码参数用例，负责根据频道配置和当前设置计算 RTC 推流编码参数
+ */
 export declare class LinkMicGuestEncodeParamUseCase implements ILinkMicEncodeParamUseCase {
     private readonly repo;
-    constructor(d35: PLVLinkMicRepo);
+    private observers;
+    constructor(e35: PLVLinkMicRepo);
+    /**
+     * 初始化当前用例或模块，注册依赖、状态监听和 socket/RTC 回调。
+     */
     init(): void;
-    setBitRate(c35: PLVLinkMicBitRate): void;
-    setPushResolutionRatio(b35: PLVLinkMicPushResolutionRatio): void;
-    setPushOrientation(a35: PLVPushOrientation): void;
-    setPushMirror(z34: boolean): void;
-    setPushDowngradePreference(y34: PLVPushDowngradePreference): void;
+    /**
+     * 设置当前推流码率档位。
+     */
+    setBitRate(d35: PLVLinkMicBitRate): void;
+    /**
+     * 设置当前推流画面比例。
+     */
+    setPushResolutionRatio(c35: PLVLinkMicPushResolutionRatio): void;
+    /**
+     * 设置当前推流方向。
+     */
+    setPushOrientation(b35: PLVPushOrientation): void;
+    setPushMirror(a35: boolean): void;
+    /**
+     * 设置弱网场景下优先保清晰度还是保流畅度。
+     */
+    setPushDowngradePreference(z34: PLVPushDowngradePreference): void;
+    onDestroy(): void;
     private updateEncodeParam;
     private parseChannelBitRateSetting;
     private parsePushStreamTemplate;

package/src/main/ets/modules/linkmic/viewmodel/usecase/roles/guest/LinkMicGuestHandleRTCUseCase.d.ets

@@ -4,21 +4,38 @@ import { PLVRTCClientRole } from '@polyvharmony/rtc-sdk';
 import { PLVLinkMicRepo } from '../../../../model/PLVLinkMicRepo';
 import { PLVLinkMicVideoRenderParam } from '../../../../model/vo/PLVLinkMicVideoRenderParam';
 import { ILinkMicHandleRTCUseCase } from '../base/ILinkMicHandleRTCUseCase';
+/**
+ * RTC 处理用例，封装连麦 RTC 加房、退房、发布、订阅和媒体控制
+ */
 export declare class LinkMicGuestHandleRTCUseCase implements ILinkMicHandleRTCUseCase {
     private readonly repo;
     private observers;
-    constructor(s35: PLVLinkMicRepo);
+    constructor(t35: PLVLinkMicRepo);
+    /**
+     * 初始化当前用例或模块，注册依赖、状态监听和 socket/RTC 回调。
+     */
     init(): void;
+    /**
+     * 加入 RTC 房间并根据角色发布或订阅音视频流。
+     */
     joinChannel(): void;
+    /**
+     * 退出 RTC 房间并清理本地/远端媒体状态。
+     */
     leaveChannel(): void;
-    switchRole(q35: PLVRTCClientRole): void;
-    enableCamera(p35: boolean): void;
-    enableMicrophone(o35: boolean): void;
+    switchRole(r35: PLVRTCClientRole): void;
+    enableCamera(q35: boolean): void;
+    enableMicrophone(p35: boolean): void;
     enableCameraMicrophoneToLastState(): void;
     switchCamera(): void;
-    setLocalRenderMirror(l35: boolean): void;
-    setupVideoRender(j35: PLVLinkMicVideoRenderParam): void;
-    removeVideoRender(h35: PLVLinkMicVideoRenderParam): void;
+    startScreenCapture(): number;
+    stopScreenCapture(): number;
+    setLocalRenderMirror(m35: boolean): void;
+    setupVideoRender(k35: PLVLinkMicVideoRenderParam): void;
+    removeVideoRender(i35: PLVLinkMicVideoRenderParam): void;
+    /**
+     * 释放当前对象持有的监听、定时器和临时状态，避免页面退出后继续收到回调。
+     */
     onDestroy(): void;
     private getVideoRenderParam;
 }