Referencia de ActionScript® 3.0 para la plataforma de Adobe® Flash®
Inicio  |  Ocultar lista de paquetes y clases |  Paquetes  |  Clases  |  Novedades  |  Índice  |  Apéndices  |  ¿Por qué hay texto en inglés?
Filtros: Recuperando datos del servidor...
Recuperando datos del servidor...
flash.events 

DRMAuthenticateEvent  - AS3

Paqueteflash.events
Clasepublic class DRMAuthenticateEvent
HerenciaDRMAuthenticateEvent Inheritance Event Inheritance Object

Versión del lenguaje: ActionScript 3.0
Versiones de motor de ejecución: AIR 1.0

Un objeto NetStream distribuye un objeto DRMAuthenticateEvent cuando intenta reproducir contenido codificado con gestión de derechos multimedia (DRM) que requiera la introducción de las credenciales del usuario como método de autenticación.

El controlador DRMAuthenticateEvent es el responsable de adquirir las credenciales necesarias (nombre de usuario, contraseña y tipo) y transferir los valores al método NetStream.setDRMAuthenticationCredentials() para su autenticación. Todas las aplicaciones de AIR debe ofrecer algún mecanismo para obtener las credenciales del usuario. Por ejemplo, la aplicación debe proporcionar una sencilla interfaz de usuario para poder introducir los valores de username y password y, opcionalmente, el valor de type.

Si falla la autenticación del usuario, la aplicación vuelve a intentarlo y distribuye un nuevo evento DRMAuthenticateEvent para el objeto NetStream.

Ver los ejemplos

Elementos de API relacionados

DRMAuthenticateEvent.DRM_AUTHENTICATE
flash.net.drm.DRMManager

Propiedades públicas
 PropiedadDefinido por
      authenticationType : String
[solo lectura] Indica si las credenciales suministradas se utilizan para autenticar con el servidor Flash Media Rights Management Server (FMRMS) o un servidor proxy.
DRMAuthenticateEvent
 Inheritedbubbles : Boolean
[solo lectura] Indica si un evento es un evento de propagación.
Event
 Inheritedcancelable : Boolean
[solo lectura] Indica si se puede evitar el comportamiento asociado al evento.
Event
 Inheritedconstructor : Object
Una referencia a la clase de objeto o función constructora para una instancia de objeto determinada.
Object
 InheritedcurrentTarget : Object
[solo lectura] Objeto que procesa de forma activa el objeto de evento con un detector de eventos.
Event
 InheritedeventPhase : uint
[solo lectura] La fase actual en el flujo del evento.
Event
      header : String
[solo lectura] Encabezado de archivo de contenido cifrado proporcionado por el servidor.
DRMAuthenticateEvent
      netstream : NetStream
[solo lectura] Objeto NetStream que inició este evento
DRMAuthenticateEvent
      passwordPrompt : String
[solo lectura] Mensaje para credenciales de contraseña proporcionado por el servidor.
DRMAuthenticateEvent
 Inheritedtarget : Object
[solo lectura] El destino del evento.
Event
 Inheritedtype : String
[solo lectura] El tipo de evento.
Event
      urlPrompt : String
[solo lectura] Mensaje de cadena URL proporcionado por el servidor.
DRMAuthenticateEvent
      usernamePrompt : String
[solo lectura] Mensaje para credenciales de nombre de usuario proporcionado por el servidor.
DRMAuthenticateEvent
Métodos públicos
 MétodoDefinido por
  
    DRMAuthenticateEvent(type:String, bubbles:Boolean = false, cancelable:Boolean = false, header:String = "", userPrompt:String = "", passPrompt:String = "", urlPrompt:String = "", authenticationType:String = "", netstream:NetStream = null)
Crea un objeto de evento que contiene información concreta sobre eventos de autenticación DRM.
DRMAuthenticateEvent
  
    clone():Event
