@polyvharmony/live-scenes-sdk 1.4.0 → 1.6.0

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(s92: StreamerHandleStateUseCase, t92: StreamerMixStreamUseCase, u92: StreamerUpdateSplashImageUseCase);
+    constructor(s94: StreamerHandleStateUseCase, t94: StreamerMixStreamUseCase, u94: StreamerUpdateSplashImageUseCase);
+    /**
+     * 初始化当前用例或模块，注册依赖、状态监听和 socket/RTC 回调。
+     */
     init(): void;
 }

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

@@ -4,13 +4,28 @@ import { LifecycleAwareDependComponent } from '@polyvharmony/media-player-sdk';
 import { PLVStreamerRepo } from '../../model/PLVStreamerRepo';
 import { IStreamerHandleStateUseCase } from './roles/base/IStreamerHandleStateUseCase';
 import { StreamerMixStreamUseCase } from './StreamerMixStreamUseCase';
+/**
+ * 连麦/推流状态处理用例，负责角色相关的状态流转和 socket 协议交互
+ */
 export declare class StreamerHandleStateUseCase implements IStreamerHandleStateUseCase, LifecycleAwareDependComponent {
     private readonly repo;
     private readonly mixStreamUseCase;
     private impl;
-    constructor(g95: PLVStreamerRepo, h95: StreamerMixStreamUseCase);
+    constructor(l97: PLVStreamerRepo, m97: StreamerMixStreamUseCase);
+    /**
+     * 初始化当前用例或模块，注册依赖、状态监听和 socket/RTC 回调。
+     */
     init(): void;
-    startStream(e95: boolean): Promise<void>;
+    /**
+     * 开始推流。讲师为开播，嘉宾为加入直播连麦。
+     */
+    startStream(j97: boolean): Promise<void>;
+    /**
+     * 结束当前推流。讲师为结束直播，嘉宾为退出直播。
+     */
     finishStream(): void;
+    /**
+     * 释放当前对象持有的监听、定时器和临时状态，避免页面退出后继续收到回调。
+     */
     onDestroy(): void;
 }

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

@@ -3,12 +3,21 @@
 import { PLVStreamerRepo } from '../../model/PLVStreamerRepo';
 import { PLVStreamerMixLayoutType } from '../../model/vo/PLVStreamerMixLayoutType';
 import { IStreamerMixStreamUseCase } from './roles/base/IStreamerMixStreamUseCase';
+/**
+ * 混流用例，负责根据当前连麦成员和布局生成服务端混流动作
+ */
 export declare class StreamerMixStreamUseCase implements IStreamerMixStreamUseCase {
     private readonly repo;
     private impl;
-    constructor(k95: PLVStreamerRepo);
+    constructor(p97: PLVStreamerRepo);
+    /**
+     * 初始化当前用例或模块，注册依赖、状态监听和 socket/RTC 回调。
+     */
     init(): void;
     startMix(): void;
     stopMix(): void;
-    setMixLayoutType(i95: PLVStreamerMixLayoutType): void;
+    /**
+     * 设置服务端混流布局类型。
+     */
+    setMixLayoutType(n97: PLVStreamerMixLayoutType): void;
 }

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

@@ -1,9 +1,15 @@
 // @keepTs
 // @ts-nocheck
 import { PLVStreamerRepo } from '../../model/PLVStreamerRepo';
+/**
+ * 频道封面更新用例，负责上传并更新开播封面图
+ */
 export declare class StreamerUpdateSplashImageUseCase {
     private readonly repo;
-    constructor(f96: PLVStreamerRepo);
-    updateChannelSplashImage(a96: string): Promise<string>;
+    constructor(k98: PLVStreamerRepo);
+    /**
+     * 上传并更新频道封面图，返回服务端图片地址。
+     */
+    updateChannelSplashImage(f98: string): Promise<string>;
     private resampleSplashImage;
 }

package/src/main/ets/modules/streamer/viewmodel/usecase/roles/base/IStreamerHandleStateUseCase.d.ets

@@ -1,8 +1,23 @@
 // @keepTs
 // @ts-nocheck
