HLS (Phát trực tuyến dựa trên HTTP)

ExoPlayer hỗ trợ HLS với nhiều định dạng vùng chứa. Các định dạng mẫu âm thanh và video có trong cũng phải được hỗ trợ (xem phần định dạng mẫu để biết thông tin chi tiết). Chúng tôi đặc biệt khuyến khích các nhà sản xuất nội dung HLS tạo ra các luồng HLS chất lượng cao, như mô tả tại đây.

Sử dụng MediaItem

Để phát một luồng HLS, bạn cần phụ thuộc vào mô-đun HLS.

implementation("androidx.media3:media3-exoplayer-hls:1.3.1")

implementation "androidx.media3:media3-exoplayer-hls:1.3.1"

Sau đó, bạn có thể tạo MediaItem cho URI danh sách phát HLS và truyền URI đó cho trình phát.

// Create a player instance.
val player = ExoPlayer.Builder(context).build()
// Set the media item to be played.
player.setMediaItem(MediaItem.fromUri(hlsUri))
// Prepare the player.
player.prepare()

// Create a player instance.
ExoPlayer player = new ExoPlayer.Builder(context).build();
// Set the media item to be played.
player.setMediaItem(MediaItem.fromUri(hlsUri));
// Prepare the player.
player.prepare();

Nếu URI của bạn không kết thúc bằng .m3u8, bạn có thể chuyển MimeTypes.APPLICATION_M3U8 đến setMimeType của MediaItem.Builder để cho biết rõ loại nội dung.

URI của mục nội dung đa phương tiện có thể trỏ đến một danh sách phát nội dung đa phương tiện hoặc một danh sách phát đa biến thể. Nếu URI trỏ đến một danh sách phát đa biến thể khai báo nhiều thẻ #EXT-X-STREAM-INF, thì ExoPlayer sẽ tự động điều chỉnh giữa các biến thể, có tính đến cả băng thông có sẵn và khả năng của thiết bị.

Sử dụng HlsMediaSource

Để có thêm lựa chọn tuỳ chỉnh, bạn có thể tạo HlsMediaSource và truyền trực tiếp đến người chơi thay vì MediaItem.

// Create a data source factory.
val dataSourceFactory: DataSource.Factory = DefaultHttpDataSource.Factory()
// Create a HLS media source pointing to a playlist uri.
val hlsMediaSource =
  HlsMediaSource.Factory(dataSourceFactory).createMediaSource(MediaItem.fromUri(hlsUri))
// Create a player instance.
val player = ExoPlayer.Builder(context).build()
// Set the HLS media source as the playlist with a single media item.
player.setMediaSource(hlsMediaSource)
// Prepare the player.
player.prepare()

// Create a data source factory.
DataSource.Factory dataSourceFactory = new DefaultHttpDataSource.Factory();
// Create a HLS media source pointing to a playlist uri.
HlsMediaSource hlsMediaSource =
    new HlsMediaSource.Factory(dataSourceFactory).createMediaSource(MediaItem.fromUri(hlsUri));
// Create a player instance.
ExoPlayer player = new ExoPlayer.Builder(context).build();
// Set the HLS media source as the playlist with a single media item.
player.setMediaSource(hlsMediaSource);
// Prepare the player.
player.prepare();

Truy cập vào tệp kê khai

Bạn có thể truy xuất tệp kê khai hiện tại bằng cách gọi Player.getCurrentManifest. Đối với HLS, bạn nên truyền đối tượng được trả về tới HlsManifest. Lệnh gọi lại onTimelineChanged của Player.Listener cũng được gọi bất cứ khi nào tệp kê khai được tải. Điều này sẽ xảy ra một lần đối với nội dung theo yêu cầu và có thể nhiều lần đối với nội dung phát trực tiếp. Đoạn mã sau đây cho thấy cách một ứng dụng có thể làm một việc gì đó bất cứ khi nào tệp kê khai được tải.

