@polyvharmony/live-scenes-sdk 1.5.0 → 1.6.0

package/BuildProfile.d.ets

@@ -3,18 +3,18 @@
 /**
  * Use these variables when you tailor your ArkTS code. They must be of the const type.
  */
-export declare const HAR_VERSION = "1.5.0";
+export declare const HAR_VERSION = "1.6.0";
 export declare const BUILD_MODE_NAME = "release";
 export declare const DEBUG = false;
 export declare const TARGET_NAME = "default";
-export declare const BUILD_TIME = "20260313";
+export declare const BUILD_TIME = "20260717";
 /**
  * BuildProfile Class is used only for compatibility purposes.
  */
 export default class BuildProfile {
-    static readonly HAR_VERSION = "1.5.0";
+    static readonly HAR_VERSION = "1.6.0";
     static readonly BUILD_MODE_NAME = "release";
     static readonly DEBUG = false;
     static readonly TARGET_NAME = "default";
-    static readonly BUILD_TIME = "20260313";
+    static readonly BUILD_TIME = "20260717";
 }

package/CHANGELOG.md

@@ -1,3 +1,30 @@
+## [v1.6.0] - 2026-07-17
+
+### 【观看端场景】
+
+### 修复优化:
+
+1. 修复部分回放视频无法播放的问题 [SDK]
+
+### 【开播端场景】
+
+新增功能:
+
+1. TRTC频道支持屏幕共享功能 [Demo、SDK]
+
+## [v1.5.1] - 2026-06-26
+
+### 【观看端场景】
+
+### 修复优化:
+
+1. 修复用户统计部分昵称乱码问题
+2. 修复播放全屏时左上角返回按钮点击无效的问题
+3. 移除回放的公告按钮
+4. httpdns库升级，解决偶现闪退问题
+5. 完善音频模式UI交互
+6. 修复播放失败重试按钮点击无效的问题
+
 ## [v1.5.0] - 2026-03-13
 
 ### 【开播端场景】

package/oh-package.json5

@@ -1 +1 @@
-{"name":"@polyvharmony/live-scenes-sdk","version":"1.5.0","description":"polyv live-scenes-sdk","author":"POLYV","license":"MIT","dependencies":{"@polyvharmony/live-scenes-foundation":"1.5.0","@ohos/dataorm":"2.2.2","@polyvharmony/media-player-sdk":"2.7.1","@polyvharmony/rtc-sdk":"1.4.0"},"types":"Index.d.ets","artifactType":"obfuscation","metadata":{"byteCodeHar":true,"sourceRoots":["./src/main"],"debug":false,"dependencyPkgVersion":{"@polyvharmony/live-scenes-foundation":"1.5.0","@ohos/dataorm":"2.2.2","@polyvharmony/media-player-sdk":"2.7.1","@polyvharmony/rtc-sdk":"1.4.0"},"declarationEntry":[],"useNormalizedOHMUrl":true},"compatibleSdkVersionStage":"beta1","compatibleSdkVersion":12,"compatibleSdkType":"HarmonyOS","obfuscated":true}
+{"name":"@polyvharmony/live-scenes-sdk","version":"1.6.0","description":"polyv live-scenes-sdk","author":"POLYV","license":"MIT","dependencies":{"@polyvharmony/live-scenes-foundation":"1.6.0","@ohos/dataorm":"2.2.2","@polyvharmony/media-player-sdk":"2.7.4","@polyvharmony/rtc-sdk":"1.5.0"},"types":"Index.d.ets","artifactType":"obfuscation","metadata":{"byteCodeHar":true,"sourceRoots":["./src/main"],"debug":false,"dependencyPkgVersion":{"@polyvharmony/live-scenes-foundation":"1.6.0","@ohos/dataorm":"2.2.2","@polyvharmony/media-player-sdk":"2.7.4","@polyvharmony/rtc-sdk":"1.5.0"},"declarationEntry":[],"useNormalizedOHMUrl":true},"compatibleSdkVersionStage":"beta1","compatibleSdkVersion":12,"compatibleSdkType":"HarmonyOS","obfuscated":true}

package/package.json

