flash.net.drmVoucherAccessInfo Un objet VoucherAccessInfo présente les informations requises pour récupérer et consommer un voucher, telles que le type d’authentification et le domaine de contenu du serveur de droits multimédias.Object Un objet VoucherAccessInfo présente les informations requises pour récupérer et consommer un voucher, telles que le type d’authentification et le domaine de contenu du serveur de droits multimédias. authenticationMethod Type d’authentification requis afin d’obtenir un voucher pour le contenu associé.String Type d’authentification requis afin d’obtenir un voucher pour le contenu associé.

Les types d’authentification pris en charge sont les suivants :

AuthenticationMethod.ANONYMOUS : tous les utilisateurs peuvent obtenir un voucher.
AuthenticationMethod.USERNAME_AND_PASSWORD : l’utilisateur doit fournir le nom d’utilisateur et le mot de passe valides correspondant au compte qui est autorisé à afficher le contenu associé.

La classe AuthenticationMethod fournit les constantes de type chaîne à utiliser avec la propriété authenticationMethod.

displayName Chaîne conviviale que vous pouvez utiliser pour faire référence à l’objet VoucherAccessInfo spécifié dans l’interface utilisateur.String Chaîne conviviale que vous pouvez utiliser pour faire référence à l’objet VoucherAccessInfo spécifié dans l’interface utilisateur.

Si le fichier de métadonnées pour un élément de contenu multimédia a plusieurs vouchers, chacun disposant de son propre objet VoucherAccessInfo, il est possible que l’utilisateur doive indiquer le voucher sur lequel s’authentifier. Par exemple, il est possible que vous disposiez d’un voucher d’abonnement doté de privilèges administrateur pour l’affichage du contenu, ainsi que d’un voucher de base doté de privilèges inférieurs. Pour faire la distinction entre ces deux vouchers, utilisez la chaîne descriptive dans la propriété displayName. La chaîne est définie par le gestionnaire de package de contenu multimédia (outil qui emballe, chiffre et prépare le contenu multimédia en vue de le distribuer avec un serveur de droits multimédias, tel que Flash Access).

Pour les applications qui sont localisées, vous pouvez utiliser cette propriété comme identificateur. L’application peut détecter le jeu de paramètres régionaux et localiser les chaînes en conséquence.

domain Domaine de contenu du serveur de droits multimédias sur lequel l’utilisateur doit s’authentifier afin d’obtenir le voucher du contenu associé.String Domaine de contenu du serveur de droits multimédias sur lequel l’utilisateur doit s’authentifier afin d’obtenir le voucher du contenu associé.

Si l’authentification est appliquée au domaine par défaut ou si aucune authentification n’est requise, la valeur de domainName est null.

Remarque : le domaine renvoyé par cette propriété n’a rien à voir avec des noms de domaine Internet ou de réseau. Dans ce cas, un domaine correspond à un groupe de contenu ou à des comptes utilisateur. Par exemple, un serveur unique peut prendre en charge plusieurs domaines, chacun possédant ses propres canaux de contenu et abonnés.

DRMContentData La classe DRMContentData fournit les informations nécessaires à l’obtention du voucher permettant de visualiser le contenu protégé par DRM.Object La classe DRMContentData fournit les informations nécessaires à l’obtention du voucher permettant de visualiser le contenu protégé par DRM.

(AIR uniquement) Il est possible d’obtenir un objet DRMContentData à partir d’une occurrence de NetStream en appelant la méthode NetStream preloadEmbeddedContent() et en fournissant une fonction de rappel onDRMContentData sur l’objet client NetStream. Utilisez l’objet DRMContentData transmis à la fonction de rappel comme paramètre de la méthode loadVoucher() de l’objet DRMManager.

Lors de la mise en package de contenu avec Flash Access, vous avez la possibilité d’enregistrer les métadonnées du contenu dans un fichier distinct. Pour créer un nouvel objet DRMContentData, obtenez ces métadonnées avec un objet URLLoader et transmettez ce dernier au constructeur DRMContentData.

DRMContentData Constructeur.rawDataflash.utils:ByteArraynull Constructeur. getVoucherAccessInfo Récupère un tableau d’objets VoucherAccessInfo. Récupère un tableau d’objets VoucherAccessInfo. Le tableau contient au moins un objet VoucherAccessInfo (valeur par défaut).

Chaque objet VoucherAccessInfo représente une stratégie, qui contient les conditions d’extraction d’un voucher à partir du serveur de droits multimédias. Par exemple, si le serveur demande à l’utilisateur de s’authentifier, l’objet VoucherAccessInfo contient la méthode d’authentification. Si le serveur requiert l’enregistrement de l’ordinateur avec un serveur de domaine, l’objet contient l’URL du serveur de domaine.

authenticationMethod Type d’authentification requis afin d’obtenir un voucher pour le contenu associé.String Type d’authentification requis afin d’obtenir un voucher pour le contenu associé.

