SwiftUI：AVPlayer在视频未启动时不显示控件的问题求助

问题核心 #

你用SwiftUI的LazyVStack加载多段视频时，原生VideoPlayer默认只会在视频播放状态下显示控件，暂停/未播放时控件会隐藏，仅靠初始化后调用player.pause()无法触发控件显示。

解决方案：用AVPlayerViewController桥接实现强制控件显示 #

直接用UIKit的AVPlayerViewController（通过UIViewRepresentable桥接到SwiftUI），可以强制开启播放控件，无论视频是否处于播放状态。

1. 编写视频控件包装器

import SwiftUI
import AVKit

struct PersistentControlsVideoPlayer: UIViewRepresentable {
    let videoURL: URL
    
    func makeUIView(context: Context) -> AVPlayerViewController {
        // 初始化播放器并暂停
        let player = AVPlayer(url: videoURL)
        player.pause()
        
        let playerVC = AVPlayerViewController()
        playerVC.player = player
        // 强制显示播放控件
        playerVC.showsPlaybackControls = true
        // 设置视频适配模式
        playerVC.videoGravity = .resizeAspect
        
        // 提前加载少量缓冲，确保控件正常渲染
        player.currentItem?.preferredForwardBufferDuration = 1
        
        return playerVC
    }
    
    func updateUIView(_ uiView: AVPlayerViewController, context: Context) {}
}

2. 在LazyVStack中使用

struct VideoListView: View {
    // 替换成你的视频URL列表
    let videoUrls: [String] = ["https://example.com/video1.mp4", "https://example.com/video2.mp4"]
    
    var body: some View {
        ScrollView {
            LazyVStack(spacing: 16) {
                ForEach(videoUrls, id: \.self) { urlStr in
                    if let url = URL(string: urlStr) {
                        PersistentControlsVideoPlayer(videoURL: url)
                            .frame(height: 220)
                            .cornerRadius(12)
                            .shadow(radius: 4)
                    }
                }
            }
            .padding(.horizontal)
        }
    }
}

关键说明 #

• 原生VideoPlayer的控件显示逻辑绑定播放状态，而AVPlayerViewController的showsPlaybackControls属性可以强制控件始终显示
• 初始化后暂停播放器，同时设置少量缓冲加载，能确保控件在未播放状态下正常渲染
• 完全适配LazyVStack的懒加载特性，不会提前加载所有视频内容

内容的提问来源于stack exchange，提问作者Eduard Unruh