AVPlayer — kulcsfogalmak, lehetőségek és használat

Mi az AVPlayer?

AVPlayer — az AVFoundation keretrendszer központi összetevője, amely a multimédiás tartalmak lejátszásáért felelős az összes Apple platformon. Az iOS 4.0-ban (2010) bevezetve az elavult MPMoviePlayerController helyettesítéseként, az AVPlayer alacsony szintű vezérlést biztosít a lejátszás felett a dekódolási paraméterek finomhangolásának, az audio és video szinkronizálásának, valamint az olyan rendszerszolgáltatásokkal való integrációnak a lehetőségével, mint az AirPlay és a Picture in Picture.

Ellentétben a harmadik féltől származó lejátszókkal, az AVPlayer élvezi a hardveres gyorsítás előnyeit az Apple Silicon chipeken. A videó dekódolás a VideoToolbox-on keresztül történik az M-sorozat dedikált médiamotorjainak (Media Engine) használatával, ami 8K HDR lejátszást biztosít minimális energiafogyasztás mellett. A HEVC (H.265) és ProRes esetében a dekódolás a chip specializált blokkjain történik, anélkül hogy terhelné a CPU-t.

Az AVPlayer szorosan integrálódik az Apple ökoszisztémába: Handoff támogatás a lejátszás eszközök közötti átviteléhez, AirPlay 2 az Apple TV-re történő streameléshez, térbeli hang dinamikus fejkövetéssel és szinkronizálás a rendszer vezérlőelemeivel az MPNowPlayingInfoCenter-en keresztül. Ezek az integrációk teszik az AVPlayer-t de facto szabvánnyá minden olyan alkalmazás számára, amely médiával dolgozik az Apple platformokon.

AVFoundation és osztályhierarchia

Az AVFoundation keretrendszer háromszintű hierarchiát biztosít a lejátszáshoz: AVAsset (metaadatok és információk a tartalomról), AVPlayerItem (állapot és egy adott tartalom példányának kezelése) és AVPlayer (lejátszás kezelése). Ez az architektúra lehetővé teszi a metaadatok betöltésének, a lejátszásra való felkészülésnek és magának a lejátszási folyamatnak a szétválasztását, ami különösen fontos a több bitsebesség-változattal rendelkező HLS streamek esetében.

AVAsset a médiatartalom — fájl vagy stream — modelljét képviseli. Az AVAsset önmagában nem játszható le; trackeket (AVAssetTrack), metaadatokat (commonMetadata), időtartam információkat és egyéb jellemzőket tartalmaz. Az AVAsset-ből létrehozzák az AVPlayerItem-et, amely aztán átadható az AVPlayer-nek lejátszásra.

Az AVPlayer fő lehetőségei

AVPlayer olyan lehetőségek készletét kínálja, amelyek a lejátszási forgatókönyvek többségét lefedik — az egyszerű fájllejátszástól a DRM-mel ellátott összetett élő közvetítésekig. Vizsgáljuk meg a kulcsfontosságú funkciókat alkalmazási példákkal.

HLS támogatás és adaptív váltás

AVPlayer natív támogatással rendelkezik a HLS-hez anélkül, hogy további könyvtárakat kellene telepíteni. HLS stream lejátszásakor az AVPlayer automatikusan kezeli az adaptív bitsebesség váltást a beépített, Apple platformokra optimalizált ABR algoritmus segítségével. Az algoritmus nemcsak a hálózati sávszélességet veszi figyelembe, hanem az eszköz termikus állapotát is — túlmelegedés esetén az AVPlayer csökkentheti a bitsebességet a processzor terhelésének csökkentése érdekében.

A FairPlay Streaming rendszerrel ellátott HLS streamek esetében az AVPlayer automatikusan kezeli a licencek beszerzését és megújítását az AVContentKeySession delegátuson keresztül. A fejlesztőnek implementálnia kell az AVContentKeySessionDelegate protokollt, amelyet a lejátszó hív meg, amikor dekódoló kulcsot kell beszerezni vagy megújítani. Ez az egyetlen módja a HLS tartalom védelmének az Apple platformokon, mivel a Widevine nem támogatott iOS-en.

