AVPlayer — βασικές έννοιες, δυνατότητες και χρήση

Τι είναι το AVPlayer;

AVPlayer — είναι το κεντρικό στοιχείο του πλαισίου AVFoundation, υπεύθυνο για την αναπαραγωγή πολυμεσικού περιεχομένου σε όλες τις πλατφόρμες Apple. Παρουσιάστηκε στο iOS 4.0 (2010) ως αντικατάσταση του ξεπερασμένου MPMoviePlayerController, το AVPlayer παρέχει έλεγχο χαμηλού επιπέδου στην αναπαραγωγή με δυνατότητα λεπτομερούς ρύθμισης παραμέτρων αποκωδικοποίησης, συγχρονισμού ήχου και βίντεο, καθώς και ενσωμάτωσης με υπηρεσίες συστήματος όπως το AirPlay και το Picture in Picture.

Σε αντίθεση με προγράμματα αναπαραγωγής τρίτων, το AVPlayer επωφελείται από την επιτάχυνση υλικού σε τσιπ Apple Silicon. Η αποκωδικοποίηση βίντεο γίνεται μέσω του VideoToolbox χρησιμοποιώντας αποκλειστικές μηχανές πολυμέσων της σειράς M (Media Engine), εξασφαλίζοντας αναπαραγωγή 8K HDR με ελάχιστη κατανάλωση ενέργειας. Για HEVC (H.265) και ProRes, η αποκωδικοποίηση πραγματοποιείται σε εξειδικευμένα μπλοκ του τσιπ, χωρίς να επιβαρύνει την CPU.

Το AVPlayer είναι στενά ενσωματωμένο με το οικοσύστημα Apple: υποστήριξη Handoff για μεταφορά αναπαραγωγής μεταξύ συσκευών, AirPlay 2 για ροή σε Apple TV, χωρικός ήχος με δυναμική παρακολούθηση κεφαλιού και συγχρονισμός με στοιχεία ελέγχου συστήματος μέσω MPNowPlayingInfoCenter. Αυτές οι ενσωματώσεις καθιστούν το AVPlayer de facto πρότυπο για όλες τις εφαρμογές που εργάζονται με πολυμέσα σε πλατφόρμες Apple.

AVFoundation και ιεραρχία κλάσεων

Το πλαίσιο AVFoundation παρέχει μια ιεραρχία τριών επιπέδων για αναπαραγωγή: AVAsset (μεταδεδομένα και πληροφορίες σχετικά με το περιεχόμενο), AVPlayerItem (κατάσταση και διαχείριση συγκεκριμένης παρουσίας περιεχομένου) και AVPlayer (διαχείριση αναπαραγωγής). Αυτή η αρχιτεκτονική επιτρέπει τον διαχωρισμό της φόρτωσης μεταδεδομένων, της προετοιμασίας για αναπαραγωγή και της ίδιας της διαδικασίας αναπαραγωγής, κάτι που είναι ιδιαίτερα σημαντικό για ροές HLS με πολλαπλές παραλλαγές bitrate.

AVAsset αντιπροσωπεύει ένα μοντέλο πολυμεσικού περιεχομένου — αρχείου ή ροής. Το AVAsset δεν είναι από μόνο του αναπαραγώγιμο; περιέχει κομμάτια (AVAssetTrack), μεταδεδομένα (commonMetadata), πληροφορίες διάρκειας και άλλα χαρακτηριστικά. Από το AVAsset δημιουργείται το AVPlayerItem, το οποίο μπορεί στη συνέχεια να μεταδοθεί στο AVPlayer για αναπαραγωγή.

Βασικές δυνατότητες του AVPlayer

AVPlayer παρέχει ένα σύνολο δυνατοτήτων που καλύπτουν τα περισσότερα σενάρια αναπαραγωγής — από απλή αναπαραγωγή αρχείου έως σύνθετες ζωντανές μεταδόσεις με DRM. Ας εξετάσουμε τις βασικές λειτουργίες με παραδείγματα εφαρμογής.

