@netless/window-manager 0.4.49 → 0.4.51

package/docs/export-pdf.md

@@ -0,0 +1,46 @@
+# 导出 PDF
+
+此功能需要额外安装 `jspdf` 依赖才能使用
+
+```
+npm install jspdf@2.5.1
+```
+
+### 支持的 app 及版本
+
+1. @netless/app-slide  `0.2.23` 及以上版本支持保存动态 ppt 板书
+
+2. @netless/app-docs-viewer  `0.2.10` 及以上版本支持保存 pdf 板书, **注意** app-docs-viewer 中可以展示静态 ppt, pdf, 动态 ppt. 其中只有 pdf 文件支持保存板书
+
+   对应 @netless/window-manager `0.4.50` 及以上
+
+### 发起保存板书任务
+
+通过 `window.postMessage` 发事件来发起保存板书任务, 注意不要在任务尚未完成之前重复发送该事件.
+
+```js
+window.postMessage({
+    type: "@netless/_request_save_pdf_",
+    appId: /* windowManager.addApp 返回的值, 指定要保存哪个窗口的板书, */
+})
+```
+
+### 获取任务进度
+
+任务进度也通过 message 事件传递, 你需要在发起任务之前监听任务进度事件, 实例代码如下所示.
+其中 data.result 只有在任务成功时候才有值, 任务失败或者任务进行中都为 Null.
+如果下载任务失败, 则 progress 为 100 但是 result 为 Null.
+
+```js
+window.addEventListener("message", evt => {
+    if (evt.data.type === "@netless/_result_save_pdf_") {
+        console.log(evt.data);
+        // data 包含如下属性
+        // data.type: 固定值 "@netless/_result_save_pdf_"
+        // data.appId: 指明是哪次下载任务, 与发起保存板书时候传递的 appId 值一致
+        // data.progress: 下载进度,  0 ~ 100
+        // data.result: ArrayBuffer 或者 Null, 值为板书的 pdf 文件内容, 仅当下载进度 100 时才有值.
+        //              获取到 ArrayBuffer 后需要自行完成下载到本地的逻辑.
+    }
+});
+```

package/package.json

@@ -1,26 +1,22 @@
 {
   "name": "@netless/window-manager",
-  "version": "0.4.49",
+  "version": "0.4.51",
   "description": "",
   "main": "dist/index.cjs.js",
   "module": "dist/index.es.js",
   "types": "dist/index.d.ts",
   "repository": "netless-io/window-manager",
-  "scripts": {
-    "prettier": "prettier --write .",
-    "build": "vite build && yarn type-gen",
-    "type-gen": "tsc --emitDeclarationOnly",
-    "predev": "yarn type-gen",
-    "build:lib:types": "tsc --emitDeclarationOnly",
-    "lint": "eslint --ext .ts,.tsx,.svelte . && prettier --check .",
-    "test": "vitest"
-  },
-  "keywords": [],
-  "author": "",
-  "license": "ISC",
+  "author": "l1shen <lishen1635@gmail.com> (https://github.com/l1shen)",
+  "license": "MIT",
   "peerDependencies": {
+    "jspdf": "2.5.1",
     "white-web-sdk": "^2.16.0"
   },
+  "peerDependenciesMeta": {
+    "jspdf": {
+      "optional": true
+    }
+  },
   "dependencies": {
     "@juggle/resize-observer": "^3.3.1",
     "@netless/telebox-insider": "0.2.27",
@@ -32,7 +28,7 @@
     "video.js": ">=7"
   },
   "devDependencies": {
-    "@netless/app-docs-viewer": "^0.2.9",
+    "@netless/app-docs-viewer": "^0.2.11",
     "@netless/app-media-player": "0.1.0-beta.5",
     "@rollup/plugin-commonjs": "^20.0.0",
     "@rollup/plugin-node-resolve": "^13.0.4",
@@ -62,5 +58,14 @@
     "vite": "^2.5.3",
     "vitest": "^0.14.1",
     "white-web-sdk": "2.16.33"
+  },
+  "scripts": {
+    "prettier": "prettier --write .",
+    "build": "vite build && yarn type-gen",
+    "type-gen": "tsc --emitDeclarationOnly",
+    "predev": "yarn type-gen",
+    "build:lib:types": "tsc --emitDeclarationOnly",
+    "lint": "eslint --ext .ts,.tsx,.svelte . && prettier --check .",
+    "test": "vitest"
   }
-}
+}

package/src/AppManager.ts

@@ -784,6 +784,9 @@ export class AppManager {
         });
         this.mainViewProxy.onReconnect();
         await Promise.all(reconnected);
+        if (this.callbacksNode) {
+            this.onSceneChange(this.callbacksNode);
+        }
     }
 
     public notifyContainerRectUpdate(rect: TeleBoxRect) {