多窗口模式

适用于 Whiteboard Web SDK 2.16.59。

多窗口模式使用 WindowManager 管理主白板（MainView）和各类课件窗口。适用于需要同时展示多个课件、切换焦点、统一翻页与协同书写的业务。

安装与接入

Shell

npm install white-web-sdk@2.16.59 @netless/window-manager@1.0.25

TypeScript

import { WhiteWebSdk, type InvisiblePluginClass } from 'white-web-sdk';
import { WindowManager } from '@netless/window-manager';
import '@netless/window-manager/dist/style.css';
const sdk = new WhiteWebSdk({ appIdentifier, region: 'cn-hz', useMobXState: true });
const room = await sdk.joinRoom({
  uuid, roomToken, uid, region: 'cn-hz',
  useMultiViews: true, disableMagixEventDispatchLimit: true,
  invisiblePlugins: [WindowManager as unknown as InvisiblePluginClass<string, object, object>]
});
const manager = await WindowManager.mount({
  room, container, containerSizeRatio: 9 / 16, cursor: true
});

container 是已有且具备有效尺寸的 DOM 元素。invisiblePlugins 在入房前注册，mount 在入房后执行；useMobXState 与 disableMagixEventDispatchLimit 应同时开启。同房间客户端保持一致的比例约定。使用教具插件时，还需要该页面介绍的插件注册与初始化。

按功能选择 API

功能	公开入口	作用
课件生命周期	addApp / closeApp	添加与关闭房间中的课件实例
课件查询	queryAll / queryOne	查询本端 AppProxy；实例是否存在不代表已渲染
窗口焦点	focusApp、focused、focusedChange	提交或观察窗口焦点；focusApp 返回 Promise<boolean>
主白板场景	setMainViewScenePath / setMainViewSceneIndex	切换主白板目录或零基场景索引
主白板页导航	nextPage / prevPage / jumpPage	操作主白板页面；jumpPage 使用零基索引
窗口状态	setBoxState / boxState / boxStateChange	最大化、最小化、普通窗口状态
视角与权限	setViewMode / setReadonly	配置跟随和只读；不能提升房间本身的写权限
光标	mount 的 cursor、入房 userPayload	配置多窗口用户光标与昵称
相机与撤销	moveCamera / undo / redo	移动主视图、撤销重做

统一控制接口使用从 1 开始的页码，与上述零基场景索引区分。操作回调只代表其定义的提交状态，课件可见/初始化/资源渲染需要分别观察。WindowManager 事件由 manager.emitter.on(...) 订阅，保存并调用返回的解除订阅函数。

课件与进阶配置

• 课件接入：动态 Slide、静态 Presentation、DocsViewer、MediaPlayer 与自定义 H5。
• 统一页面控制：按 mainView 或具体 appId 控制页面、查询倍率、监听页码和缩放。
• 统一笔记：MainView 与 Slide/Presentation 的 originSize。
• 课件按需加载：forceMaximized、按焦点初始化与 LRU 缓存。
• 动态配置：配置平台下发窗口参数与本地覆盖优先级。

退出

先解除业务监听；若创建了教具插件实例，先等待其 destroy，再等待 manager.destroy 和 room.disconnect，最后移除容器。不要一边销毁 manager 一边继续向它发送课件操作。