iOS PWA standalone模式下requestPictureInPicture失效原因及解决方案咨询

• standalone模式下的PWA并非完整复刻普通Safari的运行环境，它是独立的WebKit沙箱上下文，拥有单独的权限白名单，和Safari浏览器的JS引擎虽然同源，但开放的API能力、原生控件入口是做了裁剪隔离的。
• 从iOS 14.5版本开始，苹果官方将HTML Video的画中画API权限、视频原生控件的PiP入口，从standalone沙箱的功能白名单中移除——直接在这个上下文里调用requestPictureInPicture方法，会因为方法未注入沙箱、原生层权限校验不通过，直接抛出“当前环境不支持”的错误；原生PiP控件消失也是同一套权限逻辑触发的，和视频元素本身的配置无关。
• 这种能力裁剪是系统层的强制限制，不是网页端代码的配置错误导致的，哪怕和普通Safari跑完全一样的代码，在standalone上下文里也会触发权限拒绝。

• 调整Manifest的显示模式配置：将display字段从standalone修改为minimal-ui。该模式启动的PWA依然保留接近独立应用的全屏体验，不会跳转到完整Safari浏览器界面，但运行上下文属于带Safari基础权限的Web外壳，画中画API、原生PiP控件都会完全正常工作；仅有的体验差异是启动页顶部会保留一个极窄的地址栏条，不会出现普通Safari的完整导航栏。
• 适配standalone模式的降级交互：如果必须保留无地址栏的纯standalone全屏体验，不要尝试直接调用PiP JS API。可以在自定义PiP按钮的点击事件中，触发视频元素的系统长按手势唤起，弹出iOS原生的视频操作菜单（菜单本身自带画中画选项），绕开JS API的权限限制实现功能入口。
• 注意避坑：不要在standalone模式下引入PiP相关的JS Polyfill尝试补全能力，画中画的权限校验是WebKit原生层实现的，JS层模拟的方法无法通过系统沙箱的权限检查，只会抛出无效的权限错误。

内容的提问来源于stack exchange，提问作者Ben