@@ -1 +1 @@
-{"name":"@polyvharmony/live-scenes-sdk","version":"1.5.0","description":"polyv live-scenes-sdk","author":"POLYV","license":"MIT","dependencies":{"@polyvharmony/live-scenes-foundation":"1.5.0","@ohos/dataorm":"2.2.2","@polyvharmony/media-player-sdk":"2.7.1","@polyvharmony/rtc-sdk":"1.4.0"},"types":"Index.d.ets","artifactType":"obfuscation","metadata":{"byteCodeHar":true,"sourceRoots":["./src/main"],"debug":false,"dependencyPkgVersion":{"@polyvharmony/live-scenes-foundation":"1.5.0","@ohos/dataorm":"2.2.2","@polyvharmony/media-player-sdk":"2.7.1","@polyvharmony/rtc-sdk":"1.4.0"},"declarationEntry":[],"useNormalizedOHMUrl":true},"compatibleSdkVersionStage":"beta1","compatibleSdkVersion":12,"compatibleSdkType":"HarmonyOS","obfuscated":true}
+{"name":"@polyvharmony/live-scenes-sdk","version":"1.6.0","description":"polyv live-scenes-sdk","author":"POLYV","license":"MIT","dependencies":{"@polyvharmony/live-scenes-foundation":"1.6.0","@ohos/dataorm":"2.2.2","@polyvharmony/media-player-sdk":"2.7.4","@polyvharmony/rtc-sdk":"1.5.0"},"types":"Index.d.ets","artifactType":"obfuscation","metadata":{"byteCodeHar":true,"sourceRoots":["./src/main"],"debug":false,"dependencyPkgVersion":{"@polyvharmony/live-scenes-foundation":"1.6.0","@ohos/dataorm":"2.2.2","@polyvharmony/media-player-sdk":"2.7.4","@polyvharmony/rtc-sdk":"1.5.0"},"declarationEntry":[],"useNormalizedOHMUrl":true},"compatibleSdkVersionStage":"beta1","compatibleSdkVersion":12,"compatibleSdkType":"HarmonyOS","obfuscated":true}

package/src/main/ets/modules/chatroom/PLVChatroomManager.d.ets

@@ -4,7 +4,7 @@ import { IPLVEventNotify, PLVCallback, PLVJSONObject, PLVStateData } from '@poly
 import { PLVBaseModule } from '../../common/PLVBaseModule';
 import { PLVSocketMediator } from '../socket/PLVSocketMediator';
 import { PLVLocalSpeakEvent } from './model/PLVLocalSpeakEvent';
-import { BusinessError as BusinessError } from "@ohos.base";
+import { BusinessError } from "@ohos.base";
 import { PLVChatQuoteDataBean } from './model/PLVChatQuoteDataBean';
 import { PLVLocalQuizEvent } from './model/PLVLocalQuizEvent';
 import { PLVHistoryQuizListVO } from './model/PLVHistroyQuizListVO';

package/src/main/ets/modules/chatroom/playback/model/PLVChatPlaybackDataVO.d.ets

