APK の圧縮

APK サイズを最小限に抑えることは、優れた Android アプリを開発するうえで重要な要素です。これは、開発市場をターゲットとする場合や、Android Instant Apps を開発する場合に特に当てはまります。このような場合は、APK に含まれる ExoPlayer ライブラリのサイズを最小限に抑えることが望ましい場合があります。このページでは、これを実現するための簡単な手順について説明します。

必要な依存関係のみを使用する

実際に必要なライブラリ モジュールのみに依存します。たとえば、次のコードは、ExoPlayer、DASH、UI ライブラリ モジュールへの依存関係を追加します。これは、DASH コンテンツのみを再生するアプリで必要になる場合があります。

Kotlin

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

Groovy

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

コードとリソースの圧縮を有効にする

アプリのリリースビルドでは、コードとリソースの圧縮を有効にする必要があります。ExoPlayer は、コード圧縮によって未使用の機能を効果的に削除できるように構成されています。たとえば、DASH コンテンツを再生するアプリの場合、コード圧縮を有効にすると、APK サイズに対する ExoPlayer の寄与を約 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 など)はプレーヤーによって処理または出力されません)。

アプリに必要な抽出ツールを指定する

デフォルトでは、プレーヤーは Extractor インスタンスを作成し、DefaultExtractorsFactory を使用してプログレッシブ メディアを再生します。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();

アプリが MediaItem ではなく MediaSource を直接使用している場合は、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));