Chọn bản nhạc

Khi một mục nội dung đa phương tiện chứa nhiều bản nhạc, quá trình lựa chọn bản nhạc là quá trình xác định video nào trong số đó được chọn để phát lại. Quá trình lựa chọn kênh phát hành là do TrackSelectionParameters định cấu hình. Công cụ này cho phép nhiều chế độ cài đặt các quy tắc ràng buộc và ghi đè ảnh hưởng đến việc lựa chọn bản nhạc sẽ được chỉ định.

Truy vấn các kênh hiện có

Bạn có thể nghe Player.Listener.onTracksChanged để được thông báo về các thay đổi vào kênh, bao gồm:

• Các bản nhạc hiện có sẽ được biết đến khi quá trình chuẩn bị cho mục nội dung đa phương tiện đang được số lượt hoàn thành đã phát. Lưu ý rằng người chơi cần chuẩn bị một mục nội dung đa phương tiện để biết những bản nhạc trong đó.
• Các bản nhạc hiện có sẽ thay đổi do việc chuyển đổi phát từ một nội dung nghe nhìn mục này sang mục khác.
• Có thay đổi đối với những kênh đã chọn.

player.addListener(
  object : Player.Listener {
    override fun onTracksChanged(tracks: Tracks) {
      // Update UI using current tracks.
    }
  }
)

player.addListener(
    new Player.Listener() {
      @Override
      public void onTracksChanged(Tracks tracks) {
        // Update UI using current tracks.
      }
    });

Bạn cũng có thể truy vấn các tuyến đường hiện tại bằng cách gọi player.getCurrentTracks(). Tracks được trả về chứa danh sách đối tượng Track.Group, trong đó các bản nhạc trong một Group duy nhất trình bày cùng một nội dung nhưng ở định dạng khác nhau.

Ví dụ về cách nhóm các bản nhạc, hãy cân nhắc việc phát thích ứng trong đó nguồn cấp dữ liệu video chính được cung cấp ở 5 tốc độ bit và nguồn cấp dữ liệu video thay thế (ví dụ: góc quay khác trong một trận đấu thể thao) được cung cấp trong hai tốc độ bit. Trong trường hợp này, sẽ có hai nhóm bản video, một nhóm tương ứng với nguồn cấp dữ liệu video chứa 5 bản nhạc và một giây cho nguồn cấp dữ liệu video thay thế có hai bản nhạc.

Các bản âm thanh có ngôn ngữ khác nhau không được nhóm lại vì nội dung trong các ngôn ngữ khác nhau sẽ không được coi là giống nhau. Ngược lại, bản âm thanh có cùng ngôn ngữ, chỉ khác về thuộc tính như tốc độ bit, hoạt động lấy mẫu có thể được nhóm lại, số lượng kênh, v.v. Chế độ này cũng áp dụng cho các bản văn bản.

Bạn có thể truy vấn mỗi Group để xác định bản nhạc được hỗ trợ chế độ phát (hiện đang được chọn) và chế độ Format mà mỗi bản nhạc sử dụng:

for (trackGroup in tracks.groups) {
  // Group level information.
  val trackType = trackGroup.type
  val trackInGroupIsSelected = trackGroup.isSelected
  val trackInGroupIsSupported = trackGroup.isSupported
  for (i in 0 until trackGroup.length) {
    // Individual track information.
    val isSupported = trackGroup.isTrackSupported(i)
    val isSelected = trackGroup.isTrackSelected(i)
    val trackFormat = trackGroup.getTrackFormat(i)
  }
}

for (Tracks.Group trackGroup : tracks.getGroups()) {
  // Group level information.
  @C.TrackType int trackType = trackGroup.getType();
  boolean trackInGroupIsSelected = trackGroup.isSelected();
  boolean trackInGroupIsSupported = trackGroup.isSupported();
  for (int i = 0; i < trackGroup.length; i++) {
    // Individual track information.
    boolean isSupported = trackGroup.isTrackSupported(i);
    boolean isSelected = trackGroup.isTrackSelected(i);
    Format trackFormat = trackGroup.getTrackFormat(i);
  }
}

• Một kênh sẽ được hỗ trợ nếu Player có thể giải mã và kết xuất kênh đó mẫu. Xin lưu ý rằng ngay cả khi nhiều nhóm kênh theo dõi cùng loại (ví dụ: nhiều nhóm bản âm thanh) được hỗ trợ, nhưng điều đó chỉ có nghĩa là các nhóm này được hỗ trợ riêng và người chơi không nhất thiết phải có thể phát các video đó tại .
• Một bản nhạc sẽ được chọn nếu bản nhạc đó đã được chọn để phát dựa trên TrackSelectionParameters. Nếu nhiều kênh trong một nhóm kênh phát hành đã chọn, trình phát sẽ sử dụng các bản nhạc này để phát thích ứng (ví dụ: nhiều bản video có tốc độ bit khác nhau). Lưu ý rằng chỉ một trong số này bản nhạc sẽ được phát cùng lúc.

