跳转到内容
本站为社区维护的非官方中文翻译,与 Cloudflare, Inc. 无关联。本站不提供账户登录,请勿在任何非官方站点输入您的 Cloudflare 账户信息。官方文档:developers.cloudflare.com

Web UI Kit

最后更新 查看 MarkdownAgent 设置

Subscribe to RSS

2026-10-12

RealtimeKit Web UI Kit 2.0.3

增强功能

  • Web UI Kit 资源现在使用单一主机名 rtk-assets.realtime.cloudflare.com。您不再需要将 rtk-uploads.realtime.cloudflare.com 加入允许列表。有关域名要求,请参阅网络允许列表。

修复

  • 修复了实时转录重放过时内容并显示延迟的问题。
  • 修复了在不支持原生 structuredClone 的浏览器中转录内容无法渲染的问题。
  • 修复了重连后参与者音频丢失的问题(包括会议录制中)。如果您使用自定义录制应用,请将其 RealtimeKit Web UI Kit 依赖项升级到 2.0.3。
  • 修复了多名参与者同时重连时参与者图块从 rtk-grid 中消失的问题。
  • 修复了 rtk-debugger 在各部分之间大小调整的问题,并更新了其颜色以匹配设计系统。
  • 修复了 rtk-speaker-selector 中的事件监听器泄漏问题,该问题会导致重新打开组件后反复刷新设备。
  • 修复了 rtk-audio-tile 中的音频分析器泄漏问题,该问题会在麦克风或音频轨道变更后导致过时的音量更新和 CPU 使用率升高。
  • 修复了在 MANUAL 视图模式下本地参与者图块未出现在 rtk-grid 中的问题。
  • 修复了分页列表未渲染时 rtk-chat-selector 中出现 TypeError: Cannot read properties of undefined (reading 'onNewNode') 的问题。

2026-08-24

RealtimeKit Web UI Kit 2.0.2

修复

  • 通过合并一项上游 Stencil 修复,恢复了对 Safari 16.x 的兼容性。
  • 修复了 rtk-idle-screen 将非致命的 preJoinError 事件(例如拒绝共享媒体)错误地显示为致命错误的问题。
  • 在已有录制进行时启动录制,现在会显示特定消息,而不是通用的内部错误。

新的本地化键

  • recording.error.already_recording — "A recording is already in progress."

2026-07-17

RealtimeKit Web UI Kit 2.0.1

修复

  • joinError 状态已被 preJoinError 取代,以涵盖在加入会议之前或期间发生的所有错误。有关 UI Kit 状态的详细信息,请参阅状态管理。
  • rtk-idle-screen 现在会显示用户友好的错误消息,而不仅仅是无限加载动画,帮助客户识别问题并重试。
  • 修复了 Core SDK 抛出的错误未被 UI Kit 正确捕获和显示的问题。

新的本地化键

  • init.auth_error — "We couldn't verify your access to this meeting. The meeting may have ended, or you may not have permission to join."
  • init.network_error — "We couldn't connect to the meeting. Please try again, and if the problem continues, check your internet connection."
  • init.browser_error — "Your browser is not supported. Please try a different or updated browser."
  • init.default_error — "Something went wrong while connecting to the meeting. Please try again."
  • join.network_error — "We couldn't connect to the meeting. Please check your internet connection and try again."
  • join.media_error — "We're having trouble connecting to the meeting. Please try again, and if the problem continues, try using a different network."
  • join.media_firewall_error — "Your network may be blocking this connection. Try using a different network, or contact your network administrator for help."
  • join.default_error — "Something went wrong while joining the meeting. Please try again."
  • join.error_code — "Error code"

2026-06-18

RealtimeKit Web UI Kit 2.0.0

兼容性: 需要 RealtimeKit Web Core 2.0.0 或更高版本。

这是一个包含重大破坏性变更的版本,旨在与 Core SDK v2.0.0 的插件重新设计以及已弃用 API 的移除保持一致。

插件组件 — 重新设计

rtk-plugin-main 和 rtk-plugins 组件已针对新的插件模型进行了更新。

主要变更:

  • rtk-plugin-main 不再渲染 <iframe>,而是使用 <slot> 来投射您在插件配置中提供的 plugin.component(任何 HTMLElement)。
  • 插件权限检查现在使用 plugin.permissions.canActivate 和 plugin.permissions.canDeactivate,而不是旧的 meeting.self.permissions.plugins.canStart / canClose。
  • 插件列表(rtk-plugins)现在显示 plugin.icon,而不是 plugin.picture。
  • 新增未注册任何插件时的空状态消息(“No plugins available”)。
  • 移除了 iframe 交互检查(canInteractWithPlugin、viewModeEnabled)以及 block-inputs 遮罩层。在不使用 iframe 的情况下,这些已不再适用。