[override] Crea una copia del objeto DRMAuthenticateEvent y define el valor de cada propiedad para que coincida con el del objeto original.
DRMAuthenticateEvent
 Inherited
formatToString(className:String, ... arguments):String
Una función de utilidad para implementar el método toString() en las clases Event personalizadas de ActionScript 3.0.
Event
 Inherited
hasOwnProperty(name:String):Boolean
Indica si un objeto tiene definida una propiedad especificada.
Object
 Inherited
isDefaultPrevented():Boolean
Comprueba si se ha llamado a preventDefault() en el evento.
Event
 Inherited
isPrototypeOf(theClass:Object):Boolean
Indica si hay una instancia de la clase Object en la cadena de prototipo del objeto especificado como parámetro.
Object
 Inherited
preventDefault():void
Cancela el comportamiento predeterminado de un evento si es posible cancelarlo.
Event
 Inherited
propertyIsEnumerable(name:String):Boolean
Indica si existe la propiedad especificada y si es enumerable.
Object
 Inherited
setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void
Establece la disponibilidad de una propiedad dinámica para operaciones de bucle.
Object
 Inherited
stopImmediatePropagation():void
Impide el proceso de cualquier detector de eventos en el nodo actual y los nodos siguientes en el flujo del evento.
Event
 Inherited
stopPropagation():void
Impide el proceso de cualquier detector de eventos en nodos siguientes al nodo actual.
Event
 Inherited
toLocaleString():String
Devuelve la representación de cadena de este objeto, con formato según las convenciones específicas de configuración regional.
Object
  
    toString():String
[override] Devuelve una cadena con todas las propiedades del objeto DRMAuthenticateEvent.
DRMAuthenticateEvent
 Inherited
valueOf():Object
Devuelve el valor simple del objeto especificado.
Object
Constantes públicas
 ConstanteDefinido por
      AUTHENTICATION_TYPE_DRM : String = "drm"
[estática] La constante DRMAuthenticateEvent.AUTHENTICATION_TYPE_DRM define el valor de la propiedad authenticationType de un objeto de evento DRMAuthenticateEvent.
DRMAuthenticateEvent
      AUTHENTICATION_TYPE_PROXY : String = "proxy"
[estática] La constante DRMAuthenticateEvent.AUTHENTICATION_TYPE_PROXY define el valor de la propiedad authenticationType de un objeto de evento DRMAuthenticateEvent.
DRMAuthenticateEvent
      DRM_AUTHENTICATE : String = "drmAuthenticate"
[estática] La constante DRMAuthenticateEvent.DRM_AUTHENTICATE define el valor de la propiedad type de un objeto de evento DRMAuthenticateEvent.
DRMAuthenticateEvent
Información sobre propiedades
    

authenticationType

propiedad
authenticationType:String  [solo lectura]

Versión del lenguaje: ActionScript 3.0
Versiones de motor de ejecución: AIR 1.0

Indica si las credenciales suministradas se utilizan para autenticar con el servidor Flash Media Rights Management Server (FMRMS) o un servidor proxy. Por ejemplo, la opción "proxy" permite que la aplicación pueda autenticar siempre con un servidor proxy si una empresa así requiere este paso previo para que el usuario pueda acceder a Internet. A no ser que se utilice la autenticación anónima, tras la autenticación proxy el usuario sigue necesitando autenticarse con FMRMS para poder obtener la licencia correspondiente y reproducir el contenido. Puede volver a utilizar setDRMAuthenticationcredentials() una segunda vez con la opción "drm" para autenticar con FMRMS.



Implementación
    public function get authenticationType():String
    

header

propiedad 
header:String  [solo lectura]

Versión del lenguaje: ActionScript 3.0
Versiones de motor de ejecución: AIR 1.0

Encabezado de archivo de contenido cifrado proporcionado por el servidor. Contiene información sobre el contexto del contenido cifrado.



Implementación
    public function get header():String
    