Υποστήριξη HLS και προσαρμοστική εναλλαγή

AVPlayer έχει εγγενή υποστήριξη για HLS χωρίς την ανάγκη εγκατάστασης πρόσθετων βιβλιοθηκών. Κατά την αναπαραγωγή ροής HLS, το AVPlayer διαχειρίζεται αυτόματα την προσαρμοστική εναλλαγή bitrate χρησιμοποιώντας τον ενσωματωμένο αλγόριθμο ABR βελτιστοποιημένο για πλατφόρμες Apple. Ο αλγόριθμος λαμβάνει υπόψη όχι μόνο το εύρος ζώνης δικτύου, αλλά και τη θερμική κατάσταση της συσκευής — σε υπερθέρμανση, το AVPlayer μπορεί να μειώσει το bitrate για να ελαφρύνει το φορτίο του επεξεργαστή.

Για ροές HLS με FairPlay Streaming, το AVPlayer διαχειρίζεται αυτόματα τη λήψη και ανανέωση αδειών μέσω του εκπροσώπου AVContentKeySession. Ο προγραμματιστής πρέπει να υλοποιήσει το πρωτόκολλο AVContentKeySessionDelegate, το οποίο καλείται από το πρόγραμμα αναπαραγωγής όταν χρειάζεται να λάβει ή να ανανεώσει ένα κλειδί αποκρυπτογράφησης. Αυτός είναι ο μόνος τρόπος προστασίας περιεχομένου HLS σε πλατφόρμες Apple, καθώς το Widevine δεν υποστηρίζεται σε iOS.

Picture in Picture

PiP — λειτουργία που επιτρέπει στον χρήστη να συνεχίσει την παρακολούθηση βίντεο σε πλωτό παράθυρο κατά την εναλλαγή μεταξύ εφαρμογών. Σε iPad και iPhone (iOS 14+) το AVPlayer ενσωματώνεται με το AVPictureInPictureController για ενεργοποίηση αυτής της λειτουργίας. Σε macOS 15+ το PiP είναι επίσης διαθέσιμο, αλλά ενεργοποιείται μέσω του μενού συστήματος ή ενός κουμπιού στο παράθυρο του προγράμματος αναπαραγωγής.

Πώς να χρησιμοποιήσετε το AVPlayer σε εφαρμογή iOS

Η ενσωμάτωση του AVPlayer σε εφαρμογή iOS μπορεί να γίνει με δύο τρόπους: μέσω του υψηλού επιπέδου AVPlayerViewController (για τυπικά σενάρια) ή απευθείας μέσω AVPlayer + AVPlayerLayer (για πλήρη προσαρμογή διεπαφής). Ας εξετάσουμε και τις δύο προσεγγίσεις σε Swift.

Ενσωμάτωση μέσω AVPlayerViewController

AVPlayerViewController — ένα έτοιμο στοιχείο UI που παρέχει ενσωματωμένα στοιχεία ελέγχου: play/pause, αναδίπλωση, ένταση, AirPlay, PiP και λειτουργία πλήρους οθόνης. Η ελάχιστη ενσωμάτωση απαιτεί μόνο λίγες γραμμές κώδικα: δημιουργία παρουσίας AVPlayer, μεταφορά της στο AVPlayerViewController και εμφάνιση του ελεγκτή στην οθόνη.

import AVKit

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 controller = AVPlayerViewController()
controller.player = player
controller.allowsPictureInPicturePlayback = true

present(controller, animated: true) {
    player.play()
}

Απευθείας ενσωμάτωση μέσω AVPlayerLayer

Για εφαρμογές με προσαρμοσμένο UI, χρησιμοποιήστε το AVPlayerLayer — ένα επίπεδο Core Animation που αποδίδει βίντεο μέσα σε οποιοδήποτε UIView. Αυτή η προσέγγιση παρέχει πλήρη έλεγχο της διεπαφής: μπορείτε να προσθέσετε τα δικά σας στοιχεία ελέγχου, κινούμενα σχέδια και επιπλέον επίπεδα πάνω από το βίντεο.

