Langue

MediaDrm Classe

Définition

MediaDrm peut être utilisé pour obtenir des clés pour déchiffrer des flux multimédias protégés, conjointement avec android.media.MediaCrypto.

[Android.Runtime.Register("android/media/MediaDrm", DoNotGenerateAcw=true)]
public sealed class MediaDrm : Java.Lang.Object, IDisposable, Java.Lang.IAutoCloseable
[<Android.Runtime.Register("android/media/MediaDrm", DoNotGenerateAcw=true)>]
type MediaDrm = class
    inherit Object
    interface IAutoCloseable
    interface IJavaObject
    interface IDisposable
    interface IJavaPeerable
Héritage
Attributs
Implémente

Remarques

MediaDrm peut être utilisé pour obtenir des clés pour déchiffrer des flux multimédias protégés, conjointement avec android.media.MediaCrypto. Les API MediaDrm sont conçues pour prendre en charge la norme ISO/IEC 23001-7 : Standard de chiffrement commun, mais peuvent également être utilisées pour implémenter d’autres schémas de chiffrement.

Le contenu chiffré est préparé à l’aide d’un serveur de chiffrement et stocké dans une bibliothèque de contenu. Le contenu chiffré est diffusé ou téléchargé à partir de la bibliothèque de contenu vers les appareils clients via des serveurs de contenu. Les licences permettant d’afficher le contenu sont obtenues à partir d’un serveur de licences.

<img src=".. /.. /.. /images/mediadrm_overview.png" alt="MediaDrm Overview diagram » border="0 » />

Les clés sont demandées auprès du serveur de licences à l’aide d’une demande de clé. La réponse clé est remise à l’application cliente, qui fournit la réponse à l’API MediaDrm.

Un serveur d’approvisionnement peut être nécessaire pour distribuer des informations d’identification uniques d’appareil aux appareils.

L’application des exigences relatives au nombre d’appareils pouvant lire du contenu simultanément peut être effectuée via le renouvellement de clé ou l’utilisation des méthodes d’arrêt sécurisées.

Le diagramme de séquence suivant montre les interactions entre les objets impliqués lors de la lecture du contenu chiffré :

<img src=".. /.. /.. /images/mediadrm_decryption_sequence.png" alt="MediaDrm Overview diagram » border="0 » />

La première construction et android.media.MediaExtractor les android.media.MediaCodec objets de l’application. Il accède à l’UUID d’identification du schéma DRM, généralement à partir de métadonnées dans le contenu, et utilise cet UUID pour construire une instance d’un objet MediaDrm capable de prendre en charge le schéma DRM requis par le contenu. Les schémas de chiffrement sont attribués à 16 octets UUID. La méthode #isCryptoSchemeSupported peut être utilisée pour interroger si un schéma donné est pris en charge sur l’appareil.

L’application appelle #openSession pour générer un id de session qui identifie de façon unique la session dans les interactions suivantes. L’application utilise ensuite l’objet MediaDrm pour obtenir un message de demande de clé et l’envoyer au serveur de licences, puis fournir la réponse du serveur à l’objet MediaDrm.

Une fois que l’application a un sessionId, elle peut construire un objet MediaCrypto à partir de l’UUID et de la sessionId. L’objet MediaCrypto est inscrit auprès du MediaCodec dans la MediaCodec#configure méthode pour permettre au codec de déchiffrer le contenu.

Lorsque l’application a construit android.media.MediaExtractor, android.media.MediaCodec et android.media.MediaCrypto des objets, elle procède à l’extraction d’exemples à partir de l’extracteur et à la file d’attente dans le décodeur. Pour le contenu chiffré, les exemples retournés par l’extracteur restent chiffrés, ils ne sont déchiffrés que lorsque les échantillons sont remis au décodeur.

Les méthodes MediaDrm lèvent android.media.MediaDrm.MediaDrmStateException lorsqu’une méthode est appelée sur un objet MediaDrm qui a subi une défaillance irrécupérable dans le plug-in DRM ou le matériel de sécurité. android.media.MediaDrm.MediaDrmStateException java.lang.IllegalStateException s’étend avec l’ajout d’une chaîne d’informations de diagnostic lisible par les développeurs associée à l’exception.

