Paket | flash.events |
Klasse | public class DRMErrorEvent |
Vererbung | DRMErrorEvent ErrorEvent TextEvent Event Object |
Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | AIR 1.0, Flash Player 10.1 |
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.
Verwandte API-Elemente
Eigenschaft | Definiert von | ||
---|---|---|---|
bubbles : Boolean [schreibgeschützt]
Gibt an, ob es sich bei dem Ereignis um ein Bubbling-Ereignis handelt. | Event | ||
cancelable : Boolean [schreibgeschützt]
Gibt an, ob das mit dem Ereignis verknüpfte Verhalten verhindert werden kann. | Event | ||
constructor : Object
Ein Verweis auf das Klassenobjekt oder die Konstruktorfunktion für eine angegebene Objektinstanz. | Object | ||
contentData : DRMContentData
Die DRMContentData für die Mediendatei. | DRMErrorEvent | ||
currentTarget : 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 | ||
errorID : int [schreibgeschützt]
Enthält die Verweisnummer, die dem spezifischen Fehler zugeordnet ist. | ErrorEvent | ||
eventPhase : 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 | ||
target : Object [schreibgeschützt]
Das Ereignis-Ziel. | Event | ||
text : String
Bei einem textInput-Ereignis das bzw. die vom Benutzer eingegebene(n) Zeichen. | TextEvent | ||
type : String [schreibgeschützt]
Der Ereignistyp. | Event |
Methode | Definiert 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 | ||
Eine Dienstprogrammfunktion zur Implementierung der toString()-Methode in benutzerdefinierten ActionScript 3.0 Event-Klassen. | Event | ||
Gibt an, ob für ein Objekt eine bestimmte Eigenschaft definiert wurde. | Object | ||
Überprüft, ob die preventDefault()-Methode bei dem Ereignis aufgerufen wurde. | Event | ||
Gibt an, ob eine Instanz der Object-Klasse in der Prototypkette des Objekts vorhanden ist, das als Parameter angegeben wurde. | Object | ||
Bricht das Standardverhalten eines Ereignisses ab, wenn dieses Verhalten abgebrochen werden kann. | Event | ||
Gibt an, ob die angegebene Eigenschaft vorhanden ist und durchlaufen werden kann. | Object | ||
Legt die Verfügbarkeit einer dynamischen Eigenschaft für Schleifenoperationen fest. | Object | ||
Verhindert die Verarbeitung von Ereignis-Listenern im aktuellen Knoten und in Knoten, die dem aktuellen Knoten im Ereignisablauf nachfolgen. | Event | ||
Verhindert die Verarbeitung von Ereignis-Listenern in Knoten, die dem aktuellen Knoten im Ereignisablauf nachfolgen. | Event | ||
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 | ||
Gibt den Grundwert des angegebenen Objekts zurück. | Object |
Konstante | Definiert 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 |
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 |
subErrorID | Eigenschaft |
systemUpdateNeeded | Eigenschaft |
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.
Parametertype: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 )
|
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ückgabewerteEvent — 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
String — Ein String, der alle Eigenschaften des DRMErrorEvent-Objekts enthält.
|
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:
Eigenschaft | Wert |
---|---|
bubbles | false |
cancelable | false . Es gibt kein Standardverhalten, das abgebrochen werden kann. |
errorID | Ein dem Problem zugewiesener Fehlercode im Zahlenformat. |
subErrorID | Ein Fehlercode, der ausführlichere Informationen zum zugrundeliegenden Problem angibt. |
target | Das NetStream-Objekt. |
Verwandte API-Elemente
DRM_LOAD_DEVICEID_ERROR | Konstante |
public static const DRM_LOAD_DEVICEID_ERROR:String = "drmLoadDeviceIdError"
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()); } } }
Tue Jun 12 2018, 10:04 AM Z