Начало работы

Начало работы с Transformer состоит из следующих шагов:

1. Добавьте Media3 Transformer как зависимость в ваш проект.
2. Создайте EditedMediaItem , представляющий медиафайлы для обработки и изменения, применяемые к ним.
3. Создайте Transformer , описывающий требуемый вывод и прослушиватель событий завершения и ошибок.
4. Запустите операцию экспорта, передав EditedMediaItem для редактирования и путь к выходу. Во время экспорта вы можете запросить текущий ход выполнения или отменить операцию.
5. После завершения экспорта выполните необходимые действия с выходными данными. Например, вы можете поделиться ими с другим приложением или загрузить на сервер.

Продолжайте читать, чтобы узнать больше об этих шагах, а для полного примера смотрите TransformerActivity в демонстрационном приложении Transformer .

Добавить Media3 Transformer как зависимость

Самый простой способ начать использовать Transformer — добавить зависимости Gradle от библиотеки в файле build.gradle вашего модуля приложения:

implementation("androidx.media3:media3-transformer:1.7.1")
implementation("androidx.media3:media3-effect:1.7.1")
implementation("androidx.media3:media3-common:1.7.1")

implementation "androidx.media3:media3-transformer:1.7.1"
implementation "androidx.media3:media3-effect:1.7.1"
implementation "androidx.media3:media3-common:1.7.1"

Где 1.7.1 — предпочтительная версия. Последнюю версию можно найти в примечаниях к выпуску .

Более подробную информацию о доступных модулях библиотеки можно найти на странице Google Maven AndroidX Media3 .

Включить поддержку Java 8

Если поддержка Java 8 еще не включена, вам необходимо включить ее во всех файлах build.gradle , которые зависят от Transformer, добавив следующее в раздел android :

compileOptions {
  targetCompatibility JavaVersion.VERSION_1_8
}

Начать трансформацию

Вот пример создания EditedMediaItem для удаления звука из входного файла, а затем создания и настройки экземпляра Transformer для экспорта видео H.265/HEVC и вывода результата в outputPath .

val inputMediaItem = MediaItem.fromUri("path_to_input_file")
val editedMediaItem =
    EditedMediaItem.Builder(inputMediaItem).setRemoveAudio(true).build()
val transformer = Transformer.Builder(context)
    .setVideoMimeType(MimeTypes.VIDEO_H265)
    .addListener(transformerListener)
    .build()
transformer.start(editedMediaItem, outputPath)

MediaItem inputMediaItem = MediaItem.fromUri("path_to_input_file");
EditedMediaItem editedMediaItem =
    new EditedMediaItem.Builder(inputMediaItem).setRemoveAudio(true).build();
Transformer transformer =
    new Transformer.Builder(context)
        .setVideoMimeType(MimeTypes.VIDEO_H265)
        .addListener(transformerListener)
        .build();
transformer.start(editedMediaItem, outputPath);

Дополнительную информацию о медиафайлах см. на странице «Медиафайлы ExoPlayer» . Входной поток может быть прогрессивным или адаптивным, но выходной поток всегда прогрессивный. Для адаптивных входных данных для преобразования всегда выбираются дорожки с самым высоким разрешением. Входной файл может иметь любой формат контейнера , поддерживаемый ExoPlayer, но выходной файл всегда — MP4.

Вы можете выполнить несколько операций экспорта последовательно на одном экземпляре Transformer , но одновременный экспорт с одним и тем же экземпляром не поддерживается.

Примечание о нитях

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

Слушайте события

Метод start является асинхронным. Он немедленно возвращает управление, и приложение уведомляется о событиях через прослушиватель, переданный конструктору Transformer .

val transformerListener: Transformer.Listener =
    object : Transformer.Listener {
  override fun onCompleted(composition: Composition, result: ExportResult) {
    playOutput()
  }

  override fun onError(composition: Composition, result: ExportResult,
                       exception: ExportException) {
    displayError(exception)
  }
}

Transformer.Listener transformerListener =
    new Transformer.Listener() {
      @Override
      public void onCompleted(Composition composition, ExportResult result) {
        playOutput();
      }

      @Override
      public void onError(Composition composition, ExportResult result,
          ExportException exception) {
        displayError(exception);
      }
    };

ExportResult включает информацию о выходном файле, включая размер файла и средний битрейт для аудио и видео, если применимо.

Получайте обновления о ходе работ

Вызовите Transformer.getProgress для запроса текущего хода выполнения преобразования. Возвращаемое значение указывает состояние выполнения. Если состояние выполнения — PROGRESS_STATE_AVAILABLE , то предоставленный ProgressHolder обновляется текущим процентом выполнения. В следующем примере показано, как периодически запрашивать ход выполнения преобразования, используя метод updateProgressInUi для обновления индикатора выполнения.

transformer.start(inputMediaItem, outputPath)
val progressHolder = ProgressHolder()
mainHandler.post(
    object : Runnable {
      override fun run() {
        val progressState: @ProgressState Int = transformer.getProgress(progressHolder)
        updateProgressInUi(progressState, progressHolder)
        if (progressState != Transformer.PROGRESS_STATE_NOT_STARTED) {
          mainHandler.postDelayed(/* r= */this,  /* delayMillis= */500)
        }
      }
    }
)

transformer.start(inputMediaItem, outputPath);
ProgressHolder progressHolder = new ProgressHolder();
mainHandler.post(
    new Runnable() {
      @Override
      public void run() {
        @Transformer.ProgressState int progressState = transformer.getProgress(progressHolder);
        updateProgressInUi(progressState, progressHolder);
        if (progressState != PROGRESS_STATE_NOT_STARTED) {
          mainHandler.postDelayed(/* r= */ this, /* delayMillis= */ 500);
        }
      }
    });

Отменить преобразование

Если пользователь решит отказаться от экспорта, отмените операцию экспорта с помощью Transformer.cancel . Ресурсы, такие как аппаратные видеокодеки, ограничены, особенно на недорогих устройствах, поэтому важно сделать это, чтобы освободить ресурсы, если вывод не требуется.