Guide de référence ActionScript® 3.0 pour la plate-forme Adobe® Flash®
Accueil  |  Masquer la liste des packages et des classes |  Packages  |  Classes  |  Nouveautés  |  Index  |  Annexes  |  Pourquoi existe-t-il du contenu en anglais ?
Filtres : Récupération des données du serveur...
Récupération des données du serveur...
flash.events 

DRMAuthenticateEvent  - AS3

Packageflash.events
Classepublic class DRMAuthenticateEvent
HéritageDRMAuthenticateEvent Inheritance Event Inheritance Object

Version du langage: ActionScript 3.0
Versions du moteur d’exécution: AIR 1.0

Un objet NetStream distribue un objet DRMAuthenticateEvent lors d’une tentative de lecture d’un contenu chiffré par DRM (gestion des droits numériques) nécessitant les informations d’identification de l’utilisateur pour l’authentification.

Le gestionnaire DRMAuthenticateEvent est chargé de rassembler les informations d’identification requises (nom d’utilisateur, mot de passe et type, par exemple) et de transmettre les valeurs à la méthode NetStream.setDRMAuthenticationCredentials() pour l’authentification. Chaque application AIR doit fournir un mécanisme permettant d’obtenir les informations d’identification de l’utilisateur. Par exemple, l’application peut fournir à l’utilisateur une interface utilisateur simple pour entrer les valeurs de nom d’utilisateur et de mot de passe, ainsi que le type, le cas échéant.

En cas d’échec de l’authentification utilisateur, l’application tente de nouveau l’authentification et distribue un nouvel événement DRMAuthenticateEvent pour l’objet NetStream.

Consulter les exemples

Plus d’exemples

Eléments de l’API associés



Propriétés publiques
 PropriétéDéfini par
      authenticationType : String
[lecture seule] Indique si les informations d’identification fournies servent à l’authentification par rapport au serveur FMRMS (Flash Media Rights Management Server : serveur de gestion des droits de Flash Media) ou un serveur proxy.
DRMAuthenticateEvent
 Inheritedbubbles : Boolean
[lecture seule] Indique si un événement peut se propager vers le haut (bubbling).
Event
 Inheritedcancelable : Boolean
[lecture seule] Indique si le comportement associé à l’événement peut être évité.
Event
 Inheritedconstructor : Object
Référence à l’objet de classe ou à la fonction constructeur d’une occurrence donnée d’un objet.
Object
 InheritedcurrentTarget : Object
[lecture seule] L’objet qui traite activement l’objet Event avec un écouteur d’événements.
Event
 InheritedeventPhase : uint
[lecture seule] Phase actuelle du flux d’événements.
Event
      header : String
[lecture seule] L’en-tête du fichier de contenu chiffré fourni par le serveur.
DRMAuthenticateEvent
      netstream : NetStream
[lecture seule] L’objet NetStream qui a initié cet événement.
DRMAuthenticateEvent
      passwordPrompt : String
[lecture seule] Une invite à entrer les informations de mot de passe, fournies par le serveur.
DRMAuthenticateEvent
 Inheritedtarget : Object
[lecture seule] Cible de l’événement.
Event
 Inheritedtype : String
[lecture seule] Type d’événement.
Event
      urlPrompt : String
[lecture seule] Une invite pour une chaîne d’URL, fournie par le serveur.
DRMAuthenticateEvent
      usernamePrompt : String
[lecture seule] Une invite à entrer les informations de nom d’utilisateur, fournies par le serveur.
DRMAuthenticateEvent
Méthodes publiques
 MéthodeDéfini par
  
    DRMAuthenticateEvent(type:String, bubbles:Boolean = false, cancelable:Boolean = false, header:String = "", userPrompt:String = "", passPrompt:String = "", urlPrompt:String = "", authenticationType:String = "", netstream:NetStream = null)
Crée un objet Event contenant des informations spécifiques sur les événements d’authentification DRM.
DRMAuthenticateEvent
  
    clone():Event
[override] Crée une copie de l’objet DRMAuthenticateEvent et définit la valeur de chaque propriété de sorte qu’elle corresponde à la valeur d’origine.
DRMAuthenticateEvent
 Inherited
formatToString(className:String, ... arguments):String
Fonction d’un utilitaire permettant d’implémenter la méthode toString() dans des classes Event ActionScript 3.0 personnalisées.
Event
 Inherited
Indique si la propriété spécifiée d’un objet est définie.
Object
 Inherited
Vérifie si la méthode preventDefault() a été appelée pour l’événement.
Event
 Inherited
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
 Inherited
