用于 Adobe® Flash® Platform 的 ActionScript® 3.0 参考
主页  |  隐藏包列表和类列表 |   |   |  新增内容  |  索引  |  附录  |  为什么显示为英语?
过滤条件: 正在从服务器检索数据...
正在从服务器检索数据...
flash.events 

DRMAuthenticateEvent  - AS3

flash.events
public class DRMAuthenticateEvent
继承DRMAuthenticateEvent Inheritance Event Inheritance Object

语言版本: ActionScript 3.0
运行时版本: AIR 1.0

当尝试播放使用数字权限管理 (DRM) 加密的内容(需要用户凭据以进行身份验证)时,NetStream 对象将调度 DRMAuthenticateEvent 对象。

DRMAuthenticateEvent 处理函数负责收集所需的凭据(如用户名、密码和类型)并将值传递给 NetStream.setDRMAuthenticationCredentials() 方法以进行身份验证。每个 AIR 应用程序都必须提供用于获取用户凭据的机制。例如,应用程序可以为用户提供一个简单的用户界面以输入用户名和密码值,以及类型值(可选)。

如果用户身份验证失败,则应用程序将重新尝试身份验证并为 NetStream 对象调度一个新的 DRMAuthenticateEvent 事件。

查看示例

相关 API 元素



公共属性
 属性由以下参数定义
      authenticationType : String
[只读] 表示提供的凭据是用于针对 Flash Media Rights Management Server (FMRMS) 的验证,还是用于针对代理服务器的验证。
DRMAuthenticateEvent
 Inheritedbubbles : Boolean
[只读] 表示事件是否为冒泡事件。
Event
 Inheritedcancelable : Boolean
[只读] 表示是否可以阻止与事件相关联的行为。
Event
 Inheritedconstructor : Object
对类对象或给定对象实例的构造函数的引用。
Object
 InheritedcurrentTarget : Object
[只读] 当前正在使用某个事件侦听器处理 Event 对象的对象。
Event
 InheritedeventPhase : uint
[只读] 事件流中的当前阶段。
Event
      header : String
[只读] 服务器提供的加密内容文件标头。
DRMAuthenticateEvent
      netstream : NetStream
[只读] 启动此事件的 NetStream 对象。
DRMAuthenticateEvent
      passwordPrompt : String
[只读] 服务器提供的密码凭据提示。
DRMAuthenticateEvent
 Inheritedtarget : Object
[只读] 事件目标。
Event
 Inheritedtype : String
[只读] 事件的类型。
Event
      urlPrompt : String
[只读] 服务器提供的 URL 字符串提示。
DRMAuthenticateEvent
      usernamePrompt : String
[只读] 服务器提供的用户名凭据提示。
DRMAuthenticateEvent
公共方法
 方法由以下参数定义
  
    DRMAuthenticateEvent(type:String, bubbles:Boolean = false, cancelable:Boolean = false, header:String = "", userPrompt:String = "", passPrompt:String = "", urlPrompt:String = "", authenticationType:String = "", netstream:NetStream = null)
创建一个 Event 对象,其中包含有关 DRM 验证事件的特定信息。
DRMAuthenticateEvent
  
    clone():Event
[覆盖] 创建 DRMAuthenticateEvent 对象的副本,并将每个属性的值设置为与原始属性值相匹配。
DRMAuthenticateEvent
 Inherited
formatToString(className:String, ... arguments):String
用于在自定义 ActionScript 3.0 Event 类中实现 toString() 方法的实用程序函数。
Event
 Inherited
表示对象是否已经定义了指定的属性。
Object
 Inherited
检查是否已对事件调用 preventDefault() 方法。
Event
 Inherited
表示 Object 类的实例是否在指定为参数的对象的原型链中。
Object
 Inherited
如果可以取消事件的默认行为,则取消该行为。
Event
 Inherited
表示指定的属性是否存在、是否可枚举。
Object
 Inherited
设置循环操作动态属性的可用性。
Object
 Inherited
防止对事件流中当前节点中和所有后续节点中的事件侦听器进行处理。
Event
 Inherited
防止对事件流中当前节点的后续节点中的所有事件侦听器进行处理。
Event
 Inherited
