@polyvharmony/live-scenes-sdk 1.5.0 → 1.6.0

package/src/main/ets/modules/socket/PLVSocketManager.d.ets

@@ -35,7 +35,7 @@ export declare class PLVSocketManager extends PLVSocketIO implements IPLVBaseMod
      */
     eventNotify_socketData: IPLVEventNotify;
     private getTokenDisposable;
-    constructor(w88: PLVChannelData);
+    constructor(y88: PLVChannelData);
     /**
      * 登录socket
      */
@@ -45,18 +45,18 @@ export declare class PLVSocketManager extends PLVSocketIO implements IPLVBaseMod
      * @param callback
      * @param onTag
      */
-    onStatus(u88: Function, v88?: string | Object): void;
+    onStatus(w88: Function, x88?: string | Object): void;
     /**
      * 取消监听socket连接状态
      * @param callback
      * @param onTag
      */
-    offStatus(s88: Function, t88?: string | Object): void;
+    offStatus(u88: Function, v88?: string | Object): void;
     /**
      * 添加所需监听的socket事件
      * @param onEvents
      */
-    addOnEvent(p88: string[]): void;
+    addOnEvent(r88: string[]): void;
     /**
      * 是否处于已连接状态
      * @returns
@@ -66,12 +66,12 @@ export declare class PLVSocketManager extends PLVSocketIO implements IPLVBaseMod
      * 断开
      * @param noCallSocketClose
      */
-    disconnect(o88?: boolean | undefined): void;
+    disconnect(q88?: boolean | undefined): void;
     /**
      * 销毁
      * @param noCallSocketClose
      */
-    destroy(n88?: boolean): void;
+    destroy(p88?: boolean): void;
     private loginRoom;
     private onSocketIOStatus;
     private attachListeners;
