Gerenciamento de direitos digitais

O ExoPlayer usa a API MediaDrm do Android para oferecer suporte à reprodução protegida por DRM. As versões mínimas do Android necessárias para diferentes esquemas de DRM compatíveis, junto com os formatos de streaming para os quais eles são compatíveis, são descritas na tabela abaixo:

Para reproduzir conteúdo protegido por DRM com o ExoPlayer, o UUID do sistema DRM precisa ser especificado ao criar um item de mídia, e outras propriedades também podem ser fornecidas. O player vai usar essas propriedades para criar uma implementação padrão de DrmSessionManager, chamada DefaultDrmSessionManager, que é adequada para a maioria dos casos de uso. Para alguns casos de uso, pode ser necessário usar outras propriedades de DRM, conforme descrito nas seções a seguir.

Rotação de chaves

Para reproduzir transmissões com chaves alternadas, transmita true para MediaItem.DrmConfiguration.Builder.setMultiSession ao criar o item de mídia.

Conteúdo com várias chaves

O conteúdo com várias chaves consiste em várias transmissões, em que algumas usam chaves diferentes das outras. O conteúdo com várias chaves pode ser reproduzido de duas maneiras, dependendo da configuração do servidor de licença.

Caso 1: o servidor de licença responde com todas as chaves do conteúdo

Nesse caso, o servidor de licença é configurado para que, quando receber uma solicitação de uma chave, ele responda com todas as chaves do conteúdo. Esse caso é gerenciado pelo ExoPlayer sem a necessidade de nenhuma configuração especial. A adaptação entre streams (por exemplo, vídeos em SD e HD) é perfeita, mesmo que eles usem chaves diferentes.

Sempre que possível, recomendamos que você configure seu servidor de licenças para se comportar dessa maneira. É a maneira mais eficiente e robusta de oferecer suporte à reprodução de conteúdo com várias chaves, porque não exige que o cliente faça várias solicitações de licença para acessar os diferentes streams.

Caso 2: o servidor de licença responde apenas com a chave solicitada

Nesse caso, o servidor de licenças é configurado para responder apenas com a chave especificada na solicitação. O conteúdo de várias chaves pode ser reproduzido com essa configuração do servidor de licença transmitindo true para MediaItem.DrmConfiguration.Builder.setMultiSession ao criar o item de mídia.

Não recomendamos que você configure seu servidor de licenças para ter esse comportamento. Ele precisa de solicitações de licença extras para reproduzir conteúdo com várias chaves, que é menos eficiente e robusto do que a alternativa descrita acima.

Chaves off-line

É possível carregar um conjunto de chaves off-line transmitindo o ID do conjunto de chaves para MediaItem.DrmConfiguration.Builder.setKeySetId ao criar o item de mídia. Isso permite a reprodução usando as chaves armazenadas no conjunto de chaves off-line com o ID especificado.

Sessões de DRM para conteúdo claro

O uso do marcador de posição DrmSessions permite que ExoPlayer use os mesmos decodificadores para conteúdo claro que são usados ao reproduzir conteúdo criptografado. Quando a mídia contém seções claras e criptografadas, use o marcador de posição DrmSessions para evitar a recriação de decodificadores quando ocorrerem transições entre seções claras e criptografadas. O uso do marcador de posição DrmSessions para faixas de áudio e vídeo pode ser ativado transmitindo true para MediaItem.DrmConfiguration.Builder.forceSessionsForAudioAndVideoTracks ao criar o item de mídia.

Como usar um DrmSessionManager personalizado

Se um app quiser personalizar o DrmSessionManager usado para reprodução, ele poderá implementar um DrmSessionManagerProvider e transmitir para o MediaSource.Factory, que é usado ao criar o player. O provedor pode escolher se vai instanciar uma nova instância de gerenciador sempre ou não. Para sempre usar a mesma instância:

val customDrmSessionManager: DrmSessionManager = CustomDrmSessionManager()
// Pass a drm session manager provider to the media source factory.
val mediaSourceFactory =
  DefaultMediaSourceFactory(context).setDrmSessionManagerProvider { customDrmSessionManager }

DrmSessionManager customDrmSessionManager = new CustomDrmSessionManager(/* ... */ );
// Pass a drm session manager provider to the media source factory.
MediaSource.Factory mediaSourceFactory =
    new DefaultMediaSourceFactory(context)
        .setDrmSessionManagerProvider(mediaItem -> customDrmSessionManager);

Melhorar a performance de reprodução

Se o vídeo estiver travando ao reproduzir conteúdo protegido por DRM em um dispositivo com qualquer versão do Android, do Android 6.0 (nível 23 da API) até o Android 11 (nível 30 da API), tente ativar a fila de buffer assíncrona.