class VideoPlayerView: UIView {

    var player: AVPlayer? {
        get { (layer as! AVPlayerLayer).player }
        set { (layer as! AVPlayerLayer).player = newValue }
    }

    override class var layerClass: AnyClass {
        AVPlayerLayer.self
    }
}

// Χρήση:
let playerView = VideoPlayerView(frame: view.bounds)
playerView.player = AVPlayer(url: url)
view.addSubview(playerView)

Διαχείριση κύκλου ζωής AVPlayer

Η σωστή διαχείριση του κύκλου ζωής του προγράμματος αναπαραγωγής είναι κρίσιμη για τη σταθερότητα της εφαρμογής. Το AVPlayer πρέπει να δημιουργείται όταν εμφανίζεται η οθόνη και να απελευθερώνεται όταν κλείνει. Όταν η εφαρμογή μεταβαίνει στο παρασκήνιο, συνιστάται η παύση της αναπαραγωγής για εξοικονόμηση πόρων και αποφυγή κυρώσεων του App Review για αναπαραγωγή στο παρασκήνιο χωρίς προφανή ανάγκη.

AVPlayerLayer και εμφάνιση βίντεο

AVPlayerLayer — είναι ένα επίπεδο Core Animation, που κληρονομεί από το CALayer, το οποίο παρέχει απόδοση βίντεο στην οθόνη. Σε αντίθεση με το UIView, το AVPlayerLayer λειτουργεί απευθείας με την GPU μέσω Metal ή OpenGL, εξασφαλίζοντας ελάχιστη καθυστέρηση εξόδου καρέ. Η κατανόηση της λειτουργίας του AVPlayerLayer είναι απαραίτητη για την υλοποίηση προσαρμοσμένων διεπαφών αναπαραγωγής.

Διαμόρφωση videoGravity

Η ιδιότητα videoGravity καθορίζει πώς το βίντεο προσαρμόζεται στα όρια του επιπέδου. AVLayerVideoGravity.resizeAspect (διατήρηση αναλογίας διαστάσεων με μαύρες λωρίδες) — η προεπιλεγμένη τιμή για το AVPlayerViewController. resizeAspectFill (γέμισμα ολόκληρης της οθόνης με περικοπή) χρησιμοποιείται για λειτουργία πλήρους οθόνης. resize (παραμόρφωση αναλογίας διαστάσεων στο μέγεθος του επιπέδου) εφαρμόζεται σπάνια, κυρίως για αναλυτικές εφαρμογές.

Συγχρονισμός με το κύριο νήμα

AVPlayerLayer αποδίδει βίντεο σε πραγματικό χρόνο, αλλά όλες οι λειτουργίες με το πρόγραμμα αναπαραγωγής (start, pause, seek) πρέπει να εκτελούνται στο κύριο νήμα. Οι βασικές τιμές για παρατήρηση — timeControlStatus, rate, status και error — παρακολουθούνται μέσω KVO (Key-Value Observing) ή του σύγχρονου async/await API, που παρουσιάστηκε στο iOS 16 μέσω μεθόδων AVPlayer με υποστήριξη Swift Concurrency.

let player = AVPlayer(url: url)
let statusObservation = player.observe(
    \.status,
    options: [.new, .initial]
) { player, _ in
    switch player.status {
    case .readyToPlay:
        player.play()
    case .failed:
        handleError(player.error)
    default:
        break
    }
}

Υποστήριξη υποτίτλων και εναλλακτικών κομματιών

AVPlayer υποστηρίζει ενσωματωμένους υπότιτλους σε μορφές VTT, CEA-608 και ITT (iTunes Timed Text). Η επιλογή κομματιού ήχου και υποτίτλων γίνεται μέσω AVMediaSelectionGroup και AVMediaSelectionOption. Οι ρυθμίσεις υποτίτλων χρήστη (γραμματοσειρά, μέγεθος, χρώμα) διαβάζονται από τις ρυθμίσεις προσβασιμότητας συστήματος και εφαρμόζονται αυτόματα στο AVPlayerLayer, εάν δεν ορίζονται ρητά στον κώδικα.

