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:
| Esquema DRM | Número da versão do Android | Nível da Android API | Formatos com suporte |
|---|---|---|---|
| Widevine "cenc" | 4.4 | 19 | DASH, HLS (somente fMP4) |
| "cbcs" de Widevine | 7.1 | 25 | DASH, HLS (somente FMP4) |
| ClearKey "cenc" | 5.0 | 21 | DASH |
| PlayReady SL2000 "cenc" | Android TV | Android TV | DASH, SmoothStreaming, HLS (somente fMP4) |
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:
Kotlin
val customDrmSessionManager: DrmSessionManager = CustomDrmSessionManager()
// Pass a drm session manager provider to the media source factory.
val mediaSourceFactory =
DefaultMediaSourceFactory(context).setDrmSessionManagerProvider { customDrmSessionManager }
Java
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.