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 

DRMErrorEvent  - AS3

Paketflash.events
Klassepublic class DRMErrorEvent
VererbungDRMErrorEvent Inheritance ErrorEvent Inheritance TextEvent Inheritance Event Inheritance Object

Sprachversion: ActionScript 3.0
Laufzeitversionen: AIR 1.0, Flash Player 10.1

Die DRMErrorEvent-Klasse stellt Informationen zu Fehlern bereit, die beim Abspielen von DRM-verschlüsselten Dateien auftreten (DRM = Digital Rights Management).

Die Laufzeitumgebung löst ein DRMErrorEvent-Objekt aus, wenn ein NetStream-Objekt versucht, eine mit DRM (Digital Rights Management) verschlüsselte Datei abzuspielen und dabei ein DRM-Fehler auftritt. Ein DRMErrorEvent-Objekt wird zum Beispiel ausgelöst, wenn der Content-Provider die Anzeigeanwendung nicht unterstützt oder wenn die Autorisierung des Benutzers fehlschlägt, weil der Benutzer den Inhalt möglicherweise nicht gekauft hat.

Bei ungültigen Benutzerdaten verarbeitet das DRMAuthenticateEvent-Objekt den Fehler, indem die Auslösung wiederholt erfolgt, bis der Benützer gültige Daten eingibt oder bis die Anwendung weitere Versuche verhindert. Die Anwendung sollte alle anderen DRM-Fehlerereignisse überwachen, um die DRM-bezogenen Fehler zu erkennen, zu identifizieren und zu verarbeiten.

Diese Klasse stellt Eigenschaften bereit, die das Objekt enthalten, das den Fehler ausgegeben hat, sowie den Fehlercode und, falls zutreffend, einen untergeordneten Fehlercode und eine Textnachricht, die Informationen zum Fehler enthält. Eine Beschreibung von Fehlercodes im Zusammenhang mit DRM finden Sie unter Laufzeitfehlercodes. Die DRM-bezogenen Fehlercodes beginnen bei Fehler 3300.

Beispiele anzeigen

Verwandte API-Elemente



Öffentliche Eigenschaften
 EigenschaftDefiniert von
 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
  contentData : DRMContentData
Die DRMContentData für die Mediendatei.
DRMErrorEvent
 InheritedcurrentTarget : Object
[schreibgeschützt] Das Objekt, welches das Ereignisobjekt aktiv mit einem Ereignis-Listener verarbeitet.
Event
  drmUpdateNeeded : Boolean
[schreibgeschützt] Gibt an, ob ein DRM-Update erforderlich ist, um die DRM-geschützten Inhalte abzuspielen.
DRMErrorEvent
 InheritederrorID : int
[schreibgeschützt] Enthält die Verweisnummer, die dem spezifischen Fehler zugeordnet ist.
ErrorEvent
 InheritedeventPhase : uint
[schreibgeschützt] Die aktuelle Phase im Ereignisablauf.
Event
  subErrorID : int
[schreibgeschützt] Eine Fehler-ID, die ausführlichere Informationen zu dem zugrundeliegenden Problem bereitstellt.
DRMErrorEvent
  systemUpdateNeeded : Boolean
[schreibgeschützt] Gibt an, ob ein Systemupdate erforderlich ist, um die DRM-geschützten Inhalte abzuspielen.
DRMErrorEvent
 Inheritedtarget : Object
[schreibgeschützt] Das Ereignis-Ziel.
Event
 Inheritedtext : String
Bei einem textInput-Ereignis das bzw. die vom Benutzer eingegebene(n) Zeichen.
TextEvent
 Inheritedtype : String
[schreibgeschützt] Der Ereignistyp.
Event
Öffentliche Methoden
 MethodeDefiniert von
  
DRMErrorEvent(type:String, bubbles:Boolean = false, cancelable:Boolean = false, inErrorDetail:String = "", inErrorCode:int = 0, insubErrorID:int = 0, inMetadata:DRMContentData = null, inSystemUpdateNeeded:Boolean = false, inDrmUpdateNeeded:Boolean = false)
Erstellt ein Event-Objekt, das bestimmte Informationen über DRM-Fehlerereignisse enthält.
DRMErrorEvent
  
[override] Erstellt eine Kopie des DRMErrorEvent-Objekts und stellt den Wert jeder Eigenschaft so ein, dass er dem Wert des Originals entspricht.
DRMErrorEvent
 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
  
[override] Gibt einen String zurück, der alle Eigenschaften des DRMErrorEvent-Objekts enthält.
DRMErrorEvent
 Inherited
Gibt den Grundwert des angegebenen Objekts zurück.
Object
Öffentliche Konstanten
 KonstanteDefiniert von
  DRM_ERROR : String = "drmError"
[statisch] Die Konstante DRMErrorEvent.DRM_ERROR definiert den Wert der type-Eigenschaft eines drmError-Ereignisobjekts.
DRMErrorEvent
  DRM_LOAD_DEVICEID_ERROR : String = "drmLoadDeviceIdError"
