MediaPipe iOS 端姿势检测的横屏适配优化

问题背景

在iOS平台上使用MediaPipe的Pose Landmarker（姿势关键点检测）解决方案时，开发者可能会遇到一个常见问题：当应用以横屏模式运行时，姿势检测系统会先尝试以竖屏方向进行检测，然后才切换到横屏模式。这个过程可能导致3-20秒的延迟，影响用户体验。

问题现象分析

具体表现为：

1. 当应用直接以横屏模式启动时，姿势检测会先在竖屏方向搜索用户姿势
2. 姿势覆盖层(overlay)最初会以水平方向显示，与设备实际方向不符
3. 经过一段时间后，系统才会正确切换到横屏检测模式

技术原理

MediaPipe的姿势检测模型在iOS平台上默认会考虑设备方向信息。当设备方向改变时，系统需要重新初始化检测参数，这导致了上述延迟现象。核心问题在于相机输入方向与模型期望方向的匹配。

解决方案

经过实践验证，可以通过以下方式优化横屏体验：

func didOutput(sampleBuffer: CMSampleBuffer, orientation: UIImage.Orientation) {
   let currentTimeMs = Date().timeIntervalSince1970 * 1000

   backgroundQueue.async { [weak self] in
       self?.poseLandmarkerService?.detectAsync(
           sampleBuffer: sampleBuffer,
           orientation: UIImage.Orientation.from(
               deviceOrientation: .faceUp),
           timeStamps: Int(currentTimeMs))
   }
 }

关键修改点：

1. 将设备方向参数固定设置为.faceUp
2. 这样姿势检测服务会始终以统一方向运行，避免方向切换带来的延迟

实现原理

这种解决方案之所以有效，是因为：

1. 固定方向消除了模型需要适应不同方向的额外计算
2. .faceUp方向提供了一个稳定的参考系
3. 避免了系统在竖屏和横屏模式间切换的开销

适用场景

此方案特别适合以下应用场景：

1. 需要始终以横屏模式运行的健身或运动分析应用
2. 对实时性要求较高的AR应用
3. 固定设备方向的kiosk系统

注意事项

开发者需要注意：

1. 此方案适用于固定横屏的应用，如果应用需要支持多方向，则需要采用其他策略
2. 可能需要根据实际场景调整姿势检测的灵敏度
3. 在极端情况下，固定方向可能会影响某些特殊姿势的检测精度

总结

通过固定设备方向参数，可以有效解决MediaPipe Pose Landmarker在iOS横屏模式下的初始化延迟问题。这种优化方案简单有效，特别适合固定方向的应用场景，能够显著提升用户体验和系统响应速度。