返回此对象的字符串表示形式,其格式设置遵守区域设置特定的约定。
Object
  
    toString():String
[覆盖] 返回一个字符串,其中包含 DRMAuthenticateEvent 对象的所有属性。
DRMAuthenticateEvent
 Inherited
返回指定对象的原始值。
Object
公共常量
 常量由以下参数定义
      AUTHENTICATION_TYPE_DRM : String = "drm"
[静态] DRMAuthenticateEvent.AUTHENTICATION_TYPE_DRM 常量定义 DRMAuthenticateEvent 对象的 authenticationType 属性的值。
DRMAuthenticateEvent
      AUTHENTICATION_TYPE_PROXY : String = "proxy"
[静态] DRMAuthenticateEvent.AUTHENTICATION_TYPE_PROXY 常量定义 DRMAuthenticateEvent 对象的 authenticationType 属性的值。
DRMAuthenticateEvent
      DRM_AUTHENTICATE : String = "drmAuthenticate"
[静态] DRMAuthenticateEvent.DRM_AUTHENTICATE 常量定义 DRMAuthenticateEvent 对象的 type 属性的值。
DRMAuthenticateEvent
属性详细信息
    

authenticationType

属性
authenticationType:String  [只读]

语言版本: ActionScript 3.0
运行时版本: AIR 1.0

表示提供的凭据是用于针对 Flash Media Rights Management Server (FMRMS) 的验证,还是用于针对代理服务器的验证。例如,“proxy”选项允许应用程序针对代理服务器进行身份验证(如果企业要求用户通过此步骤后才能访问 Internet)。除非使用匿名身份验证,否则在代理身份验证之后,用户仍需要针对 FMRMS 进行身份验证才能获取凭证并播放内容。您可以再次与“drm”选项一起使用 setDRMAuthenticationcredentials() 以针对 FMRMS 进行身份验证。



实现
    public function get authenticationType():String
    

header

属性 
header:String  [只读]

语言版本: ActionScript 3.0
运行时版本: AIR 1.0

服务器提供的加密内容文件标头。它包含有关加密内容的上下文的信息。



实现
    public function get header():String
    

netstream

属性 
netstream:NetStream  [只读]

语言版本: ActionScript 3.0
运行时版本: AIR 1.0

启动此事件的 NetStream 对象。



实现
    public function get netstream():NetStream
    

passwordPrompt

属性 
passwordPrompt:String  [只读]

语言版本: ActionScript 3.0
运行时版本: AIR 1.0

服务器提供的密码凭据提示。该字符串可以包括所需密码的类型说明。



实现
    public function get passwordPrompt():String
    

urlPrompt

属性 
urlPrompt:String  [只读]

语言版本: ActionScript 3.0
运行时版本: AIR 1.0

服务器提供的 URL 字符串提示。该字符串可以提供要将用户名和密码发送到的位置。



实现
    public function get urlPrompt():String
    

usernamePrompt

属性 
usernamePrompt:String  [只读]

语言版本: ActionScript 3.0
运行时版本: AIR 1.0

服务器提供的用户名凭据提示。该字符串可以包括所需用户名的类型说明。例如,内容提供程序可能需要电子邮件地址作为用户名。



实现
    public function get usernamePrompt():String
构造函数详细信息
    

DRMAuthenticateEvent

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

语言版本: ActionScript 3.0
运行时版本: AIR 1.0

创建一个 Event 对象,其中包含有关 DRM 验证事件的特定信息。将 Event 对象作为参数传递给事件侦听器。

参数
type:String — 事件的类型。事件侦听器可以通过继承的 type 属性访问此信息。只有一种类型的 DRMAuthenticate 事件:DRMAuthenticateEvent.DRM_AUTHENTICATE
 
bubbles:Boolean (default = false) — 确定 Event 对象是否参与事件流的冒泡阶段。事件侦听器可以通过继承的 bubbles 属性访问此信息。
 
cancelable:Boolean (default = false) — 确定是否可以取消 Event 对象。事件侦听器可以通过继承的 cancelable 属性访问此信息。
 
header:String (default = "") — 服务器提供的加密内容文件标头。
 
userPrompt:String (default = "") — 服务器提供的用户名凭据提示。
 
passPrompt:String (default = "") — 服务器提供的密码凭据提示。
 
