Gestion des droits numériques

ExoPlayer utilise l'API MediaDrm d'Android pour permettre la lecture protégée par DRM. Les versions minimales d'Android requises pour différents schémas DRM compatibles, ainsi que les formats de streaming pour lesquels elles sont compatibles, sont décrits 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, 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 alternées, transmettez true à MediaItem.DrmConfiguration.Builder.setMultiSession lors de la création de l'élément multimédia.

Contenu à plusieurs touches

Un contenu à clés multiples 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 licences répond avec toutes les clés pour le contenu

Dans ce cas, le serveur de licences est configuré de sorte que lorsqu'il reçoit une requête pour une clé, il renvoie toutes les clés correspondant au contenu. Ce cas est géré par ExoPlayer sans nécessiter de configuration spéciale. L'adaptation entre les flux (par exemple, vidéo 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 sorte qu'il se comporte de cette manière. Il s'agit du moyen le plus efficace et le plus fiable de prendre en charge la lecture de contenu à plusieurs clés, car il n'oblige pas le client à effectuer plusieurs demandes de licence pour accéder aux différents flux.

Scénario 2: le serveur de licences répond uniquement avec la clé demandée

Dans ce cas, le serveur de licences est configuré pour répondre uniquement avec la clé spécifiée dans la requête. Le contenu à plusieurs clés 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. Elle nécessite des demandes de licence supplémentaires pour lire du contenu à plusieurs touches, 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 la clé hors connexion définie avec l'ID spécifié.

Sessions DRM pour un contenu clair

L'utilisation de l'espace réservé DrmSessions permet à ExoPlayer d'utiliser les mêmes décodeurs pour le contenu clair que 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éliorer les 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.