You need to enable JavaScript to run this app. iOS11.4下AVKit播放视频有声音无画面报错如何修复?
优惠活动
大模型
产品
解决方案
定价
更多

iOS11.4下AVKit播放视频有声音无画面报错如何修复?

问题根因排查
  • ATS配置缺失:你提供的测试链接中有2个为http协议,iOS9及以后系统默认开启ATS安全策略,禁止未加密的http请求,iOS11对该规则的校验更严格,报错中的-999错误码对应NSURLErrorCancelled,正是请求被ATS拦截后系统主动取消的特征。
  • Xcode 12.x 运行iOS11模拟器的已知兼容性bug:Xcode 12+在Big Sur系统上运行iOS11~12版本模拟器时,AVPlayer相关的视频渲染存在系统级问题,会出现有声音无画面、音频HAL模块报错的情况,该问题仅出现在模拟器,真机不受影响。
  • AVPlayerLayer布局时序问题:现有代码仅在viewDidAppear阶段设置一次AVPlayerLayer的frame,后续view尺寸发生变化时不会同步更新,低系统版本下容易出现layer尺寸异常导致画面不可见。
修复方案

1. 配置ATS权限

在项目的Info.plist中添加以下配置,允许http请求:

<key>NSAppTransportSecurity</key>
<dict>
    <key>NSAllowsArbitraryLoads</key>
    <true/>
    <!-- 更安全的方案是仅针对你业务用到的域名单独配置http例外 -->
</dict>

也可以直接将测试视频链接全部替换为https协议的地址,直接避开ATS校验。

2. 修复AVPlayerLayer布局逻辑

调整AVPlayerLayer的添加和布局代码,确保view尺寸变化时layer尺寸同步更新:

override func viewDidLoad() {
    super.viewDidLoad()
    setupVideoPlayer()
    // 提前初始化layer,不要等到viewDidAppear
    setupVideoPlayerView()
}

// 重写布局回调,同步更新layer尺寸
override func viewDidLayoutSubviews() {
    super.viewDidLayoutSubviews()
    videoPlayerLayer?.frame = videoPlayerView.bounds
}

private func setupVideoPlayerView() {
    guard let player = videoPlayer else { return }
    // 先移除旧layer,再添加新layer,避免layer层级混乱
    videoPlayerLayer?.removeFromSuperlayer()
    let playerLayer = AVPlayerLayer(player: player)
    playerLayer.videoGravity = .resizeAspect
    playerLayer.frame = videoPlayerView.bounds
    videoPlayerView.layer.addSublayer(playerLayer)
    videoPlayerLayer = playerLayer
}

override func viewDidAppear(_ animated: Bool) {
    super.viewDidAppear(animated)
    videoPlayer?.play()
 }

3. 模拟器问题适配

如果完成上述配置后iOS11模拟器仍然出现无画面问题,属于Xcode模拟器本身的bug,可通过以下方式验证功能正常:

  • 使用iOS11系统的真机运行测试,功能会正常工作
  • 开发阶段可暂时用iOS12+的模拟器做常规测试,仅用真机做iOS11版本的兼容验证
  • 若必须用iOS11模拟器测试,可切换到Xcode 11版本运行,即可正常渲染画面

内容的提问来源于stack exchange,提问作者Bawenang Rukmoko Pardian Putra

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.10.09 19:09:02