Picture in Picture

PiP — olyan mód, amely lehetővé teszi a felhasználó számára, hogy folytassa a videó nézését egy lebegő ablakban az alkalmazások közötti váltás közben. iPaden és iPhone-on (iOS 14+) az AVPlayer az AVPictureInPictureControllerrel integrálódik a mód aktiválásához. macOS 15+ rendszeren a PiP szintén elérhető, de a rendszermenün vagy a lejátszó ablakában lévő gombon keresztül aktiválódik.

Az AVPlayer használata iOS alkalmazásban

Az AVPlayer integrálása egy iOS alkalmazásba kétféleképpen történhet: a magas szintű AVPlayerViewController-en keresztül (tipikus forgatókönyvekhez) vagy közvetlenül az AVPlayer + AVPlayerLayer-en keresztül (a felület teljes testreszabásához). Vizsgáljuk meg mindkét megközelítést Swift-ben.

Integráció AVPlayerViewController-en keresztül

AVPlayerViewController — egy kész UI komponens, amely beépített vezérlőelemeket biztosít: play/pause, visszatekerés, hangerő, AirPlay, PiP és teljes képernyős mód. A minimális integráció csak néhány sornyi kódot igényel: AVPlayer példány létrehozása, átadása az AVPlayerViewController-nek és a vezérlő megjelenítése a képernyőn.

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()
}

Közvetlen integráció AVPlayerLayer-en keresztül

Egyedi felületű alkalmazásokhoz használja az AVPlayerLayer — egy Core Animation réteget, amely bármely UIView-en belül rendereli a videót. Ez a megközelítés teljes ellenőrzést biztosít a felület felett: saját vezérlőelemeket, animációkat és további rétegeket adhat hozzá a videó fölé.

class VideoPlayerView: UIView {

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

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

// Használat:
let playerView = VideoPlayerView(frame: view.bounds)
playerView.player = AVPlayer(url: url)
view.addSubview(playerView)

Az AVPlayer életciklusának kezelése

A lejátszó életciklusának helyes kezelése kritikus fontosságú az alkalmazás stabilitása szempontjából. Az AVPlayer-t a képernyő megjelenésekor kell létrehozni és annak bezárásakor felszabadítani. Amikor az alkalmazás háttérbe kerül, ajánlott szüneteltetni a lejátszást az erőforrások megtakarítása és az App Review büntetések elkerülése érdekében, amelyek a háttérben történő, nyilvánvaló szükség nélküli lejátszásért járnak.

AVPlayerLayer és videó megjelenítése

AVPlayerLayer — egy Core Animation réteg, amely a CALayer-ből származik, és a videó képernyőn történő megjelenítését biztosítja. Ellentétben a UIView-val, az AVPlayerLayer közvetlenül a GPU-val dolgozik a Metal vagy OpenGL segítségével, minimális képkocka kimeneti késleltetést biztosítva. Az AVPlayerLayer működésének megértése szükséges az egyedi lejátszási felületek implementálásához.

videoGravity konfigurálása

A videoGravity tulajdonság határozza meg, hogy a videó hogyan illeszkedik a réteg határaihoz. AVLayerVideoGravity.resizeAspect (képarány megtartása fekete sávokkal) — az alapértelmezett érték az AVPlayerViewController számára. A resizeAspectFill (a teljes képernyő kitöltése vágással) a teljes képernyős módhoz használatos. A resize (képarány torzítása a réteg méretéhez) ritkán alkalmazott, főleg analitikai alkalmazásokban.

Szinkronizálás a fő szállal

AVPlayerLayer valós időben rendereli a videót, de a lejátszóval végzett összes műveletet (start, pause, seek) a fő szálon kell végrehajtani. A megfigyelés kulcsértékei — timeControlStatus, rate, status és error — KVO-n (Key-Value Observing) vagy a modern async/await API-n keresztül követhetők, amelyet az iOS 16-ban vezettek be az AVPlayer metódusaival, Swift Concurrency támogatással.

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
    }
}

