嵌入展项能播放却不能全屏，怎样核对 iframe 的全屏授权

跨源 iframe 请求全屏要同时满足用户激活与全屏授权条件。先在嵌入边界核对 allow 的 fullscreen 策略，再看子文档请求的 Promise；媒体能播放并不能推出全屏也已获准。

用端口差异建立真实跨源

验证程序启动两个仅监听127.0.0.1的随机端口，顶层页来自其中一个，子页来自另一个。源由协议、主机和端口共同确定，所以即使是同一台电脑也属于跨源。两轮都点击子页按钮，第一轮不授权，第二轮加allow=fullscreen，除此之外保持页面代码和输入相同。

分别读取子页请求结果

脚本通过浏览器框架定位实际点击嵌入按钮，收集子文档的Promise兑现或拒绝与active状态。没有授权的负例应拒绝，允许组应进入全屏。程序只为本地fixture动态构造URL，HTML没有硬编码生产站根路径；这份例子不连接线上展项，也不会替用户修改第三方站点权限。

授权不是跳过所有约束

allow只处理相应嵌入权限策略，还可能受到上层响应头、更高层祖先授权、安全环境或用户激活等条件限制。实际页面若有多层iframe，应逐层确认，不能仅在最里层加一个属性。失败日志保留error.name与请求文档，避免把所有拒绝写成浏览器不支持；顶层成功也不代表跨源子页自动继承成功。

和实体展台要求分开

Fullscreen API仍允许浏览器或用户退出，不是系统安全锁，也不能保证全屏进入指定物理屏幕。附件验证Chromium headless中的策略差异，未测Safari、移动WebView和真实多屏设备。现场应补实际嵌入链、浏览器版本与维护退出流程；如果产品通过桌面壳或专用客户端展示，须以该运行时的文档和配置另验，不能照搬网页结论。

保留失败所在的嵌入层

在多层嵌套中，请求按钮所在文档、实际被全屏的元素与授权由哪层施加，可能不在同一个页面。排查表应画出父子源和allow配置，再按层查看Promise与事件；只截顶层控制台可能看不到子页错误。需要跨团队协作时提供最小父页与子页，避免把整套展项上传外部服务。本夹具两个端口由同一程序拥有，全部请求仍被限制在本地。

下载并复现

下载原创HTML夹具、独立验证程序、本次执行记录和依赖与运行说明，放在同一目录。安装Playwright 1.58.0及其Chromium后运行 python verify.py；程序使用两个随机本地端口，自动关闭浏览器与服务，不请求外网或业务接口。

本次实际环境为Python 3.12.4、Playwright 1.58.0、Chromium 145.0.7632.6。Playwright浏览器鼠标/键盘与页面API实跑；无实体硬件或业务控制。断言已通过；完整事件和数值保留在执行记录，不能把它改名后当目标展项测量。

继续核查与一级出处

基础背景见展会软件的可靠性三件套：崩溃自恢复、超时回待机、全屏锁定。嵌入授权之外，还要用全屏状态与事件确认实际请求结果，可继续用网页全屏按钮显示成功却仍有地址栏，怎样以 fullscreenElement 判定取证；相关工程入口在专题与产品对接说明。

• Fullscreen Permissions Policy与iframe授权：2026-10-24已联网读取一级来源；WHATWG Fullscreen Living Standard，读取页标记2026-10-19更新。