SuperAPI AI 工具集

zoom-apps-sdk

通用与其它

查看项目

更新于 10-16 06:51

技能介绍

用途:Zoom Apps SDK 用于构建在 Zoom 客户端内嵌浏览器中运行的网页应用,覆盖会议(inMeeting)、网络研讨会(inWebinar)、主客户端(inMainClient)、沉浸模式(inImmersive)、摄像头模式(inCamera)、协作模式(inCollaborate)、Zoom Phone(inPhone)、团队聊天(inChat)等运行环境。

主要能力:Context API 获取会议、用户与参会者信息;会议操作如 shareApp、sendAppInvitation、openUrl;客户端内 OAuth(PKCE,无浏览器跳转);Layers API 实现沉浸式视频布局与摄像头叠加;Collaborate Mode 共享应用状态;应用实例间消息通信(connect/postMessage);媒体控制如虚拟背景、摄像头列表、录制控制;UI 控制如 expandApp、通知、弹出;事件监听会议状态、参会者与共享变化。

使用方式:通过 npm 安装 @zoom/appssdk,或经 CDN 引入 https://appssdk.zoom.us/sdk.js。必须先调用 zoomSdk.config({ capabilities: [...], version: '0.16' }) 声明所需能力,之后才能调用其他方法;能力需与 Marketplace 中配置的 OAuth scope 匹配。官方文档见 https://developers.zoom.us/docs/zoom-apps/,SDK 参考 https://appssdk.zoom.us/,NPM 包 https://www.npmjs.com/package/@zoom/appssdk。

前置条件:Marketplace 中创建 Zoom App 类型应用、配置 OAuth 凭据与 scope、域名加入 allowlist、后端推荐 Node.js + Express、本地开发需 HTTPS 隧道(如 ngrok)、Node.js 18+。

限制与注意事项:SDK 仅在 Zoom 客户端内可用,在普通浏览器中 config() 会抛错,需 try/catch 提供降级 UI;CDN 方式下 window.zoomSdk 已全局定义,不可用 let zoomSdk 重复声明;未列入 config 的能力调用会报错;域名未加入 allowlist 时 Zoom 面板空白且无报错;ngrok 免费地址重启后变化,需同步更新 Marketplace 中多处 URL;嵌入式浏览器要求 Cookie 使用 SameSite=None 与 Secure=true;OAuth state 需校验防 CSRF;摄像头模式存在 CEF 初始化竞态,需重试。新项目建议使用 @zoom/appssdk ^0.16.26。