Audio y vídeo: AVPlayer, sesión y controles del sistema

Reproducir un vídeo en SwiftUI son dos líneas. Reproducirlo bien —que siga sonando con la pantalla apagada, que aparezca en la pantalla de bloqueo, que se pause cuando entra una llamada y se reanude después, que no compita groseramente con la música del usuario— exige entender que el audio de iOS no es una función de tu app, sino un recurso compartido de todo el dispositivo del que tú solo pides un turno.

Las cuatro capas

VideoPlayer de AVKit es la capa más fina posible, y suele bastar:

import AVKit

struct Reproductor: View {
    @State private var reproductor = AVPlayer(url: URL(string: "https://ejemplo.com/v.m3u8")!)

    var body: some View {
        VideoPlayer(player: reproductor) {
            Text("EN DIRECTO")
                .font(.caption.bold())
                .padding(6)
                .background(.red, in: Capsule())
                .padding()
        }
        .aspectRatio(16/9, contentMode: .fit)
        .onDisappear { reproductor.pause() }
    }
}

El cierre opcional es una superposición que se dibuja encima del vídeo, no un contenido alternativo. Debajo de esa comodidad hay cuatro objetos con responsabilidades separadas que conviene no confundir:

La confusión clásica es buscar el error de reproducción en el AVPlayer. No está ahí: player.currentItem?.status vale .failed y player.currentItem?.error tiene el motivo. El player está perfectamente sano reproduciendo algo que falló.

La sesión de audio es un contrato

Antes de que suene el primer byte, tu app tiene que declararle al sistema qué clase de audio es. Eso es AVAudioSession:

import AVFAudio

func configurarSesion() throws {
    let sesion = AVAudioSession.sharedInstance()
    try sesion.setCategory(.playback, mode: .moviePlayback)
    try sesion.setActive(true)
}

Las categorías no son ajustes de calidad: son declaraciones de intención con consecuencias visibles.

• .ambient — tu audio es accesorio. Se mezcla con el de otras apps y se calla con el interruptor de silencio. Es lo correcto para efectos de sonido de una interfaz.
• .soloAmbient — el valor por defecto. Se calla con el interruptor y además interrumpe a los demás. Casi nunca es lo que quieres conscientemente.
• .playback — tu audio es el contenido principal. Sigue sonando con el interruptor de silencio y con la pantalla apagada, e interrumpe a los demás salvo que añadas la opción mixWithOthers. Es la de un reproductor de música, pódcast o vídeo.
• .playAndRecord — para grabar y reproducir a la vez. Exige permiso de micrófono y por defecto saca el sonido por el auricular, no por el altavoz: de ahí la opción defaultToSpeaker.

Y los modos afinan el comportamiento dentro de la categoría: .moviePlayback aplica el procesado de cine, .spokenAudio optimiza voz y habilita saltos de audio, .voiceChat activa cancelación de eco.

stateDiagram-v2
[*] --> Reproduciendo
Reproduciendo --> Interrumpido: interruption began
Interrumpido --> Reproduciendo: interruption ended con shouldResume
Interrumpido --> Pausado: interruption ended sin shouldResume
Reproduciendo --> Pausado: oldDeviceUnavailable
Pausado --> Reproduciendo: el usuario pulsa play

Las interrupciones llegan por notificación y hay que atenderlas explícitamente. La regla que más se incumple es la de la ruta: cuando el usuario desconecta los auriculares, el sistema te avisa con AVAudioSession.routeChangeNotification y razón oldDeviceUnavailable, y tú debes pausar. Si no lo haces, el pódcast sale a todo volumen por el altavoz en un vagón lleno.

Segundo plano y controles del sistema

Sonar con la app en segundo plano exige dos cosas simultáneas, y fallar una sola deja de funcionar todo: la categoría .playback activa, y la capacidad de fondo declarada en el proyecto, que añade audio a UIBackgroundModes en Info.plist.

Con eso el audio sigue. Pero la pantalla de bloqueo, el centro de control, los auriculares y CarPlay siguen mudos hasta que publiques información y aceptes mandos:

import MediaPlayer

func publicarAhoraSuena(titulo: String, duracion: TimeInterval,
                        posicion: TimeInterval, ritmo: Float) {
    MPNowPlayingInfoCenter.default().nowPlayingInfo = [
        MPMediaItemPropertyTitle: titulo,
        MPMediaItemPropertyPlaybackDuration: duracion,
        MPNowPlayingInfoPropertyElapsedPlaybackTime: posicion,
        MPNowPlayingInfoPropertyPlaybackRate: ritmo
    ]
}

func aceptarMandos(_ reproductor: AVPlayer) {
    let centro = MPRemoteCommandCenter.shared()
    centro.playCommand.addTarget { _ in reproductor.play();  return .success }
    centro.pauseCommand.addTarget { _ in reproductor.pause(); return .success }
    centro.skipForwardCommand.preferredIntervals = [30]
    centro.skipForwardCommand.addTarget { _ in
        reproductor.seek(to: reproductor.currentTime() + CMTime(seconds: 30, preferredTimescale: 600))
        return .success
    }
    centro.nextTrackCommand.isEnabled = false   // desactiva lo que no soportas
}

El detalle que casi todo el mundo omite: MPNowPlayingInfoPropertyPlaybackRate es lo que hace que la barra de progreso de la pantalla de bloqueo avance sola. No hace falta actualizar la posición cada segundo; el sistema extrapola desde la posición y el ritmo que le diste. Si el ritmo es cero, la barra se queda congelada aunque el audio suene.

Observar sin dejar fugas

Para pintar tu propia barra de progreso necesitas un observador periódico, y ahí hay una trampa con nombre propio:

let intervalo = CMTime(seconds: 0.5, preferredTimescale: 600)
let testigo = reproductor.addPeriodicTimeObserver(forInterval: intervalo, queue: .main) { tiempo in
    posicion = tiempo.seconds
}
// obligatorio antes de soltar el reproductor
reproductor.removeTimeObserver(testigo)

Si el AVPlayer se libera con un observador de tiempo aún registrado, la app revienta con una excepción explícita de AVFoundation. No es una fuga silenciosa: es un crash. El observador retiene el cierre, el cierre suele retener tu modelo, y tu modelo retiene el reproductor: un ciclo perfecto. Guarda el testigo y quítalo en el mismo sitio donde paras la reproducción.