ActionScript® 3.0 Referenzhandbuch für die Adobe® Flash®-Plattform
Home  |  Liste der Pakete und Klassen ausblenden |  Pakete  |  Klassen  |  Neue Funktionen  |  Stichwortverzeichnis  |  Anhänge  |  Warum auf Englisch?
Filter: Daten werden vom Server abgerufen...
Daten werden vom Server abgerufen...
flash.events 

DRMAuthenticateEvent  - AS3

Paketflash.events
Klassepublic class DRMAuthenticateEvent
VererbungDRMAuthenticateEvent Inheritance Event Inheritance Object

Sprachversion: ActionScript 3.0
Laufzeitversionen: AIR 1.0

Ein NetStream-Objekt löst ein DRMAuthenticateEvent-Objekt aus, wenn versucht wird, DRM (digitales Rechtemanagement)-verschlüsselte Inhalte abzuspielen, die bei der Authentifizierung Benutzerdaten erfordern.

Die DRMAuthenticateEvent-Prozedur ist zuständig für das Sammeln der erforderlichen Benutzerdaten (zum Beispiel Benutzernamen, Kennwort und Typ) und die Übergabe der Werte an die NetStream.setDRMAuthenticationCredentials()-Methode zur Authentifizierung. Jede AIR-Anwendung muss einen Mechanismus zur Verfügung stellen, mit dem die Benutzerdaten erhalten werden. Die Anwendung könnte dem Benutzer zum Beispiel eine einfache Benutzeroberfläche zur Eingabe des Benutzernamens und des Kennworts, optional auch des Typs, anzeigen.

Wenn die Benutzerauthentifizierung fehlschlägt, startet die Anwendung einen neuen Versuch und löst ein neues DRMAuthenticateEvent-Ereignis für das NetStream-Objekts aus.

Beispiele anzeigen

Verwandte API-Elemente



Öffentliche Eigenschaften
 EigenschaftDefiniert von
      authenticationType : String
[schreibgeschützt] Zeigt an, ob die angegebenen Benutzerdaten für die Authentifizierung für Flash Media Rights Management Server (FMRMS) oder eine Proxyserver bestimmt sind.
DRMAuthenticateEvent
 Inheritedbubbles : Boolean
[schreibgeschützt] Gibt an, ob es sich bei dem Ereignis um ein Bubbling-Ereignis handelt.
Event
 Inheritedcancelable : Boolean
[schreibgeschützt] Gibt an, ob das mit dem Ereignis verknüpfte Verhalten verhindert werden kann.
Event
 Inheritedconstructor : Object
Ein Verweis auf das Klassenobjekt oder die Konstruktorfunktion für eine angegebene Objektinstanz.
Object
 InheritedcurrentTarget : Object
[schreibgeschützt] Das Objekt, welches das Ereignisobjekt aktiv mit einem Ereignis-Listener verarbeitet.
Event
 InheritedeventPhase : uint
[schreibgeschützt] Die aktuelle Phase im Ereignisablauf.
Event
      header : String
[schreibgeschützt] Der verschlüsselte Inhaltsdateiheader, der vom Server bereitgestellt wird.
DRMAuthenticateEvent
      netstream : NetStream
[schreibgeschützt] Das NetStream-Objekt, das dieses Ereignis eingeleitet hat.
DRMAuthenticateEvent
      passwordPrompt : String
[schreibgeschützt] Eine vom Server bereitgestellte Eingabeaufforderung für das Kennwort.
DRMAuthenticateEvent
 Inheritedtarget : Object
[schreibgeschützt] Das Ereignis-Ziel.
Event
 Inheritedtype : String
[schreibgeschützt] Der Ereignistyp.
Event
      urlPrompt : String
[schreibgeschützt] Eine vom Server bereitgestellte Eingabeaufforderung für eine URL.
DRMAuthenticateEvent
      usernamePrompt : String
[schreibgeschützt] Eine vom Server bereitgestellte Eingabeaufforderung für den Benutzernamen.
DRMAuthenticateEvent
Öffentliche Methoden
 MethodeDefiniert von
  
    DRMAuthenticateEvent(type:String, bubbles:Boolean = false, cancelable:Boolean = false, header:String = "", userPrompt:String = "", passPrompt:String = "", urlPrompt:String = "", authenticationType:String = "", netstream:NetStream = null)
Erstellt ein Event-Objekt, das bestimmte Informationen über DRM-Authentifizierungsereignisse enthält.
DRMAuthenticateEvent
  
    clone():Event