urlPrompt:String (default = "") — 服务器提供的要显示的 URL 提示。
 
authenticationType:String (default = "") — 表示提供的凭据是用于针对 Flash Media Rights Management Server (FMRMS) 的身份验证,还是用于针对代理服务器的身体验证。
 
netstream:NetStream (default = null) — 启动此事件的 NetStream 对象。
方法详细信息

    clone

()方法
override public function clone():Event

语言版本: ActionScript 3.0
运行时版本: AIR 1.0

创建 DRMAuthenticateEvent 对象的副本,并将每个属性的值设置为与原始属性值相匹配。

返回
Event — 其属性值与原始属性值匹配的新 DRMAuthenticateEvent 对象。

    toString

()方法 
override public function toString():String

运行时版本: AIR 1.0

返回一个字符串,其中包含 DRMAuthenticateEvent 对象的所有属性。字符串的格式如下:

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

返回
String — 一个字符串,其中包含 DRMAuthenticateEvent 对象的所有属性。
常量详细信息
    

AUTHENTICATION_TYPE_DRM

常量
public static const AUTHENTICATION_TYPE_DRM:String = "drm"

语言版本: ActionScript 3.0
运行时版本: AIR 1.0

DRMAuthenticateEvent.AUTHENTICATION_TYPE_DRM 常量定义 DRMAuthenticateEvent 对象的 authenticationType 属性的值。

此事件具有以下属性:

属性
authenticationType表示提供的凭据是用于针对 Flash Media Rights Management Server (FMRMS) 的身份验证,还是用于针对代理服务器的身体验证。
bubblesfalse
cancelablefalse;没有要取消的默认行为。
header服务器提供的加密内容文件标头。
netstream启动此事件的 NetStream 对象。
passwordPrompt服务器提供的密码凭据提示。
targetNetStream 对象。
urlPrompt服务器提供的要显示的 URL 提示。
usernamePrompt服务器提供的用户名凭据提示。

相关 API 元素

    

AUTHENTICATION_TYPE_PROXY

常量 
public static const AUTHENTICATION_TYPE_PROXY:String = "proxy"

语言版本: ActionScript 3.0
运行时版本: AIR 1.0

DRMAuthenticateEvent.AUTHENTICATION_TYPE_PROXY 常量定义 DRMAuthenticateEvent 对象的 authenticationType 属性的值。

此事件具有以下属性:

属性
authenticationType表示提供的凭据是用于针对 Flash Media Rights Management Server (FMRMS) 的身份验证,还是用于针对代理服务器的身体验证。
bubblesfalse
cancelablefalse;没有要取消的默认行为。
header服务器提供的加密内容文件标头。
netstream启动此事件的 NetStream 对象。
passwordPrompt服务器提供的密码凭据提示。
targetNetStream 对象。
urlPrompt服务器提供的要显示的 URL 提示。
usernamePrompt服务器提供的用户名凭据提示。

相关 API 元素

    

DRM_AUTHENTICATE

常量 
public static const DRM_AUTHENTICATE:String = "drmAuthenticate"

语言版本: ActionScript 3.0
运行时版本: AIR 1.0

DRMAuthenticateEvent.DRM_AUTHENTICATE 常量定义 DRMAuthenticateEvent 对象的 type 属性的值。

此事件具有以下属性:

属性
authenticationType表示提供的凭据是用于针对 Flash Media Rights Management Server (FMRMS) 的身份验证,还是用于针对代理服务器的身体验证。
bubblesfalse
cancelablefalse 表示没有要取消的默认行为。
header服务器提供的加密内容文件标头。
netstream启动此事件的 NetStream 对象。
passwordPrompt服务器提供的密码凭据提示。
targetNetStream 对象。
urlPrompt服务器提供的要显示的 URL 提示。
usernamePrompt服务器提供的用户名凭据提示。

相关 API 元素

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 ]为什么显示为英语?
《ActionScript 3.0 参考》中的内容以英语显示

《ActionScript 3.0 参考》中的部分内容未翻译成所有语言。当某个语言元素未翻译时,将显示为英语。例如,ga.controls.HelpBox 类未翻译成任何语言。因此在简体中文版的参考中,ga.controls.HelpBox 类显示为英语。