@netless/app-slide 0.2.103 → 0.2.105-beta.0

package/README-zh.md

@@ -36,6 +36,7 @@ manager.addApp({
   attributes: {
     taskId: "1234567...", // [2]
     url: "https://convertcdn.netless.link/dynamicConvert", // [3]
+    originSize: manager.mainView.size, // [4]
     previewList: [
       "https://convertcdn.netless.group/test/dynamicConvert/8ed5cce449874494a9ca7894b39415fb/preview/1.png",
       "https://convertcdn.netless.group/test/dynamicConvert/8ed5cce449874494a9ca7894b39415fb/preview/2.png",
@@ -67,6 +68,10 @@ manager.addApp({
 
    PPT 转码后资源存储服务器链接前缀，默认为 `https://convertcdn.netless.link/dynamicConvert`。
 
+4. (可选) `originSize`
+
+   用于匹配课件笔记的固定白板分辨率。添加 app 时传入主白板尺寸；传入 `null` 时使用 PPT 自身分辨率。
+
 ### 协议
 
 MIT @ [netless](https://github.com/netless-io)

package/README.md

@@ -39,6 +39,7 @@ manager.addApp({
   attributes: {
     taskId: "1234567...", // [2]
     url: "https://convertcdn.netless.link/dynamicConvert", // [3]
+    originSize: manager.mainView.size, // [4]
     previewList: [
       "https://convertcdn.netless.group/test/dynamicConvert/8ed5cce449874494a9ca7894b39415fb/preview/1.png",
       "https://convertcdn.netless.group/test/dynamicConvert/8ed5cce449874494a9ca7894b39415fb/preview/2.png",
@@ -80,6 +81,10 @@ Parameters:
 
    The base url of ppt resources, `https://convertcdn.netless.link/dynamicConvert` by default.
 
+4. (optional) `originSize`
+
+   Fixed whiteboard resolution used to fit the slide notes. Pass the main view size when adding the app; use `null` to use the slide resolution.
+
 ### Preview
 
 ```ts

package/dist/index.d.ts

@@ -1,3 +1,4 @@
+import * as _netless_window_manager from '@netless/window-manager';
 import { RegisterParams, ReadonlyTeleBox, Room, AppContext, Player, View, NetlessApp } from '@netless/window-manager';
 import { SlideError, VolumeAdjuster } from '@netless/ppt-player';
 import { IPlugin } from '@netless/plugin-system';
@@ -794,6 +795,10 @@ interface Attributes {
     slideScale: number;
     translateX: number;
     translateY: number;
+    originSize: {
+        width: number;
+        height: number;
+    } | null;
 }
 type MagixPayload = {
     type: typeof SLIDE_EVENTS.syncDispatch;
@@ -1044,8 +1049,10 @@ declare class ResizableContainer {
     private root;
     container: HTMLDivElement;
     private scrollContainer;
+    /** @deprecated Use addScaleChangedListener() for multiple observers. */
     onScaleChanged: ((scale: number) => void) | null;
     onLayoutUpdated: (() => void) | null;
+    private scaleChangedListeners;
     private parent;
     private whiteboardContainer;
     private slide;
@@ -1053,6 +1060,7 @@ declare class ResizableContainer {
     private slideWidth;
     private slideHeight;
     private scrollBar;
+    private layoutFrameId;
     private context;
     private translateX;
     private translateY;
@@ -1063,6 +1071,7 @@ declare class ResizableContainer {
         y: number;
     };
     getScale(): number;
+    addScaleChangedListener(listener: (scale: number) => void): () => void;
     private renderScrollBar;
     setSlideObject(slide: Slide): void;
     private updateSlideSize;
@@ -1072,6 +1081,7 @@ declare class ResizableContainer {
         triggerSync: boolean;
     }): void;
     scaleContainer(applyScale: number): void;
+    private cancelScheduledLayoutUpdate;
     addSlideContainer(slideContainer: HTMLDivElement): void;
     addWhiteboardContainer(whiteboardContainer: HTMLDivElement): void;
     getCurrentScale(): number;
@@ -1307,12 +1317,14 @@ interface AppResult {
     jumpToPage: (page: number) => boolean;
     setSildeReadonly: (bol: boolean) => void;
     setSyncEventQueuePolicy: (policy: NonNullable<ISlideConfig["syncEventQueuePolicy"]>) => void;
-    onScaleChanged: (cb: (scale: number) => void) => void;
+    onScaleChanged: (cb: (scale: number) => void) => () => void;
     scaleView: (to: number) => void;
     getViewScale: () => number | undefined;
     translateView: (offsetX: number, offsetY: number) => void;
 }
-declare const SlideApp: NetlessApp<Attributes, MagixEvents, AppOptions, AppResult>;
+declare const SlideApp: NetlessApp<Attributes, MagixEvents, AppOptions, AppResult> & {
+    teardown(context: _netless_window_manager.AppContext): void;
+};
 
 export { DefaultUrl, DocsViewer, FreezerLength, SideEffectManager, Slide, SlideController, SlideControllerBase, SlideDocsViewer, SlidePreviewer, addHooks, apps, SlideApp as default, getFreezerLength, log, logger, onCreated, onDestroyed, previewSlide, setFreezerLength, syncSceneWithSlide, useFreezer, usePlugin, version };
 export type { AddHooks, AppOptions, AppResult, Attributes, FreezableSlide, ILogger, PreviewParams };