移除了对已弃用 API 的使用

  • meeting.leaveRoom() — 请使用 meeting.leave()。
  • meeting.connectedMeetings.supportsConnectedMeetings — 已移除。分组讨论室检查直接使用 meeting.connectedMeetings.isActive 和权限检查。
  • participant.clientSpecificId — 请使用 participant.customParticipantId。

增强功能

  • AI 转录 UI:重写了转录的搜索 UI。搜索现在同时涵盖参与者姓名和转录内容。新增了专用的搜索占位符和“无结果”状态。
  • AI 转录标题:将拼写错误的“MeetingAI”更正为“Meeting AI”。
  • 聊天消息间距:减小了 rtk-message-view 中的行高,以获得更好的垂直间距。
  • 音频轨道处理:RTKAudio.addTrack() 现在会在添加之前移除具有相同 ID 的现有轨道,防止过时的轨道不断累积(修复了重连时的双重音频问题)。

新的本地化键

  • plugins.empty — "No plugins available"
  • ai.transcriptions.search_placeholder — "Search by participant name or transcript"
  • ai.transcriptions.no_transcripts_found — "No transcripts found. Try searching for a different participant or transcript."
  • ai.transcriptions.no_transcripts_yet — "No transcripts yet."

修复

  • 修复了媒体重连期间错误地出现连接突然中断界面的问题。
  • 修复了因过时轨道未被替换而导致重连后音频丢失的问题。

2026-05-28

RealtimeKit Web UI Kit 1.2.0

兼容性: 与 RealtimeKit Web Core 1.5.1 或更高版本搭配使用效果最佳。

新功能

  • 当用户加入会议失败时,rtk-idle-screen 和 rtk-setup-screen 现在会显示一个故障排除链接,帮助解决防火墙限制和权限错误等常见连接问题。
  • 如果会议预设允许转录,现在会默认显示转录面板,无需手动激活。

增强功能

  • 加入失败时,不再向最终用户显示原始的 SDK 错误代码和消息。错误消息现在会映射为清晰、用户友好的本地化文本,并附带一个简短的参考代码(例如 Error code: 0002),以便支持和调试。

修复

  • 更正了默认语言包中的若干拼写错误和间距问题。

2026-03-31

RealtimeKit Web UI Kit 1.1.2

增强功能

  • AI 侧边栏组件现在使用 activeSidebar 状态而不是 activeAI 状态,将所有侧边栏组件统一到单一状态下。

2026-03-10

RealtimeKit Web UI Kit 1.1.1

兼容性: 与 RealtimeKit Web Core 1.2.5 或更高版本搭配使用效果最佳。

增强功能

  • 改进了会议室加入失败时的错误处理,现在会显示可据以采取行动的错误消息,而不是显示无限加载动画。

修复

  • 更正了 UI 字符串中的拼写错误:
    • occured → occurred
    • On you device → On your device
    • Grant acess → Grant access
  • 修复了默认语言包中的键:
    • ai.chat.summerise → ai.chat.summarize
    • date.yesteday → date.yesterday

2026-01-30

RealtimeKit Web UI Kit 1.1.0

兼容性: 与 RealtimeKit Web Core 1.2.4 或更高版本搭配使用效果最佳。

新功能

  • 聊天消息操作(编辑、删除、置顶)现在对所有参与者开放。
  • 支持无限滚动的聊天分页,提升了消息量大的会议中的性能。
  • 置顶消息现在显示在专用视图中,便于访问。
  • 在 rtk-meeting 和 rtk-ui-provider 上新增 overrides 属性支持,便于自定义 UI。可用的覆盖项包括:
    • disablePrivateChat - 禁用私人聊天功能。
    • disableEmojiPicker - 在聊天组件中隐藏表情选择器。
    <RtkMeeting meeting={meeting} overrides={{
      disablePrivateChat: true,
      disableEmojiPicker: true
    }} />
    

新组件

  • rtk-chat-header - 包含置顶消息和私人聊天选择器的标题组件。
  • rtk-pinned-message-selector - 以分页无限滚动的方式显示所有置顶消息。
  • rtk-chat-selector - 在公开聊天和与特定参与者的私人聊天之间切换。

