PlayTrait

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

语言版本:

ActionScript 3.0

产品版本:

OSMF 1.0

运行时版本:

Flash Player 10, AIR 1.5

PlayTrait 定义可开始和停止播放的媒体的特征界面。还可以用作特定的 PlayTrait 子类的基类。

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

相关 API 元素

org.osmf.media.MediaElement

公共属性

隐藏继承的公共属性

显示继承的公共属性

	属性		由以下参数定义
		canPause : Boolean [只读] 指示是否可以暂停媒体。	PlayTrait
		constructor : Object 对类对象或给定对象实例的构造函数的引用。	Object
		playState : String [只读] PlayState 类型的当前播放状态。	PlayTrait
		traitType : String [只读] 此特征的 MediaTraitType。	MediaTraitBase

公共方法

隐藏继承的公共方法

显示继承的公共方法

	方法		由以下参数定义
		PlayTrait() 构造函数。	PlayTrait
		addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void 使用 EventDispatcher 对象注册事件侦听器对象，以使侦听器能够接收事件通知。	EventDispatcher
		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
		pause():void 暂停媒体（如果尚未暂停）。	PlayTrait
		play():void 播放媒体（如果尚未播放）。	PlayTrait
		propertyIsEnumerable(name:String):Boolean 表示指定的属性是否存在、是否可枚举。	Object
		removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void 从 EventDispatcher 对象中删除侦听器。	EventDispatcher
		setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void 设置循环操作动态属性的可用性。	Object
		stop():void 停止媒体（如果尚未停止）。	PlayTrait
		toLocaleString():String 返回此对象的字符串表示形式，其格式设置遵守区域设置特定的约定。	Object
		toString():String 返回指定对象的字符串表示形式。	Object
		valueOf():Object 返回指定对象的原始值。	Object
		willTrigger(type:String):Boolean 检查是否用此 EventDispatcher 对象或其任何祖代为指定事件类型注册了事件侦听器。	EventDispatcher

受保护的方法

	方法		由以下参数定义
		playStateChangeEnd():void 在 playState 属性值更改后立即调用。	PlayTrait
		playStateChangeStart(newPlayState:String):void 在 playState 属性值更改的前一刻调用。	PlayTrait
		setCanPause(value:Boolean):void 设置此 PlayTrait 的 canPause 属性。	PlayTrait

事件

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

隐藏继承的事件

显示继承的事件

	摘要	由以下参数定义
activate	[广播事件] Flash Player 或 AIR 应用程序获得操作系统焦点并变为活动状态时将调度此事件。	EventDispatcher
canPauseChange	在 canPause 属性发生变化时调度。	PlayTrait
deactivate	[广播事件] Flash Player 或 AIR 应用程序失去操作系统焦点并变为非活动状态时将调度此事件。	EventDispatcher
liveResume	在实时停顿后恢复播放时调度	PlayTrait
liveStall	当播放用完实时流的内容而流还未完成时调度。	PlayTrait
playStateChange	在 PlayTrait 的 playState 更改时调度。	PlayTrait

属性详细信息

canPause

属性

canPause:Boolean [只读]

语言版本:

ActionScript 3.0

产品版本:

OSMF 1.0

运行时版本:

Flash Player 10, AIR 1.5

指示是否可以暂停媒体。如果设置为 false，则不支持 pause() 方法。

实现
public function get canPause():Boolean

playState

属性

playState:String [只读]

语言版本:

ActionScript 3.0

产品版本:

OSMF 1.0

运行时版本:

Flash Player 10, AIR 1.5

PlayState 类型的当前播放状态。

实现
public function get playState():String

构造函数详细信息

()

构造函数

public function PlayTrait()

构造函数。

方法详细信息

pause

()

方法

public final function pause():void

语言版本:

ActionScript 3.0

产品版本:

OSMF 1.0

运行时版本:

Flash Player 10, AIR 1.5

暂停媒体（如果尚未暂停）。