Les types d’authentification pris en charge sont les suivants :

AuthenticationMethod.ANONYMOUS : tous les utilisateurs peuvent obtenir un voucher.
AuthenticationMethod.USERNAME_AND_PASSWORD : l’utilisateur doit fournir le nom d’utilisateur et le mot de passe valides correspondant au compte qui est autorisé à afficher le contenu associé.

La classe AuthenticationMethod fournit les constantes de type chaîne à utiliser avec la propriété authenticationMethod.

Si l’authentification est appliquée au domaine par défaut ou si aucune authentification n’est requise, la valeur de domainName est null.

licenseID ID unique permettant d’identifier le contenu associé à ces métadonnées sur le serveur de droits multimédias.String ID unique permettant d’identifier le contenu associé à ces métadonnées sur le serveur de droits multimédias. serverURL URL d’un serveur de droits multimédias qui fournit le voucher requis pour afficher le contenu associé.String URL d’un serveur de droits multimédias qui fournit le voucher requis pour afficher le contenu associé. DRMVoucher La classe DRMVoucher, intimement liée au jeton de la licence, permet à l’utilisateur d’afficher le contenu protégé par DRM.Object La classe DRMVoucher, intimement liée au jeton de la licence, permet à l’utilisateur d’afficher le contenu protégé par DRM.

Les propriétés de la classe DRMVoucher décrivent les droits d’affichage conférés par le voucher. Vous pouvez obtenir un voucher à l’aide de la méthode loadVoucher() de l’objet DRMManager. Cette méthode nécessite un objet DRMContentData, obtenu par le biais de la méthode preloadEmbeddedMetadata() de la classe NetStream (AIR uniquement) ou à l’aide du constructeur DRMContentData(). Lorsque vous utilisez un serveur de droits multimédias, tel que Flash Access, vous pouvez obtenir un objet DRMContentData à partir des métadonnées générées par le gestionnaire de package de contenu multimédia.

offlineLeaseEndDate Date et heure auxquelles ce voucher expire pour la lecture hors ligne.Date Date et heure auxquelles ce voucher expire pour la lecture hors ligne.

Si un voucher n’est valide que pour la session en ligne actuelle, la propriété offlineLeaseStartDate est null.

offlineLeaseStartDate Date et heure auxquelles ce voucher devient valide pour la lecture hors ligne.Date Date et heure auxquelles ce voucher devient valide pour la lecture hors ligne.

Si un voucher n’est valide que pour la session en ligne actuelle, la propriété offlineLeaseStartDate est null.

playbackTimeWindow Délai, après le premier affichage, pendant lequel il est possible d’afficher ou de vérifier le contenu associé.flash.net.drm:DRMPlaybackTimeWindow Délai, après le premier affichage, pendant lequel il est possible d’afficher ou de vérifier le contenu associé.

Le délai imparti pour l’affichage commence lorsque l’utilisateur affiche pour la première fois le contenu et se termine lorsque le délai imparti s’est écoulé. Si aucun délai n’est imparti, la valeur de la propriété playbackTimeWindow est null.

policies Objet dynamique qui indique les stratégies définies par l’application.Object Objet dynamique qui indique les stratégies définies par l’application.

L’objet policy contient une paire nom-valeur pour chaque stratégie active.

voucherEndDate Date d’expiration de ce voucher.Date Date d’expiration de ce voucher. voucherStartDate Début de la période de validité de ce voucher.Date Début de la période de validité de ce voucher. DRMPlaybackTimeWindow La classe DRMPlaybackTimeWindow représente la période de validité d’un voucher DRM.Object La classe DRMPlaybackTimeWindow représente la période de validité d’un voucher DRM.

Les propriétés startDate et endDate sont null jusqu’à ce que l’utilisateur affiche le contenu pour la première fois.

endDate Date de fin correspondant à la période de validité d’un voucher DRM (fenêtre de lecture).Date Date de fin correspondant à la période de validité d’un voucher DRM (fenêtre de lecture).

La propriété endDate est null si la fenêtre de lecture n’a pas démarré.

period Période de validité d’un voucher DRM (fenêtre de lecture), en secondes.uint Période de validité d’un voucher DRM (fenêtre de lecture), en secondes. startDate Date de début correspondant à la période de validité d’un voucher DRM (fenêtre de lecture).Date Date de début correspondant à la période de validité d’un voucher DRM (fenêtre de lecture).

La propriété startDate est null si la fenêtre de lecture n’a pas démarré.