En cas d’incident ou de redémarrage d’un processus mediaserver pendant qu’un objet MediaDrm est actif, les méthodes MediaDrm peuvent lever android.media.MediaDrmResetException. Pour récupérer, l’application doit libérer l’objet MediaDrm, puis créer et initialiser un nouvel objet.

Comme android.media.MediaDrmResetException et android.media.MediaDrm.MediaDrmStateException les deux s’étendent java.lang.IllegalStateException, ils doivent se trouver dans un bloc catch() antérieur que java.lang.IllegalStateException s’ils sont gérés séparément.

« Rappels"><h3>rappels</h3>

Les applications doivent s’inscrire aux événements d’information afin d’être informées des mises à jour d’état clés pendant la lecture ou la diffusion en continu. L’inscription pour ces événements est effectuée via un appel à #setOnEventListener. Pour recevoir le rappel respectif associé à cet écouteur, les applications doivent créer des objets MediaDrm sur un thread avec son propre looper en cours d’exécution (le thread d’interface utilisateur principal par défaut a un looper en cours d’exécution).

Java documentation pour android.media.MediaDrm.

Les parties de cette page sont des modifications basées sur le travail créé et partagé par Android Open Source et utilisées en fonction des termes décrits dans la Creative Commons 2.5 Attribution License.

Constructeurs

Nom Description
MediaDrm(UUID)

Instancier un objet MediaDrm

Champs

Nom Description
EventKeyExpired

Ce type d’événement indique que la durée d’utilisation sous licence des clés d’une session a expiré.

EventKeyRequired
Obsolète.

Ce type d’événement indique que l’application doit demander des clés à partir d’un serveur de licences.

EventProvisionRequired
Obsolète.

Ce type d’événement indique que l’application doit demander un certificat auprès du serveur d’approvisionnement.

EventSessionReclaimed
Obsolète.

Cet événement indique qu’une session ouverte par l’application a été récupérée par le gestionnaire de ressources.

EventVendorDefined
Obsolète.

Cet événement peut indiquer une condition spécifique définie par le fournisseur, consultez la documentation de votre fournisseur DRM pour plus d’informations

HdcpLevelUnknown
Obsolète.

Le plug-in DRM n’a pas déclaré de niveau HDCP, ou une erreur s’est produite lors de son accès

HdcpNoDigitalOutput
Obsolète.

Aucune sortie numérique, implicitement sécurisée

HdcpNone
Obsolète.

HDCP n’est pas pris en charge sur cet appareil, le contenu n’est pas protégé

HdcpV1
Obsolète.

HDCP version 1.

HdcpV2
Obsolète.

HDCP version 2.

HdcpV21
Obsolète.

HDCP version 2.

HdcpV22
Obsolète.

HDCP version 2.

HdcpV23
Obsolète.

HDCP version 2.

KeyTypeOffline
Obsolète.

Ce type de demande de clé spécifie que les clés seront utilisées hors connexion, elles seront enregistrées sur l’appareil à utiliser lorsque l’appareil n’est pas connecté à un réseau.

KeyTypeRelease
Obsolète.

Ce type de demande de clé spécifie que les clés hors connexion précédemment enregistrées doivent être libérées.

KeyTypeStreaming
Obsolète.

Cette espèce de type de requête clé que les clés seront utilisées en ligne, elles ne seront pas enregistrées sur l’appareil pour une utilisation ultérieure lorsque l’appareil n’est pas connecté à un réseau.

OfflineLicenseStateReleased
Obsolète.

La licence hors connexion est publiée, les clés ont été marquées pour la mise en production #getKeyRequest avec KEY_TYPE_RELEASE, mais la réponse de clé n’a pas été reçue.

OfflineLicenseStateUnknown
Obsolète.

L’état de la licence hors connexion est inconnu, une erreur s’est produite lors de sa tentative d’accès.

