Начало работы с Media Player

В этом документе представлены основные понятия, с которыми вам следует ознакомиться, прежде чем работать с 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 – рекомендуемое решение для воспроизведения медиаконтента в приложении. Подробнее…

На этих страницах рассматриваются темы, связанные с записью, хранением и воспроизведением аудио и видео: