APK 缩减

最小化 APK 大小是开发良好 Android 应用的重要方面。这在面向发展中国家市场以及开发 Android 即时应用时尤其重要。在这种情况下，可能需要最小化 APK 中包含的 ExoPlayer 库的大小。此页面概述了一些可以帮助实现此目标的简单步骤。

仅使用所需的依赖项

仅依赖您实际需要的库模块。例如，以下操作将添加对 ExoPlayer、DASH 和 UI 库模块的依赖项，这对于仅播放 DASH 内容的应用可能需要。

Kotlin

implementation("androidx.media3:media3-exoplayer:1.4.1")
implementation("androidx.media3:media3-exoplayer-dash:1.4.1")
implementation("androidx.media3:media3-ui:1.4.1")

Groovy

implementation "androidx.media3:media3-exoplayer:1.4.1"
implementation "androidx.media3:media3-exoplayer-dash:1.4.1"
implementation "androidx.media3:media3-ui:1.4.1"

启用代码和资源缩减

您应该为应用的发布版本启用代码和资源压缩。ExoPlayer 的结构允许代码压缩有效地移除未使用的功能。例如，对于播放 DASH 内容的应用，通过启用代码压缩，ExoPlayer 对 APK 大小的贡献可以减少大约 40%。

阅读压缩、混淆和优化您的应用，了解如何启用代码和资源压缩。

指定您的应用需要的渲染器

默认情况下，播放器的渲染器将使用DefaultRenderersFactory创建。DefaultRenderersFactory依赖于 ExoPlayer 库中提供的所有Renderer实现，因此代码压缩不会移除任何一个。如果您知道您的应用只需要一部分渲染器，则可以指定您自己的RenderersFactory。例如，一个只播放音频的应用可以在实例化ExoPlayer实例时定义如下工厂：

Kotlin

val audioOnlyRenderersFactory =
  RenderersFactory {
    handler: Handler,
    videoListener: VideoRendererEventListener,
    audioListener: AudioRendererEventListener,
    textOutput: TextOutput,
    metadataOutput: MetadataOutput,
    ->
    arrayOf<Renderer>(
      MediaCodecAudioRenderer(context, MediaCodecSelector.DEFAULT, handler, audioListener)
    )
}
val player = ExoPlayer.Builder(context, audioOnlyRenderersFactory).build()

Java

RenderersFactory audioOnlyRenderersFactory =
    (handler, videoListener, audioListener, textOutput, metadataOutput) ->
        new Renderer[] {
            new MediaCodecAudioRenderer(
                context, MediaCodecSelector.DEFAULT, handler, audioListener)
        };
ExoPlayer player = new ExoPlayer.Builder(context, audioOnlyRenderersFactory).build();

这将允许代码压缩移除其他Renderer实现。在这个具体的例子中，视频、文本和元数据渲染器将被移除（这意味着任何字幕或流内元数据（例如 ICY）都不会被播放器处理或发出）。

指定您的应用需要的提取器

默认情况下，播放器使用DefaultExtractorsFactory创建Extractor实例来播放渐进式媒体。DefaultExtractorsFactory依赖于 ExoPlayer 库中提供的所有Extractor实现，因此代码压缩不会移除任何一个。如果您知道您的应用只需要播放少量容器格式，或者根本不播放渐进式媒体，则可以指定您自己的ExtractorsFactory。例如，一个只需要播放 mp4 文件的应用可以提供如下工厂：

Kotlin

val mp4ExtractorFactory = ExtractorsFactory {
  arrayOf<Extractor>(Mp4Extractor(DefaultSubtitleParserFactory()))
}
val player =
  ExoPlayer.Builder(context, DefaultMediaSourceFactory(context, mp4ExtractorFactory)).build()

Java

ExtractorsFactory mp4ExtractorFactory =
    () -> new Extractor[] {new Mp4Extractor(new DefaultSubtitleParserFactory())};
ExoPlayer player =
    new ExoPlayer.Builder(context, new DefaultMediaSourceFactory(context, mp4ExtractorFactory))
        .build();

这将允许代码压缩移除其他Extractor实现，这可以显著减小大小。

如果您的应用根本不播放渐进式内容，则应将ExtractorsFactory.EMPTY传递给DefaultMediaSourceFactory构造函数，然后将该mediaSourceFactory传递给ExoPlayer.Builder构造函数。

Kotlin

val player =
  ExoPlayer.Builder(context, DefaultMediaSourceFactory(context, ExtractorsFactory.EMPTY)).build()

Java

ExoPlayer player =
    new ExoPlayer.Builder(
            context, new DefaultMediaSourceFactory(context, ExtractorsFactory.EMPTY))
        .build();

自定义 MediaSource 实例化

如果您的应用正在使用自定义MediaSource.Factory，并且您希望代码压缩移除DefaultMediaSourceFactory，则应将您的MediaSource.Factory直接传递给ExoPlayer.Builder构造函数。

Kotlin

val player = ExoPlayer.Builder(context, customMediaSourceFactory).build()

Java

ExoPlayer player = new ExoPlayer.Builder(context, mediaSourceFactory).build();

如果您的应用直接使用MediaSource而不是MediaItem，则应将MediaSource.Factory.UNSUPPORTED传递给ExoPlayer.Builder构造函数，以确保代码压缩可以移除DefaultMediaSourceFactory和DefaultExtractorsFactory。

Kotlin

val player = ExoPlayer.Builder(context, MediaSource.Factory.UNSUPPORTED).build()
val mediaSource =
  ProgressiveMediaSource.Factory(dataSourceFactory, customExtractorsFactory)
    .createMediaSource(MediaItem.fromUri(uri))

Java

ExoPlayer player = new ExoPlayer.Builder(context, MediaSource.Factory.UNSUPPORTED).build();
ProgressiveMediaSource mediaSource =
    new ProgressiveMediaSource.Factory(dataSourceFactory, customExtractorsFactory)
        .createMediaSource(MediaItem.fromUri(uri));