Solução de problemas


Como corrigir erros de "Tráfego HTTP de texto não criptografado não permitido"

Esse erro vai ocorrer se o app solicitar tráfego HTTP de texto não criptografado (ou seja, http:// em vez de https://) quando a configuração de segurança de rede não permitir. Se o app for destinado ao Android 9 (nível 28 da API) ou versões mais recentes, o tráfego HTTP de texto não criptografado será desativado pela configuração padrão.

Se o app precisar funcionar com tráfego HTTP de texto não criptografado, use uma configuração de segurança de rede que permita isso. Consulte a documentação de segurança de rede do Android para mais detalhes. Para ativar todo o tráfego HTTP de texto não criptografado, basta adicionar android:usesCleartextTraffic="true" ao elemento application do AndroidManifest.xml do app.

O app de demonstração do ExoPlayer usa a configuração de segurança de rede padrão e, portanto, não permite o tráfego HTTP de texto não criptografado. Para ativar, siga as instruções acima.

Como corrigir os erros "SSLHandshakeException", "CertPathValidatorException" e "ERR_CERT_AUTHORITY_INVALID"

SSLHandshakeException, CertPathValidatorException e ERR_CERT_AUTHORITY_INVALID indicam um problema com o certificado SSL do servidor. Esses erros não são específicos do ExoPlayer. Consulte a documentação de SSL do Android para mais detalhes.

Por que alguns arquivos de mídia não são pesquisáveis?

Por padrão, o ExoPlayer não oferece suporte à busca em mídias em que o único método para realizar operações de busca precisas é a verificação e indexação de todo o arquivo pelo player. O ExoPlayer considera esses arquivos como não pesquisáveis. A maioria dos formatos de contêiner de mídia modernos inclui metadados para busca (como um índice de amostra), tem um algoritmo de busca bem definido (por exemplo, pesquisa de bisseção interpolada para Ogg) ou indica que o conteúdo tem uma taxa de bits constante. Operações de busca eficientes são possíveis e compatíveis com o ExoPlayer nesses casos.

Se você precisar de busca, mas tiver mídia não buscável, sugerimos converter seu conteúdo para usar um formato de contêiner mais apropriado. Para arquivos MP3, ADTS e AMR, também é possível ativar a busca, supondo que os arquivos tenham uma taxa de bits constante, conforme descrito aqui.

Por que a busca é imprecisa em alguns arquivos MP3?

Os arquivos MP3 de taxa de bits variável (VBR, na sigla em inglês) são fundamentalmente inadequados para casos de uso que exigem busca exata. Há duas razões para isso:

  1. Para uma busca exata, o ideal é que um formato de contêiner forneça um mapeamento preciso de tempo para byte em um cabeçalho. Esse mapeamento permite que um player mapeie um tempo de busca solicitado para o deslocamento de bytes correspondente e comece a solicitar, analisar e reproduzir mídia desse deslocamento. Os cabeçalhos disponíveis para especificar esse mapeamento em MP3 (como cabeçalhos XING) geralmente são, infelizmente, imprecisos.
  2. Para formatos de contêiner que não fornecem um mapeamento preciso de tempo para byte (ou qualquer mapeamento de tempo para byte), ainda é possível realizar uma busca exata se o contêiner incluir carimbos de data/hora de amostra absolutos no stream. Nesse caso, um player pode mapear o tempo de busca para uma estimativa do deslocamento de bytes correspondente, começar a solicitar mídia desse deslocamento, analisar o primeiro carimbo de data/hora de amostra absoluto e realizar uma pesquisa binária guiada na mídia até encontrar a amostra certa. Infelizmente, o MP3 não inclui carimbos de data/hora de amostra absolutos no stream, então essa abordagem não é possível.

Por esses motivos, a única maneira de realizar uma busca exata em um arquivo MP3 VBR é verificar todo o arquivo e criar manualmente um mapeamento de tempo para byte no player. Essa estratégia pode ser ativada usando FLAG_ENABLE_INDEX_SEEKING, que pode ser definido em um DefaultExtractorsFactory usando setMp3ExtractorFlags. Ele não é bem dimensionado para arquivos MP3 grandes, principalmente se o usuário tentar buscar perto do final da transmissão logo após iniciar a reprodução, o que exige que o player aguarde até que toda a transmissão seja baixada e indexada antes de realizar a busca. No ExoPlayer, decidimos otimizar a velocidade em vez da precisão nesse caso, e FLAG_ENABLE_INDEX_SEEKING fica desativado por padrão.

Se você controla a mídia que está sendo reproduzida, recomendamos usar um formato de contêiner mais adequado, como MP4. Não conhecemos casos de uso em que o MP3 seja a melhor opção de formato de mídia.

Por que a busca no meu vídeo está lenta?

Quando o player busca uma nova posição de reprodução em um vídeo, ele precisa fazer duas coisas:

  1. Carregue os dados correspondentes à nova posição de reprodução no buffer (isso pode não ser necessário se esses dados já estiverem armazenados em buffer).
  2. Limpar o decodificador de vídeo e iniciar a decodificação do frame I (frame-chave) antes da nova posição de reprodução, devido à codificação intraframe usada pela maioria dos formatos de compactação de vídeo. Para garantir que a busca seja precisa (ou seja, que a reprodução comece exatamente na posição de busca), todos os frames entre o I-frame anterior e a posição de busca precisam ser decodificados e imediatamente descartados (sem serem mostrados na tela).

A latência introduzida por (1) pode ser reduzida aumentando a quantidade de dados armazenados em buffer na memória pelo player ou armazenando os dados em cache no disco.

A latência introduzida por (2) pode ser reduzida diminuindo a precisão da busca usando ExoPlayer.setSeekParameters ou recodificando o vídeo para ter frames I mais frequentes, o que vai resultar em um arquivo de saída maior.

Se a busca estiver lenta enquanto um usuário arrasta uma barra de busca, ative o modo de limpeza (ExoPlayer.setScrubbingModeEnabled), que combina buscas rápidas, aumenta a capacidade do decodificador e permite definir uma tolerância de busca fracionária com base na largura do limpador da interface.

Por que alguns arquivos MPEG-TS não são reproduzidos?

Alguns arquivos MPEG-TS não contêm delimitadores de unidade de acesso (AUDs, na sigla em inglês). Por padrão, o ExoPlayer depende de AUDs para detectar limites de frame de forma econômica. Da mesma forma, alguns arquivos MPEG-TS não contêm frames-chave IDR. Por padrão, esse é o único tipo de frame-chave considerado pelo ExoPlayer.

O ExoPlayer vai parecer travado no estado de buffer quando solicitado a reproduzir um arquivo MPEG-TS que não tem AUDs ou frames-chave IDR. Se você precisar reproduzir esses arquivos, use FLAG_DETECT_ACCESS_UNITS e FLAG_ALLOW_NON_IDR_KEYFRAMES, respectivamente. Essas flags podem ser definidas em um DefaultExtractorsFactory usando setTsExtractorFlags ou em um DefaultHlsExtractorFactory usando o construtor. O uso de FLAG_DETECT_ACCESS_UNITS não tem efeitos colaterais, exceto por ser computacionalmente caro em relação à detecção de limite de frame baseada em AUD. O uso de FLAG_ALLOW_NON_IDR_KEYFRAMES pode resultar em corrupção visual temporária no início da reprodução e imediatamente após buscas ao reproduzir alguns arquivos MPEG-TS.

Por que as legendas não são encontradas em alguns arquivos MPEG-TS?

Alguns arquivos MPEG-TS incluem faixas CEA-608, mas não as declaram nos metadados do contêiner. Por isso, o ExoPlayer não consegue detectá-las. É possível especificar manualmente as faixas de legenda fornecendo uma lista de formatos de legenda esperados para o DefaultExtractorsFactory, incluindo os canais de acessibilidade que podem ser usados para identificá-las no stream MPEG-TS:

Kotlin

val extractorsFactory =
  DefaultExtractorsFactory()
    .setTsSubtitleFormats(
      listOf(
        Format.Builder()
          .setSampleMimeType(MimeTypes.APPLICATION_CEA608)
          .setAccessibilityChannel(accessibilityChannel)
          // Set other subtitle format info, such as language.
          .build()
      )
    )
val player: Player =
  ExoPlayer.Builder(context, DefaultMediaSourceFactory(context, extractorsFactory)).build()

Java

DefaultExtractorsFactory extractorsFactory =
    new DefaultExtractorsFactory()
        .setTsSubtitleFormats(
            ImmutableList.of(
                new Format.Builder()
                    .setSampleMimeType(MimeTypes.APPLICATION_CEA608)
                    .setAccessibilityChannel(accessibilityChannel)
                    // Set other subtitle format info, such as language.
                    .build()));
Player player =
    new ExoPlayer.Builder(context, new DefaultMediaSourceFactory(context, extractorsFactory))
        .build();

Por que alguns arquivos MP4/FMP4 não são reproduzidos corretamente?

Alguns arquivos MP4/FMP4 contêm listas de edição que reescrevem a linha do tempo de mídia pulando, movendo ou repetindo listas de amostras. O ExoPlayer tem suporte parcial para aplicar listas de edição. Por exemplo, ele pode atrasar ou repetir grupos de amostras começando em uma amostra de sincronização, mas não trunca amostras de áudio nem pré-rola mídia para edições que não começam em uma amostra de sincronização.

Se você perceber que parte da mídia está ausente ou repetida de forma inesperada, tente definir Mp4Extractor.FLAG_WORKAROUND_IGNORE_EDIT_LISTS ou FragmentedMp4Extractor.FLAG_WORKAROUND_IGNORE_EDIT_LISTS, o que fará com que o extrator ignore as listas de edição por completo. Eles podem ser definidos em um DefaultExtractorsFactory usando setMp4ExtractorFlags ou setFragmentedMp4ExtractorFlags.

Por que algumas transmissões falham com o código de resposta HTTP 301 ou 302?

Os códigos de resposta HTTP 301 e 302 indicam redirecionamento. Breves descrições podem ser encontradas na Wikipédia. Quando o ExoPlayer faz uma solicitação e recebe uma resposta com o código de status 301 ou 302, ele normalmente segue o redirecionamento e inicia a reprodução normalmente. O único caso em que isso não acontece por padrão é para redirecionamentos entre protocolos. Um redirecionamento entre protocolos é aquele que redireciona de HTTPS para HTTP ou vice-versa (ou, menos comumente, entre outro par de protocolos). É possível testar se um URL causa um redirecionamento entre protocolos usando a ferramenta de linha de comando wget da seguinte maneira:

wget "https://yourserver.example.com/test.mp3" 2>&1  | grep Location

A resposta será semelhante a esta:

Location: https://secondserver.example.net/test.mp3 [following]
Location: http://thirdserver.example.org/test.mp3 [following]

Neste exemplo, há dois redirecionamentos. O primeiro redirecionamento é de https://yourserver.example.com/test.mp3 para https://secondserver.example.net/test.mp3. Ambos são HTTPS, então não é um redirecionamento entre protocolos. O segundo redirecionamento é de https://secondserver.example.net/test.mp3 para http://thirdserver.example.org/test.mp3. Isso redireciona de HTTPS para HTTP e, portanto, é um redirecionamento entre protocolos. O ExoPlayer não vai seguir esse redirecionamento na configuração padrão, o que significa que a reprodução vai falhar.

Se necessário, é possível configurar o ExoPlayer para seguir redirecionamentos entre protocolos ao instanciar instâncias DefaultHttpDataSource.Factory usadas no aplicativo. Saiba como selecionar e configurar a pilha de rede neste link.

Por que alguns streams falham com UnrecognizedInputFormatException?

Esta pergunta se refere a falhas de reprodução do seguinte tipo:

UnrecognizedInputFormatException: None of the available extractors
(MatroskaExtractor, FragmentedMp4Extractor, ...) could read the stream.

Há duas causas possíveis para essa falha. A causa mais comum é que você está tentando reproduzir conteúdo DASH (mpd), HLS (m3u8) ou SmoothStreaming (ism, isml), mas o player tenta reproduzi-lo como um stream progressivo. Para reproduzir essas transmissões, você precisa do módulo do ExoPlayer correspondente. Nos casos em que o URI do stream não termina com a extensão de arquivo padrão, também é possível transmitir MimeTypes.APPLICATION_MPD, MimeTypes.APPLICATION_M3U8 ou MimeTypes.APPLICATION_SS para setMimeType de MediaItem.Builder para especificar explicitamente o tipo de stream.

A segunda causa, menos comum, é que o ExoPlayer não é compatível com o formato de contêiner da mídia que você está tentando reproduzir. Nesse caso, a falha está funcionando conforme o esperado. No entanto, envie uma solicitação de recurso para nosso Issue Tracker, incluindo detalhes do formato do contêiner e um stream de teste. Pesquise uma solicitação de recurso existente antes de enviar uma nova.

Por que setPlaybackParameters não funciona corretamente em alguns dispositivos?

Ao executar um build de depuração do app no Android M e versões anteriores, você pode ter um desempenho instável, artefatos audíveis e alta utilização da CPU ao usar a API setPlaybackParameters. Isso ocorre porque uma otimização importante para essa API é desativada para builds de depuração em execução nessas versões do Android.

É importante observar que esse problema afeta apenas as builds de depuração. Isso não afeta os builds de lançamento, em que a otimização está sempre ativada. Portanto, as versões que você fornece aos usuários finais não devem ser afetadas por esse problema.

O que significam os erros "O player foi acessado na linha de execução errada"?

Consulte Uma observação sobre as linhas de execução na página de primeiros passos.

Como corrigir "Unexpected status line: ICY 200 OK"?

Esse problema pode ocorrer se a resposta do servidor incluir uma linha de status ICY, em vez de uma compatível com HTTP. As linhas de status ICY foram descontinuadas e não devem ser usadas. Portanto, se você controla o servidor, atualize-o para fornecer uma resposta compatível com HTTP. Se não for possível fazer isso, use a biblioteca OkHttp do ExoPlayer para resolver o problema, já que ela pode processar as linhas de status ICY corretamente.

Como posso consultar se o stream que está sendo reproduzido é uma transmissão ao vivo?

Você pode consultar o método isCurrentWindowLive do player. Além disso, você pode verificar isCurrentWindowDynamic para descobrir se a janela é dinâmica, ou seja, se ainda está sendo atualizada ao longo do tempo.

Como faço para manter o áudio tocando quando meu app está em segundo plano?

Siga estas etapas para garantir que o áudio continue tocando quando o app estiver em segundo plano:

  1. É necessário ter um serviço em primeiro plano em execução. Isso impede que o sistema encerre o processo para liberar recursos.
  2. Você precisa ter um WifiLock e um WakeLock. Isso garante que o sistema mantenha o rádio Wi-Fi e a CPU ativos. Isso pode ser feito facilmente se você usar ExoPlayer chamando setWakeMode, que vai adquirir e liberar automaticamente os bloqueios necessários nos momentos certos.

É importante liberar os bloqueios (se não estiver usando setWakeMode) e interromper o serviço assim que o áudio não estiver mais sendo reproduzido.

Por que o ExoPlayer é compatível com meu conteúdo, mas a biblioteca Cast do ExoPlayer não?

É possível que o conteúdo que você está tentando reproduzir não esteja ativado para CORS. O framework do Cast exige que o conteúdo esteja com o CORS ativado para ser reproduzido.

Por que o conteúdo não é reproduzido, mas nenhum erro é exibido?

É possível que o dispositivo em que você está reproduzindo o conteúdo não ofereça suporte a um formato de amostra de mídia específico. Para confirmar isso, adicione um EventLogger como listener ao player e procure uma linha semelhante a esta no Logcat:

[ ] Track:x, id=x, mimeType=mime/type, ... , supported=NO_UNSUPPORTED_TYPE

NO_UNSUPPORTED_TYPE significa que o dispositivo não consegue decodificar o formato de amostra de mídia especificado pelo mimeType. Consulte a documentação de formatos de mídia do Android para mais informações sobre os formatos de amostra compatíveis. Como posso fazer com que uma biblioteca de decodificação seja carregada e usada para reprodução? também pode ser útil.

Como posso carregar e usar uma biblioteca de decodificação para reprodução?

  • A maioria das bibliotecas de decodificador tem etapas manuais para conferir e criar as dependências. Portanto, siga as etapas no README da biblioteca relevante. Por exemplo, para a biblioteca FFmpeg do ExoPlayer, é necessário seguir as instruções em libraries/decoder_ffmpeg/README.md, incluindo a transmissão de flags de configuração para ativar decodificadores para todos os formatos que você quer reproduzir.
  • Para bibliotecas que têm código nativo, use a versão correta do Android NDK, conforme especificado no README, e fique atento a erros que aparecem durante a configuração e a criação. Os arquivos .so vão aparecer no subdiretório libs do caminho da biblioteca para cada arquitetura compatível depois que você seguir as etapas no README.
  • Para testar a reprodução usando a biblioteca no app de demonstração, consulte Ativar decodificadores em pacote. Consulte o README da biblioteca para ver instruções sobre como usá-la no seu app.
  • Se você estiver usando o DefaultRenderersFactory, uma linha de registro de nível de informação, como "Loaded FfmpegAudioRenderer", vai aparecer no Logcat quando o decodificador for carregado. Se isso estiver faltando, verifique se o aplicativo tem uma dependência na biblioteca de decodificação.
  • Se você encontrar registros de nível de aviso de LibraryLoader no Logcat, isso indica que o carregamento do componente nativo da biblioteca falhou. Se isso acontecer, verifique se você seguiu as etapas no README da biblioteca corretamente e se nenhum erro foi gerado ao seguir as instruções.

Se você ainda tiver problemas ao usar as bibliotecas de decodificação, verifique o Issue Tracker do Media3 para ver se há problemas recentes relevantes. Se você precisar registrar um novo problema relacionado à criação da parte nativa da biblioteca, inclua a saída completa da linha de comando ao executar as instruções do README para nos ajudar a diagnosticar o problema.

Posso reproduzir vídeos do YouTube diretamente com o ExoPlayer?

Não, o ExoPlayer não pode reproduzir vídeos do YouTube, como URLs do formato https://www.youtube.com/watch?v=.... Em vez disso, use a API YouTube IFrame Player, que é a maneira oficial de reproduzir vídeos do YouTube no Android.

A reprodução do vídeo está travando

Talvez o dispositivo não consiga decodificar o conteúdo com rapidez suficiente se, por exemplo, a taxa de bits ou a resolução do conteúdo excederem os recursos do dispositivo. Talvez seja necessário usar conteúdo de qualidade inferior para ter um bom desempenho nesses dispositivos.

Se você estiver enfrentando travamentos de vídeo em um dispositivo com uma versão do Android do Android 6.0 (nível 23 da API) até o Android 11 (nível 30 da API), especialmente ao reproduzir conteúdo protegido por DRM ou com alta frame rate, tente ativar o enfileiramento de buffer assíncrono.

Erros de lint de API instável

O Media3 garante compatibilidade binária para um subconjunto da plataforma da API. As partes que não garantem a compatibilidade binária são marcadas com @UnstableApi. Para deixar essa distinção clara, os usos de símbolos de API instáveis geram um erro de lint, a menos que sejam anotados com @OptIn.

A anotação @UnstableApi não implica nada sobre a qualidade ou o desempenho de uma API, apenas o fato de que ela não está "congelada".

Você tem duas opções para lidar com erros de lint de API instável:

  • Mude para uma API estável que alcance o mesmo resultado.
  • Continue usando a API instável e anote o uso com @OptIn, conforme mostrado abaixo.
Adicione a anotação @OptIn:

O Android Studio pode ajudar você a adicionar a anotação:

Captura de tela: como adicionar a anotação de ativação
Figura 2: adição de uma anotação @androidx.annotations.OptIn com o Android Studio.

Também é possível anotar manualmente sites de uso específicos:

Kotlin

import androidx.annotation.OptIn
import androidx.media3.common.util.UnstableApi

@OptIn(UnstableApi::class)
fun functionUsingUnstableApi() { ... }

Java

import androidx.annotation.OptIn;
import androidx.media3.common.util.UnstableApi;

@OptIn(markerClass = UnstableApi.class)
private void methodUsingUnstableApis() { ... }

Para ativar pacotes inteiros, adicione um arquivo package-info:

Kotlin

// In your package-info.kt
@OptIn(UnstableApi::class)
package name.of.your.package

import androidx.annotation.OptIn
import androidx.media3.common.util.UnstableApi

Java

// In your package-info.java
@OptIn(markerClass = UnstableApi.class)
package name.of.your.package;

import androidx.annotation.OptIn;
import androidx.media3.common.util.UnstableApi;

Projetos inteiros podem ser ativados suprimindo o erro de lint específico no arquivo lint.xml:

 <?xml version="1.0" encoding="utf-8"?>
 <lint>
   <issue id="UnsafeOptInUsageError">
     <option name="opt-in" value="androidx.media3.common.util.UnstableApi" />
   </issue>
 </lint>

Há também uma anotação kotlin.OptIn que não deve ser usada. É importante usar a anotação androidx.annotation.OptIn.

Como posso testar ou isolar problemas causados por novas otimizações ou recursos?

O Media3 inclui uma infraestrutura de flags de recursos em que os novos recursos e otimizações são ativados por padrão no modo Canary.

Se você suspeitar que um problema ou uma regressão no app está relacionado a um recurso ou uma otimização recém-introduzidos, desative temporariamente o modo canário:

Flags.setCanaryModeEnabled(false);

Ou desative flags de recursos específicas individualmente usando Flags.disableFlag(flagId). Para mais detalhes sobre como configurar o modo canário, substituir flags e configurar interruptores de emergência remotos, consulte o guia de flags de recurso e modo canário.