| Package | flash.net.drm |
| Classe | public class DRMManager |
| Héritage | DRMManager  EventDispatcher Object |
| Version du langage: | ActionScript 3.0 |
| Versions du moteur d’exécution: | AIR 1.5, Flash Player 10.1 |
DRMManager.getDRMManager() permet d’accéder à l’objet DRMManager existant en vue d’effectuer les tâches de gestion DRM suivantes :
- Préchargez les vouchers depuis un serveur de droits multimédias à l’aide d’un objet DRMContentData.
- Interrogez la mémoire cache locale d’un voucher individuel à l’aide d’un objet DRMContentData.
- Réinitialisez tous les vouchers (AIR uniquement).
Aucune méthode n’est fournie pour l’énumération de tous les vouchers de la mémoire cache locale.
Il est préférable de ne pas créer une occurrence de la classe DRMManager. Utilisez la propriété statique DRMManager.getDRMManager() pour accéder à l’objet DRMManager existant.
Prise en charge du profil AIR : cette fonctionnalité est prise en charge sur tous les systèmes d’exploitation de bureau et les périphériques AIR pour TV, mais ne l’est pas sur les périphériques mobiles. Vous pouvez tester la prise en charge lors de l’exécution à l’aide de la propriété DRMManager.isSupported. Voir Prise en charge du profil AIR pour plus d’informations sur la prise en charge de l’API dans plusieurs profils.
Informations complémentaires
Eléments de l’API associés
Masquer les propriétés publiques héritées
Afficher les propriétés publiques héritées| Propriété | Défini par | ||
|---|---|---|---|
 | constructor : Object