引发

IllegalOperationError — 如果 canPause 返回 false。

play

()

方法

public final function play():void

语言版本:

ActionScript 3.0

产品版本:

OSMF 1.0

运行时版本:

Flash Player 10, AIR 1.5

播放媒体（如果尚未播放）。

playStateChangeEnd

()

方法

protected function playStateChangeEnd():void

语言版本:

ActionScript 3.0

产品版本:

OSMF 1.0

运行时版本:

Flash Player 10, AIR 1.5

在 playState 属性值更改后立即调用。调度 change 事件。

进行覆盖的子类应调用此方法以调度相关的 PlayEvent。

playStateChangeStart

()

方法

protected function playStateChangeStart(newPlayState:String):void

语言版本:

ActionScript 3.0

产品版本:

OSMF 1.0

运行时版本:

Flash Player 10, AIR 1.5

在 playState 属性值更改的前一刻调用。

子类可以覆盖此方法以将更改传送到媒体。

参数

newPlayState:String

setCanPause

()

方法

protected final function setCanPause(value:Boolean):void

语言版本:

ActionScript 3.0

产品版本:

OSMF 1.0

运行时版本:

Flash Player 10, AIR 1.5

设置此 PlayTrait 的 canPause 属性。

参数

value:Boolean

stop

()

方法

public final function stop():void

语言版本:

ActionScript 3.0

产品版本:

OSMF 1.0

运行时版本:

Flash Player 10, AIR 1.5

停止媒体（如果尚未停止）。

停止媒体后，对 play 的任何后续调用都应从开头开始（尽管这取决于实际实现）。

事件详细信息

canPauseChange

事件

事件对象类型: org.osmf.events.PlayEvent
属性 PlayEvent.type = org.osmf.events.PlayEvent.CAN_PAUSE_CHANGE

语言版本:

ActionScript 3.0

产品版本:

OSMF 1.0

运行时版本:

Flash Player 10, AIR 1.5

在 canPause 属性发生变化时调度。

PlayEvent.CAN_PAUSE_CHANGE 常量为 canPauseChange 事件定义事件对象的 type 属性的值。

liveResume

事件

事件对象类型: org.osmf.events.PlayEvent
属性 PlayEvent.type = org.osmf.events.PlayEvent.LIVE_RESUME

语言版本:

ActionScript 3.0

产品版本:

OSMF 2.0

运行时版本:

Flash Player 10, AIR 1.5

在实时停顿后恢复播放时调度

PlayEvent.LIVE_RESUME 常量为 liveResume 事件的事件对象定义 type 属性的值。

在实时停顿后恢复播放时调度

liveStall

事件

事件对象类型: org.osmf.events.PlayEvent
属性 PlayEvent.type = org.osmf.events.PlayEvent.LIVE_STALL

语言版本:

ActionScript 3.0

产品版本:

OSMF 2.0

运行时版本:

Flash Player 10, AIR 1.5

当播放用完实时流的内容而流还未完成时调度。

PlayEvent.LIVE_STALL 常量为 liveStall 事件的事件对象定义 type 属性的值。

当播放用完实时流的内容而流还未完成时调度。

playStateChange

事件

事件对象类型: org.osmf.events.PlayEvent
属性 PlayEvent.type = org.osmf.events.PlayEvent.PLAY_STATE_CHANGE

语言版本:

ActionScript 3.0

产品版本:

OSMF 1.0

运行时版本:

Flash Player 10, AIR 1.5

在 PlayTrait 的 playState 更改时调度。

PlayEvent.PLAY_STATE_CHANGE 常量为 playStateChange 事件定义事件对象的 type 属性的值。

法律声明 | 在线隐私策略

PlayTrait - AS3 OSMF

类 x

canPause

playState

PlayTrait

pause

play

playStateChangeEnd

playStateChangeStart

setCanPause

stop

canPauseChange

liveResume

liveStall

playStateChange