Annule le comportement par défaut d’un événement si cette opération est possible.
Event
 Inherited
Indique si la propriété spécifiée existe et est énumérable.
Object
 Inherited
Définit la disponibilité d’une propriété dynamique pour les opérations en boucle.
Object
 Inherited
Bloque le traitement des écouteurs d’événement dans le nœud actuel et les suivants dans le flux d’événements.
Event
 Inherited
Bloque le traitement des écouteurs d’événement dans les nœuds qui suivent le nœud actuel dans le flux d’événements.
Event
 Inherited
Renvoie la représentation de chaîne de cet objet, formatée selon les paramètres régionaux en vigueur.
Object
  
    toString():String
[override] Renvoie une chaîne répertoriant toutes les propriétés de l’objet DRMAuthenticateEvent.
DRMAuthenticateEvent
 Inherited
Renvoie la valeur primitive de l’objet spécifié.
Object
Constantes publiques
 ConstanteDéfini par
      AUTHENTICATION_TYPE_DRM : String = "drm"
[statique] La constante DRMAuthenticateEvent.AUTHENTICATION_TYPE_DRM définit la valeur de la propriété authenticationType d’un objet événement DRMAuthenticateEvent.
DRMAuthenticateEvent
      AUTHENTICATION_TYPE_PROXY : String = "proxy"
[statique] La constante DRMAuthenticateEvent.AUTHENTICATION_TYPE_PROXY définit la valeur de la propriété authenticationType d’un objet événement DRMAuthenticateEvent.
DRMAuthenticateEvent
      DRM_AUTHENTICATE : String = "drmAuthenticate"
[statique] La constante DRMAuthenticateEvent.DRM_AUTHENTICATE définit la valeur de la propriété type d’un objet événement DRMAuthenticateEvent.
DRMAuthenticateEvent
Détails de la propriété
    

authenticationType

propriété
authenticationType:String  [lecture seule]

Version du langage: ActionScript 3.0
Versions du moteur d’exécution: AIR 1.0

Indique si les informations d’identification fournies servent à l’authentification par rapport au serveur FMRMS (Flash Media Rights Management Server : serveur de gestion des droits de Flash Media) ou un serveur proxy. Par exemple, l’option "proxy" permet à une société d’authentifier l’application par rapport au serveur proxy avant que l’utilisateur n’accède à Internet. A moins qu’une authentification anonyme soit utilisée, après l’authentification proxy, l’utilisateur doit encore authentifier par rapport à FMRMS afin d’obtenir le bon et lire le contenu. Vous pouvez utiliser setDRMAuthenticationcredentials() une deuxième fois, avec l’option "drm", pour authentifier par rapport à FMRMS.



Implémentation
    public function get authenticationType():String
    

header

propriété 
header:String  [lecture seule]

Version du langage: ActionScript 3.0
Versions du moteur d’exécution: AIR 1.0

L’en-tête du fichier de contenu chiffré fourni par le serveur. Il contient des informations sur le contexte du contenu chiffré.



Implémentation
    public function get header():String
    

netstream

propriété 
netstream:NetStream  [lecture seule]

Version du langage: ActionScript 3.0
Versions du moteur d’exécution: AIR 1.0

L’objet NetStream qui a initié cet événement.



Implémentation
    public function get netstream():NetStream
    

passwordPrompt

propriété 
passwordPrompt:String  [lecture seule]

Version du langage: ActionScript 3.0
Versions du moteur d’exécution: AIR 1.0

Une invite à entrer les informations de mot de passe, fournies par le serveur. La chaîne peut inclure des instructions pour le type de mot de passe requis.



Implémentation
    public function get passwordPrompt():String
    

urlPrompt

propriété 
urlPrompt:String  [lecture seule]

Version du langage: ActionScript 3.0
Versions du moteur d’exécution: AIR 1.0

Une invite pour une chaîne d’URL, fournie par le serveur. La chaîne peut fournir l’emplacement auquel le nom d’utilisateur et le mot de passe sont envoyés.



Implémentation
    public function get urlPrompt():String
    

usernamePrompt

propriété 
usernamePrompt:String  [lecture seule]

Version du langage: ActionScript 3.0
Versions du moteur d’exécution: AIR 1.0

Une invite à entrer les informations de nom d’utilisateur, fournies par le serveur. La chaîne peut inclure des instructions pour le type de nom d’utilisateur requis. Par exemple, un fournisseur de contenu peut exiger une adresse électronique comme nom d’utilisateur.



Implémentation
    public function get usernamePrompt():String
Détails du constructeur
    

DRMAuthenticateEvent