Référence à l’objet de classe ou à la fonction constructeur d’une occurrence donnée d’un objet. | Object | |
| isSupported : Boolean [statique] [lecture seule]
La propriété isSupported est définie sur true si la classe DRMManager est disponible sur la plate-forme actuelle ; dans le cas contraire, elle est définie sur false. | DRMManager | ||
| networkIdleTimeout : Number [statique] | DRMManager | ||
| Méthode | Défini par | ||
|---|---|---|---|
| addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
Enregistre un objet écouteur d’événement auprès d’un objet EventDispatcher afin que l’écouteur soit averti d’un événement. | EventDispatcher | |
ajoute le périphérique en cours d’exécution à un groupe de périphériques. | DRMManager | ||
Permet d’authentifier un utilisateur. | DRMManager | ||
|
Distribue un événement dans le flux d’événements. | EventDispatcher | |
[statique]
Renvoie une occurrence de l’objet singleton DRMManager. | DRMManager | ||
|
Vérifie si des écouteurs sont enregistrés auprès de l’objet EventDispatcher pour un type spécifique d’événement. | EventDispatcher | |
|
Indique si la propriété spécifiée d’un objet est définie. | Object | |
|
Indique si une occurrence de la classe Object figure dans la chaîne de prototype de l’objet spécifié en tant que paramètre. | Object | |
Récupère un voucher d’aperçu depuis le serveur de licences, que vous pouvez utiliser pour permettre à un utilisateur de s’assurer qu’il peut lire le contenu sur un ordinateur donné. | DRMManager | ||
Charge un voucher à partir du serveur de droits multimédias ou de la mémoire cache locale. | DRMManager | ||
|
Indique si la propriété spécifiée existe et est énumérable. | Object | |
|
Supprime un écouteur de l’objet EventDispatcher. | EventDispatcher | |
supprime le périphérique en cours d’exécution d’un groupe de périphériques. | DRMManager | ||
Dans les applications AIR, cette opération supprime toutes les données du voucher de gestion des droits numériques (DRM) mises en cache localement. | DRMManager | ||
Renvoie au serveur de licences tous les vouchers répondant à l’ensemble des critères spécifiés. | DRMManager | ||
Définit le jeton d’authentification à utiliser lors de la communication avec le serveur et le domaine spécifiés. | DRMManager | ||
|
Définit la disponibilité d’une propriété dynamique pour les opérations en boucle. | Object | |
| DRMManager | |||
|
Renvoie la représentation de chaîne de cet objet, formatée selon les paramètres régionaux en vigueur. | Object | |
|
Renvoie la représentation sous forme de chaîne de l’objet spécifié. | Object | |
|
Renvoie la valeur primitive de l’objet spécifié. | Object | |
|
Vérifie si un écouteur d’événement est enregistré auprès de cet objet EventDispatcher ou de ses ancêtres pour le type d’événement spécifié. | EventDispatcher | |
| Evénement | Synthèse | Défini par | ||
|---|---|---|---|---|
| [Evénement de diffusion] Distribué lorsque l’application Flash Player obtient le focus du système d’exploitation et devient active. | EventDispatcher | ||
| DRMManager distribue un objet DRMAuthenticationCompleteEvent lorsque l’utilisateur est authentifié par le serveur de droits multimédias après un appel de la méthode authenticate(). | DRMManager | |||
| DRMManager distribue un objet DRMAuthenticationErrorEvent lorsque l’utilisateur n’est pas authentifié par le serveur de droits multimédias après un appel de la méthode authenticate(). | DRMManager | |||
| [Evénement de diffusion] Distribué lorsque l’application Flash Player ou AIR perd le focus du système d’exploitation et devient inactive. | EventDispatcher | ||
| DRMManager distribue un objet DRMErrorEvent lorsqu’il est impossible d’obtenir le voucher requis à partir du serveur de droits multimédias. | DRMManager | |||
| DRMManager distribue un objet DRMStatusEvent lorsqu’il est possible d’obtenir le voucher requis à partir du serveur de droits multimédias. | DRMManager | |||
isSupported | propriété |
isSupported:Boolean [lecture seule] | Version du langage: | ActionScript 3.0 |
| Versions du moteur d’exécution: | Flash Player 10.1, AIR 2 |
La propriété isSupported est définie sur true si la classe DRMManager est disponible sur la plate-forme actuelle ; dans le cas contraire, elle est définie sur false.
Implémentation
public static function get isSupported():BooleannetworkIdleTimeout | propriété |
addToDeviceGroup | () | méthode |
public function addToDeviceGroup(deviceGroup:DRMDeviceGroup, forceRefresh:Boolean = false):void| Version du langage: | ActionScript 3.0 |
| Versions du moteur d’exécution: | AIR 3.0, Flash Player 11.9 |
ajoute le périphérique en cours d’exécution à un groupe de périphériques.
Paramètres
deviceGroup:DRMDeviceGroup | |
forceRefresh:Boolean (default = false) |
authenticate | () | méthode |
public function authenticate(serverURL:String, domain:String, username:String, password:String):void| Version du langage: | ActionScript 3.0 |
| Versions du moteur d’exécution: | AIR 1.5, Flash Player 10.1 |
Permet d’authentifier un utilisateur.
Ecoutez les événements authenticationComplete et authenticationError pour déterminer le résultat de la tentative d’authentification. Plusieurs appels de la méthode authenticate() sont mis en attente. L’objet AuthenticationCompleteEvent distribué pour l’événement authenticationComplete contient un jeton d’authentification que votre application peut enregistrer.
Vous pouvez utiliser un jeton d’authentification enregistré ou un jeton téléchargé pour établir ultérieurement une session authentifiée avec le serveur de droits multimédias. Pour établir une session à l’aide d’un jeton, appelez la méthode DRMManager setAuthenticationToken(). Les propriétés du jeton, telles que la date d’expiration, sont déterminées par les paramètres du serveur qui génère le symbole.
Important (AIR uniquement) : la méthode authenticate() n’aboutit pas si la connexion Internet d’un utilisateur passe par un serveur proxy nécessitant une authentification. Bien que ces utilisateurs ne soient pas autorisés à précharger un voucher DRM nécessitant une authentification, votre application peut obtenir ce voucher en démarrant la lecture et en utilisant la méthode NetStream setAuthenticationCredentials() pour connecter l’utilisateur au serveur proxy et au serveur de droits multimédias. Une fois le voucher obtenu, l’utilisateur peut visualiser le contenu hors ligne (à condition que la licence représentée par le voucher autorise la lecture hors ligne).
Paramètres
serverURL:String — L’URL d’un serveur de droits multimédias pouvant fournir un voucher qui permet de visualiser le contenu protégé
| |
domain:String — Un domaine sur le serveur (et non un nom de domaine Internet ou de réseau)
| |
username:String — Nom d’utilisateur
| |
password:String — Mot de passe utilisateur
|
Eléments de l’API associés
getDRMManager | () | méthode |
public static function getDRMManager():DRMManager| Version du langage: | ActionScript 3.0 |
| Versions du moteur d’exécution: | AIR 1.5, Flash Player 10.1 |
Renvoie une occurrence de l’objet singleton DRMManager.
Il existe une occurrence de DRMManager pour chaque domaine de sécurité.
Valeur renvoyéeDRMManager |
Eléments de l’API associés
loadPreviewVoucher | () | méthode |
public function loadPreviewVoucher(contentData:DRMContentData):void| Version du langage: | ActionScript 3.0 |
| Versions du moteur d’exécution: | AIR 2, Flash Player 10.1 |
Récupère un voucher d’aperçu depuis le serveur de licences, que vous pouvez utiliser pour permettre à un utilisateur de s’assurer qu’il peut lire le contenu sur un ordinateur donné. Cette fonction permet aux utilisateurs de vérifier qu’ils peuvent lire le contenu sur leur ordinateur avant d’acheter et de télécharger le contenu. Ceci est utile lorsque l’ordinateur de l’utilisateur ne dispose pas des fonctions de protection de sortie ou du logiciel nécessaires pour lire le contenu.
Tout comme loadVoucher(), cette méthode est un appel asynchrone qui distribue un objet DRMStatusEvent à la fin de l’appel ou un objet DRMErrorEvent en cas d’erreurs.
Paramètres
contentData:DRMContentData |
loadVoucher | () | méthode |
public function loadVoucher(contentData:DRMContentData, setting:String):void| Version du langage: | ActionScript 3.0 |
| Versions du moteur d’exécution: | AIR 1.5, Flash Player 10.1 |
Charge un voucher à partir du serveur de droits multimédias ou de la mémoire cache locale.
Le voucher est chargé en fonction du paramètre setting :
- LoadVoucherSetting.FORCE_REFRESH : le voucher est toujours téléchargé depuis le serveur de droits multimédias.
- LoadVoucherSetting.LOCAL_ONLY : le voucher est chargé uniquement depuis la mémoire cache locale.
- LoadVoucherSetting.ALLOW_SERVER : lorsque cela est possible, le voucher est chargé depuis la mémoire cache locale ; autrement, il est téléchargé depuis le serveur.
La classe LoadVoucherSetting définit les constantes de type chaîne à utiliser en tant que valeurs du paramètre setting.
Une fois le voucher correctement chargé, DRMManager distribue un événement d’état DRM. Votre application peut commencer la lecture dès que le voucher est chargé. Le voucher chargé est disponible dans la propriété voucher de l’objet DRMStatusEvent distribué. Vous pouvez utiliser cet objet voucher pour afficher les informations associées au serveur de droits multimédias à l’utilisateur.
S’il s’avère impossible de charger un voucher depuis le serveur de droits multimédias, un événement d’erreur DRM est distribué. La propriété errorID de l’objet DRMErrorEvent distribué indique la raison de l’échec. Les causes d’échec les plus courantes sont les suivantes : tentative de connexion au serveur de droits multimédias lorsque l’utilisateur est hors ligne et tentative de chargement d’un voucher lorsque l’utilisateur n’est pas connecté. Votre application peut répondre à ces erreurs et prendre les mesures nécessaires. Par exemple, si les informations d’authentification sont requises pour télécharger le voucher, vous pouvez inviter l’utilisateur à saisir son nom d’utilisateur et son mot de passe, appeler la méthode DRMManager authenticate(), puis tenter de télécharger à nouveau le voucher.
S’il s’avère impossible d’obtenir un voucher depuis la mémoire cache locale et que le paramètre localOnly est utilisé, l’objet DRMErrorEvent n’est pas distribué. C’est un événement d’état DRM qui est distribué. La propriété detail de cet objet DRMStatusEvent est toujours DRM.voucherObtained, mais la propriété voucher est null.
Paramètres
contentData:DRMContentData — L’objet DRMContentData d’un fichier multimédia protégé par DRM
| |
setting:String — Détermine si le voucher est récupéré depuis la mémoire cache locale ou le serveur de droits multimédias
|
removeFromDeviceGroup | () | méthode |
public function removeFromDeviceGroup(deviceGroup:DRMDeviceGroup):void| Version du langage: | ActionScript 3.0 |
| Versions du moteur d’exécution: | AIR 3.0, Flash Player 11.9 |
supprime le périphérique en cours d’exécution d’un groupe de périphériques.
Paramètres
deviceGroup:DRMDeviceGroup |
resetDRMVouchers | () | méthode |
public function resetDRMVouchers():void| Version du langage: | ActionScript 3.0 |
| Versions du moteur d’exécution: | AIR 1.5, Flash Player 11.8 |
Dans les applications AIR, cette opération supprime toutes les données du voucher de gestion des droits numériques (DRM) mises en cache localement. Pour les applications de navigateur, ceci est uniquement disponible pendant les erreurs 3322, 3346, 3323, 3326 et se comporte comme le panneau Paramètres de lecture de contenu protégé.
L’application doit télécharger à nouveau le voucher requis pour que l’utilisateur puisse accéder au contenu chiffré. Appeler cette fonction équivaut à appeler Netstream.resetDRMVouchers().
Valeur émise
IOError — Les données du voucher ne peuvent pas être supprimées.
|
Eléments de l’API associés
returnVoucher | () | méthode |
public function returnVoucher(inServerURL:String, immediateCommit:Boolean, licenseID:String, policyID:String):void| Version du langage: | ActionScript 3.0 |
| Versions du moteur d’exécution: | Flash Player 11.8, AIR 3.8 |
Renvoie au serveur de licences tous les vouchers répondant à l’ensemble des critères spécifiés. Lorsqu’un voucher est renvoyé, il est supprimé de l’espace de stockage sur disque et de la mémoire. Cela n’interrompt pas les objets NetStream et AVStream qui utilisent les vouchers renvoyés pour la lecture vidéo, mais interdit toute lecture future. DRMManager attribuera un événement DRMReturnVoucherCompleteEvent en cas de réussite ou un DRMReturnVoucherErrorEvent en cas d’erreur. ArgumentError est renvoyé si la valeur de inServerURL est null ou si licenseID et policyID ont tous les deux une valeur null.
Paramètres
inServerURL:String — URL des serveurs de licences à partir desquels les licences renvoyées ont été téléchargées.
| |
immediateCommit:Boolean — Réservé. La seule valeur acceptée est true.
| |
licenseID:String — (Facultatif) Les vouchers correspondant à cet identifiant de licence seront renvoyées. Si la valeur est null, l’identifiant de stratégie est utilisé à la place.
| |
policyID:String — (Facultatif) Les vouchers correspondant à cet identifiant de stratégie seront renvoyées. Si la valeur est null, l’identifiant de licence est utilisé à la place. Si les identifiants de licence et de stratégie ne sont pas null, seul un voucher correspondant aux deux valeurs est renvoyé.
|
setAuthenticationToken | () | méthode |
public function setAuthenticationToken(serverUrl:String, domain:String, token:ByteArray):void| Version du langage: | ActionScript 3.0 |
| Versions du moteur d’exécution: | AIR 1.5, Flash Player 10.1 |
Définit le jeton d’authentification à utiliser lors de la communication avec le serveur et le domaine spécifiés.
Les jetons d’authentification sont disponibles depuis la propriété token de l’objet DRMAuthenticationCompleteEvent distribué après un appel réussi de la méthode authenticate(). Le jeton est automatiquement mis en cache pour la session, mais vous pouvez utiliser la méthode setAuthenticationToken() pour gérer directement les jetons.
La définition d’un jeton remplace tout jeton mis en cache existant pour le domaine et le serveur. Définissez le paramètre token sur null pour supprimer le jeton mis en cache.
Paramètres
serverUrl:String — L’URL du serveur de droits multimédias
| |
domain:String — L’objet DRMContentData
| |
token:ByteArray — Le jeton d’authentification
|
storeVoucher | () | méthode |
authenticationComplete | Evénement |
flash.events.DRMAuthenticationCompleteEventpropriété DRMAuthenticationCompleteEvent.type =
flash.events.DRMAuthenticationCompleteEvent.AUTHENTICATION_COMPLETE| Version du langage: | ActionScript 3.0 |
| Versions du moteur d’exécution: | AIR 1.5, Flash Player 10.1 |
DRMManager distribue un objet DRMAuthenticationCompleteEvent lorsque l’utilisateur est authentifié par le serveur de droits multimédias après un appel de la méthode authenticate().
authenticationError | Evénement |
flash.events.DRMAuthenticationErrorEventpropriété DRMAuthenticationErrorEvent.type =
flash.events.DRMAuthenticationErrorEvent.AUTHENTICATION_ERROR| Version du langage: | ActionScript 3.0 |
| Versions du moteur d’exécution: | AIR 1.5, Flash Player 10.1 |
DRMManager distribue un objet DRMAuthenticationErrorEvent lorsque l’utilisateur n’est pas authentifié par le serveur de droits multimédias après un appel de la méthode authenticate().
drmError | Evénement |
flash.events.DRMErrorEventpropriété DRMErrorEvent.type =
flash.events.DRMErrorEvent.DRM_ERROR| Version du langage: | ActionScript 3.0 |
| Versions du moteur d’exécution: | AIR 1.5, Flash Player 10.1 |
DRMManager distribue un objet DRMErrorEvent lorsqu’il est impossible d’obtenir le voucher requis à partir du serveur de droits multimédias.
Remarque : en cas d’échec de la tentative de chargement d’un voucher à partir de la mémoire cache locale (avec localOnly en tant que paramètre source), aucun objet DRMErrorEvent n’est distribué. Par contre, un objet DRMStatusEvent dont la propriété voucher est définie sur null est distribué.
DRMErrorEvent.DRM_ERROR définit la valeur de la propriété type d’un objet événement drmError.
Les propriétés de cet événement sont les suivantes :
| Propriété | Valeur |
|---|---|
bubbles | false |
cancelable | false ; il n’existe aucun comportement par défaut à annuler. |
errorID | Un code d’erreur numérique correspondant au problème. |
subErrorID | Un code d’erreur qui indique des informations détaillées supplémentaires sur le problème sous-jacent. |
target | L’objet NetStream. |
drmStatus | Evénement |
flash.events.DRMStatusEventpropriété DRMStatusEvent.type =
flash.events.DRMStatusEvent.DRM_STATUS| Version du langage: | ActionScript 3.0 |
| Versions du moteur d’exécution: | AIR 1.5, Flash Player 10.1 |
DRMManager distribue un objet DRMStatusEvent lorsqu’il est possible d’obtenir le voucher requis à partir du serveur de droits multimédias.
La constanteDRMStatusEvent.DRM_STATUS définit la valeur de la propriété type d’un objet d’événement drmStatus.
Les propriétés de cet événement sont les suivantes :
| Propriété | Valeur |
|---|---|
bubbles | false |
cancelable | false ; il n’existe aucun comportement par défaut à annuler. |
detail | Une chaîne expliquant le contexte de l’événement status. |
isAnonymous | Indique si le contenu protégé avec le chiffrement DRM est disponible sans que l’utilisateur doive fournir des informations d’identification d’authentification. |
isAvailableOffline | Indique si le contenu protégé avec le chiffrement DRM est disponible hors ligne. |
offlineLeasePeriod | Le nombre de jours qu’il reste pour afficher le contenu hors ligne. |
policies | Un objet custom de l’événement DRM status. |
target | L’objet NetStream. |
voucherEndDate | La date absolue d’expiration du bon à laquelle le contenu ne peut plus être affiché par les utilisateurs |
contentData | DRMContentData pour le contenu |
voucher | L’objet DRMVoucher pour le contenu. |
isLocal | Indique si le contenu est enregistré sur le système de fichiers local |
Tue Jun 12 2018, 09:30 AM Z