扩展 API 与配置
适用于 Whiteboard Web SDK 2.16.58。多窗口和教具插件是独立组合能力,详见教具插件介绍。
View 尺寸刷新
view.refreshSize(width, height);
按已知 CSS 像素尺寸刷新 View;width/height 必须为有限正数。调用期间暂时断开 ResizeObserver,结束后恢复。
本地日志
getLocalLogState(): WhiteLocalLogState;
onLocalLogStateChange(listener: (state: WhiteLocalLogState)=>void): ()=>void;
collectLocalLogs(): Promise<WhiteLocalLogExportResult>;
flushLocalLogs(): Promise<void>;
uploadLocalLogs(request?: WhiteLocalLogUploadRequest): Promise<WhiteLocalLogUploadResult>;
Web 2.16.58 初始化时默认尝试启用本地日志;通过 loggerOptions.localLog.enabled=false 关闭。enabledUpload 默认 true,设为 false 可关闭上传而保留本地写入;运行时是否可用还取决于日志 Worker 等资源,需读取状态确认。getLocalLogState 同步返回,状态监听返回解除订阅函数,collect/flush/upload 均需等待异步完成。
基础 SDK 配置与教具插件配置分别维护;背景恢复使用插件 API,详见背景图加载与恢复。
统一页面控制
MainView、DocsViewer、Slide、Presentation 的 page 从 1 开始;target 输入可为 mainView 或 appId,省略时跟随焦点。查询输出的 target 为 mainView/DocsViewer/Slide/Presentation。scale 为相对适配尺寸倍率,1 表示适配尺寸,DocsViewer 不支持 scalePage。
accepted=true 表示命令接收;accepted=false 包含 reason/message。通过统一页事件或查询观察实际状态,不能把命令回调作为首帧完成信号。
窗口与课件配置
| 参数 | 行为 |
|---|---|
| originSize | 正数 width/height 参考尺寸;MainView 与各 App 分别设置 |
| pageScaleRange | 相对适配尺寸的 minScale/maxScale,均为有限正数 |
| forceMaximized | 房间级强制最大化,与 useBoxesStatus 不兼容 |
| lazySetupInMaximizedMode | 本端按焦点初始化,默认关闭 |
| maxCachedAppsInMaximizedMode | 本端 LRU runtime 缓存,默认 4 |
| navigationButtonMode | Slide 底部按钮:page 默认按页,step 按动画步骤 |
| syncEventQueuePolicy | fifo 默认;latest-pending-render 仅合并待执行渲染页 |
focusApp 的布尔值表示焦点提交完成;不能用它判断 setup 或全部资源就绪。插入课件需先转换,普通图片页可以创建 Presentation;原有静态文档 API 保持 DocsViewer 行为。