Diagram of AVPlayer, AVPlayerItem, and AVPlayerViewController

.

🎥 AVPlayer Architecture Diagram (Visual)

┌────────────────────────────┐
 │   AVPlayerViewController  │◄────────────┐
 │  (UI + Controls Layer)    │             │
 └────────────────────────────┘             │
         ▲                                  │ uses
         │ player                           │
 ┌────────────────────────────┐             │
 │         AVPlayer           │◄────────────┘
 │ (Playback Logic + Engine) │
 └────────────────────────────┘
         ▲
         │ currentItem
 ┌────────────────────────────┐
 │       AVPlayerItem         │
 │  (Represents a media file) │
 └────────────────────────────┘
         ▲
         │ url asset
 ┌────────────────────────────┐
 │     AVAsset / URLAsset     │
 └────────────────────────────┘

AVPlayer Stack

1. AVAsset / URLAsset

• What: Represents the actual media file (e.g., MP4, HLS stream).
• Role: Holds metadata (duration, resolution) and the media URL.

2. AVPlayerItem

• What: A playable instance of AVAsset.
• Role: Manages playback state (buffering, errors) for one media file.

3. AVPlayer

• What: The playback engine.
• Role: Controls play/pause/seek and handles timing. Needs an AVPlayerItem to work.

4. AVPlayerViewController

• What: Ready-made UI with controls (play button, timeline).
• Role: Displays video and sends user commands (e.g., play) to AVPlayer.

How They Work Together

Flow: URL → AVAsset → AVPlayerItem → AVPlayer → AVPlayerViewController

Key Points:

• One AVPlayer can swap AVPlayerItems (e.g., for playlists).
• AVPlayerViewController is optional (use AVPlayerLayer for custom UI).

let url = URL(string: "https://example.com/video.mp4")!  
let asset = AVAsset(url: url)  
let playerItem = AVPlayerItem(asset: asset)  
let player = AVPlayer(playerItem: playerItem)  
let playerVC = AVPlayerViewController()  
playerVC.player = player  
present(playerVC, animated: true)

This stack balances control (AVPlayer) and convenience (AVPlayerViewController).