netstream

propiedad 
netstream:NetStream  [solo lectura]

Versión del lenguaje: ActionScript 3.0
Versiones de motor de ejecución: AIR 1.0

Objeto NetStream que inició este evento



Implementación
    public function get netstream():NetStream
    

passwordPrompt

propiedad 
passwordPrompt:String  [solo lectura]

Versión del lenguaje: ActionScript 3.0
Versiones de motor de ejecución: AIR 1.0

Mensaje para credenciales de contraseña proporcionado por el servidor. La cadena puede incluir instrucciones para el tipo de contraseña requerido.



Implementación
    public function get passwordPrompt():String
    

urlPrompt

propiedad 
urlPrompt:String  [solo lectura]

Versión del lenguaje: ActionScript 3.0
Versiones de motor de ejecución: AIR 1.0

Mensaje de cadena URL proporcionado por el servidor. La cadena puede facilitar la ubicación a la que se enviará el nombre de usuario y la contraseña.



Implementación
    public function get urlPrompt():String
    

usernamePrompt

propiedad 
usernamePrompt:String  [solo lectura]

Versión del lenguaje: ActionScript 3.0
Versiones de motor de ejecución: AIR 1.0

Mensaje para credenciales de nombre de usuario proporcionado por el servidor. La cadena puede incluir instrucciones para el tipo de nombre de usuario requerido. Por ejemplo, un proveedor de contenido puede requerir una dirección de correo electrónico como nombre de usuario.



Implementación
    public function get usernamePrompt():String
Información sobre constructores
    

DRMAuthenticateEvent

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

Versión del lenguaje: ActionScript 3.0
Versiones de motor de ejecución: AIR 1.0

Crea un objeto de evento que contiene información concreta sobre eventos de autenticación DRM. Los objetos de evento se transfieren como parámetros a los detectores de eventos.

Parámetros
type:String — 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.
 
header:String (default = "") — Encabezado de archivo de contenido cifrado proporcionado por el servidor.
 
userPrompt:String (default = "") — Mensaje para credenciales de nombre de usuario proporcionado por el servidor.
 
passPrompt:String (default = "") — Mensaje para credenciales de contraseña proporcionado por el servidor.
 
urlPrompt:String (default = "") — Mensaje para visualizar la URL proporcionado por el servidor.
 
authenticationType:String (default = "") — Indica si las credenciales suministradas se utilizan para autenticar con el servidor Flash Media Rights Management Server (FMRMS) o un servidor proxy.
 
netstream:NetStream (default = null) — Objeto NetStream que inició este evento
Información sobre métodos

    clone

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

Versión del lenguaje: ActionScript 3.0
Versiones de motor de ejecución: AIR 1.0

Crea una copia del objeto DRMAuthenticateEvent y define el valor de cada propiedad para que coincida con el del objeto original.

Valor devuelto
Event — Un nuevo objeto DRMAuthenticateEvent con valores de propiedades que coinciden con los del objeto original.

    toString

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

Versiones de motor de ejecución: AIR 1.0

Devuelve una cadena con todas las propiedades del objeto DRMAuthenticateEvent. La cadena tiene el siguiente formato:

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

Valor devuelto
String — Cadena con todas las propiedades del objeto DRMAuthenticateEvent.
Información sobre constantes
    

AUTHENTICATION_TYPE_DRM

Constante
public static const AUTHENTICATION_TYPE_DRM:String = "drm"

Versión del lenguaje: ActionScript 3.0
Versiones de motor de ejecución: AIR 1.0

La constante DRMAuthenticateEvent.AUTHENTICATION_TYPE_DRM define el valor de la propiedad authenticationType de un objeto de evento DRMAuthenticateEvent.

Este evento tiene las propiedades siguientes:

