无法真正检测视频是否正在投屏,仅能通过事件(如webkitpresentationmodechanged)、visibilitychange及noremoteplayback属性间接推断或抑制投屏入口,但所有前端手段均可被绕过,服务端鉴权或DRM才是有效防护。

检测 HTMLMediaElement 是否被投屏(Mirroring)
浏览器本身不提供直接判断“当前视频是否正在投屏”的 API,但可通过监听 webkitpresentationmodechanged(Safari)、presentationmodechanged(部分 Chromium 实验性支持)以及更通用的 visibilitychange + document.hidden 组合来间接推断。真正稳定可用的方式是监听投屏状态变更事件,而非轮询或猜测。
- Safari 15.4+ 支持
webkitpresentationmodechanged事件,触发时video.webkitPresentationMode值为"picture-in-picture"或"inline",但注意:它不区分“投屏”(AirPlay / Chromecast)和画中画,仅反映 WebKit 的呈现模式 - Chrome / Edge 目前无标准事件监听 AirPlay / Cast 状态;
presentationmodechanged未被广泛实现,不可依赖 -
document.visibilityState === "hidden"有时伴随投屏发生(如 iOS Safari 投屏时页面可能被置为 hidden),但非必然——Android Chrome 投屏时页面通常仍 visible
拦截投屏入口:禁用 webkit-playsinline 和 disablePictureInPicture
防投屏不是靠运行时检测,而是从源头削弱用户发起投屏的路径。关键在 video 标签属性控制与 JS 配合屏蔽右键/上下文菜单。
- 移除
webkit-playsinline属性(iOS Safari 下若存在,会允许视频内联播放并开放 AirPlay 按钮;去掉后默认进入全屏,AirPlay 按钮仍可能显示,但行为受限) - 显式设置
disablePictureInPicture="true"—— 这会隐藏画中画按钮,且对部分 AirPlay 触发路径有抑制作用(尤其在 iOS 16.4+) - 添加
controlslist="nodownload noremoteplayback":noremoteplayback是关键,它告诉浏览器“禁止远程回放”,可让 Chrome / Edge 隐藏 Cast 按钮,Safari 中也会影响 AirPlay 图标可见性 - 用 JS 监听
contextmenu并preventDefault(),防止用户右键调出投屏菜单(虽不能阻止硬件快捷键或系统级投屏,但能拦住大部分手动操作)
监听 noremoteplayback 生效后的状态反馈
noremoteplayback 是声明式控制,但它本身不触发事件。要确认是否生效,只能通过观察 UI 变化或尝试触发失败来间接验证。没有回调函数,也没有 onremotereplaystatechange 这类事件。
- Chrome DevTools 中检查 video 元素:若
noremoteplayback存在且生效,右上角 Cast 图标不会出现(桌面端);移动端需真机测试,模拟器不可靠 - 可在
loadedmetadata后读取video.remotePlayback对象(Chrome 72+ 支持),它是一个RemotePlayback实例,含state("connecting"/"connected"/"disconnected"),但该 API 仅在用户主动发起投屏后才更新,无法用于“预防” - 不要试图用
video.remotePlayback.state === "disconnected"判断“未投屏”——初始值就是"disconnected",毫无区分度
为什么纯前端无法真正“防投屏”
所有前端手段都只是增加投屏门槛,而非阻断。用户绕过方式极简单:录屏、抓包下载、用开发者工具删掉 noremoteplayback 属性、或直接访问视频源地址。
-
noremoteplayback仅影响浏览器 UI 控件,不影响MediaSource或fetch请求本身 - 服务端需配合做鉴权(如短期 token、Referer 校验、UA 限制),否则前端任何防护都形同虚设
- DRM(如 Widevine、FairPlay)才是唯一有效方案,但它需要打包加密流、配置许可证服务器,且前端只负责调用
mediaKeys.setServerCertificate等,不解决“检测”问题
所谓“检测代码”,实际只能做到“感知用户是否点了 AirPlay/Cast 按钮”或“页面是否被切到后台”,而无法知道画面是否正被投到电视上——那个过程完全脱离前端控制范围。
前端入门到VUE实战笔记:立即使用
在学习笔记中,你将探索 前端 的入门与实战技巧!