Sửa đổi thông số lựa chọn kênh

Bạn có thể định cấu hình quá trình lựa chọn kênh bằng Player.setTrackSelectionParameters. Bạn có thể làm việc này cả trước và trong khi video. Ví dụ sau đây minh hoạ cách lấy giá trị hiện tại TrackSelectionParameters trong trình phát, sửa đổi chúng và cập nhật Player với kết quả được sửa đổi:

player.trackSelectionParameters =
  player.trackSelectionParameters
    .buildUpon()
    .setMaxVideoSizeSd()
    .setPreferredAudioLanguage("hu")
    .build()

player.setTrackSelectionParameters(
    player
        .getTrackSelectionParameters()
        .buildUpon()
        .setMaxVideoSizeSd()
        .setPreferredAudioLanguage("hu")
        .build());

Lựa chọn kênh dựa trên ràng buộc

Hầu hết các tuỳ chọn trong TrackSelectionParameters đều cho phép bạn chỉ định các quy tắc ràng buộc, độc lập với các bản nhạc thực sự có sẵn. Có sẵn các quy tắc ràng buộc bao gồm:

• Chiều rộng, chiều cao, tốc độ khung hình và tốc độ bit của video tối đa và tối thiểu.
• Số lượng kênh âm thanh và tốc độ bit tối đa.
• Các loại MIME được ưu tiên dùng cho video và âm thanh.
• Ngôn ngữ âm thanh ưu tiên và cờ vai trò.
• Ngôn ngữ văn bản ưu tiên và cờ vai trò.

ExoPlayer sử dụng các giá trị mặc định hợp lý cho những hạn chế này, chẳng hạn như hạn chế độ phân giải của video so với kích thước hiển thị và ưu tiên ngôn ngữ âm thanh khớp với chế độ cài đặt Ngôn ngữ của hệ thống.

Việc sử dụng lựa chọn kênh dựa trên ràng buộc mang lại một số lợi ích thay vì chọn các bản nhạc cụ thể trong số những bản nhạc có sẵn:

• Bạn có thể chỉ định các quy tắc ràng buộc trước khi biết được bản nhạc nào mà một mục nội dung đa phương tiện cung cấp. Điều này có nghĩa là các quy tắc ràng buộc có thể được chỉ định trước khi người chơi chuẩn bị một mục nội dung đa phương tiện, trong khi việc chọn kênh cụ thể lại yêu cầu mã xử lý ứng dụng để đợi cho đến khi xác định được các bản nhạc hiện có.
• Các quy tắc ràng buộc được áp dụng cho mọi mục nội dung đa phương tiện trong danh sách phát, ngay cả khi các mục đó mỗi mục có các bản nhạc có sẵn khác nhau. Ví dụ: một ngôn ngữ ưu tiên cho nội dung âm thanh quy tắc ràng buộc sẽ tự động được áp dụng cho tất cả các mục nội dung đa phương tiện, ngay cả khi Format của bản nhạc bằng ngôn ngữ đó sẽ thay đổi tuỳ theo mục nội dung đa phương tiện. Tuy nhiên, trường hợp này không xảy ra khi chọn các bản nhạc cụ thể, như mô tả dưới đây.

Chọn những bản nhạc cụ thể

Bạn có thể chọn những kênh cụ thể bằng TrackSelectionParameters. Đầu tiên, bản nhạc hiện có của trình phát nên được truy vấn bằng cách sử dụng Player.getCurrentTracks. Thứ hai, khi đã xác định được kênh cần chọn, bạn có thể đặt chúng trên TrackSelectionParameters bằng TrackSelectionOverride. Ví dụ: để chọn bản nhạc đầu tiên từ một audioTrackGroup cụ thể:

player.trackSelectionParameters =
  player.trackSelectionParameters
    .buildUpon()
    .setOverrideForType(
      TrackSelectionOverride(audioTrackGroup.mediaTrackGroup, /* trackIndex= */ 0)
    )
    .build()

player.setTrackSelectionParameters(
    player
        .getTrackSelectionParameters()
        .buildUpon()
        .setOverrideForType(
            new TrackSelectionOverride(
                audioTrackGroup.getMediaTrackGroup(), /* trackIndex= */ 0))
        .build());

