tvOS中SwiftUI VideoPlayer默认控件不显示及播放器未显示问题求助

一、修改现有代码调出控件并显示播放器 #

tvOS的VideoPlayer默认不会自动展示播放控件，且需要明确布局约束才能在屏幕上显示，可通过以下两种方式调整：

1. 用AVPlayerViewController包装（推荐）
   tvOS上SwiftUI原生VideoPlayer对控件的支持有限，直接使用AVPlayerViewController并通过UIViewControllerRepresentable包装到SwiftUI中，能更好地控制控件显示：

import SwiftUI
import AVKit

struct TVVideoPlayer: UIViewControllerRepresentable {
    let player: AVPlayer
    
    func makeUIViewController(context: Context) -> AVPlayerViewController {
        let vc = AVPlayerViewController()
        vc.player = player
        // 强制开启播放控件（tvOS默认隐藏）
        vc.showsPlaybackControls = true
        // 设置视频填充模式
        vc.videoGravity = .resizeAspectFill
        return vc
    }
    
    func updateUIViewController(_ uiViewController: AVPlayerViewController, context: Context) {}
}

struct ContentView: View {
    private let player = AVPlayer(url: URL(string: "https://bitdash-a.akamaihd.net/content/sintel/hls/playlist.m3u8")!)
    
    var body: some View {
        TVVideoPlayer(player: player)
            .edgesIgnoringSafeArea(.all) // 让播放器占满屏幕
    }
}

2. 直接调整SwiftUI VideoPlayer布局
   若不想依赖UIKit包装，可给VideoPlayer添加尺寸约束，并通过playbackControls修饰符指定控件样式：

struct ContentView: View {
    private let player = AVPlayer(url: URL(string: "https://bitdash-a.akamaihd.net/content/sintel/hls/playlist.m3u8")!)
    
    var body: some View {
        VideoPlayer(player: player)
            .playbackControls(.hidden, playbackMode: .volumeOverlay) // 切换控件显示模式
            .frame(maxWidth: .infinity, maxHeight: .infinity)
            .edgesIgnoringSafeArea(.all)
    }
}

这种方式的控件样式相对简单，适合轻量需求场景。

二、tvOS可用的其他视频播放器选项 #

如果需要更多自定义功能，除系统AVKit外，还有以下选择：

• AVFoundation手动封装：基于AVPlayerLayer自行构建播放器界面，完全自定义控件逻辑，适合高度定制的场景。
• 第三方库：比如JWPlayer、Brightcove Player的tvOS版本，这些库提供了更完善的tvOS适配和丰富的播放控件，但需要引入第三方依赖。

关键注意点 #

• tvOS交互逻辑和iOS不同，播放控件默认隐藏，需手动设置showsPlaybackControls = true强制显示，或通过遥控器操作唤起。
• 播放器必须设置明确的布局约束（如frame(maxWidth: .infinity, maxHeight: .infinity)），否则会因无尺寸设置而不显示。

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