@@ -87,7 +87,7 @@ export declare class PLVSocketManager extends PLVSocketIO implements IPLVBaseMod
  */
 export declare class PLVChildRoomEnabledStatus {
     childRoomEnabled?: boolean;
-    constructor(g87?: boolean);
+    constructor(i87?: boolean);
 }
 /**
  * socket连接状态
@@ -95,7 +95,7 @@ export declare class PLVChildRoomEnabledStatus {
 export declare class PLVSocketStatusSup {
     socketStatus: PLVSocketStatus;
     error?: Error;
-    constructor(e87: PLVSocketStatus, f87?: Error);
+    constructor(g87: PLVSocketStatus, h87?: Error);
 }
 /**
  * socket连接状态枚举

package/src/main/ets/modules/socket/PLVSocketMediator.d.ets

@@ -3,12 +3,12 @@
 import { PLVSocketManager } from './PLVSocketManager';
 export declare class PLVSocketMediator {
     private socketManager;
-    constructor(l89: PLVSocketManager);
-    onData(i89: string, j89: Function, k89?: string | Object): void;
-    offData(f89: string, g89: Function, h89?: string | Object): void;
-    onStatus(d89: Function, e89?: string | Object): void;
-    offStatus(b89: Function, c89?: string | Object): void;
-    emit(y88: string, z88: ESObject, a89?: (emit_callback_json: string) => void): boolean;
-    addOnEvent(x88: string[]): void;
+    constructor(n89: PLVSocketManager);
+    onData(k89: string, l89: Function, m89?: string | Object): void;
+    offData(h89: string, i89: Function, j89?: string | Object): void;
+    onStatus(f89: Function, g89?: string | Object): void;
+    offStatus(d89: Function, e89?: string | Object): void;
+    emit(a89: string, b89: ESObject, c89?: (emit_callback_json: string) => void): boolean;
+    addOnEvent(z88: string[]): void;
     connected(): boolean;
 }

package/src/main/ets/modules/socket/model/PLVSocketUserBean.d.ets

@@ -16,13 +16,13 @@ export declare class PLVSocketUserBean {
     classStatus?: PLVClassStatusBean;
     kickRefer?: string;
     getActor(): string;
-    setActor(r86?: string): void;
+    setActor(t86?: string): void;
     isBanned(): boolean;
-    setBanned(q86?: boolean): void;
+    setBanned(s86?: boolean): void;
     getPic(): string;
-    setPic(p86?: string): void;
-    static fixActor(n86?: string, o86?: string): string;
-    static isSpecialType(m86?: string): boolean;
+    setPic(r86?: string): void;
+    static fixActor(p86?: string, q86?: string): string;
+    static isSpecialType(o86?: string): boolean;
 }
 @Observed
 export declare class PLVAuthorizationBean {

package/src/main/ets/modules/socket/model/redpack/RedPaperReceiveType.d.ets

@@ -5,7 +5,7 @@ export declare class RedPaperReceiveType {
     value: string;
     serverTypes: string[];
     typeName: Resource;
-    constructor(b87: string, c87: string[], d87: Resource);
+    constructor(d87: string, e87: string[], f87: Resource);
     getTypeName(): Resource;
     clone(): RedPaperReceiveType;
 }
@@ -19,7 +19,7 @@ export declare class PLVRedPaperReceiveType {
     private static instance;
     private constructor();
     static getInstance(): PLVRedPaperReceiveType;
-    static getValue(a87: RedPaperReceiveTypeEvent): RedPaperReceiveType;
-    static match(v86?: string): RedPaperReceiveType | undefined;
-    static matchOrDefault(s86: string, t86: RedPaperReceiveTypeEvent): RedPaperReceiveType;
+    static getValue(c87: RedPaperReceiveTypeEvent): RedPaperReceiveType;
+    static match(x86?: string): RedPaperReceiveType | undefined;
+    static matchOrDefault(u86: string, v86: RedPaperReceiveTypeEvent): RedPaperReceiveType;
 }

package/src/main/ets/modules/streamer/PLVStreamerManager.d.ets

@@ -10,6 +10,9 @@ import { PLVLinkMicPushResolutionRatio } from '../linkmic/model/vo/PLVLinkMicPus
 import { PLVSocketMediator } from '../socket/PLVSocketMediator';
 import { PLVStreamerMixLayoutType } from './model/vo/PLVStreamerMixLayoutType';
 import { PLVStreamerState } from './model/vo/PLVStreamerState';
+/**
+ * 开播/推流模块对外管理器，向业务层暴露直播状态、推流参数和开播控制能力
+ */
 export declare class PLVStreamerManager extends PLVBaseModule {
     private readonly dependScope;
     private readonly mediator;
@@ -46,14 +49,22 @@ export declare class PLVStreamerManager extends PLVBaseModule {
      * 混流布局
      */
     readonly mixLayoutType: State<PLVStreamerMixLayoutType>;
-    constructor(a94: DependScope, b94: PLVChannelData, c94: PLVSocketMediator);
+    /**
+     * SDK 是否支持当前频道的屏幕分享
+     */
+    readonly sdkSupportScreenCapture: State<boolean>;
+    /**
+     * 本地是否正在进行屏幕分享
+     */
+    readonly isStartScreenCapture: State<boolean>;
+    constructor(c94: DependScope, d94: PLVChannelData, e94: PLVSocketMediator);
     private init;
     /**
      * [讲师] 开始直播
      * [嘉宾] 加入直播
      * @param recover 上一次直播未正常关闭，是否继续上一次直播
      */
-    startStream(w93?: boolean): Promise<void>;
+    startStream(y93?: boolean): Promise<void>;
     /**
      * [讲师] 停止直播
      * [嘉宾] 退出直播
@@ -62,31 +73,39 @@ export declare class PLVStreamerManager extends PLVBaseModule {
     /**
      * [讲师] 更新频道名称
      */
-    updateChannelName(v93: string): Promise<void>;
+    updateChannelName(x93: string): Promise<void>;
     /**
      * [讲师] 更新频道封面图
      * @param localSplashImage 封面图
      * @returns 上传到服务器后的封面图地址
      */
-    updateChannelSplashImage(u93: string): Promise<string>;
+    updateChannelSplashImage(w93: string): Promise<string>;
     /**
      * [讲师、嘉宾] 设置推流清晰度
      */
-    setBitRate(t93: PLVLinkMicBitRate): void;
+    setBitRate(v93: PLVLinkMicBitRate): void;
     /**
      * [讲师、嘉宾] 设置推流画面比例
      */
-    setPushResolutionRatio(s93: PLVLinkMicPushResolutionRatio): void;
+    setPushResolutionRatio(u93: PLVLinkMicPushResolutionRatio): void;
     /**
      * [讲师、嘉宾] 设置推流方向
      */
-    setPushOrientation(r93: PLVPushOrientation): void;
+    setPushOrientation(t93: PLVPushOrientation): void;
     /**
      * [讲师、嘉宾] 设置弱网降级偏好
      */
-    setPushDowngradePreference(q93: PLVPushDowngradePreference): void;
+    setPushDowngradePreference(s93: PLVPushDowngradePreference): void;
     /**
      * [讲师] 设置混流画面类型
      */
-    setMixLayoutType(p93: PLVStreamerMixLayoutType): void;
+    setMixLayoutType(r93: PLVStreamerMixLayoutType): void;
+    /**
+     * [讲师、嘉宾] 开始屏幕分享
+     */
+    startScreenCapture(): number;
+    /**
+     * [讲师、嘉宾] 停止屏幕分享
+     */
+    stopScreenCapture(): number;
 }

package/src/main/ets/modules/streamer/di/PLVStreamerModule.d.ets

@@ -1,4 +1,11 @@
 // @keepTs
 // @ts-nocheck
 import { DependModule } from '@polyvharmony/media-player-sdk';
+/**
+ * 开播/推流模块依赖注入定义。
+ *
+ * streamer 模块依赖 linkmic 模块提供的 RTC 状态和编码参数，因此
+ * PLVStreamerMediator 会持有 PLVLinkMicMediator。后续推流状态、混流、
+ * 封面更新等能力都通过 Repo 和 UseCase 分层实现。
+ */
 export declare const streamerModule: DependModule;

package/src/main/ets/modules/streamer/mediator/PLVStreamerMediator.d.ets

@@ -7,20 +7,37 @@ import { PLVSocketMediator } from '../../socket/PLVSocketMediator';
 import { PLVStreamerErrorEvent } from '../model/vo/PLVStreamerErrorEvent';
 import { PLVStreamerMixLayoutType } from '../model/vo/PLVStreamerMixLayoutType';
 import { PLVStreamerState } from '../model/vo/PLVStreamerState';
+/**
+ * 模块内状态中介，集中保存跨用例共享状态并桥接外部模块
+ */
 export declare class PLVStreamerMediator implements LifecycleAwareDependComponent {
+    /** 连麦状态中介，推流模块依赖它读取 RTC 编码参数和连麦成员列表。 */
     readonly linkmicMediator: PLVLinkMicMediator;
+    /** 当前登录频道、用户、角色等全局频道数据。 */
     channelData: PLVChannelData | null;
+    /** 聊天室 socket 中介，用于监听直播开始/结束等频道事件。 */
     socketMediator: PLVSocketMediator | null;
+    /** 推流模块初始化完成信号，外部动作需等待该 Promise 后再执行。 */
     readonly initFinish: {
         promise: Promise<void>;
         resolve: (value: void | PromiseLike<void>) => void;
         reject: (reason?: any) => void;
     };
+    /** 当前直播推流状态。 */
     readonly streamerState: MutableState<PLVStreamerState>;
+    /** 直播开始时间戳，用于开播时长统计。 */
     readonly liveStartTimestamp: MutableState<number>;
+    /** 当前服务端混流布局类型。 */
     readonly mixLayoutType: MutableState<PLVStreamerMixLayoutType>;
+    /** 推流模块统一错误事件。 */
     readonly errorEvent: MutableEvent<PLVStreamerErrorEvent>;
-    constructor(x89: PLVLinkMicMediator);
-    reportError(v89: number, w89: string): void;
+    constructor(z89: PLVLinkMicMediator);
+    /**
+     * 统一上报模块错误事件，便于业务层监听和展示。
+     */
+    reportError(x89: number, y89: string): void;
+    /**
+     * 释放当前对象持有的监听、定时器和临时状态，避免页面退出后继续收到回调。
+     */
     onDestroy(): void;
 }

package/src/main/ets/modules/streamer/model/PLVStreamerRepo.d.ets

@@ -6,20 +6,37 @@ import { PLVStreamerNetworkDataSource } from './datasource/PLVStreamerNetworkDat
 import { PLVStreamerLiveStatusResponseVO } from './vo/PLVStreamerLiveStatusResponseVO';
 import { PLVStreamerMixActionVO } from './vo/PLVStreamerMixActionVO';
 import { PLVStreamerMixLayoutType } from './vo/PLVStreamerMixLayoutType';
+/**
+ * 模块数据仓库，封装 mediator、网络数据源、本地数据源和 RTC 依赖的访问入口
+ */
 export declare class PLVStreamerRepo {
     readonly mediator: PLVStreamerMediator;
     readonly localDataSource: PLVStreamerLocalDataSource;
     readonly networkDataSource: PLVStreamerNetworkDataSource;
-    constructor(k93: PLVStreamerMediator, l93: PLVStreamerLocalDataSource, m93: PLVStreamerNetworkDataSource);
+    constructor(m93: PLVStreamerMediator, n93: PLVStreamerLocalDataSource, o93: PLVStreamerNetworkDataSource);
+    /**
+     * 初始化当前用例或模块，注册依赖、状态监听和 socket/RTC 回调。
+     */
     init(): Promise<void>;
     private initMixLayoutType;
-    notifyStreamStart(c93: string, d93: boolean, e93: number, f93: number): Promise<string>;
-    notifyStreamEnd(z92: string): Promise<void>;
-    setMixLayoutType(y92: PLVStreamerMixLayoutType): Promise<void>;
-    sendMixAction(w92: PLVStreamerMixActionVO): Promise<void>;
-    getStreamerSessionId(t92: string): Promise<string>;
-    updateChannelName(q92: string): Promise<void>;
-    updateChannelSplashImage(n92: string): Promise<void>;
-    getLiveStatusSessionId(k92: string): Promise<PLVStreamerLiveStatusResponseVO>;
-    uploadImageToOSS(f92: ArrayBuffer, g92: string): Promise<string>;
+    notifyStreamStart(e93: string, f93: boolean, g93: number, h93: number): Promise<string>;
+    notifyStreamEnd(b93: string): Promise<void>;
+    /**
+     * 设置服务端混流布局类型。
+     */
+    setMixLayoutType(a93: PLVStreamerMixLayoutType): Promise<void>;
+    sendMixAction(y92: PLVStreamerMixActionVO): Promise<void>;
+    getStreamerSessionId(v92: string): Promise<string>;
+    /**
+     * 更新频道直播标题。
+     */
+    updateChannelName(s92: string): Promise<void>;
+    /**
+     * 上传并更新频道封面图，返回服务端图片地址。
+     */
+    updateChannelSplashImage(p92: string): Promise<void>;
+    getLiveStatusSessionId(m92: string): Promise<PLVStreamerLiveStatusResponseVO>;
+    startScreenCapture(): number;
+    stopScreenCapture(): number;
+    uploadImageToOSS(h92: ArrayBuffer, i92: string): Promise<string>;
 }

package/src/main/ets/modules/streamer/model/datasource/PLVStreamerLocalDataSource.d.ets

@@ -2,9 +2,12 @@
 // @ts-nocheck
 import { PLVStreamerMediator } from "../../mediator/PLVStreamerMediator";
 import { PLVStreamerMixLayoutType } from "../vo/PLVStreamerMixLayoutType";
+/**
+ * 本地数据源，负责读写当前模块需要持久化的频道配置
+ */
 export declare class PLVStreamerLocalDataSource {
     private readonly mediator;
-    constructor(e90: PLVStreamerMediator);
+    constructor(g90: PLVStreamerMediator);
     getMixLayoutType(): Promise<PLVStreamerMixLayoutType | undefined>;
-    saveMixLayoutType(y89: PLVStreamerMixLayoutType): Promise<void>;
+    saveMixLayoutType(a90: PLVStreamerMixLayoutType): Promise<void>;
 }

package/src/main/ets/modules/streamer/model/datasource/PLVStreamerNetworkDataSource.d.ets

@@ -4,18 +4,27 @@ import { PLVChatImageUploadTokenVO } from '../../../chatroom/model/PLVChatImageU
 import { PLVStreamerMediator } from '../../mediator/PLVStreamerMediator';
 import { PLVStreamerLiveStatusResponseVO } from '../vo/PLVStreamerLiveStatusResponseVO';
 import { PLVStreamerMixActionVO } from '../vo/PLVStreamerMixActionVO';
+/**
+ * 网络数据源，负责调用服务端接口并屏蔽接口细节
+ */
 export declare class PLVStreamerNetworkDataSource {
     private readonly mediator;
-    constructor(e92: PLVStreamerMediator);
-    notifyStreamStart(v91: string, w91: string, x91: boolean, y91: number, z91: number): Promise<string>;
-    notifyStreamEnd(o91: string, p91: string): Promise<void>;
-    sendMixAction(k91: PLVStreamerMixActionVO): Promise<void>;
-    getStreamerSessionId(e91: string, f91: string): Promise<string>;
-    updateChannelName(x90: string, y90: string): Promise<void>;
-    updateChannelSplashImage(q90: string, r90: string): Promise<void>;
-    getLiveStatusSessionId(n90: string, o90: string): Promise<PLVStreamerLiveStatusResponseVO>;
-    getOSSUploadToken(i90: string): Promise<PLVChatImageUploadTokenVO>;
-    uploadImageToOSS(f90: ArrayBuffer, g90: string, h90: PLVChatImageUploadTokenVO): Promise<string>;
+    constructor(g92: PLVStreamerMediator);
+    notifyStreamStart(x91: string, y91: string, z91: boolean, a92: number, b92: number): Promise<string>;
+    notifyStreamEnd(q91: string, r91: string): Promise<void>;
+    sendMixAction(m91: PLVStreamerMixActionVO): Promise<void>;
+    getStreamerSessionId(g91: string, h91: string): Promise<string>;
+    /**
+     * 更新频道直播标题。
+     */
+    updateChannelName(z90: string, a91: string): Promise<void>;
+    /**
+     * 上传并更新频道封面图，返回服务端图片地址。
+     */
+    updateChannelSplashImage(s90: string, t90: string): Promise<void>;
+    getLiveStatusSessionId(p90: string, q90: string): Promise<PLVStreamerLiveStatusResponseVO>;
+    getOSSUploadToken(k90: string): Promise<PLVChatImageUploadTokenVO>;
+    uploadImageToOSS(h90: ArrayBuffer, i90: string, j90: PLVChatImageUploadTokenVO): Promise<string>;
     private get api_polyv_net();
     private get liveimages_videocc_net();
 }

package/src/main/ets/modules/streamer/model/vo/PLVStreamerErrorEvent.d.ets

@@ -1,5 +1,8 @@
 // @keepTs
 // @ts-nocheck
+/**
+ * 错误事件枚举，定义模块内部向外透出的错误类型
+ */
 export declare class PLVStreamerErrorEvent {
     /**
      * 推流模块初始化失败
@@ -19,5 +22,5 @@ export declare class PLVStreamerErrorEvent {
     static readonly UPDATE_CHANNEL_NAME_FAIL = 4;
     readonly code: number;
     readonly message: string;
-    constructor(n93: number, o93: string);
+    constructor(p93: number, q93: string);
 }

package/src/main/ets/modules/streamer/model/vo/PLVStreamerLiveStatusResponseVO.d.ts

@@ -1,3 +1,6 @@
+/**
+ * 接口响应模型，承载服务端返回的结构化数据
+ */
 export declare class PLVStreamerLiveStatusResponseVO {
     status?: string | null;
     sessionId?: string | null;

package/src/main/ets/modules/streamer/model/vo/PLVStreamerMixActionResponse.d.ets

@@ -1,5 +1,8 @@
 // @keepTs
 // @ts-nocheck
+/**
+ * 接口响应模型，承载服务端返回的结构化数据
+ */
 export declare class PLVStreamerMixActionResponse {
     res?: boolean;
 }

package/src/main/ets/modules/streamer/model/vo/PLVStreamerMixActionVO.d.ets

@@ -1,6 +1,9 @@
 // @keepTs
 // @ts-nocheck
 import { PLVStreamerMixLayoutType } from './PLVStreamerMixLayoutType';
+/**
+ * 服务端混流动作数据模型
+ */
 export declare class PLVStreamerMixActionVO {
     action?: MixAction;
     roomId?: string;
@@ -10,10 +13,16 @@ export declare class PLVStreamerMixActionVO {
     mixLayoutType?: PLVStreamerMixLayoutType;
     publishCdnParam?: MixPublishCdnParam;
 }
+/**
+ * 服务端混流输出流参数数据模型
+ */
 export declare class MixOutputParam {
     streamId?: string;
     pureAudioStream?: number;
 }
+/**
+ * 服务端混流编码参数数据模型
+ */
 export declare class MixEncodeParam {
     audioSampleRate?: number;
     audioBitrate?: number;
@@ -26,6 +35,9 @@ export declare class MixEncodeParam {
     backgroundColor: number;
     audioCodec: number;
 }
+/**
+ * 参与服务端混流的用户参数数据模型
+ */
 export declare class MixUser {
     streamType?: MixStreamType;
     userId?: string;
@@ -33,25 +45,40 @@ export declare class MixUser {
     mixInputType?: MixInputType;
     hidden: boolean;
 }
+/**
+ * 接口响应模型，承载服务端返回的结构化数据
+ */
 export declare enum MixAction {
     START = "start",
     UPDATE = "update",
     END = "end"
 }
+/**
+ * 接口响应模型，承载服务端返回的结构化数据
+ */
 export declare enum MixStreamType {
     CAMERA = 0,
     SCREEN = 1
 }
+/**
+ * 模式枚举，定义业务可选工作模式
+ */
 export declare enum MixRenderMode {
     FILL = 0,
     FIT = 1,
     FIT_BLACK_BACKGROUND = 2
 }
+/**
+ * 接口响应模型，承载服务端返回的结构化数据
+ */
 export declare enum MixInputType {
     VIDEO_AUDIO = 0,
     VIDEO_ONLY = 1,
     AUDIO_ONLY = 2
 }
+/**
+ * 混流后推送 CDN 参数数据模型
+ */
 export declare class MixPublishCdnParam {
     cdnUrl?: string;
 }

package/src/main/ets/modules/streamer/model/vo/PLVStreamerMixLayoutType.d.ets

@@ -1,5 +1,8 @@
 // @keepTs
 // @ts-nocheck
+/**
+ * 业务模型，承载当前模块内的结构化数据
+ */
 export declare enum PLVStreamerMixLayoutType {
     /**
      * 单人

package/src/main/ets/modules/streamer/model/vo/PLVStreamerSessionIdQueryResponse.d.ets

@@ -1,5 +1,8 @@
 // @keepTs
 // @ts-nocheck
+/**
+ * 接口响应模型，承载服务端返回的结构化数据
+ */
 export declare class PLVStreamerSessionIdQueryResponse {
     createTime?: number;
     sessionId?: string;

package/src/main/ets/modules/streamer/model/vo/PLVStreamerSocketEvent.d.ets

@@ -1,5 +1,8 @@
 // @keepTs
 // @ts-nocheck
+/**
+ * PLVStreamerSocketOnSliceStartRecv 接收模型
+ */
 export declare class PLVStreamerSocketOnSliceStartRecv {
     data?: PLVStreamerSocketOnSliceStartEventData | null;
     pushtime?: number | null;
@@ -8,11 +11,17 @@ export declare class PLVStreamerSocketOnSliceStartRecv {
     timeStamp?: number | null;
     videoAndPPTPosition?: string | null;
 }
+/**
+ * PLVStreamerSocketOnSliceStartEventData 数据模型
+ */
 export declare class PLVStreamerSocketOnSliceStartEventData {
     autoId?: number | null;
     docType?: number | null;
     isCamClosed?: number | null;
 }
+/**
+ * PLVStreamerSocketOnSliceIDRecv 接收模型
+ */
 export declare class PLVStreamerSocketOnSliceIDRecv {
     data?: PLVStreamerSocketOnSliceIDEventData | null;
     inClass?: boolean | null;
@@ -20,6 +29,9 @@ export declare class PLVStreamerSocketOnSliceIDRecv {
     pptAndVedioPosition?: number | null;
     token?: string | null;
 }
+/**
+ * PLVStreamerSocketOnSliceIDEventData 数据模型
+ */
 export declare class PLVStreamerSocketOnSliceIDEventData {
     autoId?: number | null;
     courseType?: string | null;
@@ -37,6 +49,9 @@ export declare class PLVStreamerSocketOnSliceIDEventData {
     timeStamp?: number | null;
     userId?: string | null;
 }
+/**
+ * PLVStreamerSocketOnSliceStartSend 发送模型
+ */
 export declare class PLVStreamerSocketOnSliceStartSend {
     EVENT: string;
     classInterval?: number | null;
@@ -51,12 +66,18 @@ export declare class PLVStreamerSocketOnSliceStartSend {
     streamName?: string | null;
     timeStamp?: number | null;
 }
+/**
+ * PLVStreamerSocketOnSliceStartData 数据模型
+ */
 export declare class PLVStreamerSocketOnSliceStartData {
     autoId?: number | null;
     isCamClosed?: number | null;
     pageId?: number | null;
     step?: number | null;
 }
+/**
+ * PLVStreamerSocketFinishClassSend 发送模型
+ */
 export declare class PLVStreamerSocketFinishClassSend {
     EVENT: string;
     channelId?: string | null;

package/src/main/ets/modules/streamer/model/vo/PLVStreamerState.d.ets

@@ -1,5 +1,8 @@
 // @keepTs
 // @ts-nocheck
+/**
+ * 状态枚举，定义模块核心业务状态
+ */
 export declare enum PLVStreamerState {
     /**
      * 直播未开始

package/src/main/ets/modules/streamer/viewmodel/PLVStreamerViewModel.d.ets

@@ -6,18 +6,59 @@ import { PLVLinkMicPushResolutionRatio } from '../../linkmic/model/vo/PLVLinkMic
 import { PLVStreamerRepo } from '../model/PLVStreamerRepo';
 import { PLVStreamerMixLayoutType } from '../model/vo/PLVStreamerMixLayoutType';
 import { PLVStreamerUseCases } from './usecase/PLVStreamerUseCases';
+/**
+ * 模块视图模型，承接 Manager 调用并分发到具体 UseCase
+ */
 export declare class PLVStreamerViewModel {
     private readonly repo;
     private readonly useCases;
-    constructor(o94: PLVStreamerRepo, p94: PLVStreamerUseCases);
+    constructor(q94: PLVStreamerRepo, r94: PLVStreamerUseCases);
+    /**
+     * 初始化当前用例或模块，注册依赖、状态监听和 socket/RTC 回调。
+     */
     init(): Promise<void>;
-    startStream(m94: boolean): Promise<void>;
+    /**
+     * 开始推流。讲师为开播，嘉宾为加入直播连麦。
+     */
+    startStream(o94: boolean): Promise<void>;
+    /**
+     * 结束当前推流。讲师为结束直播，嘉宾为退出直播。
+     */
     finishStream(): void;
-    updateChannelName(j94: string): Promise<void>;
-    updateChannelSplashImage(i94: string): Promise<string>;
-    setBitRate(h94: PLVLinkMicBitRate): void;
-    setPushResolutionRatio(g94: PLVLinkMicPushResolutionRatio): void;
-    setPushOrientation(f94: PLVPushOrientation): void;
-    setPushDowngradePreference(e94: PLVPushDowngradePreference): void;
-    setMixLayoutType(d94: PLVStreamerMixLayoutType): void;
+    /**
+     * 更新频道直播标题。
+     */
+    updateChannelName(l94: string): Promise<void>;
+    /**
+     * 上传并更新频道封面图，返回服务端图片地址。
+     */
+    updateChannelSplashImage(k94: string): Promise<string>;
+    /**
+     * 设置当前推流码率档位。
+     */
+    setBitRate(j94: PLVLinkMicBitRate): void;
+    /**
+     * 设置当前推流画面比例。
+     */
+    setPushResolutionRatio(i94: PLVLinkMicPushResolutionRatio): void;
+    /**
+     * 设置当前推流方向。
+     */
+    setPushOrientation(h94: PLVPushOrientation): void;
+    /**
+     * 设置弱网场景下优先保清晰度还是保流畅度。
+     */
+    setPushDowngradePreference(g94: PLVPushDowngradePreference): void;
+    /**
+     * 设置服务端混流布局类型。
+     */
+    setMixLayoutType(f94: PLVStreamerMixLayoutType): void;
+    /**
+     * 开始屏幕分享。
+     */
+    startScreenCapture(): number;
+    /**
+     * 停止屏幕分享。
+     */
+    stopScreenCapture(): number;
 }

package/src/main/ets/modules/streamer/viewmodel/usecase/PLVStreamerUseCases.d.ets

@@ -3,10 +3,16 @@
 import { StreamerHandleStateUseCase } from './StreamerHandleStateUseCase';
 import { StreamerMixStreamUseCase } from './StreamerMixStreamUseCase';
 import { StreamerUpdateSplashImageUseCase } from './StreamerUpdateSplashImageUseCase';
+/**
+ * UseCase 聚合对象，按角色和职责组合模块业务能力
+ */
 export declare class PLVStreamerUseCases {
     readonly handleStateUseCase: StreamerHandleStateUseCase;
     readonly mixStreamUseCase: StreamerMixStreamUseCase;
     readonly updateSplashImageUseCase: StreamerUpdateSplashImageUseCase;
-    constructor(q94: StreamerHandleStateUseCase, r94: StreamerMixStreamUseCase, s94: StreamerUpdateSplashImageUseCase);
+    constructor(s94: StreamerHandleStateUseCase, t94: StreamerMixStreamUseCase, u94: StreamerUpdateSplashImageUseCase);
+    /**
+     * 初始化当前用例或模块，注册依赖、状态监听和 socket/RTC 回调。
+     */
     init(): void;
 }