Nguồn nội dung nghe nhìn

Trong ExoPlayer, mọi nội dung nghe nhìn đều được biểu thị bằng một MediaItem. Tuy nhiên, về mặt nội bộ, trình phát cần có các thực thể MediaSource để phát nội dung. Trình phát tạo các nguồn này từ các mục nội dung nghe nhìn bằng MediaSource.Factory.

Theo mặc định, trình phát sử dụng DefaultMediaSourceFactory, có thể tạo các thực thể của các phương thức triển khai MediaSource nội dung sau:

DefaultMediaSourceFactory cũng có thể tạo các nguồn nội dung nghe nhìn phức tạp hơn, tuỳ thuộc vào thuộc tính của các mục nội dung nghe nhìn tương ứng. Vấn đề này được mô tả chi tiết hơn trên trang Mục nội dung nghe nhìn.

Đối với những ứng dụng cần thiết lập nguồn nội dung nghe nhìn không được cấu hình mặc định của trình phát hỗ trợ, có một số lựa chọn để tuỳ chỉnh.

Tuỳ chỉnh việc tạo nguồn nội dung nghe nhìn

Khi tạo trình phát, bạn có thể chèn MediaSource.Factory. Ví dụ: nếu một ứng dụng muốn chèn quảng cáo và sử dụng CacheDataSource.Factory để hỗ trợ lưu vào bộ nhớ đệm, thì bạn có thể định cấu hình một thực thể của DefaultMediaSourceFactory để phù hợp với các yêu cầu này và chèn trong quá trình tạo trình phát:

Kotlin

val mediaSourceFactory: MediaSource.Factory =
  DefaultMediaSourceFactory(context)
    .setDataSourceFactory(cacheDataSourceFactory)
    .setLocalAdInsertionComponents(adsLoaderProvider, playerView)
val player = ExoPlayer.Builder(context).setMediaSourceFactory(mediaSourceFactory).build()

Java

MediaSource.Factory mediaSourceFactory =
    new DefaultMediaSourceFactory(context)
        .setDataSourceFactory(cacheDataSourceFactory)
        .setLocalAdInsertionComponents(adsLoaderProvider, /* adViewProvider= */ playerView);
ExoPlayer player =
    new ExoPlayer.Builder(context).setMediaSourceFactory(mediaSourceFactory).build();

DefaultMediaSourceFactory JavaDoc mô tả chi tiết hơn về các tuỳ chọn có sẵn.

Bạn cũng có thể chèn một phương thức triển khai MediaSource.Factory tuỳ chỉnh, chẳng hạn như để hỗ trợ việc tạo một loại nguồn nội dung nghe nhìn tuỳ chỉnh. createMediaSource(MediaItem) của nhà máy sẽ được gọi để tạo nguồn nội dung nghe nhìn cho mỗi mục nội dung nghe nhìn được thêm vào danh sách phát.

API danh sách phát dựa trên nguồn nội dung nghe nhìn

Giao diện ExoPlayer xác định các phương thức danh sách phát bổ sung chấp nhận nguồn nội dung nghe nhìn thay vì mục nội dung nghe nhìn. Điều này giúp bạn có thể bỏ qua MediaSource.Factory nội bộ của trình phát và truyền trực tiếp các thực thể nguồn nội dung nghe nhìn đến trình phát:

Kotlin

// Set a list of media sources as initial playlist.
exoPlayer.setMediaSources(listOfMediaSources)
// Add a single media source.
exoPlayer.addMediaSource(anotherMediaSource)

// Can be combined with the media item API.
exoPlayer.addMediaItem(/* index= */ 3, MediaItem.fromUri(videoUri))

exoPlayer.prepare()
exoPlayer.play()

Java

// Set a list of media sources as initial playlist.
exoPlayer.setMediaSources(listOfMediaSources);
// Add a single media source.
exoPlayer.addMediaSource(anotherMediaSource);

// Can be combined with the media item API.
exoPlayer.addMediaItem(/* index= */ 3, MediaItem.fromUri(videoUri));

exoPlayer.prepare();
exoPlayer.play();

Thành phần nguồn nội dung nghe nhìn nâng cao

ExoPlayer cung cấp nhiều cách triển khai MediaSource để sửa đổi và kết hợp các thực thể MediaSource khác. Các tuỳ chọn này hữu ích nhất trong trường hợp bạn phải kết hợp nhiều tuỳ chỉnh và không có đường dẫn thiết lập đơn giản nào là đủ.

  • ClippingMediaSource: Cho phép cắt nội dung nghe nhìn theo một phạm vi dấu thời gian được chỉ định. Nếu đây là nội dung sửa đổi duy nhất, bạn nên sử dụng MediaItem.ClippingConfiguration.
  • FilteringMediaSource: Lọc các bản nhạc có sẵn theo loại được chỉ định, ví dụ: chỉ hiển thị bản video từ một tệp chứa cả âm thanh và video. Nếu đây là nội dung sửa đổi duy nhất, bạn nên sử dụng tham số lựa chọn bản nhạc.
  • MergingMediaSource: Hợp nhất nhiều nguồn nội dung nghe nhìn để phát song song. Trong hầu hết các trường hợp, bạn nên gọi hàm khởi tạo với adjustPeriodTimeOffsets và clipDurations được đặt thành true để đảm bảo tất cả các nguồn đều bắt đầu và kết thúc cùng một lúc. Nếu bạn thực hiện việc sửa đổi này để thêm phụ đề được tải không qua cửa hàng ứng dụng, thì bạn nên sử dụng MediaItem.SubtitleConfiguration.
  • ConcatenatingMediaSource2: Hợp nhất nhiều nguồn nội dung nghe nhìn để phát liên tiếp. Cấu trúc nội dung nghe nhìn mà người dùng nhìn thấy sẽ hiển thị một Timeline.Window, nghĩa là cấu trúc này trông giống như một mục duy nhất. Nếu bạn thực hiện việc sửa đổi này để phát nhiều mục không được coi là một mục, thì bạn nên sử dụng các phương thức API danh sách phát như Player.addMediaItem.
  • SilenceMediaSource: Tạo khoảng lặng trong một khoảng thời gian nhất định, hữu ích cho việc lấp đầy khoảng trống.
  • AdsMediaSource: Mở rộng nguồn nội dung nghe nhìn bằng các chức năng chèn quảng cáo phía máy khách. Hãy tham khảo hướng dẫn chèn quảng cáo để biết thông tin chi tiết.
  • ServerSideAdInsertionMediaSource: Mở rộng nguồn nội dung nghe nhìn bằng các chức năng chèn quảng cáo phía máy chủ. Hãy tham khảo hướng dẫn chèn quảng cáo để biết thông tin chi tiết.