enableModelPreload: true 才提前获取模型提示、下载并执行模型 JS;只有配置 dynamicConfig 才提前准备动态配置。两项均未开启时保持 2.16.60 的原入房流程。joinRoom 后,已成功的准备直接复用;仍在进行的准备按模型 120 秒、动态配置 5 秒限时等待,失败或超时后回到原加载流程。宿主可继续创建 SDK 后立即调用 joinRoom。waitForDynamicConfigPreload(),并统一 waitForModelPreload() 的结果:invalid 表示未启用,success 表示准备成功,warn 表示准备失败或入房等待超时。宿主无需调用观察接口才能入房。prepareRoomResources、prepareDynamicConfig 改为内部方法,模型及动态配置准备由上述配置自动控制。模型预加载需要对应后端与区域支持,提示不可用时自动回到普通入房。动态配置仅在显式配置 URL 时读取,本地显式入房参数优先。本版仅发布前端 SDK,不部署后端服务。
WhiteWebSdk.waitForModelPreload({ region, modulesOrigin }),用于观察当前模型预加载任务的完成结果,返回包含 state(success 或 warn)和 message 的 Promise。enableModelPreload: true 时等待模型准备;省略或关闭该开关时立即返回成功,不启动模型预加载请求。joinRoom 的入房流程。模型请求持续未完成时,观察 Promise 可持续等待;模型预加载失败时返回警告,实际入房仍按正常握手加载模型。不要把该观察方法作为入房的必要前置条件。WhiteWebSdk 构造参数新增 enableModelPreload,默认 false。仅显式设置为 true 时,在后台查询并预加载房间模型 JavaScript;省略或设为 false 时,不请求模型预加载接口,保持原有 joinRoom 握手加载模型的流程。prepareRoomResources({ region, modulesOrigin }) 和 prepareDynamicConfig(region),可在入房前准备资源、复用动态配置;prepareRoomResources 返回当前准备状态快照,不代表模型已下载完成。enableModelPreload 不保证获得加速效果。建议在目标项目、区域完成服务端准备后再开启。该开关不控制教具插件的 Worker 探针或课件预加载。WhiteWebSdk 构造参数新增可选 dynamicConfig,支持按房间区域配置 OSS 动态配置地址,在调用 joinRoom 时读取并解析配置。未配置时沿用本地参数。Room 新增只读 dynamicConfig 和 dynamicConfigState,用于获取解析后的配置及来源、版本和回退原因,供窗口管理器、教具插件等集成层消费。watcher did stop)可能中断场景更新、导致视图焦点场景路径未正确保留的问题;异常会记录日志,场景更新可继续执行。View 新增 refreshSize(width, height) 方法,可在已知白板容器 CSS 像素尺寸时主动刷新视图尺寸。ResizeObserver,避免由尺寸监听回调引起的重复刷新或干扰。agora-foundation/loggerregions 地址的合规配置importSceneSnapshot、importScene方法新增可自定义场景的name参数refresh() 刷新场景,此功能用于当前场景失效的时候恢复渲染api.whiteboard.sd-rtn.comapi.baiban.shengwang.cnapi.whiteboard.rtelink.comapi.netless.linkapi.whiteboard.agora.iomemberState.textCompleteToSelector 可以在打完字时自动切到选择工具,类似的选项还有 {rectangle,ellipse,straight,arrow,shape}CompleteToSelectormemberState.textSizeOverride 设置新的文本元素使用固定大小而不是继承上一次大小onBackgroundError,当背景图加载失败时会抛出screenshotToCanvasAsync(),会等待目标场景的图片都加载完再调用截图,注意如果有图片加载不完那么它会一直挂起room.useNativeClipboard,启用时使用原生copy paste事件而不是按键捕获onObjectsLimit,超出限制时后端会强制踢出用户cursorAdapter: false 隐藏内置光标 (激光笔、橡皮擦等)clearUndoHistory() 清空撤销栈crops 等接口实现录像剪辑播放autoSelectPaste autoSelectDuplicate,设为 true 后可以在粘贴或者点击浮动工具栏上的拷贝按钮时自动选中新创建出来的元素joinRoom 添加 optimizeOptions 参数,自定义优化(降帧)策略room 添加 syncMode 属性,设为 true 则同步会更及时,但是动画会更生硬crossOrigin 参数,默认自动跨域syncMainView 方法,用于重设复制粘贴元素的位置apiHosts 配置项, 用于配置白板的 API 服务器域名列表,具体见 sdk 初始化注释。modulesOrigin 配置项,用于配置 白板 modules 数据网址,具体见注释。view.getBoundingRect() 获取某个场景里包含所有元素的矩形NewPencilWritingQuality 选项为新铅笔书写的性能与质量平衡提供更多的可选项text 教具在不恰当的时机弹出软键盘screenshotToCanvas 方法,可以将白板内容截图指 canvaspencilEraserroom.setWritable(false) 后,部分未提交服务器的内容会被撤销InvisiblePlugin 的 API,新增 memberAttributes 属性room.setMemberState() 某些字段无法保存到本地HTMLDivElement 绑定后,再绑定后画面无法恢复room.memberState 中添加 textCanSelectText: true 开启该功能)room.memberState 中添加 dottedLine: true 开启该功能)displayer.fillSceneSnapshot() 的结果看起来被撕裂了setWritable() 时一定概率会报错react 显示异常并报错new WhiteWebSdk({...}) 的参数中添加 disableNewPencilStroke: true 来实现。path 获取场景信息。通过 room.getScene(path) 或 player.getScene(path)。insertText 可能无法顺利插入文字disableTextOperations 以关闭 insertText 与 updateText 操作权限disableCurveAnimes 的默认值改为 truedisplayer.createScenesCallback 可以监听特定地址下场景组内子场景、子场景组的变化room.setWritable(false) 可能后会报错room.state.memberState 有时无法及时更新room.updateSelectedText 方法view.setSceneIndex 方法disableRotation 关闭。insertText、updateText、updateSelectedText。disconnect() 或 setWritable(false) 后,只有当待提交消息全部提交成功后才令 Promise 成功。room.state.memberState 可能无法恢复room.updateTextFontSize 过期,用 room.updateSelectedText 代替room.customInput 过期views.writableView 过期,整个 Writable View 概念不再需要