disableRemotePlayback必须以无值布尔属性形式书写,仅Chrome/Edge可靠支持,Safari从iOS 15.4起支持,Firefox完全不识别;正确写法为,它仅提示浏览器“请勿投屏”,非强制机制。

disableRemotePlayback 属性必须无值书写,否则失效
几乎所有第一次尝试防投屏的开发者都会写成 disableRemotePlayback="true" 或 disableRemotePlayback="disabled",结果发现 Safari 和 Chrome 都没反应。这不是浏览器 bug,而是规范要求:它必须是无值布尔属性,只存在即生效。正确写法只有这一种:<video controls disableremoteplayback></video>。动态设置(比如 videoEl.setAttribute('disableRemotePlayback', ''))在部分 Android WebView 和旧版 Safari 中会失败,所以务必在 DOM 初始化时就声明,不要依赖 JS 后续添加。
controlslist="noremoteplayback" 是更广谱的兼容兜底
controlslist 比 disableRemotePlayback 更早被支持,Chrome、Edge、新版 Safari 均识别,语义也更直白——禁用远程播放入口。它和 disableRemotePlayback 可共存,不冲突,建议一起写:<video controls controlslist="nodownload noremoteplayback"></video>。注意:noremoteplayback 不带引号、不赋值、多个指令用空格分隔。但在微信 X5 内核、QQ 浏览器等环境下,controlslist 大概率被忽略,此时需 UA 判断并降级为弹窗提示或日志上报。
防投屏不是开关,而是信号,必须搭配行为监听
disableRemotePlayback 和 controlslist="noremoteplayback" 都只是向浏览器发出“请勿提供投屏入口”的提示,不强制、不可靠。用户仍可通过快捷键(F11、Cmd+Shift+F)、系统镜像(macOS 镜像、Windows 投影到此电脑)或已建立的投屏会话绕过。真正能干预的,是监听关键事件:webkitbeginfullscreen(Safari/Chrome 全屏前)、enterpictureinpicture(进入画中画)、visibilitychange(切后台)。例如:
videoEl.addEventListener('enterpictureinpicture', () => {
videoEl.pause();
// 可选:上报行为、弹警告、触发水印增强
});
这些事件在 Firefox 中支持有限,需按浏览器做 feature detection,不能无条件绑定。
立即学习“前端免费学习笔记(深入)”;
第三方播放器 SDK 通常拦截原生属性,需穿透封装
如果你用的是腾讯云、阿里云、xgplayer 等 SDK 封装的播放器,disableRemotePlayback 和 controlslist 很可能被内部 <video></video> 创建逻辑覆盖或忽略。此时必须查 SDK 文档是否暴露底层 video 实例,再手动设置属性。例如 xgplayer 提供 player.video 引用,可这样补救:
player.on('ready', () => {
const video = player.video;
video.setAttribute('disableRemotePlayback', '');
video.setAttribute('controlslist', 'noremoteplayback');
});
但要注意:某些 SDK 在初始化后会重写 controlslist,所以设置时机必须卡在 ready 之后、首次渲染之前;若 SDK 不暴露 video 实例,就只能放弃原生防投屏,转而靠 Canvas 水印 + 行为监控组合防御。
防投屏的边界很清晰:它只影响 UI 层投屏按钮的显隐,对系统级镜像、已连接设备、调试工具完全无效。真正要守住的,不是“不让投”,而是“投了也看不清”——所以 crossorigin="anonymous" 必须加,否则 Canvas 截帧水印会因 CORS 被拒;而水印密度、动态位置、帧间扰动这些,才是后端无法绕过的硬防线。



