+/**
+ * 连麦/推流状态处理用例，负责角色相关的状态流转和 socket 协议交互
+ */
 export interface IStreamerHandleStateUseCase {
+    /**
+     * 初始化当前用例或模块，注册依赖、状态监听和 socket/RTC 回调。
+     */
     init(): void;
+    /**
+     * 开始推流。讲师为开播，嘉宾为加入直播连麦。
+     */
     startStream(recover: boolean): void;
+    /**
+     * 结束当前推流。讲师为结束直播，嘉宾为退出直播。
+     */
     finishStream(): void;
+    /**
+     * 释放当前对象持有的监听、定时器和临时状态，避免页面退出后继续收到回调。
+     */
     onDestroy(): void;
 }

package/src/main/ets/modules/streamer/viewmodel/usecase/roles/base/IStreamerMixStreamUseCase.d.ets

@@ -1,9 +1,18 @@
 // @keepTs
 // @ts-nocheck
 import { PLVStreamerMixLayoutType } from '../../../../model/vo/PLVStreamerMixLayoutType';
+/**
+ * 混流用例，负责根据当前连麦成员和布局生成服务端混流动作
+ */
 export interface IStreamerMixStreamUseCase {
+    /**
+     * 初始化当前用例或模块，注册依赖、状态监听和 socket/RTC 回调。
+     */
     init(): void;
     startMix(): void;
     stopMix(): void;
+    /**
+     * 设置服务端混流布局类型。
+     */
     setMixLayoutType(mixLayoutType: PLVStreamerMixLayoutType): void;
 }

package/src/main/ets/modules/streamer/viewmodel/usecase/roles/guest/StreamerGuestHandleStateUseCase.d.ets

@@ -3,14 +3,26 @@
 import { PLVStreamerRepo } from '../../../../model/PLVStreamerRepo';
 import { IStreamerHandleStateUseCase } from '../base/IStreamerHandleStateUseCase';
 import { StreamerMixStreamUseCase } from '../../StreamerMixStreamUseCase';
