开发Microsoft Teams Tab应用时剪贴板写入失效,如何配置iframe参数?
Teams Tab 剪贴板写入权限配置说明
核心逻辑
你的 Tab 应用页面是由 Microsoft Teams 作为宿主,通过 iframe 嵌入到 Teams 客户端/Web 端的,这个 iframe 的权限策略(allow 属性)由 Teams 统一管控,你无法直接修改。可通过以下两种官方方式申请所需权限:
方式1:通过 Teams JS SDK 运行时请求(兼容全版本客户端)
- 这是目前兼容性最好的方式,适用于所有支持 Teams JS SDK v2.0+ 的客户端版本
- 首先完成 SDK 初始化:
import * as microsoftTeams from "@microsoft/teams-js"; await microsoftTeams.app.initialize(); - 初始化完成后,调用权限请求 API 申请剪贴板写入权限:
import { permissions } from "@microsoft/teams-js"; await permissions.request({ permissions: [{ name: "clipboard-write" }] }); - 用户在弹出的 Teams 客户端确认框中同意权限后,Teams 会即时给当前 Tab 对应的 iframe 追加
clipboard-write权限策略,之后即可正常调用navigator.clipboard.writeText()等剪贴板写入 API
方式2:Manifest 静态声明(适用于最新版客户端,无需运行时弹窗)
- 从 Teams 应用 Manifest 版本 1.13 开始,支持开发者在 Manifest 中静态声明 Tab 所需的 iframe 权限策略,配置后 Teams 加载 Tab 时会自动给 iframe 追加对应权限,无需用户手动确认
- 手动编辑 Manifest 时,定位到
staticTabs或configurableTabs节点下对应 Tab 的配置项,新增permissionsPolicy字段:"permissionsPolicy": ["clipboard-write"] - 如果你使用 App Studio 生成 Manifest,可直接在 Tab 的高级配置页勾选「剪贴板写入」选项,工具会自动写入该配置
补充注意事项
- 你在 Manifest 中通过
validDomains声明的域名,才会被允许申请该权限,未声明的域名无法生效 - 调用剪贴板写入 API 时,需要由用户的主动交互(如点击按钮)触发,否则即使权限放行,浏览器仍可能拦截调用
- Teams Web 端、桌面端、移动端均支持上述两种配置方式,配置生效后无需用户手动调整客户端默认权限
内容的提问来源于stack exchange,提问作者Dmytro Yaroshenko
相关产品推荐
相关产品推荐

