Seleção de faixas

Quando um item de mídia contém várias faixas, a seleção de faixas é o processo que determina quais delas são escolhidas para reprodução. O processo de seleção de faixa é configurado por TrackSelectionParameters, que permite especificar muitas restrições e substituições diferentes que influenciam a seleção de faixa.

Consultar as faixas disponíveis

Você pode detectar Player.Listener.onTracksChanged para receber notificações sobre mudanças nas faixas, incluindo:

  • As faixas disponíveis são conhecidas quando a preparação do item de mídia que está sendo reproduzido é concluída. O player precisa preparar um item de mídia para saber quais faixas ele contém.
  • As faixas disponíveis mudam devido à transição da reprodução de um item de mídia para outro.
  • Mudanças nas faixas selecionadas.

Kotlin

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

Java

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

Também é possível consultar as faixas atuais chamando player.getCurrentTracks(). O Tracks retornado contém uma lista de objetos Tracks.Group, em que as faixas em um único Group apresentam o mesmo conteúdo, mas em formatos diferentes.

Como exemplo de como as faixas podem ser agrupadas, considere uma reprodução adaptativa em que um feed de vídeo principal é fornecido em cinco taxas de bits, e um feed de vídeo alternativo (por exemplo, um ângulo de câmera diferente em uma partida esportiva) é fornecido em duas taxas de bits. Nesse caso, haverá dois grupos de faixas de vídeo: um correspondente ao feed de vídeo principal com cinco faixas e um segundo para o feed de vídeo alternativo com duas faixas.

As faixas de áudio em idiomas diferentes não são agrupadas porque o conteúdo em idiomas diferentes não é considerado o mesmo. Por outro lado, faixas de áudio no mesmo idioma que diferem apenas em propriedades como taxa de bits, taxa de amostragem, contagem de canais e assim por diante podem ser agrupadas. Isso também se aplica a faixas de texto.

Cada Group pode ser consultado para determinar quais faixas são compatíveis com reprodução, quais estão selecionadas no momento e qual Format cada faixa usa:

Kotlin

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)
  }
}
TrackSelection.kt

Java

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);
  }
}
TrackSelection.java
  • Uma faixa é compatível se o Player puder decodificar e renderizar as amostras dela. Mesmo que vários grupos de faixas do mesmo tipo (por exemplo, vários grupos de faixas de áudio) sejam compatíveis, isso significa apenas que eles são compatíveis individualmente, e o player não necessariamente consegue reproduzi-los ao mesmo tempo.
  • Uma faixa é selecionada quando é escolhida para reprodução de acordo com o TrackSelectionParameters atual. Se várias faixas em um grupo forem selecionadas, o player vai usar essas faixas para reprodução adaptativa (por exemplo, várias faixas de vídeo com taxas de bits diferentes). Apenas uma dessas faixas será reproduzida por vez.

Como modificar parâmetros de seleção de faixa

O processo de seleção de faixa pode ser configurado usando Player.setTrackSelectionParameters. Você pode fazer isso antes e durante a reprodução. O exemplo a seguir demonstra como extrair os TrackSelectionParameters atuais do player, modificá-los e atualizar o Player com o resultado modificado:

Kotlin

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

Java

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

Seleção de faixa baseada em restrições

A maioria das opções em TrackSelectionParameters permite especificar restrições, que são independentes das faixas disponíveis. As restrições disponíveis incluem:

  • Largura, altura, taxa de frames e taxa de bits máximas e mínimas do vídeo.
  • Número máximo de canais de áudio e taxa de bits.
  • Tipos MIME preferidos para vídeo e áudio.
  • Idiomas de áudio preferidos e flags de função.
  • Preferências de idioma de texto e flags de função.

O ExoPlayer usa padrões razoáveis para essas restrições, por exemplo, restringindo a resolução do vídeo ao tamanho da tela e preferindo o idioma do áudio que corresponde à configuração de localidade do sistema do usuário.

Há vários benefícios em usar a seleção de faixas baseada em restrições em vez de escolher faixas específicas entre as disponíveis:

  • É possível especificar restrições antes de saber quais faixas um item de mídia oferece. Isso significa que as restrições podem ser especificadas antes que o player tenha preparado um item de mídia, enquanto a seleção de faixas específicas exige que o código do aplicativo espere até que as faixas disponíveis sejam conhecidas.
  • As restrições são aplicadas a todos os itens de mídia em uma playlist, mesmo que eles tenham músicas disponíveis diferentes. Por exemplo, uma restrição de idioma de áudio preferido será aplicada automaticamente a todos os itens de mídia, mesmo que o Format da faixa nesse idioma varie de um item de mídia para outro. Isso não acontece quando você seleciona faixas específicas, conforme descrito abaixo.

Selecionar faixas específicas

É possível selecionar faixas específicas usando TrackSelectionParameters. Primeiro, as faixas disponíveis do player precisam ser consultadas usando Player.getCurrentTracks. Em segundo lugar, depois de identificar quais faixas selecionar, elas podem ser definidas em TrackSelectionParameters usando um TrackSelectionOverride. Por exemplo, para selecionar a primeira faixa de um audioTrackGroup específico:

Kotlin

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

Java

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

Um TrackSelectionOverride só será aplicado a itens de mídia que contenham um TrackGroup exatamente igual ao especificado na substituição. Portanto, uma substituição pode não ser aplicada a um item de mídia subsequente se ele tiver faixas diferentes.

Desativar tipos ou grupos de faixas

Tipos de faixa, como vídeo, áudio ou texto, podem ser totalmente desativados usando TrackSelectionParameters.Builder.setTrackTypeDisabled. Um tipo de faixa desativado será desativado para todos os itens de mídia:

Kotlin

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

Java

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

Como alternativa, é possível impedir a seleção de faixas de um TrackGroup específico especificando uma substituição vazia para esse grupo:

Kotlin

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

Java

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

Como personalizar o seletor de faixa

A seleção de faixas é de responsabilidade de um TrackSelector, uma instância que pode ser fornecida sempre que um ExoPlayer é criado e obtido posteriormente com ExoPlayer.getTrackSelector().

Kotlin

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

Java

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

DefaultTrackSelector é um TrackSelector flexível adequado para a maioria dos casos de uso. Ele usa o TrackSelectionParameters definido no Player, mas também oferece algumas opções avançadas de personalização que podem ser especificadas no DefaultTrackSelector.ParametersBuilder:

Kotlin

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

Java

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

Tunelamento

O tunelamento pode ajudar na reprodução eficiente de vídeos de alta resolução em alguns dispositivos de TV. Consulte a página de consumo de bateria para mais observações e detalhes.

Você pode definir uma preferência para a reprodução em túnel e ativar esse recurso quando a combinação de renderizadores e faixas selecionadas for compatível. Para isso, use DefaultTrackSelector.ParametersBuilder.setTunnelingEnabled(true).

Descarregamento de áudio

O descarregamento de áudio pode ajudar a economizar energia, principalmente em reproduções mais longas com a tela desligada. Consulte a página de consumo de bateria para mais observações e detalhes.

Você pode definir preferências para a reprodução de áudio descarregada e ativar esse recurso quando a combinação de renderizadores e faixas selecionadas for compatível. Para fazer isso, especifique AudioOffloadModePreferences no seu TrackSelectionParameters.

Kotlin

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()
TrackSelection.kt

Java

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());
TrackSelection.java