getdisplaymedia调用失败主因是环境与触发条件不满足：必须运行在https或http://localhost下，且只能由用户手势（如click）触发，禁用自动调用；约束中video:true为必需，audio支持有限；safari及移动端均不支持。
getDisplayMedia 调用失败：常见错误和权限前提
直接调用 navigator.mediaDevices.getDisplayMedia 会抛出 NotAllowedError 或 SecurityError，不是代码写错了，而是浏览器根本没给机会——它只在安全上下文（https:// 或 localhost）且用户主动触发的事件中才允许执行。点击按钮、键盘按键可以，setTimeout 或页面加载完成时自动调用都不行。
必须确保：
- 页面运行在 HTTPS 或
http://localhost（127.0.0.1不行） - 调用发生在用户手势事件回调内，比如
button.addEventListener('click', ...) - 不能在 iframe 中调用，除非该 iframe 显式声明了
allow="display-capture"
约束参数怎么写：video 为 true 是硬性要求，audio 默认不支持
getDisplayMedia 的 constraints 参数不是可选的“锦上添花”，而是决定行为的关键。最简可用配置是 { video: true }；设成 false 或省略会导致返回空流或拒绝。
音频捕获（如共享系统声音）目前仅 Chromium 120+ 在桌面端支持，且需显式传入 { video: true, audio: true }，但注意：audio: true 不代表一定能拿到系统音频——它只尝试捕获当前标签页的音频轨道（即网页自身播放的声音），无法捕获其他应用或桌面背景音。真正的系统级音频捕获仍需原生应用配合。
常见误配：
-
{ video: { cursor: "never" } }—— 有效，隐藏鼠标指针 -
{ video: { mediaSource: "window" } }—— 有效，强制弹出窗口选择器（而非标签页/屏幕） -
{ video: { width: 1920, height: 1080 } }—— 无效，分辨率约束被忽略，浏览器不支持强制缩放
拿到 MediaStream 后怎么用：别直接塞进 <video></video>，先处理 track
返回的 MediaStream 对象里只有一个 video 轨道（stream.getVideoTracks()[0]），没有音频轨道（除非你开了 audio: true 且成功获取）。直接赋值给 <video></video> 的 srcObject 能播，但有隐患：
- 用户中途取消选择，流不会自动关闭，track 仍在后台采集，浪费 CPU 和内存
- 用户切换共享目标（比如从窗口切到整个屏幕），旧流未 stop，新流叠加，可能触发多路编码压力
正确做法是监听 stream.oninactive，并在用户结束共享时手动调用 track.stop()：
const stream = await navigator.mediaDevices.getDisplayMedia({ video: true });
const videoTrack = stream.getVideoTracks()[0];
videoElement.srcObject = stream;
// 用户停止共享时触发
stream.oninactive = () => {
videoTrack.stop(); // 必须显式停止，否则持续采集
};
兼容性和降级方案：Safari 完全不支持，Edge 行为接近 Chrome
getDisplayMedia 在 Safari 中至今（截至 Safari 17.5）未实现，调用会直接抛出 TypeError: navigator.mediaDevices.getDisplayMedia is not a function。不要试图用 try/catch 捕获后 fallback 到 getUserMedia——后者只能访问摄像头，完全无法替代屏幕共享。
真实可行的降级路径只有两个：
- 检测 API 是否存在，不存在则隐藏共享按钮，并提示“仅支持 Chrome / Edge / Firefox 桌面版”
- 引导用户下载轻量桌面客户端（如 Electron 封装的共享工具），通过
chrome.runtime或自定义协议与网页通信
另外注意：移动端（Android Chrome、iOS Safari）全部不支持 getDisplayMedia，所谓“手机投屏”必须依赖 Miracast、AirPlay 等系统级协议，网页无法直接调用。