@@ -25,7 +25,7 @@ export declare class PLVChatPlaybackDataVO implements IPLVIdEvent {
     user?: PLVSocketUserBean;
     parsedData?: string[];
     inserted?: boolean;
-    constructor(w113?: string, x113?: number, y113?: string, z113?: string, a114?: string, b114?: string, c114?: string, d114?: string, e114?: string, f114?: string, g114?: string, h114?: number, i114?: number, j114?: number);
+    constructor(d114?: string, e114?: number, f114?: string, g114?: string, h114?: string, i114?: string, j114?: string, k114?: string, l114?: string, m114?: string, n114?: string, o114?: number, p114?: number, q114?: number);
     fill(): void;
     getUniqueId(): string;
     isImgMsgType(): boolean;

package/src/main/ets/modules/linkmic/PLVLinkMicManager.d.ets

@@ -16,6 +16,9 @@ import { PLVLinkMicMode } from './model/vo/PLVLinkMicMode';
 import { PLVLinkMicState } from './model/vo/PLVLinkMicState';
 import { PLVLinkMicVideoRenderParam } from './model/vo/PLVLinkMicVideoRenderParam';
 import { PLVLinkMicViewer } from './model/vo/PLVLinkMicViewer';
+/**
+ * 连麦模块对外管理器，向业务层暴露连麦状态、事件和控制能力
+ */
 export declare class PLVLinkMicManager extends PLVBaseModule {
     private readonly dependScope;
     private readonly mediator;
@@ -40,6 +43,14 @@ export declare class PLVLinkMicManager extends PLVBaseModule {
      * SDK 是否支持当前频道的连麦
      */
     readonly sdkSupportChannelLinkMic: State<boolean>;
+    /**
+     * SDK 是否支持当前频道的屏幕分享
+     */
+    readonly sdkSupportScreenCapture: State<boolean>;
+    /**
+     * 本地是否正在进行屏幕分享
+     */
+    readonly isStartScreenCapture: State<boolean>;
     /**
      * 频道当前是否支持连麦
      */
@@ -193,6 +204,14 @@ export declare class PLVLinkMicManager extends PLVBaseModule {
      * 切换前后摄像头
      */
     switchCamera(): void;
+    /**
+     * 开始屏幕分享
+     */
+    startScreenCapture(): number;
+    /**
+     * 停止屏幕分享
+     */
+    stopScreenCapture(): number;
     /**
      * 设置自己的画面镜像
      * @param isMirror 是否镜像

package/src/main/ets/modules/linkmic/di/PLVLinkMicModule.d.ets

@@ -1,4 +1,14 @@
 // @keepTs
 // @ts-nocheck
 import { DependModule } from '@polyvharmony/media-player-sdk';
+/**
+ * 连麦模块依赖注入定义。
+ *
+ * 这里按 Mediator -> DataSource -> Repo -> UseCase -> ViewModel 的顺序装配：
+ * - Mediator 持有跨用例共享状态；
+ * - DataSource 负责网络接口；
+ * - Repo 聚合数据源、RTC、socket 和共享状态；
+ * - UseCase 按职责拆分业务流程；
+ * - ViewModel 作为 Manager 和 UseCase 之间的调度层。
+ */
 export declare const linkmicModule: DependModule;

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;
+    /** 推流模块回调到连麦 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,10 +2,15 @@
 // @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(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;

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(p25: PLVLinkMicMediator, q25: PLVLinkMicNetworkDataSource);
+    /**
+     * 初始化当前用例或模块，注册依赖、状态监听和 socket/RTC 回调。
+     */
     init(): Promise<void>;
     private initLinkMicId;
     private initRtcEngine;
@@ -22,6 +28,8 @@ export declare class PLVLinkMicRepo implements LifecycleAwareDependComponent {
     sendLiveViewLog(t24: PLVLiveViewLogVO): Promise<void>;
     joinRTCChannel(): void;
     switchRTCRole(q24: PLVRTCClientRole): void;
+    startScreenCapture(): number;
+    stopScreenCapture(): number;
     enableLocalVideo(p24: boolean): void;
     enableLocalAudio(o24: boolean): void;
     switchCamera(): void;
@@ -32,5 +40,8 @@ export declare class PLVLinkMicRepo implements LifecycleAwareDependComponent {
     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,6 +4,9 @@ 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(h24: PLVLinkMicMediator);

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

@@ -1,5 +1,8 @@
 // @keepTs
 // @ts-nocheck
+/**
+ * 码率档位模型，描述频道支持的推流清晰度档位
+ */
 export declare class PLVLinkMicBitRate {
     readonly index: number;
     readonly name: string | Resource;

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;

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 {
     /**
      * 连麦模块初始化失败

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

@@ -1,6 +1,9 @@
 // @keepTs
 // @ts-nocheck
 import { PLVMemberChannelViewer } from "../../../member/model/vo/PLVMemberChannelViewer";
+/**
+ * 连麦交互事件模型，描述邀请、响应等 UI 可感知事件
+ */
 export declare class PLVLinkMicAnswerInvitationEvent {
     readonly viewer: PLVMemberChannelViewer;
     readonly accept: 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,5 +1,8 @@
 // @keepTs
 // @ts-nocheck
+/**
+ * 业务模型，承载当前模块内的结构化数据
+ */
 export declare class PLVLinkMicPushResolutionRatio {
     readonly width: number;
     readonly height: number;

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,5 +1,8 @@
 // @keepTs
 // @ts-nocheck
+/**
+ * 业务模型，承载当前模块内的结构化数据
+ */
 export declare enum PLVLinkMicRTCType {
     ARTC = "agora",
     TRTC = "trtc",

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;