macOS SwiftUI应用添加循环播放视频失败，求技术排查

你的代码里存在几个核心问题，导致循环视频无法正常播放，以下是具体问题分析和修复后的完整代码：

问题分析 #

1. 播放器实例管理不当：用@State持有AVQueuePlayer（引用类型）会导致SwiftUI在视图刷新时意外重置播放器，破坏循环逻辑。
2. 未处理视图更新：PlayerView的updateNSView是空实现，当传入的videoName变化时，无法切换或重新加载视频。
3. 循环器初始化逻辑缺陷：每次创建LoopingPlayerUIView时直接添加新的playerLooper，未清理旧资源，会引发播放冲突。

修复后的完整代码 #

1. 播放器管理器（统一生命周期） #

import SwiftUI
import AVFoundation

// 用ObservableObject托管播放器，确保生命周期稳定
class VideoPlayerManager: ObservableObject {
    let player = AVQueuePlayer()
    private var playerLooper: AVPlayerLooper?
    
    func setupLoop(for videoName: String) {
        // 清除旧的循环器和播放项
        player.removeAllItems()
        playerLooper = nil
        
        guard let fileUrl = Bundle.main.url(forResource: videoName, withExtension: "mp4") else {
            print("找不到视频文件：\(videoName).mp4")
            return
        }
        let asset = AVAsset(url: fileUrl)
        let item = AVPlayerItem(asset: asset)
        
        player.isMuted = true
        playerLooper = AVPlayerLooper(player: player, templateItem: item)
    }
}

struct VideoTutorialView: View {
    @StateObject private var playerManager = VideoPlayerManager()
    let videoName: String
    
    var body: some View {
        PlayerView(videoName: videoName, playerManager: playerManager)
            .aspectRatio(16/9, contentMode: .fill)
            .frame(height: 140)
            .background(Color.gray.opacity(0.3))
            .cornerRadius(.roundedCorner)
            .onAppear {
                playerManager.player.play()
            }
            .onDisappear {
                playerManager.player.pause()
            }
            .onReceive(NotificationCenter.default.publisher(for: NSApplication.willResignActiveNotification)) { _ in
                playerManager.player.pause()
            }
            .onReceive(NotificationCenter.default.publisher(for: NSApplication.didBecomeActiveNotification)) { _ in
                playerManager.player.play()
            }
    }
}

2. NSViewRepresentable 视图（处理更新） #

struct PlayerView: NSViewRepresentable {
    let videoName: String
    let playerManager: VideoPlayerManager
    
    func makeNSView(context: Context) -> LoopingPlayerUIView {
        let view = LoopingPlayerUIView(player: playerManager.player)
        view.setupLoop(for: videoName)
        return view
    }
    
    func updateNSView(_ nsView: LoopingPlayerUIView, context: Context) {
        // 当videoName变化时，重新设置循环播放
        nsView.setupLoop(for: videoName)
    }
}

3. 底层播放视图（资源清理） #

class LoopingPlayerUIView: NSView {
    private let playerLayer = AVPlayerLayer()
    private let player: AVQueuePlayer
    private var playerLooper: AVPlayerLooper?
    
    required init?(coder: NSCoder) {
        fatalError("init(coder:) has not been implemented")
    }
    
    init(player: AVQueuePlayer, videoGravity: AVLayerVideoGravity = .resizeAspectFill) {
        self.player = player
        super.init(frame: .zero)
        
        player.isMuted = true
        playerLayer.player = player
        playerLayer.videoGravity = videoGravity
        layer?.addSublayer(playerLayer)
    }
    
    func setupLoop(for videoName: String) {
        // 清理旧资源，避免冲突
        player.removeAllItems()
        playerLooper = nil
        
        guard let fileUrl = Bundle.main.url(forResource: videoName, withExtension: "mp4") else {
            print("找不到视频文件：\(videoName).mp4")
            return
        }
        let asset = AVAsset(url: fileUrl)
        let item = AVPlayerItem(asset: asset)
        
        playerLooper = AVPlayerLooper(player: player, templateItem: item)
        player.play() // 确保重新设置后自动播放
    }
    
    override func layout() {
        super.layout()
        playerLayer.frame = bounds
    }
}

修复关键点 #

• 稳定的播放器生命周期：用@StateObject+ObservableObject托管播放器，避免SwiftUI意外重置实例。
• 响应视图更新：在updateNSView中处理videoName变化，自动切换视频。
• 资源清理机制：每次设置新循环前清除旧的播放项和循环器，防止冲突和内存泄漏。
• 调试日志：添加了视频文件查找失败的日志，方便定位资源问题。

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