| 包 | flash.events |
| 类 | public class DRMAuthenticateEvent |
| 继承 | DRMAuthenticateEvent  Event Object |
| 语言版本: | ActionScript 3.0 |
| 运行时版本: | AIR 1.0 |
DRMAuthenticateEvent 处理函数负责收集所需的凭据（如用户名、密码和类型）并将值传递给 NetStream.setDRMAuthenticationCredentials() 方法以进行身份验证。每个 AIR 应用程序都必须提供用于获取用户凭据的机制。例如，应用程序可以为用户提供一个简单的用户界面以输入用户名和密码值，以及类型值（可选）。
如果用户身份验证失败，则应用程序将重新尝试身份验证并为 NetStream 对象调度一个新的 DRMAuthenticateEvent 事件。
相关 API 元素
公共属性
隐藏继承的公共属性
显示继承的公共属性| 属性 | 由以下参数定义 | ||
|---|---|---|---|
| authenticationType : String [只读]
表示提供的凭据是用于针对 Flash Media Rights Management Server (FMRMS) 的验证，还是用于针对代理服务器的验证。 | DRMAuthenticateEvent | ||
 | bubbles : Boolean [只读]
表示事件是否为冒泡事件。 | Event | |
| cancelable : Boolean [只读]
表示是否可以阻止与事件相关联的行为。 | Event | |
| constructor : Object
对类对象或给定对象实例的构造函数的引用。 | Object | |
| currentTarget : Object [只读]
当前正在使用某个事件侦听器处理 Event 对象的对象。 | Event | |
| eventPhase : uint [只读]
事件流中的当前阶段。 | Event | |
| header : String [只读]
服务器提供的加密内容文件标头。 | DRMAuthenticateEvent | ||
| netstream : NetStream [只读]
启动此事件的 NetStream 对象。 | DRMAuthenticateEvent | ||
| passwordPrompt : String [只读]
服务器提供的密码凭据提示。 | DRMAuthenticateEvent | ||
| target : Object [只读]
事件目标。 | Event | |
| type : 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 | ||
[覆盖]
创建 DRMAuthenticateEvent 对象的副本，并将每个属性的值设置为与原始属性值相匹配。 | DRMAuthenticateEvent | ||
|
用于在自定义 ActionScript 3.0 Event 类中实现 toString() 方法的实用程序函数。 | Event | |
|
表示对象是否已经定义了指定的属性。 | Object | |
|
检查是否已对事件调用 preventDefault() 方法。 | Event | |
|
表示 Object 类的实例是否在指定为参数的对象的原型链中。 | Object | |
|
如果可以取消事件的默认行为，则取消该行为。 | Event | |
|
表示指定的属性是否存在、是否可枚举。 | Object | |
|
设置循环操作动态属性的可用性。 | Object | |
|
防止对事件流中当前节点中和所有后续节点中的事件侦听器进行处理。 | Event | |
|
防止对事件流中当前节点的后续节点中的所有事件侦听器进行处理。 | Event | |
|
返回此对象的字符串表示形式，其格式设置遵守区域设置特定的约定。 | Object | |
[覆盖]
返回一个字符串，其中包含 DRMAuthenticateEvent 对象的所有属性。 | DRMAuthenticateEvent | ||
|
返回指定对象的原始值。 | 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 | 属性 |
netstream | 属性 |
passwordPrompt | 属性 |
urlPrompt | 属性 |
usernamePrompt | 属性 |
构造函数详细信息
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)bubbles 属性访问此信息。
| |
cancelable:Boolean (default = false)cancelable 属性访问此信息。
| |
header:String (default = " | |
userPrompt:String (default = " | |
passPrompt:String (default = " | |
urlPrompt:String (default = " | |
authenticationType:String (default = " | |
netstream:NetStream (default = null) |
方法详细信息
clone | () | 方法 |
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) 的身份验证，还是用于针对代理服务器的身体验证。 |
bubbles | false |
cancelable | false；没有要取消的默认行为。 |
header | 服务器提供的加密内容文件标头。 |
netstream | 启动此事件的 NetStream 对象。 |
passwordPrompt | 服务器提供的密码凭据提示。 |
target | NetStream 对象。 |
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) 的身份验证，还是用于针对代理服务器的身体验证。 |
bubbles | false |
cancelable | false；没有要取消的默认行为。 |
header | 服务器提供的加密内容文件标头。 |
netstream | 启动此事件的 NetStream 对象。 |
passwordPrompt | 服务器提供的密码凭据提示。 |
target | NetStream 对象。 |
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) 的身份验证，还是用于针对代理服务器的身体验证。 |
bubbles | false |
cancelable | false 表示没有要取消的默认行为。 |
header | 服务器提供的加密内容文件标头。 |
netstream | 启动此事件的 NetStream 对象。 |
passwordPrompt | 服务器提供的密码凭据提示。 |
target | NetStream 对象。 |
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");
}
}
}
Tue Jun 12 2018, 11:04 AM Z