OfflineLicenseStateUsable
Obsolète.

La licence hors connexion est utilisable, les clés peuvent être utilisées pour le déchiffrement.

PropertyAlgorithms

Nom de propriété de chaîne : liste séparée par des virgules d’algorithmes de chiffrement et mac pris en charge par CryptoSession.

PropertyDescription

Nom de la propriété de chaîne : décrit le plug-in DRM

PropertyDeviceUniqueId

Nom de propriété de tableau d’octets : l’identificateur unique de l’appareil est établi pendant l’approvisionnement de l’appareil et fournit un moyen d’identifier de manière unique chaque appareil.

PropertyVendor

Nom de la propriété de chaîne : identifie le créateur du plug-in DRM

PropertyVersion

Nom de la propriété de chaîne : identifie la version du plug-in DRM

SecurityLevelHwSecureAll
Obsolète.

La gestion des clés DRM, les opérations de chiffrement, le décodage du contenu et la gestion de tous les supports (compressés et non compressés) sont gérées dans un environnement d’exécution approuvé soutenu par le matériel.

SecurityLevelHwSecureCrypto
Obsolète.

La gestion des clés DRM et les opérations de chiffrement sont effectuées dans un environnement d’exécution approuvé soutenu par le matériel.

SecurityLevelHwSecureDecode
Obsolète.

La gestion des clés DRM, les opérations de chiffrement et le décodage du contenu sont effectuées dans un environnement d’exécution approuvé soutenu par le matériel.

SecurityLevelSwSecureCrypto
Obsolète.

La gestion des clés DRM utilise le chiffrement de boîte de réception logicielle.

SecurityLevelSwSecureDecode
Obsolète.

La gestion des clés DRM et le décodage utilisent le chiffrement de boîte de réception logicielle.

SecurityLevelUnknown
Obsolète.

Le plug-in DRM n’a pas indiqué de niveau de sécurité, ou une erreur s’est produite lors de son accès

Propriétés

Nom Description
Class

Retourne la classe runtime de ce Object.

(Hérité de Object)
ConnectedHdcpLevel

Retournez le niveau HDCP négocié avec les récepteurs en aval où l’appareil est connecté.

Handle

Handle de l’instance Android sous-jacente.

(Hérité de Object)
JniIdentityHashCode

Obtient le code de hachage d’identité affecté à cet homologue Java par le runtime d’interopérabilité.

(Hérité de Object)
JniManagedPeerState

Obtient les indicateurs d’état affectés en dernier par le runtime.

(Hérité de JavaObject)
JniPeerMembers

Obtient les métadonnées JNI utilisées pour accéder aux membres de cette liaison Java.

LogMessages

Retourne une valeur récente LogMessage LogMessages associée à cette MediaDrm instance.

MaxHdcpLevel

Retourne le niveau HDCP maximal pris en charge.

MaxSecurityLevel

Retourne une valeur qui peut être passée en tant que paramètre pour #openSession(int) demander que la session soit ouverte au niveau de sécurité maximal de l’appareil.

MaxSessionCount

Retourne le nombre maximal de sessions MediaDrm qui peuvent être ouvertes en simultaneosly entre toutes les instances MediaDrm pour le schéma DRM actif.

Metrics

Retournez des données de métriques sur l’instance MediaDrm actuelle.

OfflineLicenseKeySetIds

Les clés d’une licence hors connexion permettent de lire du contenu protégé même si l’appareil n’est pas connecté à un réseau.

OpenSessionCount

Retourne le nombre de sessions MediaDrm actuellement ouvertes simultanément entre toutes les instances MediaDrm pour le schéma DRM actif.

PeerReference

Obtient la référence d’objet JNI pour cet homologue Java.

(Hérité de Object)
SecureStopIds

Retourne une liste de tous les ID d’arrêt sécurisés actuellement en mémoire persistante.

SecureStops

Les arrêts sécurisés permettent d’appliquer des limites au nombre de flux simultanés par abonné sur les appareils.

SupportedCryptoSchemes

Obtient les UUID du schéma DRM énumérés comme pris en charge par la plateforme.

