移动端视频防投屏本质是禁用webkit-playsinline以外的投屏能力,需同时设置playsinline、webkit-playsinline和airplay="none"以降低系统级投屏触发概率,但无法完全阻止硬件镜像。

移动端视频防投屏本质是禁用 webkit-playsinline 以外的投屏能力
HTML 标签本身没有“防投屏”属性,所谓防投屏,实际是阻止用户通过系统级投屏(如 iOS 的 AirPlay、Android 的 Chromecast)将 内容镜像出去。但必须明确:**浏览器无法完全禁止硬件级投屏,只能削弱触发条件和降低成功率**。关键点在于控制播放上下文和媒体能力声明。
playsinline + webkit-playsinline 是基础门槛
不加这两个属性,iOS Safari 默认全屏播放并自动启用 AirPlay 按钮;加了才能让视频在页面内播放,同时隐藏原生投屏控件。
实操建议:
- 必须同时设置
playsinline(标准属性)和webkit-playsinline(Safari 专有),仅一个无效 - 需配合
controls属性使用,否则部分 iOS 版本仍可能唤起全屏控件(进而暴露 AirPlay) - 不要依赖
x5-video-player-type="h5"等微信私有属性——它只影响内嵌 WebView 行为,对系统级投屏无约束力
<video src="example.mp4" playsinline webkit-playsinline controls muted autoplay></video>
禁用 airplay 属性可隐藏 AirPlay 按钮(仅 iOS)
airplay="none" 是 WebKit 提供的明确指令,用于移除视频控件中的 AirPlay 图标。但它不阻止用户手动打开系统控制中心再点投屏——只是减少“一键触达”路径。
注意点:
- 该属性仅在 Safari 和部分基于 WebKit 的 iOS 浏览器生效,Chrome / Firefox on iOS 无视此属性
- 必须与
playsinline共存,否则即使设了airplay="none",全屏后仍会显示 AirPlay 按钮 - 不能写成
airplay="false"或省略值——只接受"allow"、"deny"、"none",其中"none"是最常用且最克制的选项
真正难防的是系统级镜像,前端能做的非常有限
用户长按音量键呼出控制中心 → 开启屏幕镜像 → 选择设备,这个流程完全绕过网页 DOM 和 JS。任何声称“100% 防投屏”的方案,要么混淆了“禁用控件”和“禁用功能”,要么依赖服务端 DRM(如 Widevine、FairPlay),而这需要打包加密流、证书分发、客户端 SDK 集成,已超出纯 HTML 范畴。
所以务实做法是:
- 把
playsinline、webkit-playsinline、airplay="none"当作必选项写死 - 避免使用
webkit-airplay(已废弃)、x5-video-player-fullscreen="true"(反而诱导全屏)等反效果属性 - 如果内容敏感,必须防录屏/镜像,请直接对接 DRM 方案,不要试图用 HTML 属性“堵漏洞”
容易被忽略的一点:安卓 Chrome 对投屏无任何 HTML 层面的干预能力,它的 Cast 按钮是否出现,只取决于当前页面是否支持 Media Session API 以及系统设置,前端几乎无法感知或拦截。
前端入门到VUE实战笔记:立即使用
在学习笔记中,你将探索 前端 的入门与实战技巧!











