AVPlayer加载HLS(.m3u8)真机失效、模拟器正常，求解决方案

Hey there, let's tackle this HLS playback issue on physical iOS devices together! I've run into similar headaches before, so here are some actionable, tested fixes to get your CameraView working on real hardware:

Fix 1: Verify App Transport Security (ATS) Settings #

Physical devices enforce ATS far more strictly than simulators. If your .m3u8 stream uses HTTP (not HTTPS), you’ll need to adjust your app’s ATS policies in Info.plist:

<key>NSAppTransportSecurity</key>
<dict>
    <!-- Quick fix (not ideal for production) -->
    <key>NSAllowsArbitraryLoads</key>
    <true/>
    
    <!-- Recommended: Domain-specific exception for better security -->
    <key>NSExceptionDomains</key>
    <dict>
        <key>your-stream-domain.com</key>
        <dict>
            <key>NSIncludesSubdomains</key>
            <true/>
            <key>NSTemporaryExceptionAllowsInsecureHTTPLoads</key>
            <true/>
        </dict>
    </dict>
</dict>

Pro tip: Stick to domain exceptions in production to avoid compromising your app’s security.

Fix 2: Properly Initialize & Monitor AVPlayerItem #

Simulators often handle lazy resource loading more forgivingly. On real devices, you need to explicitly wait for the player item to be ready before starting playback:

// Add this to your CameraView or TableViewCell setup logic
func setupPlayer(with streamURL: URL) {
    let playerItem = AVPlayerItem(url: streamURL)
    
    // Async load critical playback properties
    playerItem.loadValuesAsynchronously(forKeys: ["playbackLikelyToKeepUp"]) { [weak self] in
        DispatchQueue.main.async {
            guard let self = self else { return }
            var loadError: NSError?
            let loadStatus = playerItem.statusOfValue(forKey: "playbackLikelyToKeepUp", error: &loadError)
            
            if loadStatus == .loaded && playerItem.playbackLikelyToKeepUp {
                self.player = AVPlayer(playerItem: playerItem)
                self.player?.play()
            } else {
                print("Playback load failed: \(loadError?.localizedDescription ?? "Unknown error")")
            }
        }
    }
}

// Clean up observers in deinit to avoid crashes
deinit {
    player?.currentItem?.removeObserver(self, forKeyPath: "status")
}

Fix 3: Handle TableView Cell Reuse Correctly #

Cell reuse is a common culprit for player issues on physical devices. When a cell gets reused, you need to reset the CameraView’s player to prevent memory leaks or broken playback:

// In your TableViewCell subclass
override func prepareForReuse() {
    super.prepareForReuse()
    cameraView.player?.pause()
    cameraView.player = nil
}

Also, always stop any existing playback in a cell before configuring it with a new stream URL.

Fix 4: Ensure AVPlayerLayer Fits Its Container #

Physical devices sometimes have layout quirks simulators don’t. Make sure your AVPlayerLayer always matches the CameraView bounds:

// In your CameraView class
override func layoutSubviews() {
    super.layoutSubviews()
    playerLayer.frame = self.bounds
    // Adjust video gravity to match your UI needs
    playerLayer.videoGravity = .resizeAspect
}

Fix 5: Validate Your HLS Stream #

Some .m3u8 streams use codecs or segment configurations that don’t work on iOS devices. Use Apple’s built-in mediastreamvalidator tool to check your stream:

mediastreamvalidator https://your-stream-url.m3u8

This tool will flag issues like unsupported H.264 profiles, incorrect segment durations, or missing metadata that might break playback on real hardware.

Start with ATS and cell reuse fixes—those are the most common causes of this exact issue. Let me know if you need help troubleshooting any of these steps!

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