[override] Erstellt eine Kopie des DRMAuthenticateEvent-Objekts und stellt den Wert jeder Eigenschaft so ein, dass er dem Wert des Originals entspricht.
DRMAuthenticateEvent
 Inherited
formatToString(className:String, ... arguments):String
Eine Dienstprogrammfunktion zur Implementierung der toString()-Methode in benutzerdefinierten ActionScript 3.0 Event-Klassen.
Event
 Inherited
Gibt an, ob für ein Objekt eine bestimmte Eigenschaft definiert wurde.
Object
 Inherited
Überprüft, ob die preventDefault()-Methode bei dem Ereignis aufgerufen wurde.
Event
 Inherited
Gibt an, ob eine Instanz der Object-Klasse in der Prototypkette des Objekts vorhanden ist, das als Parameter angegeben wurde.
Object
 Inherited
Bricht das Standardverhalten eines Ereignisses ab, wenn dieses Verhalten abgebrochen werden kann.
Event
 Inherited
Gibt an, ob die angegebene Eigenschaft vorhanden ist und durchlaufen werden kann.
Object
 Inherited
Legt die Verfügbarkeit einer dynamischen Eigenschaft für Schleifenoperationen fest.
Object
 Inherited
Verhindert die Verarbeitung von Ereignis-Listenern im aktuellen Knoten und in Knoten, die dem aktuellen Knoten im Ereignisablauf nachfolgen.
Event
 Inherited
Verhindert die Verarbeitung von Ereignis-Listenern in Knoten, die dem aktuellen Knoten im Ereignisablauf nachfolgen.
Event
 Inherited
Gibt die Stringdarstellung dieses Objekts zurück, formatiert entsprechend den Konventionen des Gebietsschemas.
Object
  
    toString():String
[override] Gibt einen String zurück, der alle Eigenschaften des DRMAuthenticateEvent-Objekts enthält.
DRMAuthenticateEvent
 Inherited
Gibt den Grundwert des angegebenen Objekts zurück.
Object
Öffentliche Konstanten
 KonstanteDefiniert von
      AUTHENTICATION_TYPE_DRM : String = "drm"
[statisch] Die DRMAuthenticateEvent.AUTHENTICATION_TYPE_DRM-Konstante definiert den Wert der authenticationType-Eigenschaft eines DRMAuthenticateEvent-Objekts.
DRMAuthenticateEvent
      AUTHENTICATION_TYPE_PROXY : String = "proxy"
[statisch] Die DRMAuthenticateEvent.AUTHENTICATION_TYPE_PROXY-Konstante definiert den Wert der authenticationType-Eigenschaft eines DRMAuthenticateEvent-Objekts.
DRMAuthenticateEvent
      DRM_AUTHENTICATE : String = "drmAuthenticate"
[statisch] Die DRMAuthenticateEvent.DRM_AUTHENTICATE-Konstante definiert den Wert der type-Eigenschaft eines DRMAuthenticateEvent-Objekts.
DRMAuthenticateEvent
Eigenschaftendetails
    

authenticationType

Eigenschaft
authenticationType:String  [schreibgeschützt]

Sprachversion: ActionScript 3.0
Laufzeitversionen: AIR 1.0

Zeigt an, ob die angegebenen Benutzerdaten für die Authentifizierung für Flash Media Rights Management Server (FMRMS) oder eine Proxyserver bestimmt sind. Die "proxy"-Option ermöglicht der Anwendung zum Beispiel die Authentifizierung für einen Proxyserver, wenn ein Unternehmen diesen Schritt verlangt, bevor der Benutzer Zugriff auf das Internet hat. Sofern keine anonyme Authentifizierung verwendet wird, muss sich der Benutzer nach der Proxyauthentifizierung immer noch für den FMRMS authentifizieren, um den Gutschein zu erhalten und den Inhalt abzuspielen. Sie können setDRMAuthenticationcredentials() ein zweites Mal verwenden, diesmal mit der "drm"-Option, um die Authentifizierung für den FMRMS auszuführen.



Implementierung
    public function get authenticationType():String
    

header

Eigenschaft 
header:String  [schreibgeschützt]

Sprachversion: ActionScript 3.0
Laufzeitversionen: AIR 1.0

Der verschlüsselte Inhaltsdateiheader, der vom Server bereitgestellt wird. Er enthält Informationen über den Kontext des verschlüsselten Inhalts.



Implementierung
    public function get header():String
    

netstream

Eigenschaft 
netstream:NetStream  [schreibgeschützt]

Sprachversion: ActionScript 3.0
Laufzeitversionen: AIR 1.0