player.addListener(
  object : Player.Listener {
    override fun onTimelineChanged(timeline: Timeline, @TimelineChangeReason reason: Int) {
      val manifest = player.currentManifest
      if (manifest is HlsManifest) {
        // Do something with the manifest.
      }
    }
  }
)

player.addListener(
    new Player.Listener() {
      @Override
      public void onTimelineChanged(
          Timeline timeline, @Player.TimelineChangeReason int reason) {
        Object manifest = player.getCurrentManifest();
        if (manifest != null) {
          HlsManifest hlsManifest = (HlsManifest) manifest;
          // Do something with the manifest.
        }
      }
    });

Tuỳ chỉnh chế độ phát

ExoPlayer cung cấp nhiều cách để bạn điều chỉnh trải nghiệm phát theo nhu cầu của ứng dụng. Xem trang Tuỳ chỉnh để biết các ví dụ.

Tắt tính năng chuẩn bị không phân đoạn

Theo mặc định, ExoPlayer sẽ sử dụng chế độ chuẩn bị phân đoạn. Tức là ExoPlayer sẽ chỉ sử dụng thông tin trong danh sách phát đa biến thể để chuẩn bị luồng. Việc này sẽ hoạt động nếu các thẻ #EXT-X-STREAM-INF chứa thuộc tính CODECS.

Có thể bạn sẽ phải tắt tính năng này nếu các phân khúc nội dung nghe nhìn của bạn chứa các bản phụ đề kết hợp dạng kết hợp không được khai báo trong danh sách phát đa biến thể bằng thẻ #EXT-X-MEDIA:TYPE=CLOSED-CAPTIONS. Nếu không, các bản phụ đề này sẽ không được phát hiện và phát. Bạn có thể tắt tính năng chuẩn bị phân đoạn trong HlsMediaSource.Factory như minh hoạ trong đoạn mã sau. Xin lưu ý rằng việc này sẽ làm tăng thời gian khởi động vì ExoPlayer cần tải một phân đoạn nội dung nghe nhìn xuống để khám phá các bản nhạc bổ sung này. Đồng thời, bạn nên khai báo các bản phụ đề đóng trong danh sách phát đa biến thể.

val hlsMediaSource =
  HlsMediaSource.Factory(dataSourceFactory)
    .setAllowChunklessPreparation(false)
    .createMediaSource(MediaItem.fromUri(hlsUri))

HlsMediaSource hlsMediaSource =
    new HlsMediaSource.Factory(dataSourceFactory)
        .setAllowChunklessPreparation(false)
        .createMediaSource(MediaItem.fromUri(hlsUri));

Tạo nội dung HLS chất lượng cao

Để khai thác tối đa ExoPlayer, bạn có thể làm theo một số nguyên tắc nhất định để cải thiện nội dung HLS của mình. Hãy đọc bài đăng trên Medium về chế độ phát HLS trong ExoPlayer của chúng tôi để xem nội dung giải thích đầy đủ. Sau đây là các điểm chính:

• Sử dụng thời lượng chính xác của đoạn.
• Sử dụng luồng nội dung nghe nhìn liên tục; tránh thay đổi cấu trúc nội dung nghe nhìn trên các phân đoạn.
• Sử dụng thẻ #EXT-X-INDEPENDENT-SEGMENTS.
• Ưu tiên luồng riêng tư, thay vì các tệp có cả video và âm thanh.
• Đưa tất cả thông tin mà bạn có thể vào Danh sách phát đa biến thể.

Các nguyên tắc sau đây áp dụng riêng cho sự kiện phát trực tiếp:

• Sử dụng thẻ #EXT-X-PROGRAM-DATE-TIME.
• Sử dụng thẻ #EXT-X-DISCONTINUITY-SEQUENCE.
• Cung cấp một cửa sổ trực tiếp dài. Một phút trở lên thật tuyệt.