ThresholdClass

Cette API prend en charge l’infrastructure Mono pour Android et n’est pas destinée à être utilisée directement à partir de votre code.

(Hérité de Object)
ThresholdType

Cette API prend en charge l’infrastructure Mono pour Android et n’est pas destinée à être utilisée directement à partir de votre code.

(Hérité de Object)

Méthodes

Nom Description
ClearOnEventListener()

Effacez le OnEventListener.

ClearOnExpirationUpdateListener()

Effacez le OnExpirationUpdateListener.

ClearOnKeyStatusChangeListener()

Effacez le OnKeyStatusChangeListener.

ClearOnSessionLostStateListener()

Effacez le OnSessionLostStateListener.

Clone()

Crée et retourne une copie de cet objet.

(Hérité de Object)
Close()

Libère les ressources associées à la session actuelle de MediaDrm.

CloseSession(Byte[])

Fermez une session sur l’objet MediaDrm qui a été ouvert précédemment avec #openSession.

Construct(JniObjectReference, JniObjectReferenceOptions)

Délègue la construction de cet homologue au gestionnaire de valeurs du runtime.

(Hérité de JavaObject)
Dispose()

Libère les ressources détenues par cet homologue Java.

(Hérité de Object)
Dispose(Boolean)

Libère les ressources détenues par cet homologue Java.

(Hérité de Object)
DisposeUnlessReferenced()

Demande au gestionnaire de valeurs de supprimer cet homologue, sauf si son mappage conserve cette même instance managée.

(Hérité de JavaObject)
Equals(Object)

Teste si un autre homologue managé fait référence au même objet Java.

(Hérité de JavaObject)
Equals(Object)

Indique si un autre objet est « égal à » celui-ci.

(Hérité de Object)
GetCryptoSession(Byte[], String, String)

Obtenez un objet CryptoSession qui peut être utilisé pour chiffrer, déchiffrer, signer et vérifier des messages ou des données à l’aide des clés de session établies pour la session à l’aide de méthodes #getKeyRequest et #provideKeyResponse d’un serveur de clés de session.

GetHashCode()

Retourne une valeur de code de hachage pour l’objet.

(Hérité de Object)
GetKeyRequest(Byte[], Byte[], String, Int32, IDictionary<String,String>)

Un échange de demande/réponse de clé se produit entre l’application et un serveur de licences pour obtenir ou libérer des clés utilisées pour déchiffrer le contenu chiffré.

GetOfflineLicenseState(Byte[])

Demandez l’état d’une licence hors connexion.

GetPlaybackComponent(Byte[])

Obtenez un PlaybackComponent associé à une session DRM.

GetPropertyByteArray(String)

Lisez une valeur de propriété de tableau d’octets MediaDrm, en fonction de la chaîne de nom de propriété.

GetPropertyString(String)

Lisez une valeur de propriété MediaDrm String, en fonction de la chaîne de nom de propriété.

GetProvisionRequest()

Un échange de demande/réponse d’approvisionnement se produit entre l’application et un serveur d’approvisionnement pour récupérer un certificat d’appareil.

GetSecureStop(Byte[])

Accédez à un arrêt sécurisé spécifique en fonction de son ID d’arrêt sécurisé.

GetSecurityLevel(Byte[])

Retourne le niveau de sécurité actuel d’une session.

IsCryptoSchemeSupported(UUID, String, SecurityLevel)

Interrogez si le schéma donné identifié par son UUID est pris en charge sur cet appareil et si le plug-in DRM est en mesure de gérer le format de conteneur multimédia spécifié par mimeType au niveau de sécurité demandé.

IsCryptoSchemeSupported(UUID, String)

Interrogez si le schéma donné identifié par son UUID est pris en charge sur cet appareil et si le plug-in DRM est en mesure de gérer le format de conteneur multimédia spécifié par mimeType.

IsCryptoSchemeSupported(UUID)

Interrogez si le schéma donné identifié par son UUID est pris en charge sur cet appareil.

JavaFinalize()
Obsolète.

