动态配置
适用于 Whiteboard Web SDK 2.16.59。
动态配置在每次加入房间前加载指定地址的参数，减少为了调整兼容性配置而重新发布客户端的需要。它不提供对已加入房间的热更新；修改发布后，应在后续入房时验证效果。
配置平台操作流程
打开白板动态配置管理，使用获授权的账号登录。每份草稿选择一个平台，本页选择 web；四个平台需要分别保存和发布。
- 选择交付方式。“导入与下载”适合自行维护配置地址；“托管配置”先在“我的 OSS”登记连接，选择平台并读取当前配置。配置地址由 Bucket、Endpoint、前缀和平台目录生成。
- 从 JSON 或通用模板载入配置。编辑器分为
joinRoom、windowManager、appliancePlugin.extras三组，可按需展开；字段旁说明给出类型、作用和约束。完整 JSON 可在高级编辑器核对。 - 编辑默认参数和按运行时版本覆盖的参数，点击“保存草稿”。不需要下发的字段选择“不配置”；false、0 等显式值不是缺省。
- 点击“提交审核”。保存不会触发 AI；提交会等待本次审核结果。失败或要求修改时查看原因、修改后再提交，刷新状态不会重新发起 AI。
- 导入模式审核通过后下载冻结配置，自行上传到可读取的 HTTPS 地址。托管模式审核通过后选择“直接发布”或“提交管理员审核”；进入人工审核后等待处理。管理员可审核通过并发布或给出修改意见。
- 确认发布已完成后，在“我的 OSS”的 SDK 接入信息中复制当前平台的 region → URL 映射。托管地址通常以
/web/latest.json结尾；SDK 使用此 JSON 地址，不使用管理网页或 version.json。 - 需要回退时，在“版本路径历史”读取历史版本并生成回退草稿，重新审核发布；不要把历史地址原地改写成另一份内容。
以下交互图根据配置服务现行设计整理，省略服务端存储细节：
当前平台接入
将 dynamicConfig 加到加入白板房间教程已有的 SDK 初始化配置中，保留既有插件注册和多窗口挂载流程。下方重点展示地址配置，room 指该流程成功返回的房间。
import { WhiteWebSdk } from 'white-web-sdk';
const dynamicConfig = {
'cn-hz': 'https://YOUR_CONFIG_HOST/config/web/latest.json',
'sg': 'https://YOUR_CONFIG_HOST/config-sg/web/latest.json'
};
const sdk = new WhiteWebSdk({
appIdentifier, region: 'cn-hz', useMobXState: true, dynamicConfig
});
// 后续沿用加入房间教程中的完整 joinRoom、WindowManager 和教具插件流程。
接入前核对 URL 中的平台目录和发布文档的 platforms。未配置的 region 使用本地参数，不自动跨区取其他地址。URL 应可由客户端直接读取；浏览器/WebView 请求还需要资源域的跨域策略支持。管理平台账号或 OSS 写入凭证不应传入客户端。
配置内容与匹配规则
| 分组 | 用途 |
|---|---|
| joinRoom | 加入房间时的可配置参数，例如撤销缓存、原生剪贴板 |
| windowManager | 多窗口配置，例如强制最大化、课件按需加载、参考尺寸 |
| appliancePlugin.extras | 教具插件的扩展配置，例如背景图重试、笔宽与 Worker 策略 |
平台生成的发布文件使用 schemaVersion=2、runtimeContractVersion=1，以及 profiles["whiteboard-1.0"]。SDK 读取配置后求值，再交给对应组件；不能把 { defaults, webviewVersion } 包装直接作为 Native 方法参数。
配置编辑器中的单字段示例（不是完整发布文件）：
{
"useNativeClipboard": {
"defaults": false,
"webviewVersion": { "androidWebView": { "80": true } }
}
}
版本表的 key 表示版本上限，选择能覆盖当前运行时版本的最小上限；例如 Android WebView 79 命中 80，81 使用 defaults。支持 androidWebView、iosWebView、harmonyArkWeb，以及 web 下按 chrome/edge/firefox/safari 分类的版本表。最终 null 表示不下发字段；不是字符串 "null"。
优先级与失败回退
显式业务本地配置优先于远端；远端优先于宿主默认和 SDK 默认。未设置或 undefined 允许继承，false 是明确覆盖。普通对象递归合并，数组、实例对象、hotKeys、floatBar 等按整体处理。若希望平台管理某字段，业务侧就不要同时把该字段写死。
每次入房前按实际 region 加载，默认最长等待 5 秒。网络、超时、格式或平台不匹配时使用本地参数；本地配置应保持可独立入房。当前实现成功读取（含有效 304）记为 remote，失败记为 local；不承诺请求失败后继续使用上一份缓存。
console.log(room.dynamicConfig);
console.log(room.dynamicConfigState);
dynamicConfig 是已求值的只读快照，包含 joinRoom/windowManager/appliancePlugin.extras；dynamicConfigState 给出 source、可选 configVersion、runtime、fieldSources、fallbackReason。原生 SDK 没有同名房间查询属性，不应跨端照搬。
直接组合 WindowManager 与 Appliance Plugin 时，按各自当前公开接入入口使用该房间；Fastboard Web 1.1.10 会把解析后的配置传递给内部组件。
配置发布完成不等于某客户端已经生效。先用测试房间确认对应版本、平台、region 的实际配置，再观察课件按需加载、光标或教具行为。配置平台的审核与包版本元数据不能替代对应 SDK 的能力验证。