Gestion des droits numériques

ExoPlayer utilise l'API MediaDrm d'Android pour prendre en charge la lecture protégée 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écrites dans le tableau suivant:

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, adaptée à 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 touches rotatives, transmettez true à MediaItem.DrmConfiguration.Builder.setMultiSession lors de la création de l'élément multimédia.

Contenu multiclavier

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

Cas 1: Le serveur de gestion des 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 requête pour une clé, il répond avec toutes les clés du contenu. Ce cas est géré par ExoPlayer sans aucune 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 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é, car le client n'a pas besoin d'effectuer plusieurs demandes de licence pour accéder aux différents flux.

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

Dans ce cas, le serveur de licence est configuré pour ne répondre qu'avec la clé spécifiée dans la requête. Le contenu multi-clé peut être lu avec cette configuration de serveur de licence 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. Des demandes de licence supplémentaires sont nécessaires pour lire du contenu multiclé, ce qui est moins efficace et moins robuste que l'alternative décrite ci-dessus.

Clés hors connexion

Vous pouvez charger un ensemble de clés hors connexion 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 la clé hors connexion définie avec l'ID spécifié.

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 la recréation de décodeurs lors des transitions entre les sections claires et chiffrées. Vous pouvez activer l'utilisation de l'espace réservé DrmSessions pour les pistes audio et vidéo 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 une nouvelle instance de gestionnaire à chaque fois ou non. Pour toujours utiliser la même instance, procédez comme suit:

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);

Amélioration des performances de lecture

Si la vidéo est saccadée lors de la lecture de contenu protégé par DRM sur un appareil exécutant n'importe quelle version d'Android depuis Android 6.0 (niveau d'API 23) jusqu'à Android 11 (niveau d'API 30), vous pouvez essayer d'activer la mise en file d'attente de tampon asynchrone.