在 iOS 的 WKWebView 中播放 HTML5 视频时,系统级画中画(Picture in Picture,简称 PiP)可以满足大部分场景,但它的拖拽边界动画完全由系统控制,开发者拿不到手势回调,也无法修改回弹、吸附或减速效果。如果你的产品要求在应用内浮窗中模拟带有能量守恒的拖拽边界,让窗口越靠近边缘时势能增加、松手后动能与势能相互转换并最终稳定,就需要自己实现一套轻量物理模拟。下面基于 WKWebView 的视频播放配置、边界势能模型和 UIKit 手势驱动展开。

WKWebView 视频画中画与系统限制
WKWebView 对 HTML5 视频的播放行为主要受 WKWebViewConfiguration 控制。要让网页中的 <video> 元素支持系统画中画,需要将 allowsPictureInPictureMediaPlayback 设为 true,同时根据业务情况处理 allowsInlineMediaPlayback。例如在 iPad 上,如果希望视频在页面内播放而不是自动全屏,通常需要同时开启内联播放。iOS 14 之后苹果对画中画的支持更加稳定,但部分网页可能通过 JavaScript 禁用 PiP,需要在注入脚本中恢复。
系统 PiP 窗口的拖拽、缩放、关闭操作都运行在独立的系统进程中,应用层只能监听 AVPictureInPictureControllerDelegate 的开启、关闭、恢复等状态变化,而无法获取浮窗位置或手势事件。这带来一个明显限制:如果你需要边界重吸附、能量衰减、碰撞效果等自定义物理动画,系统 PiP 无法满足。实际项目中常见的做法是保留系统 PiP 作为后台能力,同时在应用内实现一个可拖拽的浮窗容器,两者根据状态切换。
import WebKit let configuration = WKWebViewConfiguration() configuration.allowsInlineMediaPlayback = true configuration.allowsPictureInPictureMediaPlayback = true configuration.mediaTypesRequiringUserActionForPlayback = [] let webView = WKWebView(frame: .zero, configuration: configuration)
上面的配置打开内联播放与 PiP,并把媒体类型限制清空,让视频可以在不触发用户手势的情况下准备播放。对于需要全局浮窗的场景,可以额外创建自定义 UIView,内部仍使用 WKWebView 播放视频,但浮窗拖拽逻辑完全由应用层控制。这种方案能获得完整的手势回调,也让后续的物理模拟得以实现。
边界能量守恒的物理建模
拖拽边界要模拟能量守恒,需要把窗口位置和速度抽象成状态变量。假设浮窗中心点的横坐标为 x,屏幕左右边界为 leftBound 和 rightBound。当窗口位于边界以内时,边界势能可以视为零;当窗口越过边界时,可以用一个线性或二次弹簧势能描述被推回的趋势。常见做法是采用胡克定律,势能为 U = 0.5 * k * d^2,其中 d 为越界距离,k 为边界弹性系数。
动能则与窗口质量 m 和速度 v 相关,表达式为 K = 0.5 * m * v^2。在没有任何阻尼的情况下,松手后动能会全部转化为边界势能,然后势能再转化为动能,窗口会沿着边界内外做等幅振荡。真实交互需要加入阻尼项,例如使用 damping 系数与速度成正比,让振荡逐渐衰减,最终稳定在边界或者容器中心。这个框架可以扩展到上下边界以及四角,计算时拆分为水平与垂直两个轴即可。
加速度由势能梯度、阻尼和外部手势力共同决定。对二次势能求导得到回复力 F = -k * d,再除以质量得到加速度。阻尼项可以写为 -damping * v。使用半隐式欧拉积分时先更新速度再更新位置,比显式欧拉更稳定,适合移动端 60fps 的刷新率。
struct BoundaryPhysics {
var position: CGFloat = 0
var velocity: CGFloat = 0
var mass: CGFloat = 1.0
var stiffness: CGFloat = 800.0
var damping: CGFloat = 20.0
mutating func update(dt: CGFloat, left: CGFloat, right: CGFloat) {
var force: CGFloat = 0
let halfWidth: CGFloat = 60
let minX = left + halfWidth
let maxX = right - halfWidth
if position < minX {
let d = minX - position
force += stiffness * d
} else if position > maxX {
let d = position - maxX
force -= stiffness * d
}
let acceleration = force / mass - damping * velocity
velocity += acceleration * dt
position += velocity * dt
}
}
这个模型只处理水平轴,实际浮窗需要同时处理垂直轴。将两个轴独立计算可以简化代码,但要注意屏幕旋转后边界值会变化。若窗口为圆形或带有圆角,边界判断还应考虑窗口尺寸和目标安全区。参数方面,stiffness 越大回弹越快、越接近生硬边界;damping 越大振荡越快消失,但过大会让窗口像掉进蜂蜜一样迟钝。建议从 800 和 20 开始,再根据真机手感微调。
手势驱动与 CADisplayLink 数值积分实现
应用内浮窗通常使用 UIPanGestureRecognizer 识别拖拽。手势状态为 .began 时暂停物理动画,避免和用户操作冲突;.changed 时根据 translation 直接更新浮窗位置,并根据时间差估算当前速度;.ended 时把估算速度写入物理模型,再启动 CADisplayLink 驱动后续运动。这样手指滑动过程中窗口完全跟手,松手后进入物理模拟阶段。
CADisplayLink 需要添加到 RunLoop 的 common mode,否则在滑动 ScrollView 或执行动画时可能暂停。每帧回调获取时间步长 dt,限制最大值例如 1/30 秒,避免应用切后台回来产生过大位移。每帧调用物理模型的 update 方法,把结果写回浮窗的 center,并判断速度与越界距离是否低于阈值,若满足则停止 displayLink 并把窗口吸附到最终位置。
class PiPWindow: UIView {
private var displayLink: CADisplayLink?
private var physics = BoundaryPhysics()
private let halfWidth: CGFloat = 60
func startPhysics() {
guard displayLink == nil else { return }
let link = CADisplayLink(target: self, selector: #selector(step))
link.add(to: .main, forMode: .common)
displayLink = link
}
@objc private func step(_ link: CADisplayLink) {
let dt = min(CGFloat(link.targetTimestamp - link.timestamp), 1.0 / 30.0)
guard let bounds = superview?.bounds else { return }
physics.position = center.x
physics.update(dt: dt, left: bounds.minX, right: bounds.maxX)
center.x = physics.position
let minX = bounds.minX + halfWidth
let maxX = bounds.maxX - halfWidth
var overshoot: CGFloat = 0
if center.x < minX {
overshoot = minX - center.x
} else if center.x > maxX {
overshoot = center.x - maxX
}
if abs(physics.velocity) < 0.5 && overshoot < 0.5 {
stopPhysics()
}
}
private func stopPhysics() {
displayLink?.invalidate()
displayLink = nil
}
}
上面代码只演示水平方向的步骤,实际项目需要补充垂直轴。可以用两个 BoundaryPhysics 实例分别管理 center.x 和 center.y,或者把状态扩展为 CGPoint 和 CGVector。手势结束后估算速度时,可以使用 velocity(in:) 获取手势在视图坐标系的即时速度,再除以一个时间系数,避免直接使用过大或过小的值。
相比之下,UIKit 的 UIDynamicAnimator 配合 UIAttachmentBehavior 或 UISnapBehavior 也能实现边界吸附,但难以精确控制能量守恒和阻尼曲线。自定义积分方案虽然代码稍多,却能透明地调节质量、弹性系数和阻尼,也方便把水平、垂直和斜向边界统一到同一套势能模型中。尤其在需要录制教学或调试工具时,可以直接导出每个时间步的速度与势能数据,观察能量转换是否符合预期。
参数调优、安全区适配与状态管理
浮窗在拖拽到边界时是否产生自然回弹,很大程度上取决于屏幕安全区和窗口尺寸。若使用 superview.bounds 作为边界,浮窗可能被刘海、状态栏或底部横条遮挡。更合适的做法是从 safeAreaLayoutGuide 读取 layoutFrame,把 minX、maxX 设置为安全区边界再减去窗口半宽。横竖屏切换时安全区会变化,应在 layoutSubviews 或 viewWillTransition(to:with:) 中更新边界参数,并暂停物理动画。
状态管理上可以定义一个简单枚举,包含 dragging、animating、settled 三种状态。拖拽开始时设置 dragging 并停止 displayLink;拖拽结束时写入速度并置为 animating;当速度与越界量都低于阈值时置为 settled。若用户在动画过程中再次触摸浮窗,应立即从物理模拟中接管位置,避免窗口跳变。这个细节在快速连续拖拽时很重要。
参数调节可以参考以下经验:质量 mass 影响整体响应,质量越大越难被推离边界;弹性系数 stiffness 控制边界硬软,过大容易产生肉眼可见的抖动;阻尼 damping 控制振荡衰减,太小时窗口会在边界附近来回摆动多次,太大则松手后像被吸住。可以先用竖直方向固定边界测试,观察窗口从越界位置松手后的回弹次数。通常回弹 1 到 2 次后平滑停止,是适合大多数视频浮窗的手感。
还有一点值得注意,如果浮窗内部仍然承载 WKWebView 视频播放,手势拖拽会与网页内的触摸事件产生冲突。需要在浮窗容器上设置 isUserInteractionEnabled 为 true,并对手势设置 cancelsTouchesInView = true,避免拖拽时误触网页播放按钮。若视频需要保持播放不中断,应确保手势只影响浮窗容器,不干扰内部 WKWebView 的媒体控件。