Appelé par le garbage collector sur un objet lorsque le garbage collection détermine qu’il n’y a plus de références à l’objet.

(Hérité de Object)
Notify()

Réveille un thread unique qui attend le moniteur de cet objet.

(Hérité de Object)
NotifyAll()

Réveille tous les threads qui attendent le moniteur de cet objet.

(Hérité de Object)
OpenSession()

Ouvrez une nouvelle session avec l’objet MediaDrm.

OpenSession(Int32)

Ouvrez une nouvelle session au niveau de sécurité demandé.

ProvideKeyResponse(Byte[], Byte[])

Une réponse clé est reçue du serveur de licences par l’application, puis elle est fournie à l’instance MediaDrm à l’aide de provideKeyResponse.

ProvideProvisionResponse(Byte[])

Une fois qu’une réponse d’approvisionnement est reçue par l’application, elle est fournie à l’instance MediaDrm à l’aide de cette méthode.

QueryKeyStatus(Byte[])

Demandez une description informative de l’état de la clé pour la session.

Release()

Ce membre est déconseillé.

ReleaseAllSecureStops()

Supprimez tous les arrêts sécurisés sans nécessiter de message de mise en production d’arrêt sécurisé du serveur de licences.

ReleaseSecureStops(Byte[])

Traitez le message de réponse de serveur d’arrêt sécurisé ssRelease.

RemoveAllSecureStops()

Supprimez tous les arrêts sécurisés sans nécessiter de message de mise en production d’arrêt sécurisé du serveur de licences.

RemoveKeys(Byte[])

Supprimez les clés actuelles d’une session.

RemoveOfflineLicense(Byte[])

Normalement, les licences hors connexion sont publiées à l’aide d’un échange de demande/réponse de clé à l’aide #getKeyRequest de l’emplacement où le type de clé est KEY_TYPE_RELEASE, suivi de #provideKeyResponse.

RemoveSecureStop(Byte[])

Supprimez un arrêt sécurisé spécifique sans nécessiter de message de mise en production d’arrêt sécurisé du serveur de licences.

RequiresSecureDecoder(String, Int32)

Interrogez si le schéma de chiffrement nécessite l’utilisation d’un décodeur sécurisé pour décoder les données du type mime donné au niveau de sécurité donné.

RequiresSecureDecoder(String)

Interrogez si le schéma de chiffrement nécessite l’utilisation d’un décodeur sécurisé pour décoder les données du type mime donné au niveau de sécurité par défaut.

RestoreKeys(Byte[], Byte[])

Restaurez les clés hors connexion persistantes dans une nouvelle session.

SetHandle(IntPtr, JniHandleOwnership)

Définit la propriété Handle.

(Hérité de Object)
SetOnEventListener(IExecutor, MediaDrm+IOnEventListener)

Inscrire un rappel à appeler lorsqu’un événement se produit

SetOnEventListener(MediaDrm+IOnEventListener, Handler)

Inscrire un rappel à appeler lorsqu’un événement se produit

SetOnEventListener(MediaDrm+IOnEventListener)

Inscrire un rappel à appeler lorsqu’un événement se produit

SetOnExpirationUpdateListener(IExecutor, MediaDrm+IOnExpirationUpdateListener)

Inscrivez un rappel à appeler lorsqu’une mise à jour d’expiration de session se produit.

SetOnExpirationUpdateListener(MediaDrm+IOnExpirationUpdateListener, Handler)

Inscrivez un rappel à appeler lorsqu’une mise à jour d’expiration de session se produit.

SetOnKeyStatusChangeListener(IExecutor, MediaDrm+IOnKeyStatusChangeListener)

Inscrivez un rappel à appeler lorsque l’état des clés dans une session change, e.

SetOnKeyStatusChangeListener(MediaDrm+IOnKeyStatusChangeListener, Handler)

Inscrivez un rappel à appeler lorsque l’état des clés dans une session change, e.

SetOnSessionLostStateListener(IExecutor, MediaDrm+IOnSessionLostStateListener)

