全屏 API 调用必须由用户手势触发，需在 click、touchstart、keydown 等事件回调中调用；移动端推荐 touchstart；禁止在异步回调中调用；iframe 嵌套时父页面需添加 allowfullscreen 属性。
全屏 API 调用必须由用户手势触发
浏览器明确禁止脚本自动进入全屏，requestFullscreen() 必须在 click、touchstart、keydown 等用户主动交互事件回调中调用。否则会静默失败或抛出 TypeError: Document not active 或 SecurityError。
常见错误写法：
gameCanvas.requestFullscreen(); // ❌ 页面加载后直接调用，必然失败
正确做法：
- 绑定按钮点击：
fullscreenBtn.addEventListener('click', () => canvas.requestFullscreen()); - 移动端需注意
touchstart比click更可靠（尤其 iOS） - 避免在异步回调（如
setTimeout、Promise.then）中调用，即使它紧接在 click 后——浏览器会丢失“用户手势上下文”
iframe 嵌套场景下需显式声明 allowfullscreen
如果游戏运行在 内（例如嵌入到 CMS 或活动页），父页面的 iframe 标签必须带 allowfullscreen 属性，否则子页面调用 requestFullscreen() 会被拒绝。
立即学习“前端免费学习笔记（深入）”；
错误示例（父页）：