Das NetStream-Objekt, das dieses Ereignis eingeleitet hat.



Implementierung
    public function get netstream():NetStream
    

passwordPrompt

Eigenschaft 
passwordPrompt:String  [schreibgeschützt]

Sprachversion: ActionScript 3.0
Laufzeitversionen: AIR 1.0

Eine vom Server bereitgestellte Eingabeaufforderung für das Kennwort. Der String kann Anweisungen enthalten, die den erforderlichen Typ des Kennworts betreffen.



Implementierung
    public function get passwordPrompt():String
    

urlPrompt

Eigenschaft 
urlPrompt:String  [schreibgeschützt]

Sprachversion: ActionScript 3.0
Laufzeitversionen: AIR 1.0

Eine vom Server bereitgestellte Eingabeaufforderung für eine URL. Der String kann angeben, wohin Benutzername und Kennwort gesendet werden.



Implementierung
    public function get urlPrompt():String
    

usernamePrompt

Eigenschaft 
usernamePrompt:String  [schreibgeschützt]

Sprachversion: ActionScript 3.0
Laufzeitversionen: AIR 1.0

Eine vom Server bereitgestellte Eingabeaufforderung für den Benutzernamen. Der String kann Anweisungen enthalten, die den erforderlichen Typ des Benutzernamens betreffen. Ein Content-Provider könnte zum Beispiel eine E-Mail-Adresse als Benutzernamen verlangen.



Implementierung
    public function get usernamePrompt():String
Konstruktordetails
    

DRMAuthenticateEvent

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

Sprachversion: ActionScript 3.0
Laufzeitversionen: AIR 1.0

Erstellt ein Event-Objekt, das bestimmte Informationen über DRM-Authentifizierungsereignisse enthält. Ereignisobjekte werden Ereignis-Listenern als Parameter übergeben.

Parameter
type:String — Der Ereignistyp. Ereignis-Listener können über die übernommene Eigenschaft type auf diese Informationen zugreifen. Es gibt nur einen Typ von DRMAuthenticate-Ereignissen: DRMAuthenticateEvent.DRM_AUTHENTICATE.
 
bubbles:Boolean (default = false) — Bestimmt, ob das Ereignisobjekt an der Bubbling-Phase des Ereignisablaufs teilnimmt. Ereignis-Listener können über die übernommene Eigenschaft bubbles auf diese Informationen zugreifen.
 
cancelable:Boolean (default = false) — Bestimmt, ob das Ereignisobjekt abgebrochen werden kann. Ereignis-Listener können über die übernommene Eigenschaft cancelable auf diese Informationen zugreifen.
 
header:String (default = "") — Der verschlüsselte Inhaltsdateiheader, der vom Server bereitgestellt wird.
 
userPrompt:String (default = "") — Eine vom Server bereitgestellte Eingabeaufforderung für den Benutzernamen.
 
passPrompt:String (default = "") — Eine vom Server bereitgestellte Eingabeaufforderung für das Kennwort.
 
urlPrompt:String (default = "") — Eine vom Server bereitgestellte Eingabeaufforderung für eine anzuzeigende URL.
 
authenticationType:String (default = "") — Zeigt an, ob die angegebenen Benutzerdaten für die Authentifizierung für den Flash Media Rights Management Server (FMRMS) oder eine Proxyserver bestimmt sind.
 
netstream:NetStream (default = null) — Das NetStream-Objekt, das dieses Ereignis eingeleitet hat.
Methodendetails

    clone

()Methode
override public function clone():Event

Sprachversion: ActionScript 3.0
Laufzeitversionen: AIR 1.0

Erstellt eine Kopie des DRMAuthenticateEvent-Objekts und stellt den Wert jeder Eigenschaft so ein, dass er dem Wert des Originals entspricht.

Rückgabewerte
Event — Ein neues DRMAuthenticateEvent-Objekt mit Eigenschaftswerten, die denen des Originals entsprechen.

    toString

()Methode 
override public function toString():String

Laufzeitversionen: AIR 1.0

Gibt einen String zurück, der alle Eigenschaften des DRMAuthenticateEvent-Objekts enthält. Der String liegt im folgenden Format vor:

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

Rückgabewerte
String — Ein String, der alle Eigenschaften des DRMAuthenticateEvent-Objekts enthält.
Konstantendetails
    

AUTHENTICATION_TYPE_DRM

Konstante
public static const AUTHENTICATION_TYPE_DRM:String = "drm"

Sprachversion: ActionScript 3.0
Laufzeitversionen: AIR 1.0

