html5媒体播放器全屏功能需系统适配：必须用户手势触发，按优先级调用各浏览器全屏api，监听fullscreenchange与fullscreenerror事件，兼容退出方法，并为移动端准备css伪全屏等降级方案。
HTML5 媒体播放器的全屏功能不能只靠 requestFullscreen() 一行代码搞定。核心难点在于浏览器行为不一致、触发条件严格、退出逻辑易遗漏，必须系统性适配。
必须由用户手势触发
所有现代浏览器（Chrome、Firefox、Safari、Edge）都强制要求全屏请求必须来自明确的用户交互事件，比如 click、touchend 或 pointerup。任何异步上下文调用都会失败：
- ✅ 正确：按钮
onclick或addEventListener('click', ...)中直接调用 - ❌ 错误：放在
setTimeout、Promise.then、video.oncanplay或页面load回调里 - ⚠️ Safari 更严：若
<video></video>未设置playsinline且从未播放过，webkitEnterFullscreen()可能静默失效；建议先play()再触发全屏
兼容各内核的请求方法
不同浏览器对全屏 API 的实现存在前缀差异，不能只依赖标准方法。需按优先级顺序尝试可用接口，并忽略不支持时的报错：
-
element.requestFullscreen()—— Chrome 66+、Firefox 64+、Edge 79+、Safari 15.4+ -
element.webkitRequestFullscreen()—— Safari 5.1–15.3、旧版 Chrome/Opera -
element.webkitEnterFullscreen()—— Safari 仅对<video></video>元素有效（iOS/macOS 原生视频控件） -
element.mozRequestFullScreen()—— Firefox 49–63（已废弃，但低版本仍需兜底） -
element.msRequestFullscreen()—— IE11、Edge 12–18（已淘汰，可酌情移除）
推荐封装为健壮函数，自动跳过不可用方法：
function launchFullscreen(el) {if (!el || !el.isConnected) return;
const method = el.requestFullscreen
|| el.webkitRequestFullscreen
|| el.webkitEnterFullscreen
|| el.mozRequestFullScreen
|| el.msRequestFullscreen;
if (method) method.call(el);
}
状态监听与退出控制统一处理
全屏状态变化必须通过 document.addEventListener('fullscreenchange') 监听，不能轮询或依赖 UI 按钮状态。同时，退出操作也受相同手势限制：
- 检测是否全屏：用
document.fullscreenElement !== null（避免用真值判断，因旧版返回undefined） - 退出全屏：统一调用
document.exitFullscreen()，而非元素方法（不存在） - 兼容退出方法：
document.exitFullscreen||document.webkitExitFullscreen||document.mozCancelFullScreen||document.msExitFullscreen - 务必监听
fullscreenerror事件，捕获用户拒绝（如按 Esc）、策略拦截或跨域 iframe 无allow="fullscreen"等异常
移动端与降级方案不可少
iOS Safari 和部分 Android WebView 对全屏 API 支持有限或静默忽略。需准备 fallback 方案：
- 提供“按 F11”提示（Windows/Linux）或 “Control+Command+F”（macOS），并监听
keydown中的 F11 事件同步 UI（注意：无法主动触发，仅响应） - 实现 CSS 伪全屏：添加
position: fixed; top:0; left:0; width:100vw; height:100vh;类，配合object-fit: cover保持视频比例 - 检查
document.fullscreenEnabled，若为false，说明环境不支持（常见于 HTTP 页面、无 HTTPS、iframe 缺allow="fullscreen"）
大量免费API接口：立即使用
涵盖生活服务API、金融科技API、企业工商API、等相关的API接口服务。免费API接口可安全、合规地连接上下游，为数据API应用能力赋能！
