Реализация фонового воспроизведения аудио в мобильном приложении
Звонок от клиента: «Музыка останавливается, как только блокирую экран». Это типичная проблема, с которой сталкиваются многие разработчики. Фоновое воспроизведение аудио — одна из самых частых технических сложностей в мобильной разработке. Ошибки в конфигурации AVAudioSession на iOS или Audio Focus на Android приводят к тому, что приложение замолкает при сворачивании. Мы реализовали эту задачу более 50 раз и знаем все подводные камни. Среднее время интеграции — 3 дня, а экономия на отладке благодаря готовым шаблонам — до 40% времени. Наши инженеры тестируют на 10+ реальных устройствах, включая старые модели. Мы подготовили проверенные шаблоны кода для iOS и Android, которые уже используют в production десятки приложений. Один из них — подкаст-сервис с миллионной аудиторией. Типовое решение обходится на 30–50% дешевле, чем самостоятельная разработка.
Как настроить AVAudioSession для непрерывного воспроизведения?
Три обязательных шага:
-
Info.plist Background Mode. Добавить
UIBackgroundModes→audio. Без этого iOS убьёт аудио через несколько секунд после ухода в фон. -
AVAudioSession категория
.playback. Именно эта категория позволяет воспроизведение при заблокированном экране и в фоне..ambientзамолкает при блокировке — типичная ошибка.
func configureAudioSession() { do { let session = AVAudioSession.sharedInstance() try session.setCategory( .playback, mode: .default, options: [.allowBluetooth, .allowAirPlay, .mixWithOthers] ) try session.setActive(true) } catch { print("AudioSession error: \(error)") } } Apple рекомендует также обрабатывать прерывания (документация). Входящий звонок — 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 } } Apple Developer Documentation: AVAudioSession
Дополнительно — AVAudioSession.routeChangeNotification: если наушники отключились, ставьте воспроизведение на паузу.
Почему важно обрабатывать прерывания на Android?
На Android фоновое воспроизведение требует Foreground Service с типом mediaPlayback. Без Foreground Service Android убьёт процесс после нескольких минут. Начиная с Android 8 (API 26) это обязательно.
class AudioPlaybackService : Service() { private lateinit var player: ExoPlayer private lateinit var mediaSession: MediaSessionCompat override fun onCreate() { super.onCreate() player = ExoPlayer.Builder(this).build() 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+ обязательно указывать 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() } Без правильного Audio Focus другие приложения могут перекрыть звук, а ваш плеер не восстановится. ExoPlayer обрабатывает прерывания в два раза быстрее стандартного MediaPlayer благодаря встроенному управлению фокусом.
Что такое MediaSession и зачем он нужен для Lock Screen?
Без MediaSession (Android) или MPRemoteCommandCenter (iOS) управление с Lock Screen и наушников не работает. Настройка этих компонентов занимает около 30% времени разработки фонового аудио. На Android MediaNotification.Provider создаёт уведомление с кнопками, а MediaSession.Callback обрабатывает команды. MediaBrowserServiceCompat позволяет подключать Android Auto. На iOS MPNowPlayingInfoCenter и MPRemoteCommandCenter обеспечивают управление; обновляйте nowPlayingInfo при каждой смене трека, иначе прогресс-бар будет неточным.
Типичные ошибки и их решения
| Ошибка | Причина | Решение |
|---|---|---|
| Звук пропадает после звонка (iOS) | Забытый setActive(true) |
Добавить в InterruptionType.ended |
| Уведомление исчезает (Android) | stopForeground(true) удаляет уведомление |
Использовать stopForeground(false) при паузе |
| Нет звука в Bluetooth-наушниках | Не указаны Bluetooth-опции | На iOS: .allowBluetooth, на Android: AudioAttributes USAGE_MEDIA |
| Прерывание не обрабатывается (Android) | Отсутствует AudioFocusRequest | Добавить запрос фокуса перед стартом |
Сравнение подходов iOS и Android
| Параметр | iOS | Android |
|---|---|---|
| Сессия/Фокус | AVAudioSession .playback | AudioFocusRequest |
| Фоновый сервис | UIBackgroundModes audio | Foreground Service типа mediaPlayback |
| Lock Screen | MPNowPlayingInfoCenter + MPRemoteCommandCenter | MediaSession + MediaNotification.Provider |
| Прерывания | AVAudioSession.interruptionNotification | AudioFocusChangeListener |
| Bluetooth | .allowBluetooth | AudioAttributes USAGE_MEDIA |
Что входит в нашу работу
- Интеграция аудио-движка (ExoPlayer, AVAudioSession, Media3)
- Настройка Background Mode и Foreground Service
- Реализация Lock Screen controls (прогресс-бар, кнопки управления)
- Обработка системных прерываний (звонки, наушники)
- Тестирование на 10+ реальных устройствах
- Оптимизация под Android Auto / CarPlay (опционально)
- Документация API и описание интеграции
Свяжитесь с нами для предварительной оценки вашего проекта — мы подберём оптимальное решение. Получите консультацию по срокам и стоимости. Закажите интеграцию с гарантией качества.
Сроки
Стандартное внедрение фонового воспроизведения с Lock Screen controls занимает 2–3 рабочих дня. Если требуется поддержка Android Auto или CarPlay, либо сложный lifecycle с несколькими типами контента — до 5 дней. Стоимость рассчитывается индивидуально и зависит от объёма работ.