iPadOS 13+ 中 playsinline 不默认启用，必须显式声明；漏写会导致视频强制全屏、画中画失效、play() 被静音拦截，且需与 muted、autoplay 配合使用才生效。

playsinline 在 iPadOS 13+ **不默认启用**，必须显式声明才能生效。

很多开发者误以为 iPadOS 13 后“自动支持内联播放”，结果视频一加载就跳全屏、画中画失败、或 play() 被静音拦截——根本原因就是漏写了 playsinline 属性。

为什么必须手动加 playsinline？

iPadOS 的 WebKit 行为与 iOS 一致：未声明 playsinline 时，<video> 默认走原生全屏播放器（即使页面是横屏、容器足够大）。这不是 bug，而是 Apple 强制的策略，目的是防止网页滥用自动播放干扰用户。

• playsinline 是 Safari/iPadOS 唯一认可的内联控制开关，没有等效的 meta 标签或 JS API 替代
• 仅加 webkit-playsinline（旧版）已无效，iPadOS 13+ 只认标准属性 playsinline
• React/Vue 等框架中需注意写法：playsInline={true}（驼峰 + 布尔值），而非字符串 playsinline="true"

playsinline 和 muted、autoplay 的依赖关系

三者是 iPadOS 自动播放链上的“铁三角”，缺一不可：

• 没 muted → play() 调用直接被拒绝（Uncaught (in promise) DOMException）
• 没 autoplay → 即使内联了也得用户点一下才播
• 没 playsinline → 视频强制全屏，autoplay 失效，画中画入口消失
• 三者都齐了，仍可能因 canplaythrough 未触发而卡住，建议用 video.addEventListener('canplaythrough', () => video.play().catch(e => console.warn('play failed:', e)))

iPadOS 上 playsinline 的兼容性陷阱

看似简单的一个属性，在真实设备上容易栽在这些细节里：

• HTML 中写成 playsinline="" 或 playsinline="false" 都无效；必须是存在该属性（布尔属性语义），推荐写 playsinline 或 playsinline="true"
• Safari 技术预览版（TP）和部分企业内部分发的 iPadOS 测试版可能对 playsinline 检查更严格，比如要求父容器 position: relative 或非 display: none
• 如果视频是通过 srcObject 动态设置 MediaStream（如摄像头），playsinline 依然生效，但需确保设置前 video 元素已挂载且属性已存在
• 使用 picture-in-picture API 时，playsinline 不影响 PiP 行为，但它决定了 PiP 入口是否可用——没它，Safari 根本不显示画中画按钮

真正麻烦的不是加不加这个属性，而是加了之后发现它被框架忽略、被服务端响应头屏蔽、或者被 CDN 缓存了旧 HTML。上线前务必在真机 iPad 上用 Web Inspector 连接验证 video.hasAttribute('playsinline') 返回 true。