用途:该技能指导开发者使用 Zoom Video SDK for Web 在浏览器中构建自定义视频应用,适用于自建 UI 的视频会话,而非在页面中嵌入标准 Zoom 会议(后者应转向 meeting-sdk/web 组件视图)。
主要能力:会话管理(加入/离开 Video SDK 会话)、音视频(启停摄像头与麦克风)、屏幕共享、云录制、RTMP 直播、会话内聊天、自定义命令通道、实时转写、分组讨论(Subsession)、协作白板、虚拟背景,以及通过 VideoProcessor 自定义视频帧处理。支持 WebRTC 模式,可开启 HD 视频。
使用方式:通过 npm install @zoom/videosdk 安装并 import ZoomVideo from '@zoom/videosdk';也可使用 CDN,但 CDN 导出为 WebVideoSDK(而非 ZoomVideo),需注意 ES Module 加载竞态。需准备 Marketplace 的 SDK Key/Secret 及服务端生成的 JWT。初始化可先调用 ZoomVideo.checkSystemRequirements() 与 checkFeatureRequirements() 检查兼容性,并按顺序执行:createClient() → init('en-US','Global',{patchJsMedia:true}) → join(topic,signature,userName,password) → getMediaStream()(必须在 join 之后调用)→ startVideo()/startAudio()。渲染视频应使用 attachVideo(),不要用已废弃的 renderVideo();视频渲染是事件驱动的,需监听 peer-video-state-change、user-added、user-removed 等事件。
适用场景:需要在浏览器中实现带自定义界面的实时音视频、屏幕共享、录制或直播的应用。
限制与注意事项:需现代浏览器(Chrome 80+、Firefox 75+、Safari 14+、Edge 80+);Safari 不支持虚拟背景,屏幕共享需 macOS 15+;HD 视频建议配置 COOP/COEP 响应头,自 v1.11.2 起 SharedArrayBuffer 为可选;部分网络可能拦截 source.zoom.us,可考虑加入白名单或经许可的自托管回退;log-external-gateway.zoom.us 的 CORS 报错不影响力功能。价格、授权等细节资料中暂未提供。