PuppyIP 资源中心
开发接入 7 分钟 发布于 2026-11-13

Cloudflare RealtimeKit 白板接入与数据保留:访问、编辑和删除边界

Cloudflare 托管的 RealtimeKit Whiteboard 为每场会议提供一块跨会话保留的共享白板。接入前先确认令牌片段写法、所有打开白板的参与者都可编辑,以及内容目前无限期保留且没有清空 API。

RealtimeKit 白板 Cloudflare Whiteboard RealtimeKit 插件 白板数据保留 authToken 片段

服务对象与地域限制

PuppyIP 仅面向海外合规企业及其授权人员提供服务,不面向中国大陆地区开放或提供代理服务。本服务仅限用于中国大陆境外的合法业务活动,严禁在中国大陆境内使用本服务。

代理 IP 或服务器位于境外,不改变上述限制。不得通过中转、转接、共享或转售向中国大陆境内的最终使用者提供本服务。使用前请阅读用户服务协议。

本文要点

  • Whiteboard 是由 Cloudflare 托管的会议插件;每场会议有一块白板,内容会在同一会议的不同 session 间保留。
  • Web 端把参与者令牌放在插件 URL 的 #authToken= 片段中,并在首次加载前允许 iframe 使用剪贴板;移动端由 SDK 提供承载插件的 WebView。
  • 只有持有该会议有效参与者令牌的人能打开对应白板,但每位打开白板的参与者都能编辑;预设角色不控制白板编辑权限。
  • 白板内容无限期保留,session 结束不会清除,当前没有清空或删除白板的 API;参与者被移出会议后,令牌仍可用至到期。
  • 文档没有给出套餐费用、地区或账号资格、白板人数和容量的具体数值;上线前应核对适用条件与数据告知要求。

先确认:这是托管的会议白板

Cloudflare RealtimeKit Whiteboard 是 Cloudflare 托管和运行的协作插件,集成方使用现有 plugins API 注册,不需要自行部署或运维白板服务。参与者可以在会议中共同绘图、写字和画示意图,也能看到其他打开白板者的光标和 RealtimeKit 显示名称。

每场 meeting 对应一块白板;会议结束后再开新的 session,仍会继续使用这块白板。晚加入或重新连接的人可以接着当前内容工作。

Web 和移动端使用同一插件 ID 接入

Web 端加载的插件地址格式是 https://whiteboard-v2.plugins.realtime.cloudflare.com/#authToken=<auth_token>。把当前参与者的 auth token 放在 # 后的 URL 片段中;不要把它改成 ?authToken= 查询参数。浏览器不会把片段发送给服务器或放进 Referer,插件加载后也会从地址中移除令牌。

初始化 SDK 前创建 iframe,并在它首次加载 src 之前设置 allow="clipboard-read; clipboard-write",否则浏览器可能阻止复制和粘贴。按指南设置 referrerPolicy="no-referrer",将 iframe 作为插件 component 传入,并在该 meeting 的整个生命周期内复用同一个元素。

Android、iOS 和 React Native 由 RealtimeKit SDK 创建承载插件的 WebView,注册时传入带令牌片段的插件 URL。所有平台使用相同的 plugin id,插件激活状态才会在注册了该 ID 的参与者之间同步;无需登记应用来源域名。

打开白板的权限与编辑权限是两回事

插件向 RealtimeKit 验证参与者令牌,并打开令牌所属 meeting 的白板;不需要另传 meeting ID 或参与者姓名。只有持有该会议有效 auth token 的参与者能打开它,令牌决定会访问哪一块白板。

每位当前打开白板的参与者都能编辑,preset 不能限制白板编辑。插件权限分别控制谁能 activate 或 deactivate 插件;UI Kit 用户可从插件面板打开或关闭,自建界面也可以调用相应操作,但 activate 和 deactivate 都会应用于整个 session。

Whiteboard 指南明确说明:即使参与者已从 meeting 中移除,其 auth token 仍会有效到到期,因此该参与者在到期前仍可能打开白板。不要把移除参与者理解为立即结束这项白板访问;所核白板文档没有说明更快的白板访问截止方式。

白板内容无限期保留,当前没有清除 API

Cloudflare 会在其基础设施上保存该 meeting 的白板内容,包括参与者添加的形状、线条、手绘笔迹和文本。内容会无限期保留,session 结束时不会删除;目前没有清空或删除白板内容的 API。

参与者可以在白板上输入个人或敏感信息。使用方有责任说明内容会被保存,并处理适用于自身使用场景的法律或监管义务;使用 Whiteboard 也受与 Cloudflare 达成的协议约束。接入前应先判断这种保留方式是否适合会议内容。

参与者光标和显示名称会分享给打开白板的人,但不会与白板内容一同存储。这个说明仅限于白板存储范围,不代表其他 RealtimeKit 数据采用相同保留规则。

支持的内容与容量边界

参与者可绘制形状、箭头、线条、手绘笔迹和文本,也可将白板导出为图片。插件不支持添加图片、frame、嵌入网页内容或导入白板文件;尝试使用时会显示不可用提示。

同时连接白板的参与者数量有限,白板本身及单个元素也有大小上限;官方文档没有给出具体数值。人数上限导致无法连接时会出现 Reconnect 提示;白板或元素达到上限后,新改动不会保存,并会显示提示。

人数较多的网络研讨会或直播场景,官方建议让一小组参与者编辑白板,再通过屏幕共享给其他观众。不要把白板按大型广播工具规划。

上线前核对账号条件与数据告知

Cloudflare 公告日期为 2026-11-11,白板操作指南页面标注 2026-10-26;这两个页面日期不代表已证明某地区、套餐或账号范围全面开放。所核页面没有说明价格、地区资格或账号开通条件,依赖插件前应确认当前账号可用性及适用条款。

本文依据 Cloudflare 公告和操作指南整理,没有进行实时账号、插件安装或会议验证。建议在获授权的测试 meeting 中核对插件显示、参与者打开与编辑体验、跨 session 内容,以及团队向参与者说明保留方式的流程;这属于上线前建议,不是已完成的测试结果。

资料来源

常见问题

看到 Rejoin the meeting 或 Cannot verify your meeting 怎么处理?

Rejoin the meeting 表示令牌无效、已过期或不属于当前会议,应为插件 URL 提供该参与者当前有效的令牌。Cannot verify your meeting 表示插件无法连接 RealtimeKit 完成验证,按提示选择 Try again;这些提示不能证明账号套餐或地区资格发生变化。

出现 Too many attempts 时,继续重连有帮助吗?

这是同一网络短时间内连接请求过多触发的限制。官方建议等待一分钟,再选择 Try again;不要把反复重连或更换代理当作绕过限制的方法。

白板无法加载,或 Web 端粘贴没有反应,先检查什么?

Cannot load the whiteboard 时先检查参与者的网络连接,再重试。复制或粘贴失效时,确认 iframe 首次加载前设置了 allow="clipboard-read; clipboard-write";首次加载后才修改该属性,需要重新加载 iframe。