Inscrivez un rappel à appeler lorsque l’état de session a été perdu.

SetOnSessionLostStateListener(MediaDrm+IOnSessionLostStateListener, Handler)

Inscrivez un rappel à appeler lorsque l’état de session a été perdu.

SetPeerReference(JniObjectReference, JniObjectReferenceOptions)

Stocke une valeur de référence dans le bloc de contrôle sans créer de copie de référence JNI.

(Hérité de JavaObject)
SetPropertyByteArray(String, Byte[])

Définissez une valeur de propriété de tableau d’octets MediaDrm, en fonction de la chaîne de nom de propriété et de la nouvelle valeur de la propriété.

SetPropertyString(String, String)

Définissez une valeur de propriété String MediaDrm, en fonction de la chaîne de nom de propriété et de la nouvelle valeur de la propriété.

ToArray<T>()

Crée un tableau managé à partir de ce wrapper de tableau Java.

(Hérité de Object)
ToString()

Retourne une représentation sous forme de chaîne de l’objet.

(Hérité de Object)
UnregisterFromRuntime()

Annule l’inscription de cet homologue Java à partir du runtime d’interopérabilité.

(Hérité de Object)
Wait()

Provoque l’attente du thread actuel jusqu’à ce qu’il soit réveillé, généralement en étant <averti par em ou><em>interrompu</em>.<>

(Hérité de Object)
Wait(Int64, Int32)

Provoque l’attente du thread actuel jusqu’à ce qu’il soit réveillé, généralement en étant <averti> par< em>ou <em>interrompu/em<,> ou jusqu’à ce qu’une certaine quantité de temps réel s’est écoulée.

(Hérité de Object)
Wait(Int64)

Provoque l’attente du thread actuel jusqu’à ce qu’il soit réveillé, généralement en étant <averti> par< em>ou <em>interrompu/em<,> ou jusqu’à ce qu’une certaine quantité de temps réel s’est écoulée.

(Hérité de Object)

Événements

Nom Description
MediaDrmEvent

Se produit lorsque le moteur DRM distribue un événement de plug-in général à son écouteur d’événements inscrit.

Implémentations d’interfaces explicites

Nom Description
IJavaPeerable.Disposed()

Marque cet homologue comme supprimé et appelle Dispose avec disposing la valeur définie truesur .

(Hérité de JavaObject)
IJavaPeerable.Finalized()

Marque cet homologue comme supprimé et appelle Dispose avec disposing la valeur définie falsesur .

(Hérité de JavaObject)
IJavaPeerable.JniObjectReferenceControlBlock

Obtient le pointeur de bloc de contrôle natif utilisé par cet homologue.

(Hérité de JavaObject)
IJavaPeerable.SetJniIdentityHashCode(Int32)

Stocke le code de hachage d’identité fourni par le runtime.

(Hérité de JavaObject)
IJavaPeerable.SetJniManagedPeerState(JniManagedPeerStates)

Remplace les indicateurs d’état d’homologue géré stockés.

(Hérité de JavaObject)
IJavaPeerable.SetPeerReference(JniObjectReference)

Met à jour la référence d’homologue et libère le bloc de contrôle d’un homologue supprimé lorsque la référence n’est pas valide.

(Hérité de JavaObject)
IJavaPeerable.UnregisterFromRuntime()

Supprime cette instance de la recherche d'objets Java du runtime.

Méthodes d’extension

Nom Description
GetJniTypeName(IJavaPeerable)

Obtient le nom JNI du type de l’instance self.

JavaAs<TResult>(IJavaPeerable)

Essayez de forcer self le typeTResult, en vérifiant que le forçage est valide côté Java.

JavaCast<TResult>(IJavaObject)

Effectue une conversion de type vérifiée par le runtime Android.

JavaCast<TResult>(IJavaObject)

Réutilise un homologue managé compatible ou obtient un wrapper du type demandé.

TryJavaCast<TResult>(IJavaPeerable, TResult)

Essayez de forcer self le typeTResult, en vérifiant que le forçage est valide côté Java.

S’applique à