+/**
+ * 连麦/推流状态处理用例，负责角色相关的状态流转和 socket 协议交互
+ */
 export declare class StreamerGuestHandleStateUseCase implements IStreamerHandleStateUseCase {
     private readonly repo;
     private readonly mixStreamUseCase;
     private updateLiveStreamStatusIntervalTask;
     private disposables;
-    constructor(t93: PLVStreamerRepo, u93: StreamerMixStreamUseCase);
+    constructor(t95: PLVStreamerRepo, u95: StreamerMixStreamUseCase);
+    /**
+     * 初始化当前用例或模块，注册依赖、状态监听和 socket/RTC 回调。
+     */
     init(): void;
-    startStream(q93: boolean): Promise<void>;
+    /**
+     * 开始推流。讲师为开播，嘉宾为加入直播连麦。
+     */
+    startStream(q95: boolean): Promise<void>;
+    /**
+     * 结束当前推流。讲师为结束直播，嘉宾为退出直播。
+     */
     finishStream(): void;
     private onSocketMessage;
     private onSocketOnSliceStart;

package/src/main/ets/modules/streamer/viewmodel/usecase/roles/guest/StreamerGuestMixStreamUseCase.d.ets

@@ -3,11 +3,20 @@
 import { PLVStreamerRepo } from '../../../../model/PLVStreamerRepo';
 import { PLVStreamerMixLayoutType } from '../../../../model/vo/PLVStreamerMixLayoutType';
 import { IStreamerMixStreamUseCase } from '../base/IStreamerMixStreamUseCase';
+/**
+ * 混流用例，负责根据当前连麦成员和布局生成服务端混流动作
+ */
 export declare class StreamerGuestMixStreamUseCase implements IStreamerMixStreamUseCase {
     private readonly repo;
-    constructor(w93: PLVStreamerRepo);
+    constructor(w95: PLVStreamerRepo);
+    /**
+     * 初始化当前用例或模块，注册依赖、状态监听和 socket/RTC 回调。
+     */
     init(): void;
     startMix(): void;
     stopMix(): void;
-    setMixLayoutType(v93: PLVStreamerMixLayoutType): void;
+    /**
+     * 设置服务端混流布局类型。
+     */
+    setMixLayoutType(v95: PLVStreamerMixLayoutType): void;
 }

package/src/main/ets/modules/streamer/viewmodel/usecase/roles/teacher/StreamerTeacherHandleStateUseCase.d.ets

@@ -3,14 +3,29 @@
 import { PLVStreamerRepo } from '../../../../model/PLVStreamerRepo';
 import { IStreamerHandleStateUseCase } from '../base/IStreamerHandleStateUseCase';
 import { StreamerMixStreamUseCase } from '../../StreamerMixStreamUseCase';
+/**
+ * 连麦/推流状态处理用例，负责角色相关的状态流转和 socket 协议交互
+ */
 export declare class StreamerTeacherHandleStateUseCase implements IStreamerHandleStateUseCase {
     private readonly repo;
     private readonly mixStreamUseCase;
-    constructor(j94: PLVStreamerRepo, k94: StreamerMixStreamUseCase);
+    constructor(j96: PLVStreamerRepo, k96: StreamerMixStreamUseCase);
+    /**
+     * 初始化当前用例或模块，注册依赖、状态监听和 socket/RTC 回调。
+     */
     init(): void;
-    startStream(b94: boolean): Promise<void>;
+    /**
+     * 开始推流。讲师为开播，嘉宾为加入直播连麦。
+     */
+    startStream(b96: boolean): Promise<void>;
+    /**
+     * 结束当前推流。讲师为结束直播，嘉宾为退出直播。
+     */
     finishStream(): void;
     private emitSocketOnSliceStart;
     private emitSocketFinishClass;
+    /**
+     * 释放当前对象持有的监听、定时器和临时状态，避免页面退出后继续收到回调。
+     */
     onDestroy(): void;
 }

package/src/main/ets/modules/streamer/viewmodel/usecase/roles/teacher/StreamerTeacherMixStreamUseCase.d.ets

@@ -3,17 +3,26 @@
 import { PLVStreamerRepo } from '../../../../model/PLVStreamerRepo';
 import { PLVStreamerMixLayoutType } from '../../../../model/vo/PLVStreamerMixLayoutType';
 import { IStreamerMixStreamUseCase } from '../base/IStreamerMixStreamUseCase';
+/**
+ * 混流用例，负责根据当前连麦成员和布局生成服务端混流动作
+ */
 export declare class StreamerTeacherMixStreamUseCase implements IStreamerMixStreamUseCase {
     private readonly repo;
-    constructor(d95: PLVStreamerRepo);
+    constructor(i97: PLVStreamerRepo);
     private readonly mixActionDebounce;
     private readonly mixAction;
     private updateMixObserver;
+    /**
+     * 初始化当前用例或模块，注册依赖、状态监听和 socket/RTC 回调。
+     */
     init(): void;
     startMix(): void;
     private observeUpdateMix;
     stopMix(): void;
-    setMixLayoutType(y94: PLVStreamerMixLayoutType): void;
+    /**
+     * 设置服务端混流布局类型。
+     */
+    setMixLayoutType(d97: PLVStreamerMixLayoutType): void;
     private readMixEncodeParam;
     private readMixLayoutType;
     private readMixUserList;

package/src/main/ets/modules/web/PLVSocketWebController.d.ets

@@ -12,11 +12,11 @@ export declare class PLVSocketWebController extends PLVWebController {
     private callbacks;
     private awaitFinishCallback;
     eventNotify: PLVEventNotify;
-    constructor(q97: PLVChannelData, r97: PLVSocketMediator, s97?: string);
-    callWebHandle(o97: string, p97: PLVCallback<string, void>): void;
+    constructor(v99: PLVChannelData, w99: PLVSocketMediator, x99?: string);
+    callWebHandle(t99: string, u99: PLVCallback<string, void>): void;
     destroy(): void;
-    private init;
-    private initAfterAttached;
+    protected init(): void;
+    protected initAfterAttached(): void;
     private handleOnEvent;
     private forwardSocketEvent;
 }

package/src/main/ets/modules/web/PLVWebControllerManager.d.ets

@@ -6,6 +6,7 @@ import { PLVSocketWebController } from './PLVSocketWebController';
 import common from "@ohos.app.ability.common";
 import { PLVPPTWebController } from '../ppt/PLVPPTWebController';
 import { PLVPlayerMediator } from '../player/PLVPlayerMediator';
+import { PLVStreamerInteractWebController } from '../interact/PLVStreamerInteractWebController';
 /**
  * web控制器管理器
  */
@@ -17,8 +18,8 @@ export declare class PLVWebControllerManager {
      * 初始化上下文
      * @param importSDKModuleContext
      */
-    static initContext(w97: common.UIAbilityContext): void;
-    constructor(t97: PLVChannelData, u97: PLVSocketMediator, v97: PLVPlayerMediator);
+    static initContext(b100: common.UIAbilityContext): void;
+    constructor(y99: PLVChannelData, z99: PLVSocketMediator, a100: PLVPlayerMediator);
     /**
      * 创建一个socketWeb控制器
      * @returns
@@ -29,4 +30,9 @@ export declare class PLVWebControllerManager {
      * @returns
      */
     createPPTWebController(): PLVPPTWebController;
+    /**
+     * 创建一个推流互动Web控制器
+     * @returns
+     */
+    createStreamerInteractWebController(): PLVStreamerInteractWebController;
 }

package/src/main/ets/modules/web/PLVWebParams.d.ets

@@ -24,4 +24,4 @@ export interface ChannelInfoBean {
     channelId?: string;
     roomId?: string;
 }
-export declare function toWebParams(x97: PLVChannelData): Promise<string>;
+export declare function toWebParams(c100: PLVChannelData): Promise<string>;

package/src/main/ets/modules/web/qa/PLVQAWeb.d.ets

@@ -14,5 +14,5 @@ export declare struct PLVQAWeb {
     aboutToDisappear(): void;
     build(): void;
     config(): Promise<void>;
-    initUrl(b98?: PLVLanguage): void;
+    initUrl(g100?: PLVLanguage): void;
 }

package/src/main/ets/modules/web/tuwen/PLVTuwenWeb.d.ets

@@ -14,6 +14,6 @@ export declare struct PLVTuwenWeb {
     aboutToDisappear(): void;
     build(): void;
     config(): Promise<void>;
-    initUrl(v98?: PLVLanguage): void;
+    initUrl(a101?: PLVLanguage): void;
     callRefresh(): void;
 }

package/src/main/module.json

@@ -1 +1 @@
-{"app":{"bundleName":"net.plv.livescenes.demo","debug":false,"versionCode":1040000,"versionName":"1.4.0","minAPIVersion":50000012,"targetAPIVersion":60000020,"apiReleaseType":"Release","targetMinorAPIVersion":0,"targetPatchAPIVersion":0,"compileSdkVersion":"6.0.0.47","compileSdkType":"HarmonyOS","appEnvironments":[],"bundleType":"app","buildMode":"release"},"module":{"name":"sdk","type":"har","deviceTypes":["default","tablet","2in1"],"packageName":"@polyvharmony/live-scenes-sdk","installationFree":false,"virtualMachine":"ark12.0.2.0","compileMode":"esmodule","dependencies":[]}}
+{"app":{"bundleName":"net.plv.livescenes.demo","debug":false,"versionCode":1060000,"versionName":"1.6.0","minAPIVersion":50000012,"targetAPIVersion":60002022,"apiReleaseType":"Release","targetMinorAPIVersion":0,"targetPatchAPIVersion":0,"compileSdkVersion":"6.0.2.130","compileSdkType":"HarmonyOS","appEnvironments":[],"bundleType":"app","buildMode":"release"},"module":{"name":"sdk","type":"har","deviceTypes":["default","tablet","2in1"],"packageName":"@polyvharmony/live-scenes-sdk","installationFree":false,"virtualMachine":"ark12.0.2.0","compileMode":"esmodule","dependencies":[]}}