[statisch]
DRMErrorEvent
Eigenschaftendetails

contentData

Eigenschaft
contentData:DRMContentData

Sprachversion: ActionScript 3.0
Laufzeitversionen: AIR 1.5, Flash Player 10.1

Die DRMContentData für die Mediendatei.

Sie können das Objekt, auf das mit der contentData-Eigenschaft verwiesen wird, verwenden, um den zugehörigen DRM-Gutschein aus dem Gutscheincache von DRMManager abzurufen. Die Gutscheineigenschaften beschreiben die dem Benutzer zugängliche Lizenz und erklären ggf., weshalb der DRM-geschützte Inhalt nicht angezeigt werden kann.



Implementierung
    public function get contentData():DRMContentData
    public function set contentData(value:DRMContentData):void

drmUpdateNeeded

Eigenschaft 
drmUpdateNeeded:Boolean  [schreibgeschützt]

Sprachversion: ActionScript 3.0
Laufzeitversionen: AIR 2, Flash Player 10.1

Gibt an, ob ein DRM-Update erforderlich ist, um die DRM-geschützten Inhalte abzuspielen.



Implementierung
    public function get drmUpdateNeeded():Boolean

subErrorID

Eigenschaft 
subErrorID:int  [schreibgeschützt]

Sprachversion: ActionScript 3.0
Laufzeitversionen: AIR 1.0, Flash Player 10.1

Eine Fehler-ID, die ausführlichere Informationen zu dem zugrundeliegenden Problem bereitstellt.



Implementierung
    public function get subErrorID():int

systemUpdateNeeded

Eigenschaft 
systemUpdateNeeded:Boolean  [schreibgeschützt]

Sprachversion: ActionScript 3.0
Laufzeitversionen: AIR 2, Flash Player 10.1

Gibt an, ob ein Systemupdate erforderlich ist, um die DRM-geschützten Inhalte abzuspielen.



Implementierung
    public function get systemUpdateNeeded():Boolean
Konstruktordetails

DRMErrorEvent

()Konstruktor
public function DRMErrorEvent(type:String, bubbles:Boolean = false, cancelable:Boolean = false, inErrorDetail:String = "", inErrorCode:int = 0, insubErrorID:int = 0, inMetadata:DRMContentData = null, inSystemUpdateNeeded:Boolean = false, inDrmUpdateNeeded:Boolean = false)

Sprachversion: ActionScript 3.0
Laufzeitversionen: AIR 1.0, Flash Player 10.1

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

Parameter
type:String (default = NaN) — 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.
 
inErrorDetail:String (default = "") — Die spezifischen syntaktischen Details zum Fehler (falls zutreffend).
 
inErrorCode:int (default = 0) — Der Hauptfehlercode.
 
insubErrorID:int (default = 0) — Die sekundäre Fehler-ID.
 
inMetadata:DRMContentData (default = null)
 
inSystemUpdateNeeded:Boolean (default = false)
 
inDrmUpdateNeeded:Boolean (default = false)
Methodendetails

clone

()Methode
override public function clone():Event

Sprachversion: ActionScript 3.0
Laufzeitversionen: AIR 1.0, Flash Player 10.1

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

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

toString

()Methode 
override public function toString():String

Sprachversion: ActionScript 3.0
Laufzeitversionen: AIR 1.0, Flash Player 10.1

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

[DRMErrorEvent type=Wert bubbles=Wert cancelable=Wert eventPhase=Wert errroID=Wert subErrorID=Wert text=Wert

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

DRM_ERROR

Konstante
public static const DRM_ERROR:String = "drmError"

Sprachversion: ActionScript 3.0
Laufzeitversionen: AIR 1.0, Flash Player 10.1

Die Konstante DRMErrorEvent.DRM_ERROR definiert den Wert der type-Eigenschaft eines drmError-Ereignisobjekts.

Dieses Ereignis verfügt über die folgenden Eigenschaften:

EigenschaftWert
bubblesfalse
cancelablefalse. Es gibt kein Standardverhalten, das abgebrochen werden kann.
errorIDEin dem Problem zugewiesener Fehlercode im Zahlenformat.
subErrorIDEin Fehlercode, der ausführlichere Informationen zum zugrundeliegenden Problem angibt.
targetDas NetStream-Objekt.

Verwandte API-Elemente

DRM_LOAD_DEVICEID_ERROR

Konstante 
public static const DRM_LOAD_DEVICEID_ERROR:String = "drmLoadDeviceIdError"

DRMErrorEventExample.as

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

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

        public function DRMVideoExample()
        {
            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(DRMErrorEvent.DRM_ERROR, drmErrorEventHandler);
            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 drmErrorEventHandler(event:DRMErrorEvent):void {
            trace(event.toString());
        }
     }
}




[ 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.