LoadVoucherSetting La classe LoadVoucherSetting fournit des constantes de type chaîne à utiliser avec le paramètre settings de la méthode loadVoucher() de l’objet DRMManager.Définit les constantes permettant de définir les options de chargement du voucher de l’objet DRMManager. Object La classe LoadVoucherSetting fournit des constantes de type chaîne à utiliser avec le paramètre settings de la méthode loadVoucher() de l’objet DRMManager. ALLOW_SERVER Charge le voucher depuis la mémoire cache locale, le cas échéant ; télécharge le voucher depuis un serveur de droits multimédias uniquement s’il n’existe aucune copie mise en mémoire cache localement.allowServerString Charge le voucher depuis la mémoire cache locale, le cas échéant ; télécharge le voucher depuis un serveur de droits multimédias uniquement s’il n’existe aucune copie mise en mémoire cache localement. FORCE_REFRESH Télécharge le voucher depuis le serveur de droits multimédias uniquement.forceRefreshString Télécharge le voucher depuis le serveur de droits multimédias uniquement. Ne télécharge pas le voucher depuis la mémoire cache locale. LOCAL_ONLY Charge le voucher depuis la mémoire cache uniquement.localOnlyString Charge le voucher depuis la mémoire cache uniquement. Ne télécharge pas le voucher depuis un serveur de droits multimédias. AuthenticationMethod La classe AuthenticationMethod fournit des constantes de type chaîne qui énumèrent les différents types d’authentification utilisés par la propriété authenticationMethod de la classe DRMContentData.Object La classe AuthenticationMethod fournit des constantes de type chaîne qui énumèrent les différents types d’authentification utilisés par la propriété authenticationMethod de la classe DRMContentData. ANONYMOUS Indique qu’aucune authentification n’est requise.anonymousString Indique qu’aucune authentification n’est requise. USERNAME_AND_PASSWORD Indique qu’un nom d’utilisateur et un mot de passe valides sont requis.usernameAndPasswordString Indique qu’un nom d’utilisateur et un mot de passe valides sont requis. DRMManager L’objet DRMManager gère la récupération et le stockage des vouchers nécessaires à l’affichage de contenus protégés par DRM.flash.events:EventDispatcher L’objet DRMManager gère la récupération et le stockage des vouchers nécessaires à l’affichage de contenus protégés par DRM. La méthode statique 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.

drmError DRMManager distribue un objet DRMErrorEvent lorsqu’il est impossible d’obtenir le voucher requis à partir du serveur de droits multimédias.flash.events.DRMErrorEvent.DRM_ERRORflash.events.DRMErrorEvent 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é.

drmStatus DRMManager distribue un objet DRMStatusEvent lorsqu’il est possible d’obtenir le voucher requis à partir du serveur de droits multimédias.flash.events.DRMStatusEvent.DRM_STATUSflash.events.DRMStatusEvent DRMManager distribue un objet DRMStatusEvent lorsqu’il est possible d’obtenir le voucher requis à partir du serveur de droits multimédias. authenticationError 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().flash.events.DRMAuthenticationErrorEvent.AUTHENTICATION_ERRORflash.events.DRMAuthenticationErrorEventDistribué par l’objet DRMManager lorsque l’authentification de l’utilisateur échoue. 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(). authenticationComplete 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().flash.events.DRMAuthenticationCompleteEvent.AUTHENTICATION_COMPLETEflash.events.DRMAuthenticationCompleteEventDistribué par l’objet DRMManager lorsque l’authentification de l’utilisateur est terminée. 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(). authenticate Permet d’authentifier un utilisateur.serverURLStringL’URL d’un serveur de droits multimédias pouvant fournir un voucher qui permet de visualiser le contenu protégé domainStringUn domaine sur le serveur (et non un nom de domaine Internet ou de réseau) usernameStringNom d’utilisateur passwordStringMot de passe utilisateur 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).

getDRMManager Renvoie une occurrence de l’objet singleton DRMManager.flash.net.drm:DRMManager Renvoie une occurrence de l’objet singleton DRMManager.

Il existe une occurrence de DRMManager pour chaque domaine de sécurité.

loadPreviewVoucher 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é.contentDataflash.net.drm:DRMContentData 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.

loadVoucher Charge un voucher à partir du serveur de droits multimédias ou de la mémoire cache locale.contentDataflash.net.drm:DRMContentDataL’objet DRMContentData d’un fichier multimédia protégé par DRM settingStringDétermine si le voucher est récupéré depuis la mémoire cache locale ou le serveur de droits multimédias 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.

resetDRMVouchers Supprime toutes les données du voucher de gestion de droits numériques (DRM) mises en cache localement.DRMManager, resetDRMVouchers Les données du voucher ne peuvent pas être supprimées. IOErrorflash.errors:IOError Supprime toutes les données du voucher de gestion de droits numériques (DRM) mises en cache localement.

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().

setAuthenticationToken Définit le jeton d’authentification à utiliser lors de la communication avec le serveur et le domaine spécifiés.serverUrlStringL’URL du serveur de droits multimédias domainStringLe domaine du serveur de droits multimédias tokenflash.utils:ByteArrayLe jeton d’authentification 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.

isSupported 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.BooleanIndique si la classe DRMManager est prise en charge sur le système client. 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.