()Constructeur
public function DRMAuthenticateEvent(type:String, bubbles:Boolean = false, cancelable:Boolean = false, header:String = "", userPrompt:String = "", passPrompt:String = "", urlPrompt:String = "", authenticationType:String = "", netstream:NetStream = null)

Version du langage: ActionScript 3.0
Versions du moteur d’exécution: AIR 1.0

Crée un objet Event contenant des informations spécifiques sur les événements d’authentification DRM. Les objets Event sont transmis en tant que paramètres aux écouteurs d’événements.

Paramètres
type:String — Type de l’événement. Les écouteurs d’événement peuvent accéder à cette information par le biais de la propriété type héritée. Il n’existe qu’un seul type d’événement DRMAuthenticate : DRMAuthenticateEvent.DRM_AUTHENTICATE.
 
bubbles:Boolean (default = false) — Détermine si l’objet Event prend part à la phase de propagation du flux d’événements. Les écouteurs d’événement peuvent accéder à cette information par le biais de la propriété bubbles héritée.
 
cancelable:Boolean (default = false) — Détermine si l’objet Event peut être annulé. Les écouteurs d’événement peuvent accéder à cette information par le biais de la propriété cancelable héritée.
 
header:String (default = "") — L’en-tête du fichier de contenu chiffré fourni par le serveur.
 
userPrompt:String (default = "") — Une invite à entrer les informations de nom d’utilisateur, fournies par le serveur.
 
passPrompt:String (default = "") — Une invite à entrer les informations de mot de passe, fournies par le serveur.
 
urlPrompt:String (default = "") — Une invite pour une URL à afficher, fournie par le serveur.
 
authenticationType:String (default = "") — Indique si les informations d’identification fournies servent à l’authentification par rapport à un serveur FMRMS (Flash Media Rights Management Server : serveur de gestion des droits de Flash Media) ou un serveur proxy.
 
netstream:NetStream (default = null) — L’objet NetStream qui a initié cet événement.
Détails de la méthode

    clone

()méthode
override public function clone():Event

Version du langage: ActionScript 3.0
Versions du moteur d’exécution: AIR 1.0

Crée une copie de l’objet DRMAuthenticateEvent et définit la valeur de chaque propriété de sorte qu’elle corresponde à la valeur d’origine.

Valeur renvoyée
Event — Nouvel objet DRMAuthenticateEvent dont les propriétés ont la même valeur que celles de l’objet d’origine.

    toString

()méthode 
override public function toString():String

Versions du moteur d’exécution: AIR 1.0

Renvoie une chaîne répertoriant toutes les propriétés de l’objet DRMAuthenticateEvent. La chaîne est écrite au format suivant :

[DRMAuthenticateEvent type=valeur bubbles=valeur cancelable=valeur eventPhase=valeur header=valeur usernamePrompt=valeur passwordPrompt=valeur urlPrompt=valeur] authenticationType=valeur

Valeur renvoyée
String — Une chaîne répertoriant toutes les propriétés de l’objet DRMAuthenticateEvent.
Détails de la constante
    

AUTHENTICATION_TYPE_DRM

Constante
public static const AUTHENTICATION_TYPE_DRM:String = "drm"

Version du langage: ActionScript 3.0
Versions du moteur d’exécution: AIR 1.0

La constante DRMAuthenticateEvent.AUTHENTICATION_TYPE_DRM définit la valeur de la propriété authenticationType d’un objet événement DRMAuthenticateEvent.

Les propriétés de cet événement sont les suivantes :

PropriétéValeur
authenticationTypeIndique si les informations d’identification fournies servent à l’authentification par rapport à un serveur FMRMS (Flash Media Rights Management Server : serveur de gestion des droits de Flash Media) ou un serveur proxy.
bubblesfalse
cancelablefalse ; il n’existe aucun comportement par défaut à annuler.
en-têteL’en-tête du fichier de contenu chiffré fourni par le serveur.
netStreamL’objet NetStream qui a initié cet événement.
passwordPromptUne invite à entrer les informations de mot de passe, fournies par le serveur.
targetL’objet NetStream.
urlPromptUne invite pour une URL à afficher, fournie par le serveur.
usernamePromptUne invite à entrer les informations de nom d’utilisateur, fournies par le serveur.

Eléments de l’API associés

    

AUTHENTICATION_TYPE_PROXY

Constante 
public static const AUTHENTICATION_TYPE_PROXY:String = "proxy"

Version du langage: ActionScript 3.0
Versions du moteur d’exécution: AIR 1.0

