@plasosdk/plaso-electron-sdk 1.3.5 → 1.3.7

package/CHANGELOG.md

@@ -5,3 +5,9 @@
 ## [1.3.5](https://www.npmjs.com/package/@plasosdk/plaso-electron-sdk/v/1.3.5)(2025-08-21)
 
 ### 1. 移除了未使用的rtmpplayer和plasoffmpeg依赖
+
+## [1.3.6](https://www.npmjs.com/package/@plasosdk/plaso-electron-sdk/v/1.3.6)(2025-08-29)
+
+### 1. 音视频课堂增加常驻的禁麦提示
+
+### 2. 优化本地麦克风音量波纹显示

package/README.md

@@ -1,23 +1,24 @@
-# 支持的平台与 Electron 版本
+# Plaso SDK for Electron
 
--   MacOS 支持 x64、arm64架构
--   Windows 支持 x86、x64架构
+## 🖥 环境支持
 
-**<font color=red>Electron 版本要求： 14.0.0~22.3.27</font>**
+- 🌈 支持 MacOS x86-64 和 arm64
+- ⚙️ 支持 Windows ia32 和 x64
+- [Electron](https://www.electronjs.org/): 14.0.0~22.3.27
 
-# 1、接入步骤
-
-## 1.1、安装
+| MacOS | Windows | Electron |
+| --- | --- | --- |
+| x86 \| arm64 | ia32 \| x64 | 14.0.0~22.3.27                                                                        
 
-**<font color=red>注意: 不同平台依赖包不互通</font>**
+## 安装
 
-**第一步：安装 @electron/remote**
+**安装 @electron/remote**
 
 ```shell
 npm install @electron/remote --global-style --legacy-peer-deps
 ```
 
-**第二步：安装 plaso-electron-sdk**
+**安装 plaso-electron-sdk**
 
 ```shell
 npm install @plasosdk/plaso-electron-sdk --global-style
@@ -26,69 +27,95 @@ npm install @plasosdk/plaso-electron-sdk --global-style
 **<font color=red>注意: 不同平台需要单独安装，尤其是MacOS，请分别在Intel芯片和Apple芯片的电脑上安装</font>**
 
 ## electron-builder打包特别说明
-使用electron-builder打包时，需要对工程的node_modules中的agora-electron-sdk-v4进行特殊处理，该包是在安装@plasosdk/plaso-electron-sdk时动态安装的，因此需要通过配置extraResources单独拷贝。配置入如下
+
+### extraResources配置
+
+> ⚠️ 注意：该配置在 1.3.7 版本有所调整。如果你正在从 < 1.3.7 升级到 >= 1.3.7，请参照下列说明进行调整。
+
+agora-electron-sdk-v4包是在安装plaso-electron-sdk时通过脚本动态安装的，不在dependencies依赖树中，electron-builder打包时不会包含它。为了保留它，需要配置[extraResources](https://www.electron.build/configuration#extraresources)来单独拷贝一份，把它包含进来。
+
 ```json
-"extraResources": [
-    {
-        "from": "node_modules/agora-electron-sdk-v4",
-        "to": "app/node_modules/agora-electron-sdk-v4",
-        "filter": ["**/*"]
-    },
-    {
-        "from": "node_modules/agora-electron-sdk-v4/node_modules",
-        "to": "app/node_modules/agora-electron-sdk-v4/node_modules",
-        "filter": ["**/*"]
-    }
-]
+{
+    "extraResources": [
+        {
+            "from": "node_modules/@plasosdk/plaso-electron-sdk/node_modules/agora-electron-sdk-v4",
+            "to": "app/node_modules/@plasosdk/plaso-electron-sdk/node_modules/agora-electron-sdk-v4",
+            "filter": [
+                "**/*"
+            ]
+        },
+        {
+            "from": "node_modules/@plasosdk/plaso-electron-sdk/node_modules/agora-electron-sdk-v4/node_modules",
+            "to": "app/node_modules/@plasosdk/plaso-electron-sdk/node_modules/agora-electron-sdk-v4/node_modules",
+            "filter": [
+                "**/*"
+            ]
+        }
+    ]
+}
 ```
+
 同时，由于这个包是通过extraResources进行拷贝的，需要在签名脚本中额外配置这个包的路径。
 
-另外在打包MacOS的包时有几个需要额外进行授权的可执行文件。建议通过额外的脚本来执行。下面的可执行文件是在安装@plasosdk/plaso-electron-sdk时动态下载的，因此授权的脚本需要保证是在文件下载之后。
+### 关闭asar
+
+需要关闭asar，否则SDK会无法加载到node_modules。关闭方式详见electron-buider[官方文档](https://www.electron.build/configuration#asar)。
+
+```json
+{
+    "asar": false, // 关闭asar
+}
+```
+
+### MacOS赋予文件执行权限
+
+打MacOS的包时有几个需要额外进行授权的可执行文件。建议通过额外的脚本来执行。
+
+下面的可执行文件是在安装@plasosdk/plaso-electron-sdk时动态下载的，因此授权的脚本需要保证是在文件下载之后。
+
 ```shell
 // 截图会用到
-chmod +x node_modules/@plasosdk/plaso-electron-sdk/lib/flameshot  
+chmod +x node_modules/@plasosdk/plaso-electron-sdk/lib/flameshot.app
 
 // 桌面共享会用到
 chmod +x node_modules/@plasosdk/plaso-electron-sdk/lib/PlasoALD/PlasoALD.scpt
 ```
 
-MacOS打包完毕后，建议安装打好的包后自行验证上述的操作时候生效了。
+### 验证
+
+MacOS打包完毕后，建议安装打好的包，验证上述操作是否成功。核对清单：
 - 检查包内容中node_modules里面的agora-electron-sdk-v4包中是否包含node_modules，包含则说明打包正确。
 - 上课测试截图功能是否正常，截图正常说明授权正确。
 - 上课测试桌面共享功能，使用屏幕共享，并在浏览器里面播放一段视频，结束课堂后检查回放中能否听到桌面共享那一段播放的视频的声音，能听到说明授权正确。
 
-## 1.2、使用
+## 使用
 
-### 1.2.1、在主进程中使用
+### 在主进程中使用
 
 需要在主进程加载 `@plasosdk/plaso-electron-sdk` 依赖包
 
 ```ts
-require('@plasosdk/plaso-electron-sdk');
-
 // electron 版本>=14.0.0 时：需要在主进程里 初始化、启动 remote
-const electronVersion = process.versions['electron'];
-if (electronVersion && versionComp(electronVersion, '14.0.0') >= 0) {
-    const electronStore = require('@electron/remote/main');
-    electronStore.initialize();
-    // mainWindow: 主进程打开的渲染进程窗口
-    electronStore.enable(mainWindow.webContents);
-}
-
-// 通过 initRemoteMain方法 传入 remoteMain
 const remoteMain = require('@electron/remote/main');
+remoteMain.initialize();
+remoteMain.enable(mainWindow.webContents); // mainWindow: 主进程通过loadURL加载的那个渲染进程窗口
+
+// plaso-electron-sdk中依赖@electron/remote，需要通过 initRemoteMain方法 传入 remoteMain
 const { initRemoteMain } = require('@plasosdk/plaso-electron-sdk');
 initRemoteMain(remoteMain);
 ```
 
-### 1.2.2、在渲染进程中使用
+### 在渲染进程中使用
 
 <a id="open-sdk-window-params"></a>
 
 **打开实时课堂/备课课堂方法入参类型定义**
 ```ts
-interface CreateClassPamras {
-    classOptions: Object;
+interface CreateClassWindowPamras {
+    /**
+     * 属性说明详见下方classOptions，打开实时课堂时为ILiveClassOptions，备课课堂为IPrepareClassOptions
+     */
+    classOptions: ILiveClassOptions | IPrepareClassOptions;
     electronWinOptions?: Electron.BrowserWindowConstructorOptions;
     onClassWindowReadyFn?: (winId: number) => void
     onClassWindowLeaveFn?: (winId: number) => void
@@ -105,242 +132,222 @@ interface CreateClassPamras {
 }
 ```
 
-#### 1.2.3.1、打开实时课堂
-
-```ts
-// 代码示例
-const PlasoElectronSdk = window.require('@plasosdk/plaso-electron-sdk');
-const createLiveClassParams: CreateClassPamras = { classOptions: { query } };
-PlasoElectronSdk.createLiveClassWindow(createLiveClassParams);
-```
-
-入参详见[实时课堂参数说明](#live-class-params)
+#### 打开实时课堂
 
-#### 1.2.3.2、打开备课课堂
+SDK打开一个新的`BrowserWindow`来加载实时课堂UI界面，示例代码如下：
 
 ```ts
-// 代码示例
 const PlasoElectronSdk = window.require('@plasosdk/plaso-electron-sdk');
-const createPrepareClassParams: CreateClassPamras = { classOptions: { loginName: 'hello', userName: 'world' } };
-PlasoElectronSdk.createPrepareClassWindow(createClassParams);
+const createLiveClassWindowParams: CreateClassWindowPamras = { classOptions: { query } };
+PlasoElectronSdk.createLiveClassWindow(createLiveClassWindowParams);
 ```
 
-入参详见[备课课堂入参说明](#prepare-class-params)
+##### createLiveClassWindow参数说明
 
+###### classOptions
 
-<a id="live-class-params"></a>
-# 2、实时课堂入参说明
-
-## 2.1、参数 classOptions
+```ts
+interface ILiveClassOptions {
+    /** 进入课堂必须的签名字符串 */
+    query: string;
+    /** 当前进入课堂用户的头像，取值为https全地址 */
+    displayAvatarUrl?: string;
+    /** 课堂中的成员，会在成员列表中呈现 */
+    classMembers?: UserInfo[];
+    /** 是否启用降噪 */
+    enableENC?: boolean;
+    /** 是否启用3A */
+    enableRTC3A?: boolean;
+    /** 是否启用新桌面共享 */
+    enableLiveNewShare?: boolean;
+    /** 是否启用触屏设备上的新桌面共享 */
+    enableLiveNewShareInTouch?: boolean;
+    /** 是否启用部分屏幕区域共享 */
+    enableLiveNewShareRegion?: boolean;
+    /** 是否启用签到 */
+    enableLiveSign?: boolean;
+    /** 是否启用资料中心（云盘） */
+    supportShowResourceCenter?: boolean;
+    /** 是否支持保存板书 */
+    supportSaveBoard?: boolean;
+    /** 是否启用摄像头常驻 */
+    residentCamera?: boolean;
+}
 
-```
-类型：Object
+interface UserInfo {
+    /** 用户名，唯一标识 */
+    loginName: string;
+    /** 用户昵称 */
+    name: string;
+    /** 用户角色 */
+    upimeRole: 'speaker' | 'assistant' | 'listener';
+    /** 用户头像 */
+    displayAvatarUrl?: string;
+}
 ```
 
-### 2.1.1、属性列表
-
-| 参数 | 是否必传 | 类型 | 默认值 | 说明 |
-| --- | --- | --- | --- | --- |
-| query | 是 | string | 无 | 进课堂必传字段，具体拼接逻辑见下文[query 属性说明](#query) |
-| displayAvatarUrl | 否 | string | 无 | 用户头像地址 |
-| classMembers | 否 | object[] | 无 | 1、课对应的班级用户信息<br />2、初始化课堂参与人<br /><br />3、最多支持 2000 人，需要支持更多学生需要联系伯索平台进行额外申请<br />{<br /><br />/** 唯一标识该用户的 id \*/<br />loginName: string,<br /><br />/** 用户显示的姓名 _/<br />name: string,<br />/\*\* 用户角色，"speaker","assistant","listener","superlistener" 之一 _/<br />upimeRole: string,<br />/** 用户的 id，和云学堂业务强相关，sdk 用户非必要 \*/<br />unique_id: number \| string<br />/** 用户头像图片的 url，非必要 \*/<br />displayAvatarUrl: string,<br />} |
-| enableENC | 否 | boolean | true | 是否启用降噪 |
-| enableRTC3A | 否 | boolean | true | 是否启用 3A。<br />false：关闭回音消除、关闭降噪、关闭增益控制 |
-| supportShowResourceCenter | 否 | boolean | false | true：工具栏显示 资料中心 按钮，但资料中心的逻辑需要用户自己实现 |
-| supportSaveBoard | 否 | boolean | false | 是否支持保存板书，依赖于资料中心实现保存和插入板书文件 |
-| enableLiveNewShareRegion | 否 | boolean | false | 是否允许区域共享 |
-| enableLiveNewShareInTouch | 否 | boolean | false | 是否支持触屏模式下的新桌面共享（左侧新增按钮窗口来切换显示工具栏）<br />建议开启 |
-| enableLiveNewShare | 否 | boolean | false | 是否支持新桌面共享<br />开启新桌面共享需要开启 electron 透明窗口,且可能触发 electron 本身存在的长时间透传导致的在应用上鼠标失焦问题 |
-| enableLiveSign | 否 | boolean | false | 是否支持签到 |
-| residentCamera | 否 | boolean | false | 常驻摄像头：只对学生或游客生效 |
-|  |  |  |  |  |
+| <span style="white-space: nowrap;">参数名称</span> | <span style="white-space: nowrap;">是否必填</span> | <span style="white-space: nowrap;">类型</span> | <span style="white-space: nowrap;">参数描述</span> |
+| --- | --- | --- | --- |
+| query | 是 | string | 带签名的字符串，具体拼接逻辑见下文[query属性说明](#query) |
+| displayAvatarUrl | 否 | string | 用户头像地址。不传默认使用用户昵称作为头像。 |
+| classMembers | 否 | UserInfo[] | 成员列表中显示的人员，最多支持 2000 人。**人员超过2000人需要联系伯索平台进行额外申请**。 |
+| enableRTC3A | 否 | boolean | 是否启用3A：回音消除、噪声抑制、自动增益控制。默认启用。 |
+| enableENC | 否 | boolean | 是否启用降噪控制，开启后设置界面可以设置`基础降噪`或`增强降噪`。默认启用。 |
+| enableLiveNewShare | 否 | boolean | 是否启用新桌面共享。启用后共享`屏幕`/`部分屏幕区域`时会对课堂窗口做透明化处理，需要选中工具栏上的`交互模式`工具来交互桌面应用，可能会触发`Electron`长时间透传鼠标事件导致的透传异常问题，谨慎使用。默认不启用。 |
+| enableLiveNewShareInTouch | 否 | boolean | 是否在触屏设备上启用新桌面共享，启用后通过切换`演示模式`和`互动模式`来交互桌面应用和课堂中的工具。默认不启用。 |
+| enableLiveNewShareRegion | 否 | boolean | 是否启用`部分屏幕区域`共享。 |
+| enableLiveSign | 否 | boolean | 是否启用签到，启用后工具箱中显示`签到`按钮。默认不启用。 |
+| supportShowResourceCenter | 否 | boolean | 是否启用`资料中心(云盘)`，启用后在工具栏显示`资料中心(云盘)`按钮，此按钮需要配合`onOpenResourceCenterFn`回调一起使用。默认不启用。 |
+| supportSaveBoard | 否 | boolean | 是否启用保存板书，启用后工具箱中显示`保存当页板书`按钮，需要配合云盘使用。默认不启用。 |
+| residentCamera | 否 | boolean | 是否启用常驻摄像头：只对学生或游客生效。启用后学生进入课堂后摄像头常驻开启，没有开启摄像头权限时也会开启。默认不启用。 |
 
 <a id="query"></a>
-### 2.1.1、query 属性
+**query属性说明**
 
-**query 属性格式示例**：
+query本质上是根据`IQueryParams`对象中的字段生成带签名的字符串，query示例如下：
 
-```
-appId=plaso&appType=liveclassSDK&d_dimension=1280x720&dhost=https%3A%2F%2Fdev.plaso.cn%2F&enableHiliter=true&enableNewClassExam=1&enableVideoMark=true&loginName=t_1&mediaType=video&meetingId=test_1742442362&meetingType=public&signature=A226198904A392579B98987FB4CD5478AB3F5587&upimeTeacherTool=1151&userName=%E8%80%81%E5%B8%881&userType=speaker&validBegin=1742442364&validTime=99999&vendorType=2&videoStream=2
+```ts
+const query = 'appId=plaso&appType=liveclassSDK&d_dimension=1280x720&enableNewClassExam=1&loginName=t_1&mediaType=video&meetingId=test_1742442362&meetingType=public&signature=A226198904A392579B98987FB4CD5478AB3F5587&userName=%E8%80%81%E5%B8%881&userType=speaker&validBegin=1742442364&validTime=99999'
 ```
 
-#### 2.1.1.1、组成 queryParams 对象
-
 ```ts
 interface IQueryParams {
     appId: string;
-    signature: string;
     validBegin: number;
     validTime: number;
-    endTime: number;
-    appType: string;
-    userType: string;
-    meetingType: string;
     mediaType: string;
+    meetingType: string;
     meetingId: string;
+    userType: string;
     loginName: string;
     userName: string;
     d_dimension: string;
-    vendorType: number;
-    videoStream: number;
-    enableNewClassExam: number;
-    d_enableReRecording: number;
 
     topic?: string;
+    endTime?: number;
     onlineMode?: number;
-    d_enableOMO?: number;
     d_delayEndTimes?: number;
     d_delayEnd?: number;
-    d_restrictAssistantPerm?: number;
     d_enableAvatarFreeScale?: number;
     d_enableObjectEraser?: number;
     d_vote?: number;
     d_sharpness?: number;
     isNewMT?: number;
-    d_enableDualCamera?: number;
+    enableNewClassExam?: number;
+    d_enableReRecording?: number;
+    d_restrictAssistantPerm?: number;
 }
 ```
 
-##### 2.1.1.1.1、必传参数表格说明
-
-| 参数 | 类型 | 说明 |
-| --- | --- | --- |
-| appId | string | 在申请接入时，伯索平台给予的 appId |
-| signature | string | 签名字符串，根据queryParams中除去signature参数的其他参数生成，生成示例参考[根据queryParams对象生成签名字符串](#generate-signature) |
-| validBegin | number | 请求课堂**开始生效起始时间**的 Unix Epoch 时间戳，单位秒：（时间戳/1000 再取整） |
-| validTime | number | 请求的**签名在课堂的有效时间段**（断网重连后会重新校验签名），单位秒，建议: 24 _ 60 _ 60 s |
-| endTime | number | 请求课堂**结束时间**的 Unix Epoch 时间戳，单位秒：（时间戳/1000 再取整） |
-| appType | string | 应用类型，必填，目前为固定值：liveclassSDK |
-| userType | string | 用户类型，目前有三个值可选： speaker，assistant，listener； <br />speaker：主讲，有控制其他 listener 是否可写可说话的权限；<br />assistant：助教，也有控制权限<br />listener：学生 |
-| meetingType | string | 课堂类型，传入值：private。 当选择 private 类型时，每一个进入课堂者，必须提供 loginName，这是唯一标识该用户的 id，相同的 loginName 登录，后进入者会使前一个强制登出 |
-| mediaType | string | 媒体类型：audio, video<br />audio: 语音实时课堂<br />video：有头像权限的课堂，含语音权限 |
-| meetingId | string | 课堂 ID，唯一标识该课堂；使用 ASSIIC 字符，不得包含/，,空格等；长度在 40 字节以内的字符串 |
-| loginName | string | **唯一标识该用户的 id**，不能为空，相同的 loginName 登录，后面一个会使前面一个登出； |
-| d_dimension | string | 1280x720 定义界面尺寸为 16:9 界面 |
-| userName | string | 登录的用户名，在列表中显示用 |
-| vendorType | number | rtc 类型 <br />2：agora |
-| videoStream | number | 课堂类型，与 mediaType 需要对应上<br />2：视频课堂<br />1：语音课堂 |
-| enableNewClassExam | number | 新版随堂测选择题：1；<br />新版随堂测填空题：2；<br />新版随堂测选择+填空：3，建议：3 |
-| d_enableReRecording | number | 主讲、助教都可以重新录制课堂：3 |
-|  |  |  |
-|  |  |  |
-
-##### 2.1.1.1.2、可选参数表格说明
-
-| 参数 | 类型 | 默认值 | 建议值 | 说明 |
-| :-: | :-: | :-: | :-: | :-- |
-| topic | string | 无 | 非空 | 显示该课堂的名称 |
-| onlineMode | number | 6 | 无 | 上台学生数，1:最大上台 1 个学生，6：最大上台 6 个学生，12：最大上台 12 个学生。默认：6 |
-| d_enableOMO | number | 0 | 无 | 是否开启站播模式,1：开启；0：关闭 |
-| d_delayEndTimes | number | 0 | 无 | 单节课最大延迟下课次数：1、2、3、4 |
-| d_delayEnd | number | 0 | 无 | 单次延时时间，单位秒：5*60、10 * 60、15*60、20 * 60、30\*60 |
-| d_restrictAssistantPerm | number | 0 | 无 | 是否开启了：大班课限制助教权限<br />1：开启<br />0：关闭 |
-| d_enableAvatarFreeScale | number | 0 | 无 | 开启头像任意比例缩放<br />0:关闭 1:开启，默认关闭 （非录制课堂、非无头像录制模式下，裁剪掉的老师/助教头像也会被录到回放中） |
-| d_enableObjectEraser | number | 0 | 无 | 新板书配置，二进制位存储<br />default: 0；默认关闭对象擦<br />7:手写(对象擦);<br /> |
-| d_vote | number | 0 | 1 | 0：未开放投票；1：开放投票 |
-| d_sharpness | number | 10 | 无 | 头像推流清晰度、桌面共享清晰度<br />**仅 onlineMode 为 1 时生效**：<br />10：标清 20：高清 21: 高清流畅 30：超清 31: 超清流畅 |
-| isNewMT | number | 0 | 1 | 是否支持 移动授课模式；<br />建议传 1 |
-| d_enableDualCamera | number | 0 | 无 | 是否开启双摄，1：开启，0： 关闭 |
-| recordType | number | 无 | 无 | 配置 recordAvartor 设置录制对象，参数说明参考[附录 9.1](#record-type) |
-| recordAvator | string | '' | 无 | 传入老师/助教的`loginName`表示录制对应人的头像 |
-| recordScreen | string | '' | 无 | 传入'screen'表示录制屏幕（当前仅支持录制老师屏幕）|
-|  |  |  |  |  |
-
-<a id="generate-signature"></a>
-#### 2.1.1.2、根据 queryParams 对象生成签名字符串
-
-（1）**用户把 queryParams 作为参数传给自己的接口，接口返回值必须返回签名字符串：signature**
-
-（2）获取 signature 后需要把 signature 加到 queryParams 中作为一个参数
+| <span style="white-space: nowrap;">字段名称</span> | <span style="white-space: nowrap;">是否必填</span> | <span style="white-space: nowrap;">类型</span> | <span style="white-space: nowrap;">字段描述</span> |
+| --- | --- | --- |--- |
+| appId | 是 | string | 在申请接入时，伯索平台给予的 appId |
+| validBegin | 是 | number  | 签名query生效的起始时间，Unix Epoch 时间戳，单位为秒 |
+| validTime | 是 | number | 签名query的有效期，从`validBegin`开始计算，单位为秒 |
+| mediaType | 是 | string  | 媒体类型，取值：<ul><li>audio: 音频课堂</li><li>video: 视频课堂</li></ul>
+| meetingType | 是 | string | 课堂类型，固定值为`public` |
+| meetingId | 是 | string  | 课堂ID，唯一标识该课堂；使用ASSIIC字符，不得包含/，\,空格等；长度在40字节以内的字符串。 |
+| userType | 是 | string | 用户角色类型，取值：<ul><li>speaker: 课堂的主讲者，有控制其他listener是否可板书/发言的权限。课堂中只能有一个主讲</li><li>assistant：助教，辅助主讲授课的角色，在课堂中的权限与主讲基本一致。课堂中可以有多个助教</li><li>listener：听众，可以理解为学生</li></ul> |
+| loginName | 是 | string | 唯一标识该用户的id，不能为空，相同的loginName进入课堂时，后面进入的会使前面进入的登出 |
+| userName | 是 | string | 用户昵称，头像缺省时会显示 |
+| d_dimension | 是 | string | 固定值为`1280x720`，定义界面尺寸为16:9界面 |
+| topic | 否 | string | 课堂名称，在标题栏上显示 |
+| endTime | 否 | number | 课堂结束时间，格式为 Unix Epoch 时间戳，单位为秒 |
+| onlineMode | 否 | number | 当mediaType为`video`时生效，表示最大能开启的`listener`的摄像头的个数，取值：<ul><li>1</li><li>6</li><li>12</li></ul>默认值为6 |
+| d_delayEndTimes | 否 | number | 单节课最大延时下课次数，取值：<ul><li>1</li><li>2</li><li>3</li><li>4</li></ul>默认没有延时 |
+| d_delayEnd | 否 | number | 单次延时时间，单位为秒，取值：<ul><li>5 * 60</li><li>10 * 60</li><li>20 * 60</li><li>30 * 60</li></ul>默认20分钟 |
+| d_enableAvatarFreeScale | 否 | number | 是否开启头像任意比例缩放，仅上课中各端同步，录制头像时历史课堂不支持课堂调整的任意比例，取值：<ul><li>0：关闭</li><li>1：开启</li></ul>默认关闭 |
+| d_enableObjectEraser | 否 | number | 是否启用新版板书，新版板书的橡皮擦支持对象擦除，传入大于0的值启用新版板书。取值：<ul><li>0: 不启用，橡皮功能为点擦</li><li>1: 支持对象擦除手写</li><li>3: 支持对象擦除手写+文本</li><li>5: 支持对象擦除手写+图形</li><li>7: 支持对象擦除手写+文本+图形</li></ul>默认不启用 |
+| d_vote | 否 | number | 是否启用投票工具。取值：<ul><li>0：关闭</li><li>1：开启</li></ul>默认关闭 |
+| d_sharpness | 否 | number | 当mediaType为`video`时生效，表示摄像头画面的清晰度。取值：<ul><li>10: 360p</li><li>20: 720p</li><li>30: 1080p</li></ul>默认值为10 |
+| isNewMT | 否 | number | 是否支持移动授课模式，建议传1 |
+| recordAvator | 否 | string | 传入老师或助教的`loginName`表示录制对应人的头像，传入`recordScreen`时SDK会忽略此参数 |
+| recordScreen | 否 | string | 传入`screen`表示录制屏幕（当前仅支持录制老师屏幕）|
+| enableNewClassExam | 否 | number | 是否启用新版随堂测，取值：<ul><li>0: 不启用</li><li>1: 启用选择题</li><li>2: 启用填空题</li><li>3: 启用选择题+填空题</li></ul>默认不启用，建议传3 |
+| d_enableReRecording | 否 | number | 是否允许老师/助教重新录制，取值：<ul><li>0: 不允许老师和助教重新录制</li><li>1: 仅允许老师重新录制</li><li>2: 仅允许助教重新录制</li><li>3: 允许老师和助教重新录制</li></ul>默认值为3 |
+| d_restrictAssistantPerm | 否 | number | 是否启用限制助教权限，取值：<ul><li>0: 不启用</li><li>1: 启用</li></ul>默认不启用 |
+
+**根据 queryParams 对象生成签名字符串**
+> 注意：为了安全和各端签名统一，建议将签名的计算放在服务端，前端通过接口获取带签名的query
+
+将queryParams传入签名函数生成签名，签名示例参考：[签名示例](https://open.plaso.cn/doc-6285173?nav=01HEQ5Y5RXKMCPBPF6S8T3VK56)
+
+获取`signature`后将`signature`加到`queryParams`中作为一个字段。
 
 ```ts
 queryParams.signature = signature;
 ```
 
-（3）**服务端接口生成 signature 规则**如下：
-
-https://open.plaso.cn/doc-6285173?nav=01HEQ5Y5RXKMCPBPF6S8T3VK56
-
-**signKey**：机构申请接入时，伯索平台给予的 key
+获取完整的`queryParams`后，遍历`queryParams`生成`query`字符串，每个字段的值用`encodeURIComponent`编码。完整流程示例如下：
 
 ```ts
-/*！----------演示签名代码------------- */
-
-// 业务参数，根据接口文档中定义，自行生成填写
-const queryParams = { name: 'test' };
-
-//平台分配给机构的key
-const signKey = 'a_secret';
-
-// 业务参数和签名验证混合后排序
-const afterSortParam = Object.keys(queryParams).sort();
-
-const res = [];
-for (let key of afterSortParam) {
-    res.push(`${key}=${queryParams[key]}`);
+function genSignature(params) {
+    return 'xxx';
 }
 
-// 排序后连接成字符串
-const content = res.join('&');
-
-const crypto = require('crypto');
-
-// 使用分配的signKey来加密生成签名串signature
-const signature = crypto.createHmac('sha1', signKey).update(content).digest('hex').toUpperCase();
-```
-
-#### 2.1.1.3、生成 query 字符串
-
-（1）获取 完整的 queryParams 后，遍历对象生成 query 字符串
-
-每个参数值用 encodeURIComponent 编码
-
-```ts
-// 代码示例：其中 queryParams 对象包含signature
-function genQuery(queryParams) {
-    const keys = Object.keys(queryParams).sort();
+function genQuery(params) {
+    const keys = Object.keys(params).sort();
     const res = [];
-    for (let key of keys) {
-        res.push(key + '=' + encodeURIComponent(queryParams[key]));
+    for (const key of keys) {
+        res.push(key + '=' + encodeURIComponent(params[key]));
     }
     return res.join('&');
 }
-genQuery(queryParams);
-```
 
-<a id="prepare-class-params"></a>
-# 3、备课课堂入参说明
+const queryParams = {
+    appId: 'xxx';
+    validBegin: 175645206;
+    validTime: 3600;
+    mediaType: 'video';
+    meetingType: 'public';
+    meetingId: 1234;
+    userType: 'speaker';
+    loginName: 'hello';
+    userName: 'world';
+    d_dimension: '1280x720';
+};
 
-## 3.1、参数 classOptions
+const signature = genSignature(queryParams);
+queryParams.signature = signature;
 
-```
-类型：Object
+const query = genQuery(queryParams);
 ```
 
-### 3.1.1、必传参数
+#### 打开备课课堂
 
-| 参数      | 类型   | 说明                                                                                 |
-| --------- | ------ | ------------------------------------------------------------------------------------ |
-| loginName | String | **唯一标识该用户的 id**，不能为空，相同的 loginName 登录，后面一个会使前面一个登出； |
-| userName  | String | 登录的用户名，在列表中显示用                                                         |
-|           |        |                                                                                      |
+SDK打开一个新的`BrowserWindow`来加载备课课堂UI界面，示例代码如下：
 
-### 3.1.2、可选参数
+```ts
+const PlasoElectronSdk = window.require('@plasosdk/plaso-electron-sdk');
+const createPrepareClassWindowParams: CreateClassWindowPamras = { classOptions: { loginName: 'hello', userName: 'world' } };
+PlasoElectronSdk.createPrepareClassWindow(createPrepareClassWindowParams);
+```
 
-| 参数 | 类型 | 说明 |
-| --- | --- | --- |
-| displayAvatarUrl | String | 用户头像地址 |
-| topic | String | 默认值是中文的 “备课课堂” |
-| **d_enableObjectEraser** | number | 新板书配置，二进制位存储<br />default: 0；默认关闭对象擦<br />7:手写(对象擦);<br />**注意：该值需要和实时课堂的传值一样** |
-|  |  |  |
+##### createPrepareClassWindow参数说明
 
-**注意：**
+###### classOptions
+
+```ts
+interface IPrepareClassOptions {
+    loginName: string;
+    userName: string;
+
+    displayAvatarUrl?: string;
+    topic?: string;
+    d_enableObjectEraser?: number;
+}
+```
 
-1、备课课堂直接通过任务栏关闭不会清空本地记录的板书内容，下次进入后会 板书交互会和上次进入的板书 配置一致（即使 d_enableObjectEraser 参数 值变动了）
+| <span style="white-space: nowrap;">参数名称</span> | <span style="white-space: nowrap;">是否必填</span> | <span style="white-space: nowrap;">类型</span> | <span style="white-space: nowrap;">参数描述</span> |
+| --- | --- | --- | --- |
+| loginName | 是 | string | 唯一标识该用户的id，不能为空，相同的loginName进入课堂时，后面进入的会使前面进入的登出 |
+| userName | 是 | string | 用户昵称，头像缺省时会显示 |
+| displayAvatarUrl | 否 | string | 用户头像地址。不传默认使用用户昵称作为头像。 |
+| d_enableObjectEraser | 否 | number | 是否启用新版板书，新版板书的橡皮擦支持对象擦除，传入大于0的值启用新版板书。取值：<ul><li>0: 不启用，橡皮功能为点擦</li><li>1: 支持对象擦除手写</li><li>3: 支持对象擦除手写+文本</li><li>5: 支持对象擦除手写+图形</li><li>7: 支持对象擦除手写+文本+图形</li></ul>默认不启用 |
 
-# 4、打开实时课堂/备课课堂通用参数说明
+#### 打开实时课堂/备课课堂通用参数说明
 
-## 4.1、参数 electronWinOptions 
+##### electronWinOptions 
 
 > **即将弃用**: 不推荐传入，SDK内部默认设置了一些窗口参数，为了保证最佳体验，不要传入此参数。
 
@@ -350,29 +357,28 @@ Electron的窗口参数，详情参考 [Electron官方文档](https://www.electr
 type electronWinOptions = Electron.BrowserWindowConstructiorOptions;
 ```
 
-## 4.2、参数回调 onClassWindowReadyFn
+##### onClassWindowReadyFn
 
 ```ts
 // 课堂窗口打开渲染成功后的回调，回调参数为 窗口id
 type onClassWindowReadyFn = (winId: number) => void;
 ```
 
-## 4.3、参数回调 onClassWindowLeaveFn
+##### onClassWindowLeaveFn
 
 ```ts
 // 课堂窗口关闭后的回调，回调参数为 窗口id
 type onClassWindowLeaveFn = (winId: number) => void;
 ```
 
-## 4.4、参数回调 onClassFinishedFn
+##### onClassFinishedFn
 
 ```ts
 // 课堂结束后的回调，回调参数为 课堂的meetingId
 type onClassFinishedFn = (meetingId: string) => void;
-
 ```
 
-## 4.5、参数回调 onSaveBoardFn
+##### onSaveBoardFn
 
 **注意：**
 
@@ -401,7 +407,7 @@ type onSaveBoardFn = (
 ) => void;
 ```
 
-## 4.6、参数回调 onOpenResourceCenterFn
+##### onOpenResourceCenterFn
 
 ```ts
 // 通知外部用户打开自己的资料中心，资料中心的具体ui和逻辑由外部用户自己实现
@@ -410,7 +416,7 @@ type onSaveBoardFn = (
 type onOpenResourceCenterFn = () => void;
 ```
 
-## 4.7、参数回调 onGetExtFileNameFn
+##### onGetExtFileNameFn
 
 ```ts
 // 通过 insertObject 插入的文件传入 参数 info 时，怎么从info中获取文件的可访问地址的逻辑在用户那，所以需要函数从外部用户获取外部用户传入的文件地址
@@ -419,31 +425,51 @@ type onOpenResourceCenterFn = () => void;
 type onGetExtFileNameFn = (...args: any[]) => Promise<string>;
 ```
 
-# 5、API参考
-
-## 5.1、PlasoElectronSdk.initLogConfig
+#### API参考
 
-**初始化课堂窗口日志位置**，窗口崩溃时会在同级目录下生成 reports 文件夹存储 dump，**在 调用 createLiveClassWindow 前设置**
+##### PlasoElectronSdk.initLogConfig
 
-**日志默认位置**：
+该方法用于设置SDK日志位置，SDK崩溃时会在同级目录下生成`reports`文件夹存储 dump，在调用`createLiveClassWindow`前设置，不调用SDK会在默认位置写入日志，默认位置如下：
 
 ```js
+// 获取日志路径的代码如下
 require('path').join(require('electron').app.getPath('userData'), 'P403FileTemp');
 
 // Windows：C:\Users\${userName}\AppData\Roaming\${appName}\P403FileTemp
 // Mac：/Users/${userName}/Application\ Support/${appName}/P403FileTemp
 ```
 
-参数示例：
+参考示例：
 
 ```ts
 // 代码示例
 const PlasoElectronSdk = window.require('@plasosdk/plaso-electron-sdk');
-const logFilePath = 'C:/Users/userName/Desktop/electronDemo/electron12.0.18_x32/resources/app';
-PlasoElectronSdk.initLogConfig(logFilePath);
+const logDir = 'C:/Users/userName/Desktop/electronDemo/electron12.0.18_x32/resources/app';
+PlasoElectronSdk.initLogConfig(logDir);
 ```
 
-## 5.2、PlasoElectronSdk.getVersion
+> 重要：用户需要对日志目录做定期清理和及时上传日志到自己的服务器或OSS。推荐在退出SDK后做一次清理和上传，建议清理创建时间超过7天的日志即可。
+清理日志代码示例如下：
+```ts
+function clearExpireLog() {
+    // logDir为日志目录，即initLogConfig方法设置的路径或者SDK默认路径
+    const fs = require('fs');
+    const path = require('path');
+    const logFile = fs
+        .readdirSync(logDir)
+        .filter((fileName) => /\.(log|dmp)/.test(path.extname(fileName)));
+    logFile.forEach((fileName) => {
+        const fileInfo = fs.statSync(path.join(logDir, fileName));
+        const fileDate = new Date(fileInfo.birthtime).setHours(0, 0, 0, 0).valueOf();
+        const currentDate = new Date().setHours(0, 0, 0, 0);
+        if (currentDate - fileDate > 7 * 24 * 60 * 60 * 1000) {
+            fs.unlinkSync(path.join(logDir, fileName));
+        }
+    });
+}
+```
+
+##### PlasoElectronSdk.getVersion
 
 返回包的版本，格式：x.x.x
 
@@ -451,26 +477,26 @@ PlasoElectronSdk.initLogConfig(logFilePath);
 type getVersion = () => string;
 ```
 
-## 5.3、PlasoElectronSdk.createLiveClassWindow
+##### PlasoElectronSdk.createLiveClassWindow
 
 **创建实时课堂窗口**
 
 ```ts
-function createLiveClassWindow(params: CreateClassPamras): void;
+function createLiveClassWindow(params: CreateClassWindowPamras): void;
 ```
 参数详见[打开实时课堂/备课课堂方法入参类型定义](#open-sdk-window-params)
 
-## 5.4、PlasoElectronSdk.createPrepareClassWindow
+##### PlasoElectronSdk.createPrepareClassWindow
 
 **创建备课课堂窗口**
 ```ts
-function createLiveClassWindow(params: CreateClassPamras): void;
+function createLiveClassWindow(params: CreateClassWindowPamras): void;
 ```
 参数详见[打开实时课堂/备课课堂方法入参类型定义](#open-sdk-window-params)
 
 <a id="insert-object"></a>
 
-## 5.5、PlasoElectronSdk.insertObject
+##### PlasoElectronSdk.insertObject
 
 用户从自己的资料中心往**实时课堂/备课课堂**插入文件
 
@@ -532,7 +558,7 @@ const PlasoElectronSdk = window.require('@plasosdk/plaso-electron-sdk');
 PlasoElectronSdk.insertObject(fileData);
 ```
 
-### 5.5.1、插入备课文件
+###### 插入备课文件
 
 1、 插入 备课文件 的格式如下,其中 fileLocationPath 为 插入的备课文件资源的地址前缀，比如要本地插入一个备课文件（info.pb）,其完整地址为 C:\Users\xxx\AppData\Roaming\plaso_sdk\prepareLessonsTemp\draft.swap\info.pb，则此时 fileLocationPath = C:\Users\xxx\AppData\Roaming\plaso_sdk\prepareLessonsTemp\draft.swap
 
@@ -549,7 +575,7 @@ const fileDataWithInfo = {
 
 1、**保存备课文件时，需要把 info.pb 和其他的图片文件放在同一个目录下，这样才可以通过一个 目录地址获取 备课的所有资源**
 
-### 5.5.2、插入图片
+###### 插入图片
 
 ```ts
 // 图片可以通过url或info插入，当插入gif时，title需要带上.gif后缀
@@ -567,7 +593,7 @@ const fileDataWithInfo = {
 };
 ```
 
-### 5.5.3、插入PPT
+###### 插入PPT
 
 ```ts
 // PPT仅支持url插入
@@ -579,7 +605,7 @@ const fileDataWithUrl = {
 };
 ```
 
-### 5.5.4、插入音视频
+###### 插入音视频
 
 ```ts
 // 音视频可以通过url或info插入
@@ -598,7 +624,7 @@ const fileDataWithInfo = {
 }
 ```
 
-### 5.5.5、插入PDF
+###### 插入PDF
 ```ts
 // PDF可以通过url或info插入
 
@@ -616,7 +642,7 @@ const fileDataWithInfo = {
 ```
 
 
-### 5.5.6、插入WORD/EXCEL/DOC/XLS
+###### 插入WORD/EXCEL/DOC/XLS
 
 ```ts
 // WORD/EXCEL/DOC/XLS仅支持url插入
@@ -628,7 +654,7 @@ const fileDataWithUrl = {
 }
 ```
 
-# 6、资料中心
+## 资料中心
 
 step1、进课堂时，对象 **classOptions.supportShowResourceCenter** 需要是 true
 
@@ -638,45 +664,16 @@ step3、选择文件后，通过 **PlasoElectronSdk.insertObject** 方法插入
 
 step4、insertObject 方法 入参 有 info 时，此时 会触发进课堂时传入的回调函数 **onGetExtFileNameFn** 来获取文件的全地址
 
-# 7、播放历史课堂
+## 播放历史课堂
 
 1、参考文档： **[播放器SDK-Web播放器](https://open.plaso.cn/doc-6285192)**
 
 2、当课堂中insertObject使用了`info`属性时，SDK内部需要外部传入`getExtFileName`，因此历史课堂需要使用jssdk的接入方式， 详见：**[Web播放器-jssdk接入](https://open.plaso.cn/doc-6285192#jssdk%E6%8E%A5%E5%85%A5)**
 
-# 8、注意点
+## 注意点
 
 （1）用户的课堂外主窗口销毁时需要销毁课堂窗口
 
-（2）electron 版本>=14.0.0 时：需要在主进程里 启动 remote
-
-```ts
-try {
-    const electronRemote = require('@electron/remote/main');
-    electronRemote.initialize();
-    // mainWindow为app启动的渲染进程窗口
-    electronRemote.enable(mainWindow.webContents);
-} catch (error) {
-    console.error(
-        'Module not found',
-        'Please run `npm install @electron/remote` to enable remote module and update electron version to 22.0.0 or higher',
-    );
-}
-```
-
-（3）**基于 此包封装新包时**：注意 @electron/remote 这个包的位置需要 和新包处于同级目录，需要把 和该包同级的@electron/remote 移到新包的同级目录处
-
-（4）确保 仅最后的 node_moudles 的顶层有 @electron/remote
-
-# 9、附录参数说明
-
-<a id="record-type"></a>
-## 9.1、RecordType
+（2）**基于 此包封装新包时**：注意 @electron/remote 这个包的位置需要 和新包处于同级目录，需要把 和该包同级的@electron/remote 移到新包的同级目录处
 
-| 值  | 说明                            |
-| --- | ------------------------------- |
-| 1   | 无头像录制（仅录制板书）        |
-| 2   | 录老师头像（录制老师头像+板书） |
-| 3   | 录助教头像（录制助教头像+板书） |
-| 4   | 录制课堂（录制整个屏幕和头像）  |
-| 5   | 仅录老师头像                    |
+（3）确保 仅最后的 node_moudles 的顶层有 @electron/remote

package/index.html

@@ -137,14 +137,63 @@
     document.head.appendChild(ele);
   }
 
+  let hasInit = false;
+  function init(appinfo) {
+    if (hasInit) {
+      return;
+    } else {
+      hasInit = true;
+    }
 
-  function init(classObj) {
-    let query;
-    if (classObj) {
-      globalAppInfo = Object.assign({}, classObj)
+    // from url
+    var query;
+    if (window.location.search) {
+      query = window.location.search.substring(1).split("&");
+      for (var i = 0, l = query.length; i < l; i++) {
+        var temp = query[i].split('=');
+        if (temp.length == 2) {
+          globalAppInfo[temp[0]] = decodeURIComponent(temp[1]);
+        } else if (
+          typeof globalAppInfo[temp[0]] === 'string' &&
+          globalAppInfo[temp[0]].length > 0 &&
+          !isNaN(Number(globalAppInfo[temp[0]])) &&
+          Number(globalAppInfo[temp[0]]) !== undefined &&
+          !globalAppInfo[temp[0]]?.includes?.('.')
+        ) {
+          globalAppInfo[temp[0]] = Number(globalAppInfo[temp[0]]);
+        }
+      }
+    }
+
+    // from ipc
+    if (appinfo) {
+      globalAppInfo = Object.assign({}, globalAppInfo, appinfo)
     }
-    globalAppInfo.needFullScreen = false;
 
+    // properties init
+    if (globalAppInfo.rhost == undefined && location.protocol.indexOf('http') == 0) {
+      globalAppInfo.rhost = './';
+      if (!globalAppInfo.dhost) {
+        if (globalAppInfo.env) {
+          if (globalAppInfo.env === 'local') {
+            globalAppInfo.dhost = location.origin;
+          } else {
+            globalAppInfo.dhost = `${location.protocol}//${globalAppInfo.env}.plaso.cn/`;
+          }
+        } else if (location.origin.indexOf('plaso.cn') > -1) {
+          globalAppInfo.dhost = location.origin.replace('wwwr', 'www');
+          globalAppInfo.env = location.host.split('.')[0];
+        } else if (location.origin.indexOf('127.0.0.1') > -1 || location.origin.indexOf('192.168') > -1) {
+          globalAppInfo.env = 'dev';
+          globalAppInfo.dhost = `${location.protocol}//${globalAppInfo.env}.plaso.cn/`;
+        } else {
+          globalAppInfo.dhost = `${location.protocol}//www.plaso.cn/`;
+        }
+      }
+    }
+    if (!globalAppInfo.env) globalAppInfo.env = 'www';
+    globalAppInfo.markString = globalAppInfo.markString ?? '';
+    globalAppInfo.needFullScreen = false;
     if (globalAppInfo.rhost && globalAppInfo.rhost.substring(globalAppInfo.rhost.length - 1) != '/') {
       globalAppInfo.rhost += "/";
     }
@@ -152,6 +201,7 @@
       globalAppInfo.dhost += "/";
     }
 
+    // load all.js
     path = globalAppInfo.initjs || "js/all.js";
     include(path);
   }
@@ -166,14 +216,14 @@
       if (key === 'openerId') openerId = Number(value);
     });
 
-    ipcRenderer.on(CLASS_WINDOW_MESG_TYPE.INIT_CLASS_OPTIONS, (_, classObj) => {
-      if (classObj) init(classObj);
+    ipcRenderer.on(CLASS_WINDOW_MESG_TYPE.INIT_GLOBAL_APPINFO, (_, appinfo) => {
+      if (appinfo) init(appinfo);
     });
 
     if(openerId){
       const remote = getElectronRemote();
       const webContents = remote.getCurrentWebContents();
-      ipcRenderer.sendTo(openerId, CLASS_WINDOW_MESG_TYPE.CLASS_READY, {webContentId: webContents.id});
+      ipcRenderer.sendTo(openerId, CLASS_WINDOW_MESG_TYPE.HTML_READY, {webContentId: webContents.id});
     }
 
   }

package/js/macro.js

@@ -24,10 +24,10 @@ const CLASS_WINDOW_MESG_TYPE = {
     LIVE_WINDOW_READY: 'liveWindowReady',
     /** 课堂结束 */
     ON_CLASS_FINISHED: 'onClassFinished',
-    /** 初始化进课堂参数 */
-    INIT_CLASS_OPTIONS: 'init_class_options',
-    /** 课堂窗口 html ready */
-    CLASS_READY: 'class_ready',
+    /** 初始化 globalAppInfo */
+    INIT_GLOBAL_APPINFO: 'init_global_appinfo',
+    /** html ready */
+    HTML_READY: 'html_ready',
     /** 保存白板文件 */
     SAVE_BOARD: 'save_board',
     /** 响应保存白板文件 */

package/js/render.js

@@ -108,7 +108,7 @@ function createClassWindow(classWindowProps) {
                     rhost = `https://${env}.plaso.cn/static/yxtelectronsdk/`;
                     dhost = `https://${env}.plaso.cn/`;
                 } else {
-                    rhost = `https://wwwr.plaso.cn/static/sdk/styleupime/${classOptions.version ?? '1.58.104'}/`;
+                    rhost = `https://wwwr.plaso.cn/static/sdk/styleupime/${classOptions.version ?? '1.59.201'}/`;
                     dhost = 'https://www.plaso.cn/';
                 }
 
@@ -143,6 +143,10 @@ function createClassWindow(classWindowProps) {
                     fullScreenable,
                 };
 
+                if (classOptionsObj.userType === 'monitor') {
+                    classOptionsObj.monitor = true;
+                }
+
                 /**----------------------------------------------------electron 窗口相关设置-----------------------------------*/
 
                 const bounds = win.getBounds();
@@ -221,12 +225,12 @@ function createClassWindow(classWindowProps) {
                     logger.info(`课堂已结束，id:${currentWinId}, meetingId is ${meetingId}`);
                     if (onClassFinishedFn && currentWinId) onClassFinishedFn(meetingId);
                 };
-                const onClassHtmlReady = (event, value) => {
+                const onHtmlReady = (event, value) => {
                     currentWebContentsId = value?.webContentId;
                     logger.info(`课堂窗口 html ready，web contents id:${currentWebContentsId}`);
 
                     if (currentWebContentsId) {
-                        ipcRenderer.sendTo(currentWebContentsId, CLASS_WINDOW_MESG_TYPE.INIT_CLASS_OPTIONS, classOptionsObj);
+                        ipcRenderer.sendTo(currentWebContentsId, CLASS_WINDOW_MESG_TYPE.INIT_GLOBAL_APPINFO, classOptionsObj);
                     }
                 };
                 const onSaveBoard = (event, value) => {
@@ -256,7 +260,7 @@ function createClassWindow(classWindowProps) {
 
                 ipcRenderer.on(CLASS_WINDOW_MESG_TYPE.LIVE_WINDOW_READY, onClassWindowReady);
                 ipcRenderer.on(CLASS_WINDOW_MESG_TYPE.ON_CLASS_FINISHED, onClassFinished);
-                ipcRenderer.on(CLASS_WINDOW_MESG_TYPE.CLASS_READY, onClassHtmlReady);
+                ipcRenderer.on(CLASS_WINDOW_MESG_TYPE.HTML_READY, onHtmlReady);
                 ipcRenderer.on(CLASS_WINDOW_MESG_TYPE.SAVE_BOARD, onSaveBoard);
                 ipcRenderer.on(CLASS_WINDOW_MESG_TYPE.OPEN_RESOURCE_CENTER, onOpenResourceCenter);
                 ipcRenderer.on(CLASS_WINDOW_MESG_TYPE.GET_EXT_FILE_NAME, onGetExtFileName);
@@ -289,7 +293,7 @@ function createClassWindow(classWindowProps) {
                             currentWebContentsId = null;
                             ipcRenderer.removeListener(CLASS_WINDOW_MESG_TYPE.LIVE_WINDOW_READY, onClassWindowReady);
                             ipcRenderer.removeListener(CLASS_WINDOW_MESG_TYPE.ON_CLASS_FINISHED, onClassFinished);
-                            ipcRenderer.removeListener(CLASS_WINDOW_MESG_TYPE.CLASS_READY, onClassHtmlReady);
+                            ipcRenderer.removeListener(CLASS_WINDOW_MESG_TYPE.HTML_READY, onHtmlReady);
                             ipcRenderer.removeListener(CLASS_WINDOW_MESG_TYPE.SAVE_BOARD, onSaveBoard);
                             ipcRenderer.removeListener(CLASS_WINDOW_MESG_TYPE.OPEN_RESOURCE_CENTER, onOpenResourceCenter);
                             ipcRenderer.removeListener(CLASS_WINDOW_MESG_TYPE.GET_EXT_FILE_NAME, onGetExtFileName);
@@ -322,7 +326,6 @@ function createLiveClassWindow(liveClassWindowProps) {
         classOptions: {
             ...liveClassWindowProps.classOptions,
             appType: 'liveclassSDK',
-            meetingType: 'private',
             classType: LESSON_TYPE.LIVECLASS,
         },
     };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@plasosdk/plaso-electron-sdk",
-  "version": "1.3.5",
+  "version": "1.3.7",
   "description": "伯索课堂Electron SDK",
   "main": "index.js",
   "scripts": {

package/scripts/downloadPrebuild.js

@@ -94,10 +94,10 @@ const npmInstall = () => {
             installCb(agora_electron_sdk_v4, installAgora, error, stdout, stderr);
             if (!error?.message) {
                 const oldAgoraV4Path = path.join(__dirname, '../node_modules', 'agora-electron-sdk');
-                const newAgoraV4Path = path.join(__dirname, '../../../', 'agora-electron-sdk-v4');
+                const newAgoraV4Path = path.join(__dirname, '../node_modules', 'agora-electron-sdk-v4');
                 fs.move(oldAgoraV4Path, newAgoraV4Path, { overwrite: true }, (err) => {
                     if (!err) {
-                        logger.info('更新agora_electron_sdk_v4成功');
+                        logger.info('命名agora_electron_sdk_v4成功');
                     }
                 });
             }