SuperAPI AI 工具集

ui-toolkit/web

前端与建站

查看项目

更新于 10-15 16:51

技能介绍

用途:Zoom Video SDK UI Toolkit 是一个预构建的 Web 视频 UI 库,可用较少代码渲染完整视频会议体验。资料建议当用户可能仍需 Meeting SDK 时,先使用 choose-zoom-approach 路由确认;确认走 Web 视频工作流且希望用现成 React UI 时再使用本技能。

主要能力:提供开箱即用的专业视频界面,无需自行构建布局、控件与参会者管理;框架无关,可用于 React、Vue、Angular、Next.js 与原生 JS;可选择启用功能并自定义主题;内置视频、音频、屏幕共享、聊天、参会者列表、设置、虚拟背景、入会前预览、云录制(付费方案)与离开按钮等。

使用方式:通过 npm install @zoom/videosdk-zoom-ui-toolkit jsrsasign 安装,并安装 @types/jsrsasign。核心调用为 uitoolkit.joinSession(container, config) 与 uitoolkit.closeSession(container);配置需包含 videoSDKJWT、sessionName、userName,可选项包括 sessionPasscode 等。事件监听用 onSessionJoined、onSessionClosed,组件方法包括 showChatComponent、showUsersComponent、showControlsComponent、showSettingsComponent、hideAllComponents 等。也提供 CDN 无构建步骤用法。

JWT 鉴权:必须在服务端生成 JWT,不得在客户端暴露 SDK Secret。载荷字段含 app_key、role_type(0 参会者、1 主持人)、tpc、version(固定为 1)、iat、exp,可选 user_identity。

适用场景与限制:适合希望快速获得完整视频方案、需 Zoom 风格界面一致性、需要聊天/共享/参会者等标准功能的项目;需要完全自定义 UI、非标准视频体验、原始音视频数据或自建渲染管线时,应改用原生 Video SDK。依赖 React 版本需匹配所安装的 UI Toolkit 包 peer 依赖(常见为 React 18),需要 Zoom Marketplace 凭证、服务端签发的 JWT、支持 WebRTC 的现代浏览器(Chrome 78+、Firefox 76+、Safari 14.1+、Edge 79+),并注意 CSS 导入、React peer 依赖、basePath 等常见问题。其他价格与支持细节暂未提供。