Paquete | flash.events |
Clase | public class DRMErrorEvent |
Herencia | DRMErrorEvent ErrorEvent TextEvent Event Object |
Versión del lenguaje: | ActionScript 3.0 |
Versiones de motor de ejecución: | AIR 1.0, Flash Player 10.1 |
El motor de ejecución de AIR distribuye un objeto DRMErrorEvent cuando obtiene un error relacionado con DRM al intentar reproducir un archivo cifrado con administración de derechos digitales. Por ejemplo, se distribuye un objeto DRMErrorEvent cuando el proveedor de contenido no admite la aplicación de visualización, o si falla la autorización del usuario (probablemente porque el usuario no ha adquirido el contenido correspondiente).
En caso de credenciales de usuario no válidas, el objeto DRMAuthenticateEvent gestiona el error distribuyendo este objeto continuamente hasta que el usuario introduzca credenciales válidas o hasta que la aplicación de deniegue más intentos. La aplicación debería detectar cualquier otro evento de error DRM para poder detectar, identificar y gestionar los errores relacionados con administración de derechos digitales.
Esta clase proporciona propiedades que contienen el objeto que emite una excepción, el código de error y, si procede, un código de error secundario y un mensaje de texto con información relacionada con el error. Para obtener una descripción de los códigos de error relacionados con DRM, consulte Códigos de error en tiempo de ejecución. Los códigos de error relacionados con DRM empiezan en 3300.
Elementos de API relacionados
Propiedad | Definido por | ||
---|---|---|---|
bubbles : Boolean [solo lectura]
Indica si un evento es un evento de propagación. | Event | ||
cancelable : Boolean [solo lectura]
Indica si se puede evitar el comportamiento asociado al evento. | Event | ||
constructor : Object
Una referencia a la clase de objeto o función constructora para una instancia de objeto determinada. | Object | ||
contentData : DRMContentData
DRMContentData para el archivo multimedia. | DRMErrorEvent | ||
currentTarget : Object [solo lectura]
Objeto que procesa de forma activa el objeto de evento con un detector de eventos. | Event | ||
drmUpdateNeeded : Boolean [solo lectura]
Indica si se necesita una actualización de DRM para reproducir el contenido protegido con DRM. | DRMErrorEvent | ||
errorID : int [solo lectura]
Contiene el número de referencia asociado al error concreto. | ErrorEvent | ||
eventPhase : uint [solo lectura]
La fase actual en el flujo del evento. | Event | ||
subErrorID : int [solo lectura]
Identificador de error que facilita información detallada sobre el problema subyacente. | DRMErrorEvent | ||
systemUpdateNeeded : Boolean [solo lectura]
Indica si se necesita una actualización del sistema para reproducir el contenido protegido con DRM. | DRMErrorEvent | ||
target : Object [solo lectura]
El destino del evento. | Event | ||
text : String
Para un evento textInput, el carácter o la secuencia de caracteres introducidos por el usuario. | TextEvent | ||
type : String [solo lectura]
El tipo de evento. | Event |
Método | Definido por | ||
---|---|---|---|
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)
Crea un objeto de evento que contiene información concreta sobre eventos de error DRM. | DRMErrorEvent | ||
[override]
Crea una copia del objeto DRMErrorEvent y define el valor de cada propiedad para que coincida con el del objeto original. | DRMErrorEvent | ||
Una función de utilidad para implementar el método toString() en las clases Event personalizadas de ActionScript 3.0. | Event | ||
Indica si un objeto tiene definida una propiedad especificada. | Object | ||
Comprueba si se ha llamado a preventDefault() en el evento. | Event | ||
Indica si hay una instancia de la clase Object en la cadena de prototipo del objeto especificado como parámetro. | Object | ||
Cancela el comportamiento predeterminado de un evento si es posible cancelarlo. | Event | ||
Indica si existe la propiedad especificada y si es enumerable. | Object | ||
Establece la disponibilidad de una propiedad dinámica para operaciones de bucle. | Object | ||
Impide el proceso de cualquier detector de eventos en el nodo actual y los nodos siguientes en el flujo del evento. | Event | ||
Impide el proceso de cualquier detector de eventos en nodos siguientes al nodo actual. | Event | ||
Devuelve la representación de cadena de este objeto, con formato según las convenciones específicas de configuración regional. | Object | ||
[override]
Devuelve una cadena con todas las propiedades del objeto DRMErrorEvent. | DRMErrorEvent | ||
Devuelve el valor simple del objeto especificado. | Object |
Constante | Definido por | ||
---|---|---|---|
DRM_ERROR : String = "drmError" [estática]
La constante DRMErrorEvent.DRM_ERROR define el valor de la propiedad type de un objeto de evento drmError. | DRMErrorEvent | ||
DRM_LOAD_DEVICEID_ERROR : String = "drmLoadDeviceIdError" [estática] | DRMErrorEvent |
contentData | propiedad |
contentData:DRMContentData
Versión del lenguaje: | ActionScript 3.0 |
Versiones de motor de ejecución: | AIR 1.5, Flash Player 10.1 |
DRMContentData para el archivo multimedia.
Se puede utilizar el objeto al que se hace referencia en la propiedad contentData
para recuperar la licencia DRM relacionada desde la caché de licencias de DRMManager. Las propiedades de la licencia describen la licencia disponible para el usuario y pueden aclarar el motivo por el cual el contenido DRM no se puede visualizar.
Implementación
public function get contentData():DRMContentData
public function set contentData(value:DRMContentData):void
drmUpdateNeeded | propiedad |
subErrorID | propiedad |
systemUpdateNeeded | propiedad |
systemUpdateNeeded:Boolean
[solo lectura] Versión del lenguaje: | ActionScript 3.0 |
Versiones de motor de ejecución: | AIR 2, Flash Player 10.1 |
Indica si se necesita una actualización del sistema para reproducir el contenido protegido con DRM.
Implementación
public function get systemUpdateNeeded():Boolean
DRMErrorEvent | () | Información sobre |
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)
Versión del lenguaje: | ActionScript 3.0 |
Versiones de motor de ejecución: | AIR 1.0, Flash Player 10.1 |
Crea un objeto de evento que contiene información concreta sobre eventos de error DRM. Los objetos de evento se transfieren como parámetros a los detectores de eventos.
Parámetrostype:String (default = NaN ) — El tipo de evento. Los detectores de eventos pueden acceder a esta información a través de la propiedad type heredada. Sólo hay un tipo de evento DRMAuthenticate: DRMAuthenticateEvent.DRM_AUTHENTICATE .
| |
bubbles:Boolean (default = false ) — Determina si el objeto de evento participa en la fase de propagación del flujo del evento. Los detectores de eventos pueden acceder a esta información a través de la propiedad bubbles heredada.
| |
cancelable:Boolean (default = false ) — Determina si se puede cancelar el objeto Event. Los detectores de eventos pueden acceder a esta información a través de la propiedad cancelable heredada.
| |
inErrorDetail:String (default = " ") — Si procede, los detalles de sintaxis específicos del error.
| |
inErrorCode:int (default = 0 ) — Código del error principal.
| |
insubErrorID:int (default = 0 ) — Identificador del error menor.
| |
inMetadata:DRMContentData (default = null )
| |
inSystemUpdateNeeded:Boolean (default = false )
| |
inDrmUpdateNeeded:Boolean (default = false )
|
clone | () | método |
override public function clone():Event
Versión del lenguaje: | ActionScript 3.0 |
Versiones de motor de ejecución: | AIR 1.0, Flash Player 10.1 |
Crea una copia del objeto DRMErrorEvent y define el valor de cada propiedad para que coincida con el del objeto original.
Valor devueltoEvent — Un nuevo objeto DRMErrorEvent con valores de propiedades que coinciden con los del objeto original.
|
toString | () | método |
override public function toString():String
Versión del lenguaje: | ActionScript 3.0 |
Versiones de motor de ejecución: | AIR 1.0, Flash Player 10.1 |
Devuelve una cadena con todas las propiedades del objeto DRMErrorEvent. La cadena tiene el siguiente formato:
[DRMErrorEvent type=valor bubbles=valor cancelable=valor eventPhase=valor errroID=valor subErrorID=valor text=valor
String — Cadena con todas las propiedades del objeto DRMErrorEvent.
|
DRM_ERROR | Constante |
public static const DRM_ERROR:String = "drmError"
Versión del lenguaje: | ActionScript 3.0 |
Versiones de motor de ejecución: | AIR 1.0, Flash Player 10.1 |
La constante DRMErrorEvent.DRM_ERROR
define el valor de la propiedad type
de un objeto de evento drmError
.
Este evento tiene las propiedades siguientes:
Propiedad | Valor |
---|---|
bubbles | false |
cancelable | false ; no hay ningún comportamiento predeterminado que cancelar. |
errorID | Se ha asignado un código de error numérico al problema. |
subErrorID | Código de error que indica más información detallada sobre el problema subyacente. |
target | Objeto NetStream. |
Elementos de API relacionados
DRM_LOAD_DEVICEID_ERROR | Constante |
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, 02:12 PM Z