组件增强

  • rtk-chat-composer-view 现在接受 isSending 属性,可将发送者的消息显示在右侧、其他消息显示在左侧,并使用不同的颜色。
  • rtk-chat-messages-ui-paginated 现在接受 privateChatRecipient 属性,用于显示分页的私人聊天消息。
  • rtk-chat-messages-ui-paginated 现在会针对消息操作触发 editMessage、deleteMessage 和 pinMessage 事件。
  • rtk-menu-item 和 rtk-menu-list 现在接受 menuVariant 属性,可根据用户操作使用不同的配色方案。
  • rtk-message-view 现在接受 isEdited、isSelf、messageType 和 pinned 属性,以正确渲染消息。
  • 新增自动滚动到新消息的功能。

破坏性变更

移除了不可用的聊天频道组件,以精简 SDK。rtk-chat 仍可完全正常使用。

  • 移除了 rtk-channel-creator。
  • 移除了 rtk-channel-header。
  • 移除了 rtk-channel-details。
  • 移除了 rtk-channel-selector-ui。
  • 移除了 rtk-channel-selector-view。
  • rtk-chat-composer-ui 不再接受 channelId 属性。
  • rtk-chat 不再接受 disablePrivateChat 属性。请改用预设配置,或作为覆盖项传入:
    <RtkMeeting meeting={meeting} overrides={{disablePrivateChat: true}} />
    

弃用

  • 由于可扩展性限制且缺乏分页支持,rtk-chat-composer-ui 已弃用。

已移除的本地化键

  • ai.chat.summarise
  • ai.chat.agenda
  • chat.new_channel
  • chat.channel_name
  • chat.channel_members

已重命名的本地化键

  • chat.empty_channel → chat.empty_chat

已知限制

  • 目前不显示公开聊天和私人聊天的消息总数。

2025-12-17

RealtimeKit Web UI Kit 1.0.8

修复

  • 修复了 iOS 上输入消息时聊天输入视图会放大的问题。

2025-11-18

RealtimeKit Web UI Kit 1.0.7

修复

  • 修复了未读聊天消息计数、未读投票计数以及待处理的参与者舞台请求计数的对齐问题。
  • 解决了设置组件中参与者视频预览里错误显示操作开关的问题。

2025-10-30

RealtimeKit Web UI Kit 1.0.6

修复

  • 修复了 rtk-debugger 将音频和视频比特率显示为 0 的问题。
  • 解决了参与者列表较长时最后一个参与者的菜单可见性问题。
  • 修复了在首次挂载后才提供属性时 rtk-polls 无法渲染的问题。
  • 改进了静音时 rtk-participant-tile 音频可视化效果的外观(不再显示为单个圆点)。
  • 防止大型通知溢出其容器。
  • 修复了 mediaConnectionUpdate 事件监听器中的内存泄漏。
  • 更正了在同一页面上连续进行会议时 rtk-ui-provider 向子组件传递属性的问题。

新的本地化键

  • network.troubleshoot — "Troubleshoot your connection"

2025-08-14

RealtimeKit Web UI Kit 1.0.5

修复

  • 修复了 Safari 上的 CSS 问题:rtk-settings 组件不可见,以及音频播放模态框高度不正确。

增强功能

  • 直播观众端现在支持进度拖动和 DVR 功能。

2025-07-17

RealtimeKit Web UI Kit 1.0.4

修复

  • 修复了 Angular 集成问题。

增强功能

  • 新增对 RealtimeKit 中同一页面上多个会议的支持。
  • 增强了 rtk-ui-provider 组件,使其可以作为父组件,与所有子组件共享通用属性(meeting、config、iconPack)。

2025-07-08

RealtimeKit Web UI Kit 1.0.3

修复

  • 解决了没有标题的会议出现 TypeError 的问题。
  • 对聊天组件进行了细微的 UI 改进。

新功能

  • 直播功能现已向所有 Beta 用户开放。

2025-07-02

RealtimeKit Web UI Kit 1.0.2

性能

  • 修复了依赖项问题,以提升性能和 Angular 集成。

2025-06-30

RealtimeKit Web UI Kit 1.0.1

已弃用的 API

  • 停止对 Vue UI 的支持。

2025-05-29

RealtimeKit Web UI Kit 1.0.0

新功能

  • Cloudflare RealtimeKit 首个版本,支持群组通话、网络研讨会、直播、投票和聊天。

这篇文档对您有帮助吗?