Die DRMAuthenticateEvent.AUTHENTICATION_TYPE_DRM-Konstante definiert den Wert der authenticationType-Eigenschaft eines DRMAuthenticateEvent-Objekts.

Dieses Ereignis verfügt über die folgenden Eigenschaften:

EigenschaftWert
authenticationTypeZeigt an, ob die angegebenen Benutzerdaten für die Authentifizierung für den Flash Media Rights Management Server (FMRMS) oder eine Proxyserver bestimmt sind.
bubblesfalse
cancelablefalse. Es gibt kein Standardverhalten, das abgebrochen werden kann.
headerDer verschlüsselte Inhaltsdateiheader, der vom Server bereitgestellt wird.
netstreamDas NetStream-Objekt, das dieses Ereignis eingeleitet hat.
passwordPromptEine vom Server bereitgestellte Eingabeaufforderung für das Kennwort.
targetDas NetStream-Objekt.
urlPromptEine vom Server bereitgestellte Eingabeaufforderung für eine anzuzeigende URL.
usernamePromptEine vom Server bereitgestellte Eingabeaufforderung für den Benutzernamen.

Verwandte API-Elemente

    

AUTHENTICATION_TYPE_PROXY

Konstante 
public static const AUTHENTICATION_TYPE_PROXY:String = "proxy"

Sprachversion: ActionScript 3.0
Laufzeitversionen: AIR 1.0

Die DRMAuthenticateEvent.AUTHENTICATION_TYPE_PROXY-Konstante definiert den Wert der authenticationType-Eigenschaft eines DRMAuthenticateEvent-Objekts.

Dieses Ereignis verfügt über die folgenden Eigenschaften:

EigenschaftWert
authenticationTypeZeigt an, ob die angegebenen Benutzerdaten für die Authentifizierung für den Flash Media Rights Management Server (FMRMS) oder eine Proxyserver bestimmt sind.
bubblesfalse
cancelablefalse. Es gibt kein Standardverhalten, das abgebrochen werden kann.
headerDer verschlüsselte Inhaltsdateiheader, der vom Server bereitgestellt wird.
netstreamDas NetStream-Objekt, das dieses Ereignis eingeleitet hat.
passwordPromptEine vom Server bereitgestellte Eingabeaufforderung für das Kennwort.
targetDas NetStream-Objekt.
urlPromptEine vom Server bereitgestellte Eingabeaufforderung für eine anzuzeigende URL.
usernamePromptEine vom Server bereitgestellte Eingabeaufforderung für den Benutzernamen.

Verwandte API-Elemente

    

DRM_AUTHENTICATE

Konstante 
public static const DRM_AUTHENTICATE:String = "drmAuthenticate"

Sprachversion: ActionScript 3.0
Laufzeitversionen: AIR 1.0

Die DRMAuthenticateEvent.DRM_AUTHENTICATE-Konstante definiert den Wert der type-Eigenschaft eines DRMAuthenticateEvent-Objekts.

Dieses Ereignis verfügt über die folgenden Eigenschaften:

EigenschaftWert
authenticationTypeZeigt an, ob die angegebenen Benutzerdaten für die Authentifizierung für den Flash Media Rights Management Server (FMRMS) oder eine Proxyserver bestimmt sind.
bubblesfalse
cancelablefalse. Es gibt kein Standardverhalten, das abgebrochen werden kann.
headerDer verschlüsselte Inhaltsdateiheader, der vom Server bereitgestellt wird.
netstreamDas NetStream-Objekt, das dieses Ereignis eingeleitet hat.
passwordPromptEine vom Server bereitgestellte Eingabeaufforderung für das Kennwort.
targetDas NetStream-Objekt.
urlPromptEine vom Server bereitgestellte Eingabeaufforderung für eine anzuzeigende URL.
usernamePromptEine vom Server bereitgestellte Eingabeaufforderung für den Benutzernamen.

Verwandte API-Elemente

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 ]Warum auf Englisch?
Inhalt des ActionScript 3.0-Referenzhandbuchs wird in englischer Sprache angezeigt

Nicht alle Teile des ActionScript 3.0-Referenzhandbuchs wurden in alle Sprachen übersetzt. Wenn der Text zu einem Sprachelement nicht übersetzt wurde, wird er auf Englisch angezeigt. Zum Beispiel wurden die Informationen zur ga.controls.HelpBox-Klasse nicht in andere Sprachen übersetzt. In der deutschen Version des Referenzhandbuchs erscheint der Abschnitt zur ga.controls.HelpBox-Klasse deshalb auf Englisch.