移动端网页嵌入第三方视频为何无法自动播放？检查 Permissions Policy
移动端网页嵌入第三方视频无法自动播放时，应检查 Permissions Policy 头部或 iframe allow 属性是否限制了 autoplay 功能。
检查 Permissions Policy 头部配置
移动端网页嵌入第三方视频无法自动播放，可能是因为服务器返回的 Permissions-Policy 头部限制了 autoplay 功能。Permissions Policy 提供了机制让开发者明确声明网站可以使用哪些功能。你可以通过检查响应头中的 Permissions-Policy 来确认 autoplay 是否被设置为禁用。如果头部中包含 autoplay=() 或 autoplay=(none)，则该功能在当前文档及其嵌套上下文中将被禁用。确保头部中包含 autoplay=* 或 autoplay=(self) 以允许自动播放。
Permissions Policy 与 Content Security Policy 类似，但控制的是功能而非安全行为。它允许你定义一组策略来限制代码可以访问或修改的 API。在移动端，视频自动播放是一个敏感功能，浏览器通常会要求用户交互才能播放。通过 Permissions Policy，你可以覆盖浏览器的默认行为。例如，你可以允许特定来源的视频自动播放，或者限制第三方内容自动播放以保护用户体验。检查头部配置是排查此类问题的第一步。
检查 iframe allow 属性设置
如果头部配置正确，但仍无法自动播放，需要检查嵌入视频的 iframe 标签上的 allow 属性。Permissions Policy 允许通过 iframe 的 allow 属性来控制特定 iframe 内的功能使用。该属性使用与头部相同的语法，但仅作用于特定的 iframe。确保 allow 属性中包含 autoplay。如果 allow 属性中包含 autoplay='none' 或 autoplay=()，则该 iframe 内的视频将无法自动播放。正确的写法应包含 autoplay，例如 allow='autoplay' 或 allow='autoplay; fullscreen'。
iframe allow 属性的语法与 Permissions-Policy 头部略有不同。头部使用逗号分隔多个策略，而 allow 属性使用分号分隔。此外，allow 属性中的 allowlist 值需要用单引号括起来，例如 autoplay='self'。默认情况下，iframe 的 allow 属性会继承父页面的策略，但你可以通过显式设置 allow 属性来覆盖它。确保 allow 属性中的设置与你的业务需求一致，并且没有意外地禁用了自动播放功能。
验证策略继承与组合规则
Permissions Policy 的策略继承规则可能导致自动播放被意外禁用。脚本会继承其浏览上下文的策略，无论其来源如何。这意味着顶级页面的策略会应用于所有嵌套的 iframe。如果父页面的 Permissions-Policy 头部禁用了 autoplay，那么所有 iframe 内的视频都无法自动播放，即使 iframe 的 allow 属性中包含了 autoplay。要验证这一点，可以检查父页面的头部配置。如果父页面禁用了该功能，子页面无法重新启用它。
iframe 的 allow 属性与父页面的策略会进行组合，取最严格的子集。如果父页面允许 autoplay，但 iframe 的 allow 属性中包含 autoplay='none'，则该 iframe 内的视频将无法自动播放。要验证这一点，可以尝试移除 iframe allow 属性中的 autoplay='none'，或者确保父页面的头部配置允许该功能。理解这种组合规则对于排查问题至关重要。确保父页面和 iframe 的策略设置不会相互冲突，导致自动播放被意外禁用。
确认浏览器兼容性与实验性特性
Permissions Policy 是一个实验性技术，并非所有浏览器都支持。在移动端，不同浏览器的支持情况可能不同。在部署到生产环境之前，必须仔细检查浏览器兼容性表。如果浏览器不支持 Permissions Policy，它将忽略该头部或属性，并使用默认行为。默认行为通常要求用户交互才能播放视频。因此，如果浏览器不支持该特性，你可能需要采用其他方法来实现自动播放，例如使用用户交互事件来触发播放。
Permissions Policy 曾被称为 Feature Policy，名称和 HTTP 头部语法已更改。如果你之前使用了 Feature Policy，需要更新你的配置。iframe 的 allow 属性语法保持不变。确保你的代码符合当前的规范，并且与目标浏览器兼容。在移动端，由于浏览器版本众多，兼容性检查尤为重要。使用特性检测来确保你的代码在支持的浏览器中正常工作，并在不支持的浏览器中提供回退方案。
资料与延伸阅读
你可以通过以下原始资料核对文中概念，并继续深入阅读。