В этом документе представлены основные понятия, с которыми вам следует ознакомиться, прежде чем работать с Media Player.
Занятия по звуку и видео
Для воспроизведения звука и видео в платформе Android используются следующие классы:
MediaPlayer– основной API для воспроизведения аудио и видео.AudioManager– этот класс управляет источниками звука и аудиовыходом на устройстве.
Объявления в манифесте
Прежде чем начать разработку приложения с использованием MediaPlayer, убедитесь, что в манифесте есть соответствующие объявления, разрешающие использование связанных функций.
Разрешение на доступ к интернету. Если вы используете MediaPlayer для потоковой передачи контента из сети, ваше приложение должно запрашивать доступ к сети.
<uses-permission android:name="android.permission.INTERNET" />Разрешение на запрет блокировки. Если вашему приложению-проигрывателю нужно предотвращать затемнение экрана или переход процессора в спящий режим, или если оно использует методы
MediaPlayer.setScreenOnWhilePlaying(boolean)илиMediaPlayer.setWakeMode(android.content.Context, int), вы должны запросить это разрешение.<uses-permission android:name="android.permission.WAKE_LOCK" />
Используйте класс MediaPlayer
Класс MediaPlayer – важный компонент фреймворка Media.
Объект этого класса может получать, декодировать и воспроизводить аудио и видео с минимальными настройками. MediaPlayer поддерживает несколько источников медиаконтента, в том числе:
- Местные ресурсы
- Внутренние URI, например полученные от Content Resolver.
- Внешние URL (потоковая передача)
Список поддерживаемых форматов медиафайлов можно найти на этой странице.
Примеры работы с источниками аудио
Ниже приведен пример воспроизведения аудио, доступного в качестве локального необработанного ресурса (сохраненного в каталоге res/raw/ вашего приложения).
Kotlin
var mediaPlayer = MediaPlayer.create(context, R.raw.sound_file_1)
mediaPlayer.start() // no need to call prepare(); create() does that for you
Java
MediaPlayer mediaPlayer = MediaPlayer.create(context, R.raw.sound_file_1);
mediaPlayer.start(); // no need to call prepare(); create() does that for you
В данном случае "необработанный" ресурс – это файл, который система не пытается проанализировать каким-либо определенным образом. Однако контент этого ресурса не должен быть необработанным аудио. Это должен быть правильно закодированный и отформатированный медиафайл в одном из поддерживаемых форматов.
А вот как можно воспроизвести файл по URI, доступному локально в системе (например, полученному через Content Resolver):
Kotlin
val myUri: Uri = .... // initialize Uri here
val mediaPlayer = MediaPlayer().apply {
setAudioAttributes(
AudioAttributes.Builder()
.setContentType(AudioAttributes.CONTENT_TYPE_MUSIC)
.setUsage(AudioAttributes.USAGE_MEDIA)
.build()
)
setDataSource(applicationContext, myUri)
prepare()
start()
}
Java
Uri myUri = ....; // initialize Uri here
MediaPlayer mediaPlayer = new MediaPlayer();
mediaPlayer.setAudioAttributes(
new AudioAttributes.Builder()
.setContentType(AudioAttributes.CONTENT_TYPE_MUSIC)
.setUsage(AudioAttributes.USAGE_MEDIA)
.build()
);
mediaPlayer.setDataSource(getApplicationContext(), myUri);
mediaPlayer.prepare();
mediaPlayer.start();
Воспроизведение из удаленного URL-адреса с использованием потоковой передачи HTTP выглядит следующим образом:
Kotlin
val url = "http://........" // your URL here
val mediaPlayer = MediaPlayer().apply {
setAudioAttributes(
AudioAttributes.Builder()
.setContentType(AudioAttributes.CONTENT_TYPE_MUSIC)
.setUsage(AudioAttributes.USAGE_MEDIA)
.build()
)
setDataSource(url)
prepare() // might take long! (for buffering, etc)
start()
}
Java
String url = "http://........"; // your URL here
MediaPlayer mediaPlayer = new MediaPlayer();
mediaPlayer.setAudioAttributes(
new AudioAttributes.Builder()
.setContentType(AudioAttributes.CONTENT_TYPE_MUSIC)
.setUsage(AudioAttributes.USAGE_MEDIA)
.build()
);
mediaPlayer.setDataSource(url);
mediaPlayer.prepare(); // might take long! (for buffering, etc)
mediaPlayer.start();
Как использовать асинхронную подготовку для повышения эффективности
При использовании MediaPlayer не забывайте об эффективности. Например, вызов prepare() может занять много времени, поскольку он может включать получение и декодирование медиаданных. Как и любой метод, выполнение которого может занять много времени, никогда не вызывайте его из потока UI приложения. В противном случае интерфейс перестанет отвечать на запросы, пока метод не вернет результат. Это неудобно для пользователей и может привести к ошибке ANR ("Приложение не отвечает").
Чтобы избежать зависания потока UI, создайте другой поток для подготовки MediaPlayer и уведомления основного потока о завершении. Фреймворк предоставляет удобный способ реализации метода prepareAsync() для выполнения этой задачи. Этот метод запускает подготовку медиаконтента в фоновом режиме и сразу же возвращает результат. Когда медиаконтент будет готов, вызывается метод onPrepared() объекта MediaPlayer.OnPreparedListener, настроенный с помощью setOnPreparedListener().
Подробнее…
Jetpack Media3 – рекомендуемое решение для воспроизведения медиаконтента в приложении. Подробнее…
На этих страницах рассматриваются темы, связанные с записью, хранением и воспроизведением аудио и видео: