DRMTrait

包	org.osmf.traits
类	public class DRMTrait
继承	DRMTrait MediaTraitBase EventDispatcher Object

语言版本:

ActionScript 3.0

产品版本:

OSMF 1.0

运行时版本:

Flash Player 10.1, AIR 1.5

DRMTrait 定义受数字权限管理 (DRM) 技术保护的媒体的特征界面。它还可以用作更具体的 DRMTrait 子类的基类。

支持匿名身份验证和基于凭据的身份验证。

具有 DRMTrait 的媒体的工作流程是媒体进行某种类型的身份验证，然后在特定的时间范围内有效（即可以播放）。

使用 MediaElement.hasTrait(MediaTraitType.DRM) 方法查询媒体元素是否具有此特征。如果 hasTrait(MediaTraitType.DRM) 返回 true，则使用 MediaElement.getTrait(MediaTraitType.DRM) 方法获取一个此类型的对象。

公共属性

隐藏继承的公共属性

显示继承的公共属性

	属性		由以下参数定义
		constructor : Object 对类对象或给定对象实例的构造函数的引用。	Object
		drmState : String [只读] 此媒体的 DRM 的当前状态。	DRMTrait
		endDate : Date [只读] 播放窗口的结束日期。	DRMTrait
		period : Number [只读] 播放窗口的长度（以秒为单位）。	DRMTrait
		startDate : Date [只读] 播放窗口的开始日期。	DRMTrait
		traitType : String [只读] 此特征的 MediaTraitType。	MediaTraitBase

公共方法

隐藏继承的公共方法

显示继承的公共方法

	方法		由以下参数定义
		DRMTrait() 构造函数。	DRMTrait
		addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void 使用 EventDispatcher 对象注册事件侦听器对象，以使侦听器能够接收事件通知。	EventDispatcher
		authenticate(username:String = null, password:String = null):void 认证媒体。	DRMTrait
		authenticateWithToken(token:Object):void 使用用作标记的对象认证媒体。	DRMTrait
		dispatchEvent(event:Event):Boolean 将事件调度到事件流中。	EventDispatcher
		dispose():void 处理此特征使用的任何资源。	MediaTraitBase
		hasEventListener(type:String):Boolean 检查 EventDispatcher 对象是否为特定事件类型注册了任何侦听器。	EventDispatcher
		hasOwnProperty(name:String):Boolean 表示对象是否已经定义了指定的属性。	Object
		isPrototypeOf(theClass:Object):Boolean 表示 Object 类的实例是否在指定为参数的对象的原型链中。	Object
		propertyIsEnumerable(name:String):Boolean 表示指定的属性是否存在、是否可枚举。	Object
		removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void 从 EventDispatcher 对象中删除侦听器。	EventDispatcher
		setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void 设置循环操作动态属性的可用性。	Object
		toLocaleString():String 返回此对象的字符串表示形式，其格式设置遵守区域设置特定的约定。	Object
		toString():String 返回指定对象的字符串表示形式。	Object
		valueOf():Object 返回指定对象的原始值。	Object
		willTrigger(type:String):Boolean 检查是否用此 EventDispatcher 对象或其任何祖代为指定事件类型注册了事件侦听器。	EventDispatcher

受保护的方法

	方法		由以下参数定义
		setDrmState(value:String):void 更新 DRM 状态。	DRMTrait
		setEndDate(value:Date):void 更新结束日期。	DRMTrait
		setPeriod(value:Number):void 更新时间段。	DRMTrait
		setStartDate(value:Date):void 更新开始日期。	DRMTrait

事件

单击此处了解有关事件的更多信息

隐藏继承的事件

显示继承的事件

	摘要	由以下参数定义
activate	[广播事件] Flash Player 或 AIR 应用程序获得操作系统焦点并变为活动状态时将调度此事件。	EventDispatcher
deactivate	[广播事件] Flash Player 或 AIR 应用程序失去操作系统焦点并变为非活动状态时将调度此事件。	EventDispatcher
drmStateChange	在需要匿名或基于凭据的身份验证才能播放媒体时调度。	DRMTrait

属性详细信息

drmState

属性

drmState:String [只读]

语言版本:

ActionScript 3.0

产品版本:

OSMF 1.0

运行时版本:

Flash Player 10.1, AIR 1.5

此媒体的 DRM 的当前状态。DRMState 枚举中对这些状态进行了说明。

实现
public function get drmState():String

endDate

属性

endDate:Date [只读]

语言版本:

ActionScript 3.0

产品版本:

OSMF 1.0

运行时版本:

Flash Player 10.1, AIR 1.5

播放窗口的结束日期。如果尚未进行身份验证，则返回 null。

实现
public function get endDate():Date

period

属性

period:Number [只读]

语言版本:

ActionScript 3.0

产品版本:

OSMF 1.0

运行时版本:

Flash Player 10.1, AIR 1.5

播放窗口的长度（以秒为单位）。如果身份验证还没有进行，则返回 NaN。

请注意，此属性通常是 startDate 和 endDate 之间的差值，但是作为属性提供，因为持续时间预先可能知道，但是开始日期和结束日期预先可能不知道（例如，为期一周的租赁）。

实现
public function get period():Number

startDate

属性

startDate:Date [只读]

语言版本:

ActionScript 3.0

产品版本:

OSMF 1.0

运行时版本:

Flash Player 10.1, AIR 1.5

播放窗口的开始日期。如果尚未进行身份验证，则返回 null。

实现
public function get startDate():Date

构造函数详细信息

()

构造函数

public function DRMTrait()

语言版本:

ActionScript 3.0

产品版本:

OSMF 1.0

运行时版本:

Flash Player 10.1, AIR 1.5

构造函数。

方法详细信息

authenticate

()

方法

public function authenticate(username:String = null, password:String = null):void

语言版本:

ActionScript 3.0

产品版本:

OSMF 1.0

运行时版本:

Flash Player 10.1, AIR 1.5

认证媒体。可以用于匿名或基于凭据的身份验证。如果媒体已被认证，则为无操作。

参数

	`username:String` (default = `null`) — 用户名。对于匿名身份验证，应为 null。

	`password:String` (default = `null`) — 密码。对于匿名身份验证，应为 null。

引发

IllegalOperationError — 如果媒体尚未初始化。

authenticateWithToken

()

方法

public function authenticateWithToken(token:Object):void

语言版本:

ActionScript 3.0

产品版本:

OSMF 1.0

运行时版本:

Flash Player 10.1, AIR 1.5

使用用作标记的对象认证媒体。可以用于匿名或基于凭据的身份验证。如果媒体已被认证，则为无操作。

参数

token:Object — 用于身份验证的标记。

setDrmState

()

方法

protected final function setDrmState(value:String):void

语言版本:

ActionScript 3.0

产品版本:

OSMF 1.0

运行时版本:

Flash Player 10.1, AIR 1.5

更新 DRM 状态。

请注意，此方法不会调度 drmStateChange 事件。

参数

value:String — drmState 的新值。

setEndDate

()

方法

protected final function setEndDate(value:Date):void

语言版本:

ActionScript 3.0

产品版本:

OSMF 1.0

运行时版本:

Flash Player 10.1, AIR 1.5

更新结束日期。

参数

value:Date — endDate 的新值。

setPeriod

()

方法

protected final function setPeriod(value:Number):void

语言版本:

ActionScript 3.0

产品版本:

OSMF 1.0

运行时版本:

Flash Player 10.1, AIR 1.5

更新时间段。

参数

value:Number — 时间段的新值。

setStartDate

()

方法

protected final function setStartDate(value:Date):void

语言版本:

ActionScript 3.0

产品版本:

OSMF 1.0

运行时版本:

Flash Player 10.1, AIR 1.5

更新开始日期。

参数

value:Date — startDate 的新值。

事件详细信息

drmStateChange

事件

事件对象类型: org.osmf.events.DRMEvent
属性 DRMEvent.type = org.osmf.events.DRMEvent.DRM_STATE_CHANGE

语言版本:

ActionScript 3.0

产品版本:

OSMF 1.0

运行时版本:

Flash Player 10.1, AIR 1.5

在需要匿名或基于凭据的身份验证才能播放媒体时调度。

DRMEvent.DRM_STATE_CHANGE 常量为对 DRMTrait 的 drmState 的更改定义事件对象的 type 属性的值。

法律声明 | 在线隐私策略

DRMTrait - AS3 OSMF

类 x

drmState

endDate

period

startDate

DRMTrait

authenticate

authenticateWithToken

setDrmState

setEndDate

setPeriod

setStartDate

drmStateChange