Διαχείριση αναπαραγωγής και προηγμένα σενάρια

Για εφαρμογές παραγωγής, η βασική ενσωμάτωση του AVPlayer συχνά απαιτεί πρόσθετη διαμόρφωση: προσωρινή αποθήκευση τμημάτων HLS, εργασία με FairPlay DRM, ενσωμάτωση με το σύστημα «Now Playing» και υλοποίηση προσαρμοσμένων αλγορίθμων επιλογής bitrate.

Προσωρινή αποθήκευση HLS μέσω AVAssetResourceLoader

AVAssetResourceLoader — ο μόνος τρόπος αναχαίτισης της φόρτωσης τμημάτων HLS και υλοποίησης προσωρινής αποθήκευσης. Ο εκπρόσωπος AVAssetResourceLoaderDelegate λαμβάνει αιτήματα φόρτωσης κλειδιών και τμημάτων, επιτρέποντας την τοπική αποθήκευσή τους και την επιστροφή από την προσωρινή μνήμη σε επαναλαμβανόμενα αιτήματα. Αυτό είναι ιδιαίτερα χρήσιμο για εφαρμογές που λειτουργούν σε συνθήκες ασταθούς δικτύου.

let asset = AVURLAsset(url: hlsURL)
asset.resourceLoader.setDelegate(
    resourceLoaderDelegate,
    queue: DispatchQueue(label: "com.app.resourceloader")
)
let playerItem = AVPlayerItem(asset: asset)

FairPlay Streaming — ενσωμάτωση DRM

FairPlay Streaming (FPS) — το πρότυπο Apple για προστασία περιεχομένου HLS. Για την ενσωμάτωση FPS πρέπει να υλοποιηθεί το πρωτόκολλο AVContentKeySessionDelegate, το οποίο χειρίζεται αιτήματα λήψης κλειδιών αποκρυπτογράφησης. Η διαδικασία περιλαμβάνει: λήψη SPC (Server Playback Context) από το πρόγραμμα αναπαραγωγής, αποστολή στον διακομιστή άδειας, λήψη CKC (Content Key Context) και επιστροφή του στο AVContentKeySession.

class DRMDelegate: NSObject, AVContentKeySessionDelegate {

    func contentKeySession(
        _ session: AVContentKeySession,
        didProvide keyRequest: AVContentKeyRequest
    ) {
        // 1. Λήψη SPC από το keyRequest
        // 2. Αποστολή SPC στον διακομιστή άδειας
        // 3. Λήψη CKC και μεταφορά στο keyRequest.processContentKeyResponse
    }
}

Now Playing και στοιχεία ελέγχου συστήματος

Για εμφάνιση πληροφοριών σχετικά με την τρέχουσα αναπαραγωγή στην οθόνη κλειδώματος, το Κέντρο Ελέγχου και το Apple Watch, χρησιμοποιείται το MPNowPlayingInfoCenter από το MediaPlayer.framework. Το AVPlayer δεν ενημερώνει αυτόματα το Now Playing — ο προγραμματιστής πρέπει να ορίζει χειροκίνητα τα μεταδεδομένα (τίτλος, καλλιτέχνης, εξώφυλλο, πρόοδος) κατά την αλλαγή της κατάστασης αναπαραγωγής. Για ενημέρωση της προόδου, χρησιμοποιείται τακτικό χρονόμετρο ή observe(\.timeControlStatus).

Remote Command Center — μια άλλη υπηρεσία συστήματος που επιτρέπει τον έλεγχο της αναπαραγωγής από την κλειδωμένη οθόνη, τα AirPods και το CarPlay. Το MPRemoteCommandCenter καταγράφει χειριστές για τις εντολές play, pause, nextTrack, previousTrack, changePlaybackPosition και skipForward/skipBackward. Το AVPlayer δεν επεξεργάζεται αυτές τις εντολές αυτόματα — ο προγραμματιστής πρέπει να τις συνδέσει με κλήσεις player.play(), player.pause() και player.seek().