Управление состоянием и ресурсами MediaPlayer

В этом документе рассматриваются две области, в которых могут возникнуть проблемы.

  • Штат. При использовании Medialayer некоторые операции допустимы только в определенных состояниях. Неправильные операции могут привести к исключениям или неожиданному поведению.

  • Ресурсы. При изменении конфигурации, например повороте экрана, необходимо освободить объект MediaPlayer, чтобы освободить системные ресурсы и избежать их нехватки.

Управление статусом

MediaPlayer зависит от состояния. Это означает, что у него есть внутреннее состояние, которое всегда нужно учитывать при написании кода, поскольку некоторые операции допустимы только в определенных состояниях. Если вы выполните операцию в неправильном состоянии, система может выдать исключение или вызвать другое нежелательное поведение.

Диаграмма состояний в документации по классу MediaPlayer показывает, какие методы переводят MediaPlayer из одного состояния в другое. Пример:

  • Новый MediaPlayer находится в состоянии Бездействие.
  • Вы инициализируете его, вызывая setDataSource(), что переводит его в состояние Initialized.
  • Вы подготавливаете его с помощью метода prepare() или prepareAsync().
  • Когда MediaPlayer завершит подготовку, он перейдет в состояние Prepared. Это значит, что вы можете вызвать start(), чтобы воспроизвести медиаконтент.

Как показано на диаграмме, вы можете переключаться между состояниями Started, Paused и PlaybackCompleted, вызывая такие методы, как start(), pause() и seekTo().

Однако при вызове stop() вы не сможете снова вызвать start(), пока не подготовите MediaPlayer.

При написании кода, взаимодействующего с объектом MediaPlayer, всегда учитывайте диаграмму состояний, поскольку вызов методов из неправильного состояния – распространенная причина ошибок.

Освобождение MediaPlayer

MediaPlayer может потреблять ценные системные ресурсы. Поэтому всегда принимайте дополнительные меры предосторожности, чтобы не удерживать экземпляр MediaPlayer дольше, чем необходимо. Когда вы закончите с ним, вы всегда должны вызывать release(), чтобы убедиться, что все выделенные ему системные ресурсы правильно освобождены.

Например, если вы используете MediaPlayer и ваше действие получает вызов onStop(), вы должны освободить MediaPlayer, поскольку нет смысла удерживать его, пока ваше действие не взаимодействует с пользователем (если только вы не воспроизводите медиаконтент в фоновом режиме, что обсуждается в следующем разделе).

Когда активность возобновляется или перезапускается, вам нужно создать новый экземпляр MediaPlayer и подготовить его, прежде чем возобновить воспроизведение.

Вот как можно освободить, а затем аннулировать MediaPlayer:

Kotlin

mediaPlayer?.release()
mediaPlayer = null

Java

mediaPlayer.release();
mediaPlayer = null;

Например, если вы забудете освободить MediaPlayer при остановке операции, а при ее повторном запуске создадите новый объект, то могут возникнуть проблемы. Когда пользователь меняет ориентацию экрана (или иным образом изменяет конфигурацию устройства), система по умолчанию перезапускает операцию. Если пользователь будет поворачивать устройство, то при каждой смене ориентации будет создаваться новый объект MediaPlayer, который не будет удаляться. В результате системные ресурсы могут быстро закончиться.

Подробнее об обработке изменений во время выполнения…

Возможно, вы захотите, чтобы фоновое воспроизведение продолжалось, даже когда пользователь выходит из приложения, как это происходит в стандартном музыкальном проигрывателе. В этом случае вам нужен MediaPlayer, управляемый сервисом, как описано в следующем разделе.

Подробнее…

Jetpack Media3 – рекомендуемое решение для воспроизведения медиаконтента в приложении. Подробнее…

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