Реализация фонового воспроизведения аудио в мобильном приложении

Реализация фонового воспроизведения аудио в мобильном приложении

Фоновое воспроизведение — это не одна строка кода. iOS и Android по умолчанию останавливают аудио при уходе приложения в фон. Чтобы музыка, подкаст или звук игры продолжали играть, нужно правильно настроить AudioSession/AudioFocus, зарегистрировать Background Mode и обработать системные прерывания. И всё это — отдельно для каждой платформы.

iOS: AVAudioSession и Background Mode

Три обязательных шага:

1. Info.plist Background Mode. Добавить UIBackgroundModes → audio. Без этого iOS убьёт аудио через несколько секунд после ухода в фон.

2. AVAudioSession категория .playback. Именно эта категория позволяет воспроизведение при заблокированном экране и в фоне. .ambient замолкает при блокировке — типичная ошибка.

func configureAudioSession() {
    do {
        let session = AVAudioSession.sharedInstance()
        try session.setCategory(
            .playback,
            mode: .default,
            options: [.allowBluetooth, .allowAirPlay, .mixWithOthers] // убрать .mixWithOthers если нужно прерывать другие приложения
        )
        try session.setActive(true)
    } catch {
        print("AudioSession error: \(error)")
        // не игнорировать — без активной сессии фоновое воспроизведение не работает
    }
}

3. Обработка прерываний. Входящий звонок — iOS деактивирует AVAudioSession. После звонка — нужно явно восстановить:

NotificationCenter.default.addObserver(
    forName: AVAudioSession.interruptionNotification,
    object: nil,
    queue: .main
) { notification in
    guard let typeValue = notification.userInfo?[AVAudioSessionInterruptionTypeKey] as? UInt,
          let type = AVAudioSession.InterruptionType(rawValue: typeValue) else { return }

    switch type {
    case .began:
        audioPlayer.pause()
    case .ended:
        let shouldResume = (notification.userInfo?[AVAudioSessionInterruptionOptionKey] as? UInt)
            .flatMap { AVAudioSession.InterruptionOptions(rawValue: $0).contains(.shouldResume) } ?? false
        if shouldResume {
            try? AVAudioSession.sharedInstance().setActive(true)
            audioPlayer.play()
        }
    @unknown default: break
    }
}

Дополнительно — AVAudioSession.routeChangeNotification: наушники отключились → поставить на паузу (стандартное поведение всех плееров).

Android: Foreground Service и Audio Focus

На Android фоновое воспроизведение требует Foreground Service с типом mediaPlayback. Без Foreground Service Android убьёт процесс после нескольких минут.

class AudioPlaybackService : Service() {
    private lateinit var player: ExoPlayer
    private lateinit var mediaSession: MediaSessionCompat

    override fun onCreate() {
        super.onCreate()
        player = ExoPlayer.Builder(this).build()

        // Foreground notification — обязательна для Foreground Service
        val notification = buildMediaNotification()
        startForeground(NOTIFICATION_ID, notification, ServiceInfo.FOREGROUND_SERVICE_TYPE_MEDIA_PLAYBACK)

        mediaSession = MediaSessionCompat(this, "AudioService")
        mediaSession.setCallback(mediaSessionCallback)
        mediaSession.isActive = true
    }
}

Начиная с Android 14 (API 34) — FOREGROUND_SERVICE_TYPE_MEDIA_PLAYBACK обязателен в манифесте и в startForeground. Без явного типа — SecurityException.

Audio Focus. Запросить фокус перед началом воспроизведения:

val audioFocusRequest = AudioFocusRequest.Builder(AudioManager.AUDIOFOCUS_GAIN)
    .setOnAudioFocusChangeListener { focusChange ->
        when (focusChange) {
            AudioManager.AUDIOFOCUS_LOSS -> player.pause()
            AudioManager.AUDIOFOCUS_LOSS_TRANSIENT -> player.pause()
            AudioManager.AUDIOFOCUS_LOSS_TRANSIENT_CAN_DUCK -> player.volume = 0.3f
            AudioManager.AUDIOFOCUS_GAIN -> {
                player.volume = 1.0f
                player.play()
            }
        }
    }
    .build()

val result = audioManager.requestAudioFocus(audioFocusRequest)
if (result == AudioManager.AUDIOFOCUS_REQUEST_GRANTED) {
    player.play()
}

MediaSession и Lock Screen Controls

Без MediaSession (Android) / MPRemoteCommandCenter (iOS) управление с Lock Screen и наушников не работает.

Android (Jetpack Media3 / MediaSessionCompat): MediaNotification.Provider создаёт уведомление с кнопками предыдущий/пауза/следующий. MediaSession.Callback обрабатывает команды. MediaBrowserServiceCompat позволяет Android Auto подключаться к сервису.

iOS (MPNowPlayingInfoCenter + MPRemoteCommandCenter): обновлять nowPlayingInfo при каждой смене трека. MPRemoteCommandCenter.shared().playCommand.addTarget — обработчик команды Play. Если не обновлять MPNowPlayingInfoPropertyElapsedPlaybackTime периодически — прогресс-бар на Lock Screen будет неточным.

Типичные ошибки

Звук после входящего звонка на iOS. Забытый AVAudioSession.setActive(true) после завершения прерывания. Добавить в обработчик InterruptionType.ended.

Уведомление исчезает — сервис убивается. На Android при остановке воспроизведения нужно либо вызвать stopForeground(false) (убрать foreground, но не уведомление), либо правильно перейти в PAUSED состояние. Если вызвать stopForeground(true) — уведомление пропадёт, OS убьёт сервис вскоре после.

Bluetooth-наушники — нет звука. На iOS: options: .allowBluetooth в setCategory. На Android: AudioAttributes.Builder().setUsage(AudioAttributes.USAGE_MEDIA) — без этого Bluetooth может переключиться в SCO режим (телефонный, плохое качество).

Сроки

2–3 рабочих дня для стандартного фонового воспроизведения с Lock Screen controls. Интеграция с Android Auto / CarPlay или сложный lifecycle с несколькими типами контента — до 5 дней. Стоимость рассчитывается индивидуально.