Feliratok és alternatív trackek támogatása

AVPlayer támogatja a beépített feliratokat VTT, CEA-608 és ITT (iTunes Timed Text) formátumokban. Az audio track és a feliratok kiválasztása az AVMediaSelectionGroup és AVMediaSelectionOption segítségével történik. A felhasználói feliratbeállítások (betűtípus, méret, szín) a rendszer Accessibility beállításaiból olvasódnak ki, és automatikusan alkalmazódnak az AVPlayerLayer-re, ha a kódban nincsenek kifejezetten meghatározva.

Lejátszás kezelése és haladó forgatókönyvek

Termelési alkalmazások esetében az AVPlayer alapintegrációja gyakran további konfigurációt igényel: HLS szegmensek gyorsítótárazása, FairPlay DRM-mel való munka, integráció a „Now Playing" rendszerrel és egyedi bitsebesség kiválasztási algoritmusok implementálása.

HLS gyorsítótárazás AVAssetResourceLoader segítségével

AVAssetResourceLoader — az egyetlen módja a HLS szegmensek betöltésének elfogására és a gyorsítótárazás implementálására. Az AVAssetResourceLoaderDelegate delegátus fogadja a kulcsok és szegmensek betöltésére vonatkozó kéréseket, lehetővé téve azok helyi tárolását és a gyorsítótárból való visszaadását ismételt kérések esetén. Ez különösen hasznos a nem stabil hálózati körülmények között működő alkalmazások számára.

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

FairPlay Streaming — DRM integráció

FairPlay Streaming (FPS) — az Apple szabványa a HLS tartalom védelmére. Az FPS integrációhoz implementálni kell az AVContentKeySessionDelegate protokollt, amely a dekódoló kulcsok beszerzésére irányuló kéréseket kezeli. A folyamat magában foglalja: SPC (Server Playback Context) beszerzése a lejátszótól, elküldése a licencszerverre, CKC (Content Key Context) fogadása és visszaküldése az AVContentKeySession-be.

class DRMDelegate: NSObject, AVContentKeySessionDelegate {

    func contentKeySession(
        _ session: AVContentKeySession,
        didProvide keyRequest: AVContentKeyRequest
    ) {
        // 1. SPC beszerzése a keyRequest-ből
        // 2. SPC elküldése a licencszerverre
        // 3. CKC beszerzése és átadása a keyRequest.processContentKeyResponse-nak
    }
}

Now Playing és rendszer vezérlőelemek

A zárolási képernyőn, a Vezérlőközpontban és az Apple Watch-on az aktuális lejátszásról szóló információk megjelenítéséhez a MediaPlayer.framework-ből származó MPNowPlayingInfoCenter használatos. Az AVPlayer nem frissíti automatikusan a Now Playing-et — a fejlesztőnek manuálisan kell beállítania a metaadatokat (cím, előadó, borítókép, haladás) a lejátszás állapotának változásakor. A haladás frissítéséhez rendszeres időzítő vagy observe(\.timeControlStatus) használatos.

Remote Command Center — egy másik rendszerszolgáltatás, amely lehetővé teszi a lejátszás vezérlését a zárolt képernyőről, az AirPods-ról és a CarPlay-ről. Az MPRemoteCommandCenter regisztrálja a kezelőket a play, pause, nextTrack, previousTrack, changePlaybackPosition és skipForward/skipBackward parancsokhoz. Az AVPlayer nem dolgozza fel automatikusan ezeket a parancsokat — a fejlesztőnek kell összekapcsolnia őket a player.play(), player.pause() és player.seek() hívásokkal.