Gestion des droits numériques

ExoPlayer utilise l'API MediaDrm d'Android pour prendre en charge la lecture de contenu protégé par DRM. Les versions minimales d'Android requises pour les différents schémas DRM compatibles, ainsi que les formats de streaming pour lesquels ils sont compatibles, sont décrits dans le tableau suivant :

Schéma DRM	Numéro de version d'Android	Niveau d'API Android	Formats compatibles
Widevine "cenc"	4.4	19	DASH, HLS (FMP4 uniquement)
Widevine "cbcs"	7.1	25	DASH, HLS (FMP4 uniquement)
ClearKey "cenc"	5,0	21	DASH
PlayReady SL2000 "cenc"	Android TV	Android TV	DASH, SmoothStreaming, HLS (FMP4 uniquement)

Pour lire du contenu protégé par DRM avec ExoPlayer, l'UUID du système DRM doit être spécifié lors de la création d'un élément multimédia. D'autres propriétés peuvent également être fournies. Le lecteur utilisera ensuite ces propriétés pour créer une implémentation par défaut de DrmSessionManager, appelée DefaultDrmSessionManager, qui convient à la plupart des cas d'utilisation. Pour certains cas d'utilisation, des propriétés DRM supplémentaires peuvent être nécessaires, comme indiqué dans les sections suivantes.

Rotation des clés

Pour lire des flux avec des clés rotatives, transmettez true à MediaItem.DrmConfiguration.Builder.setMultiSession lors de la création de l'élément multimédia.

Contenu à clés multiples

Le contenu à clés multiples se compose de plusieurs flux, dont certains utilisent des clés différentes. Le contenu à clés multiples peut être lu de deux manières, selon la configuration du serveur de licences.

Cas 1 : Le serveur de licences répond avec toutes les clés du contenu

Dans ce cas, le serveur de licences est configuré de sorte que, lorsqu'il reçoit une demande pour une clé, il répond avec toutes les clés du contenu. ExoPlayer gère ce cas sans nécessiter de configuration spéciale. L'adaptation entre les flux (par exemple, les vidéos SD et HD) est fluide, même s'ils utilisent des clés différentes.

Dans la mesure du possible, nous vous recommandons de configurer votre serveur de licences pour qu'il se comporte de cette manière. Il s'agit du moyen le plus efficace et le plus robuste de prendre en charge la lecture de contenu multiclés, car il ne nécessite pas que le client effectue plusieurs demandes de licence pour accéder aux différents flux.

Cas 2 : Le serveur de licence ne répond qu'avec la clé demandée

Dans ce cas, le serveur de licences est configuré pour ne répondre qu'avec la clé spécifiée dans la requête. Le contenu à clés multiples peut être lu avec cette configuration de serveur de licences en transmettant true à MediaItem.DrmConfiguration.Builder.setMultiSession lors de la création de l'élément multimédia.

Nous vous déconseillons de configurer votre serveur de licences de cette manière. Il nécessite des demandes de licence supplémentaires pour lire du contenu à clés multiples, ce qui est moins efficace et robuste que l'alternative décrite ci-dessus.

Clés hors connexion

Un ensemble de clés hors connexion peut être chargé en transmettant l'ID de l'ensemble de clés à MediaItem.DrmConfiguration.Builder.setKeySetId lors de la création de l'élément multimédia. Cela permet la lecture à l'aide des clés stockées dans l'ensemble de clés hors connexion avec l'ID spécifié.

Problème connu 3872 : Une seule clé hors connexion peut être spécifiée par lecture. Par conséquent, la lecture hors connexion de contenu à clés multiples n'est actuellement possible que lorsque le serveur de licences est configuré comme décrit dans le cas 1 ci-dessus.

Sessions DRM pour le contenu clair

L'utilisation de l'espace réservé DrmSessions permet à ExoPlayer d'utiliser les mêmes décodeurs pour le contenu clair que ceux utilisés lors de la lecture de contenu chiffré. Lorsque le contenu multimédia contient à la fois des sections claires et chiffrées, vous pouvez utiliser l'espace réservé DrmSessions pour éviter de recréer des décodeurs lors des transitions entre les sections claires et chiffrées. L'utilisation du placeholder DrmSessions pour les pistes audio et vidéo peut être activée en transmettant true à MediaItem.DrmConfiguration.Builder.forceSessionsForAudioAndVideoTracks lors de la création de l'élément multimédia.

Utiliser un DrmSessionManager personnalisé

Si une application souhaite personnaliser le DrmSessionManager utilisé pour la lecture, elle peut implémenter un DrmSessionManagerProvider et le transmettre au MediaSource.Factory qui est utilisé lors de la création du lecteur. Le fournisseur peut choisir d'instancier ou non une nouvelle instance de gestionnaire à chaque fois. Pour toujours utiliser la même instance :

Kotlin

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

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

Améliorer les performances de lecture

Si vous rencontrez des saccades vidéo lorsque vous lisez du contenu protégé par DRM sur un appareil exécutant une version d'Android comprise entre Android 6.0 (niveau d'API 23) et Android 11 (niveau d'API 30) inclus, vous pouvez essayer d'activer la mise en file d'attente asynchrone des tampons.