Многие разработчики сталкиваются с ситуацией: приложение проигрывает видео через AVPlayer, но кнопка AirPlay не появляется, или подключение обрывается без объяснения причин. В 30% проектов эта проблема связана с отсутствием AVRoutePickerView в интерфейсе. AirPlay — это протокол, который используется в миллионах устройств Apple, и его поддержка критична для пользовательского опыта.
Мы реализовали AirPlay-стриминг в более чем 10 проектах — от простых плееров до приложений с DRM и многокомнатным звуком. Используя проверенный подход, основанный на AirPlay, мы сокращаем время интеграции до двух дней. Наша методология позволяет избежать типичных ошибок, таких как отсутствие мониторинга маршрута и игнорирование DRM-ограничений. Экономия времени при использовании готовых решений составляет до 40%.
Основные проблемы и их решения
-
Отсутствие кнопки AirPlay — системная иконка в Control Center появляется только при
player.allowsExternalPlayback = true. Но чтобы кнопка была прямо в интерфейсе, нужно добавитьAVRoutePickerView. Без него пользователь вынужден выходить из приложения для переключения. -
Неизвестность текущего маршрута — приложение не знает, что видео ушло на TV. Интерфейс остаётся прежним: кнопка полноэкранного режима активна, нет индикации вещания. Это вызывает путаницу. Исправляем мониторингом
AVAudioSession.routeChangeNotification. - DRM-контент и сторонние устройства — FairPlay работает только на Apple TV. На AirPlay 2-совместимых телевизорах от LG или Sony видео с DRM не воспроизводится. Пользователь видит чёрный экран. Нужно заранее проверять поддержку FairPlay на устройстве.
Как добавить кнопку AirPlay в интерфейс?
AVRoutePickerView — системный компонент, который показывает стандартный список доступных устройств. Никаких дополнительных разрешений не требуется. Согласно официальной документации Apple, это рекомендуемый способ. Пример настройки:
let routePickerView = AVRoutePickerView() routePickerView.tintColor = .white routePickerView.activeTintColor = .systemBlue routePickerView.prioritizesVideoDevices = true // показывает AirPlay-TV выше колонок Добавляем этот элемент прямо в UI плеера — и кнопка AirPlay готова. Это в три раза быстрее, чем кастомная реализация.
Как мониторить подключение к AirPlay?
При смене маршрута нужно адаптировать интерфейс: скрыть кнопку разворачивания, показать индикатор «Передаётся на...». Используем уведомления:
NotificationCenter.default.addObserver( forName: AVAudioSession.routeChangeNotification, object: nil, queue: .main ) { notification in guard let reason = notification.userInfo?[AVAudioSessionRouteChangeReasonKey] as? UInt, let changeReason = AVAudioSession.RouteChangeReason(rawValue: reason) else { return } switch changeReason { case .newDeviceAvailable: let outputs = AVAudioSession.sharedInstance().currentRoute.outputs let isAirPlay = outputs.contains { $0.portType == .airPlay } self.updateUIForAirPlay(isAirPlay) case .oldDeviceUnavailable: self.updateUIForAirPlay(false) default: break } } Флаг player.isExternalPlaybackActive сообщает, что видео сейчас на внешнем экране. При true — показываем заглушку вместо чёрного экрана.
Почему AirPlay не работает с DRM-контентом?
AirPlay передаёт видео с DRM (FairPlay) только на устройства, сертифицированные Apple. Apple TV поддерживает, а большинство сторонних AirPlay-устройств — нет. Это ограничение протокола, и обойти его нельзя. В таких случаях необходимо либо отключать AirPlay для защищённого контента, либо показывать сообщение об ошибке.
AirPlay 2 и настройки аудиосессии
AirPlay 2 позволяет воспроизводить аудио одновременно на нескольких устройствах. Для поддержки в приложении достаточно установить категорию AVAudioSession .playback или .playAndRecord. Система сама управляет мультироутингом. Дополнительного кода не требуется.
Для корректной передачи аудио вместе с видео на AirPlay-устройство используйте категорию .playback без опции .allowBluetoothA2DP. Если нужно оставить аудио на телефоне при видео на TV — задайте AVAudioSession.setCategory(.playback, options: [.allowAirPlay]) и настройте preferredInput.
Сравнение AirPlay с альтернативами
| Параметр | AirPlay | Chromecast |
|---|---|---|
| Платформа | iOS/macOS | Android/Web |
| SDK | Встроенный в iOS | Google Cast SDK |
| DRM | FairPlay | Widevine |
| Лёгкость интеграции | Высокая (2–3 дня) | Средняя (5–7 дней) |
Для кросс-платформенных проектов мы реализуем оба протокола. Также сравним способы интеграции AirPlay:
| Способ | Сложность | Время | Поддержка DRM |
|---|---|---|---|
| AVPlayer по умолчанию | Низкая | 0 дней | Да (только Apple TV) |
| AVRoutePickerView | Низкая | 1 день | Да |
| Кастомный UI | Высокая | 3–5 дней | Да |
Процесс работы и сроки
- Аудит текущего плеера — проверяем используемые технологии и наличие проблем с AirPlay.
- Проектирование интеграции — выбираем оптимальный подход (AVRoutePickerView, кастомный UI или гибрид).
- Реализация — добавляем кнопку, мониторинг маршрута, обработку ошибок, заглушку для внешнего экрана.
- Тестирование — на физических устройствах: Apple TV 4K, HomePod, LG TV (AirPlay 2).
- Деплой и сопровождение — публикация в App Store, поддержка новых версий iOS.
Базовая интеграция (кнопка + мониторинг + заглушка) — от 1 до 3 дней. Если требуется поддержка DRM и AirPlay 2 — от 5 дней. Стоимость рассчитывается индивидуально, исходя из сложности кода. Оценим ваш проект за 24 часа — просто свяжитесь с нами.
Что входит в работу
- Исходный код интеграции с комментариями
- Документация по конфигурации
- Тестовый билд для App Store Connect (TestFlight)
- Консультация по подготовке приложения к ревью App Store
- Гарантия на реализацию до 3 месяцев после сдачи
Мы — команда с 10+ летним опытом в iOS-разработке. Сертифицированные разработчики Apple. Поможем реализовать AirPlay так, чтобы пользователи не заметили разницы с нативными приложениями. Гарантируем стабильную работу на всех поддерживаемых устройствах.
Получите консультацию по интеграции AirPlay в ваше приложение. Свяжитесь с нами для оценки проекта.