La constante DRMAuthenticateEvent.AUTHENTICATION_TYPE_PROXY définit la valeur de la propriété authenticationType d’un objet événement DRMAuthenticateEvent.

Les propriétés de cet événement sont les suivantes :

PropriétéValeur
authenticationTypeIndique si les informations d’identification fournies servent à l’authentification par rapport à un serveur FMRMS (Flash Media Rights Management Server : serveur de gestion des droits de Flash Media) ou un serveur proxy.
bubblesfalse
cancelablefalse ; il n’existe aucun comportement par défaut à annuler.
en-têteL’en-tête du fichier de contenu chiffré fourni par le serveur.
netStreamL’objet NetStream qui a initié cet événement.
passwordPromptUne invite à entrer les informations de mot de passe, fournies par le serveur.
targetL’objet NetStream.
urlPromptUne invite pour une URL à afficher, fournie par le serveur.
usernamePromptUne invite à entrer les informations de nom d’utilisateur, fournies par le serveur.

Eléments de l’API associés

    

DRM_AUTHENTICATE

Constante 
public static const DRM_AUTHENTICATE:String = "drmAuthenticate"

Version du langage: ActionScript 3.0
Versions du moteur d’exécution: AIR 1.0

La constante DRMAuthenticateEvent.DRM_AUTHENTICATE définit la valeur de la propriété type d’un objet événement DRMAuthenticateEvent.

Les propriétés de cet événement sont les suivantes :

PropriétéValeur
authenticationTypeIndique si les informations d’identification fournies servent à l’authentification par rapport à un serveur FMRMS (Flash Media Rights Management Server : serveur de gestion des droits de Flash Media) ou un serveur proxy.
bubblesfalse
cancelablefalse il n’existe aucun comportement par défaut à annuler.
en-têteL’en-tête du fichier de contenu chiffré fourni par le serveur.
netStreamL’objet NetStream qui a initié cet événement.
passwordPromptUne invite à entrer les informations de mot de passe, fournies par le serveur.
targetL’objet NetStream.
urlPromptUne invite pour une URL à afficher, fournie par le serveur.
usernamePromptUne invite à entrer les informations de nom d’utilisateur, fournies par le serveur.

Eléments de l’API associés

DRMAuthenticateEventExample.as

package
{
    import flash.display.Sprite;
    import flash.events.AsyncErrorEvent;
    import flash.events.NetStatusEvent;
    import flash.events.DRMAuthenticateEvent;
    import flash.media.Video;
    import flash.net.NetConnection;
    import flash.net.NetStream;

    public class DRMAuthenticateEventExample extends Sprite
    {
        var videoURL:String = "Video.flv";
        var videoConnection:NetConnection;
        var videoStream:NetStream;
        var video:Video = new Video();            

        public function DRMAuthenticateEventExample()
        {
            videoConnection = new NetConnection();
            videoConnection.addEventListener(NetStatusEvent.NET_STATUS, netStatusHandler);
            videoConnection.connect(null);
        }

        private function connectStream():void {
            videoStream = new NetStream(videoConnection);
            videoStream.addEventListener(NetStatusEvent.NET_STATUS, netStatusHandler);
            videoStream.addEventListener(AsyncErrorEvent.ASYNC_ERROR, asyncErrorHandler);
            videoStream.addEventListener(DRMAuthenticateEvent.DRM_AUTHENTICATE, drmAuthenticateEventHandler);
            video.attachNetStream(videoStream);
            videoStream.play(videoURL);
            addChild(video);
        }

        private function netStatusHandler(event:NetStatusEvent):void {
            switch (event.info.code) {
                case "NetConnection.Connect.Success":
                    connectStream();
                    break;
                case "NetStream.Play.StreamNotFound":
                    trace("Unable to locate video: " + videoURL);
                    break;
            }
        }

        private function asyncErrorHandler(event:AsyncErrorEvent):void {
            // ignore AsyncErrorEvent events.
        }

         private function drmAuthenticateEventHandler(event:DRMAuthenticateEvent):void {
            videoStream.setDRMAuthenticationCredentials("User", "password", "drm");
        }
     }
}




[ X ]Pourquoi existe-t-il du contenu en anglais ?
Certaines parties du Guide de référence ActionScript 3.0 sont en anglais

Tout le contenu du Guide de référence ActionScript 3.0 n’a pas été traduit dans toutes les langues. Si un élément de langage n’est pas traduit, il s’affiche en anglais. Par exemple, la classe ga.controls.HelpBox n’est traduite dans aucune langue. Ainsi, dans la version française du guide de référence, la classe ga.controls.HelpBox apparaît en anglais.