PropiedadValor
authenticationTypeIndica si las credenciales suministradas se utilizan para autenticar con el servidor Flash Media Rights Management Server (FMRMS) o un servidor proxy.
bubblesfalse
cancelablefalse; no hay ningún comportamiento predeterminado que cancelar.
headerEncabezado de archivo de contenido cifrado proporcionado por el servidor.
netstreamObjeto NetStream que inició este evento
passwordPromptMensaje para credenciales de contraseña proporcionado por el servidor.
targetObjeto NetStream.
urlPromptMensaje para visualizar la URL proporcionado por el servidor.
usernamePromptMensaje para credenciales de nombre de usuario proporcionado por el servidor.

Elementos de API relacionados

flash.net.NetStream.drmAuthenticate
DRMAuthenticateEvent.authenticationType
    

AUTHENTICATION_TYPE_PROXY

Constante 
public static const AUTHENTICATION_TYPE_PROXY:String = "proxy"

Versión del lenguaje: ActionScript 3.0
Versiones de motor de ejecución: AIR 1.0

La constante DRMAuthenticateEvent.AUTHENTICATION_TYPE_PROXY define el valor de la propiedad authenticationType de un objeto de evento DRMAuthenticateEvent.

Este evento tiene las propiedades siguientes:

PropiedadValor
authenticationTypeIndica si las credenciales suministradas se utilizan para autenticar con el servidor Flash Media Rights Management Server (FMRMS) o un servidor proxy.
bubblesfalse
cancelablefalse; no hay ningún comportamiento predeterminado que cancelar.
headerEncabezado de archivo de contenido cifrado proporcionado por el servidor.
netstreamObjeto NetStream que inició este evento
passwordPromptMensaje para credenciales de contraseña proporcionado por el servidor.
targetObjeto NetStream.
urlPromptMensaje para visualizar la URL proporcionado por el servidor.
usernamePromptMensaje para credenciales de nombre de usuario proporcionado por el servidor.

Elementos de API relacionados

flash.net.NetStream.drmAuthenticate
DRMAuthenticateEvent.authenticationType
    

DRM_AUTHENTICATE

Constante 
public static const DRM_AUTHENTICATE:String = "drmAuthenticate"

Versión del lenguaje: ActionScript 3.0
Versiones de motor de ejecución: AIR 1.0

La constante DRMAuthenticateEvent.DRM_AUTHENTICATE define el valor de la propiedad type de un objeto de evento DRMAuthenticateEvent.

Este evento tiene las propiedades siguientes:

PropiedadValor
authenticationTypeIndica si las credenciales suministradas se utilizan para autenticar con el servidor Flash Media Rights Management Server (FMRMS) o un servidor proxy.
bubblesfalse
cancelablefalse; no hay ningún comportamiento predeterminado para cancelar.
headerEncabezado de archivo de contenido cifrado proporcionado por el servidor.
netstreamObjeto NetStream que inició este evento
passwordPromptMensaje para credenciales de contraseña proporcionado por el servidor.
targetObjeto NetStream.
urlPromptMensaje para visualizar la URL proporcionado por el servidor.
usernamePromptMensaje para credenciales de nombre de usuario proporcionado por el servidor.

Elementos de API relacionados

flash.net.NetStream.drmAuthenticate
Ejemplos Cómo utilizar este ejemplo
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");
        }
     }
}



© 2015 Adobe Systems Incorporated. All rights reserved.
Tue Jun 12 2018, 02:12 PM Z
 

 

Avisos legales | Política de privacidad en línea
[ X ]¿Por qué hay texto en inglés?
Cierto contenido de la Referencia de ActionScript 3.0 se muestra en inglés

No todo el contenido de la Referencia de ActionScript 3.0 se traduce a todos los idiomas. Si un elemento del lenguaje no se traduce, aparecerá en inglés. Por ejemplo, la clase ga.controls.HelpBox no está traducida en ningún idioma. Por lo tanto, en la versión en español de la referencia, la clase ga.controls.HelpBox aparecerá en inglés.