Rút gọn APK

Giảm thiểu kích thước tệp APK là khía cạnh quan trọng để phát triển một ứng dụng Android tốt. Điều này đặc biệt đúng khi nhắm đến các thị trường đang phát triển cũng như khi phát triển Ứng dụng Android tức thì. Trong những trường hợp như vậy, bạn nên giảm thiểu kích thước của thư viện ExoPlayer có trong tệp APK. Trang này trình bày một số bước đơn giản có thể giúp bạn đạt được điều này.

Chỉ sử dụng các phần phụ thuộc bắt buộc

Chỉ phụ thuộc vào các mô-đun thư viện mà bạn thực sự cần. Ví dụ: nội dung sau đây sẽ thêm các phần phụ thuộc vào mô-đun thư viện ExoPlayer, DASH và giao diện người dùng, có thể cần thiết cho một ứng dụng chỉ phát nội dung 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"

Bật tính năng rút gọn mã và tài nguyên

Bạn nên bật tính năng rút gọn mã và tài nguyên cho các bản phát hành của ứng dụng. ExoPlayer được cấu trúc theo cách cho phép rút gọn mã để loại bỏ hiệu quả chức năng không sử dụng. Ví dụ: đối với một ứng dụng phát nội dung DASH, bạn có thể giảm khoảng 40% kích thước APK của ExoPlayer bằng cách bật tính năng rút gọn mã.

Hãy đọc bài viết Rút gọn, làm rối mã nguồn và tối ưu hoá ứng dụng để tìm hiểu cách bật tính năng rút gọn mã và tài nguyên.

Chỉ định trình kết xuất mà ứng dụng của bạn cần

Theo mặc định, trình kết xuất của trình phát sẽ được tạo bằng DefaultRenderersFactory. DefaultRenderersFactory phụ thuộc vào tất cả các phương thức triển khai Renderer được cung cấp trong thư viện ExoPlayer, do đó, không có phương thức triển khai nào bị xoá bằng cách rút gọn mã. Nếu biết rằng ứng dụng của bạn chỉ cần một nhóm nhỏ trình kết xuất, bạn có thể chỉ định RenderersFactory của riêng mình. Ví dụ: một ứng dụng chỉ phát âm thanh có thể xác định một nhà máy như vậy khi tạo bản sao 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();

Thao tác này sẽ cho phép xoá các phương thức triển khai Renderer khác bằng cách rút gọn mã. Trong video ví dụ cụ thể này, trình kết xuất văn bản và siêu dữ liệu sẽ bị xoá (tức là trình phát sẽ không xử lý hoặc phát bất kỳ phụ đề hoặc siêu dữ liệu nào trong luồng (ví dụ: ICY)).

Chỉ định trình trích xuất mà ứng dụng của bạn cần

Theo mặc định, trình phát tạo các thực thể Extractor để phát nội dung nghe nhìn tăng tiến bằng DefaultExtractorsFactory. DefaultExtractorsFactory phụ thuộc vào tất cả các phương thức triển khai Extractor được cung cấp trong thư viện ExoPlayer. Do đó, không có phương thức nào trong số này bị xoá bằng tính năng rút gọn mã. Nếu biết rằng ứng dụng của mình chỉ cần phát một số ít định dạng vùng chứa hoặc không phát nội dung nghe nhìn luỹ tiến, thì bạn có thể chỉ định ExtractorsFactory của riêng mình. Ví dụ: một ứng dụng chỉ cần phát tệp mp4 có thể cung cấp một nhà máy như:

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();

Điều này sẽ cho phép xoá các phương thức triển khai Extractor khác bằng cách rút gọn mã, nhờ đó có thể giảm đáng kể kích thước.

Nếu ứng dụng của bạn không phát nội dung truyền phát liên tục, bạn nên truyền ExtractorsFactory.EMPTY đến hàm khởi tạo DefaultMediaSourceFactory, sau đó truyền mediaSourceFactory đó đến hàm khởi tạo 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();

Tạo bản sao MediaSource tuỳ chỉnh

Nếu ứng dụng của bạn đang sử dụng MediaSource.Factory tuỳ chỉnh và bạn muốn xoá DefaultMediaSourceFactory bằng cách loại bỏ mã, thì bạn nên truyền trực tiếp MediaSource.Factory vào hàm khởi tạo ExoPlayer.Builder.

Kotlin

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

Java

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

Nếu ứng dụng của bạn đang sử dụng trực tiếp MediaSource thay vì MediaItem, bạn nên truyền MediaSource.Factory.UNSUPPORTED vào hàm khởi tạo ExoPlayer.Builder để đảm bảo DefaultMediaSourceFactoryDefaultExtractorsFactory có thể bị xoá bằng cách rút gọn mã.

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));