TrackSelectionOverride sẽ chỉ áp dụng cho các mục nội dung đa phương tiện chứa TrackGroup khớp chính xác với giá trị được chỉ định trong phần ghi đè. Do đó, một chế độ ghi đè có thể không áp dụng cho mục nội dung đa phương tiện tiếp theo nếu mục đó chứa bản nhạc khác nhau.

Tắt các loại hoặc nhóm theo dõi

Bạn có thể tắt hoàn toàn các loại bản nhạc như video, âm thanh hoặc văn bản bằng cách sử dụng TrackSelectionParameters.Builder.setTrackTypeDisabled. Một loại kênh bị vô hiệu hoá sẽ bị tắt đối với tất cả các mục nội dung đa phương tiện:

player.trackSelectionParameters =
  player.trackSelectionParameters
    .buildUpon()
    .setTrackTypeDisabled(C.TRACK_TYPE_VIDEO, /* disabled= */ true)
    .build()

player.setTrackSelectionParameters(
    player
        .getTrackSelectionParameters()
        .buildUpon()
        .setTrackTypeDisabled(C.TRACK_TYPE_VIDEO, /* disabled= */ true)
        .build());

Ngoài ra, bạn cũng có thể ngăn việc lựa chọn các bản nhạc từ một TrackGroup bằng cách chỉ định cơ chế ghi đè trống cho nhóm đó:

player.trackSelectionParameters =
  player.trackSelectionParameters
    .buildUpon()
    .addOverride(
      TrackSelectionOverride(disabledTrackGroup.mediaTrackGroup, /* trackIndices= */ listOf())
    )
    .build()

player.setTrackSelectionParameters(
    player
        .getTrackSelectionParameters()
        .buildUpon()
        .addOverride(
            new TrackSelectionOverride(
                disabledTrackGroup.getMediaTrackGroup(),
                /* trackIndices= */ ImmutableList.of()))
        .build());

Tuỳ chỉnh bộ chọn bản nhạc

Việc lựa chọn kênh là trách nhiệm của TrackSelector, một thực thể Bạn có thể cung cấp số này bất cứ khi nào tạo ExoPlayer và lấy được sau cùng với ExoPlayer.getTrackSelector().

val trackSelector = DefaultTrackSelector(context)
val player = ExoPlayer.Builder(context).setTrackSelector(trackSelector).build()

DefaultTrackSelector trackSelector = new DefaultTrackSelector(context);
ExoPlayer player = new ExoPlayer.Builder(context).setTrackSelector(trackSelector).build();

DefaultTrackSelector là một TrackSelector linh hoạt phù hợp với hầu hết nhu cầu sử dụng trường hợp. Phương thức này sử dụng TrackSelectionParameters được đặt trong Player, nhưng cũng cung cấp một số tuỳ chọn tuỳ chỉnh nâng cao có thể được chỉ định trong DefaultTrackSelector.ParametersBuilder:

trackSelector.setParameters(
  trackSelector.buildUponParameters().setAllowVideoMixedMimeTypeAdaptiveness(true))
)

trackSelector.setParameters(
    trackSelector.buildUponParameters().setAllowVideoMixedMimeTypeAdaptiveness(true));

Tạo đường hầm

Bạn có thể cho phép phát theo đường hầm trong trường hợp sự kết hợp giữa trình kết xuất và các kênh được chọn có hỗ trợ định dạng này. Để làm việc này, hãy sử dụng DefaultTrackSelector.ParametersBuilder.setTunnelingEnabled(true).

Giảm tải âm thanh

Bạn có thể bật tính năng phát âm thanh giảm tải trong trường hợp trình kết xuất đồ hoạ và kênh được chọn hỗ trợ định dạng này. Để thực hiện việc này, hãy chỉ định AudioOffloadModePreferences trong TrackSelectionParameters của bạn.

val audioOffloadPreferences =
  AudioOffloadPreferences.Builder()
      .setAudioOffloadMode(AudioOffloadPreferences.AUDIO_OFFLOAD_MODE_ENABLED)
      // Add additional options as needed
      .setIsGaplessSupportRequired(true)
      .build()
player.trackSelectionParameters =
  player.trackSelectionParameters
    .buildUpon()
    .setAudioOffloadPreferences(audioOffloadPreferences)
    .build()

AudioOffloadPreferences audioOffloadPreferences =
  new AudioOffloadPreferences.Builder()
      .setAudioOffloadMode(AudioOffloadPreferences.AUDIO_OFFLOAD_MODE_ENABLED)
      // Add additional options as needed
      .setIsGaplessSupportRequired(true)
      .build();
player.setTrackSelectionParameters(
  player.getTrackSelectionParameters()
    .buildUpon()
    .setAudioOffloadPreferences(audioOffloadPreferences)
    .build());
);