disableRemotePlayback仅提示不拦截投屏,真正有效的是监听webkitbeginfullscreen和enterpictureinpicture事件,结合页面可见性、设备方向与服务端Token失效实现主动防控。

disableRemotePlayback 只是提示,不是行为拦截
disableRemotePlayback 是个布尔属性,写在 标签里就生效,但它的作用仅限于“告诉浏览器:别显示投屏入口”。它不监听、不阻断、不校验——用户手动打开 Chrome 的 Cast 菜单、用快捷键 Ctrl+Shift+M(Windows)或 Cmd+Shift+M(macOS)触发投屏,照样能投。Safari 在 iOS 15.4+ 后对 AirPlay 有类似提示逻辑,但同样不拦截已发起的投屏会话。
监听 webkitbeginfullscreen 和 enterpictureinpicture 事件做响应
真正能感知投屏行为的,是这两个事件:前者在 Chrome/Edge 投屏启动时触发(注意不是全屏),后者在进入画中画时触发。它们虽不能阻止投屏本身,但可作为“用户正在尝试外传内容”的明确信号:
-
webkitbeginfullscreen在 Chromecast/AirPlay 开始镜像时触发,此时document.hidden === true,且document.pictureInPictureElement为空 -
enterpictureinpicture触发后,video.webkitDisplayingFullscreen或document.pictureInPictureElement可确认状态 - 必须在用户手势(如 click/tap)后绑定监听,否则部分浏览器会静默忽略
- 触发后可立即执行:
video.pause()、弹出遮罩层、上报风控系统、甚至调用video.exitPictureInPicture()(需用户再次交互才能成功)
结合页面可见性与设备方向判断异常投屏场景
单纯监听事件还不够,因为用户可能先投屏再刷新页面,事件不会重发。需要叠加运行时环境分析:
生成可在 deepbi 沙箱 iframe 内运行或作为独立文件运行的交互式 HTML 页面,使用 `window.deepbi` JS SDK 实现数据查询、空间管理、文件浏览及用户操作。当用户提出以下需求时启用该能力: - 创建 KPI 仪表盘、数据表格、文件浏览器、成员列表、管理页面; - 明确要求“转成 dhtml”、“转译成 HTML”、“把 XX 页面转成……”、“控制台页面”、“管理后台”、“DeepBI 页面迁移”; - 提及位于 `apps/console/src/featur
- 轮询
document.hidden+document.visibilityState:若长期为hidden但视频仍在播放,大概率已投屏或被后台挂起 - 监听
deviceorientation:手机横屏且document.hidden === true时,极可能是将设备投到电视后转为横屏观看 - 检查
navigator.permissions.query({name: 'display-capture'})(Chrome 92+):若返回state: 'granted',说明页面已被允许捕获屏幕,存在录屏或投屏风险 - 避免高频轮询:用
requestIdleCallback或节流至 3–5 秒一次,防止影响主线程
服务端联动才是防投屏的真正闭环
前端行为分析只能预警,要形成闭环,必须和服务端配合:
- 前端在检测到
webkitbeginfullscreen时,立即发送带签名的上报请求(含videoId、timestamp、screenOrientation、userAgenthash) - 后端收到后,主动使该用户的当前播放 Token 失效(如 Redis 中
DEL video:token:{xxx}),后续分片请求直接 403 - 若同一设备 5 分钟内触发 ≥3 次投屏行为,后端可临时降级画质(如从 1080p 切至 480p)或插入动态水印
- 注意:所有上报必须走 HTTPS,且签名密钥不可硬编码在前端 JS 中
行为分析本身不增加投屏难度,但它把“被动禁用”变成“主动感知+服务端干预”,这才是金融、教育等高敏场景下真正可用的防投屏路径。最容易被忽略的是事件监听时机和 Token 失效的原子性——没用户手势就绑不了事件,Token 没及时删干净,前端拦住十次,后端漏放一次,整套逻辑就归零。
前端入门到VUE实战笔记:立即使用
在学习笔记中,你将探索 前端 的入门与实战技巧!










