包 | fl.video |
类 | public class VideoPlayer |
继承 | VideoPlayer Video DisplayObject EventDispatcher Object |
语言版本 : | ActionScript 3.0 |
Player 版本 : | Flash Player 9.0.28.0 |
cuePoint
事件。 FLVPlayback 类包装 VideoPlayer 类。
由于使用 FLVPlayback 类可以访问 VideoPlayer 类中的所有功能,因此,可以在几乎所有情况下使用 FLVPlayback 类。
此外,FLVPlayback 类自动与 NCManager 类连接,以访问视频服务器(例如 Flash Media Server)上的流式 FLV 文件。 您在设置 contentPath
属性和将某个 URL 传递到 play()
和 load()
方法时,将与 NCManager 类交互。 但是,如果您使用 VideoPlayer 类本身,则必须在 ActionScript 代码中包括以下语句,以确保包括 NCManager 类:
var _forceNCManager:fl.video.NCManager;
NCManager 类实现 INCManager 接口,且可使用实现该接口的自定义类进行替换,以管理网络通信。 如果您进行了上述替换,则还需要包括以下语句,以用提供的类名称替换 NCManager:
fl.video.VideoPlayer.iNCManagerClass = fl.video.NCManager;
如果您在使用默认的 NCManager 类,则不需要添加此语句。
注意:您还可以设置 iNCManagerClass
,以便在使用 FLVPlayback 组件时替换默认的 fl.video.NCManager。
为了为多个带宽处理多个流,NCManager 支持 SMIL 的一个子集。
另请参见
属性 | 定义方 | ||
---|---|---|---|
accessibilityProperties : AccessibilityProperties
此显示对象的当前辅助功能选项。
| DisplayObject | ||
align : String
指定如何相对于 registrationX、registrationY、registrationWidth 和 registrationHeight 属性显示视频。
| VideoPlayer | ||
alpha : Number
指示指定对象的 Alpha 透明度值。
| DisplayObject | ||
autoRewind : Boolean
一个布尔值,如果为 true,则播放停止时(由于播放器到达流的末端或调用了 stop() 方法),会使 FLV 文件后退到第 1 帧。
| VideoPlayer | ||
blendMode : String
BlendMode 类中的一个值,用于指定要使用的混合模式。
| DisplayObject | ||
bufferTime : Number
一个数字,指定开始播放视频流前要在内存中缓冲的秒数。
| VideoPlayer | ||
bytesLoaded : uint
[read-only]
一个数字,指示 HTTP 下载的下载程度,以字节数表示。
| VideoPlayer | ||
bytesTotal : uint
[read-only]
一个数字,指定 HTTP 下载的总下载字节数。
| VideoPlayer | ||
cacheAsBitmap : Boolean
如果设置为 true,则 Flash Player 将缓存显示对象的内部位图表示形式。
| DisplayObject | ||
constructor : Object
对类对象或给定对象实例的构造函数的引用。
| Object | ||
deblocking : int
指示作为后处理的一部分应用于已解码视频的滤镜的类型。
| Video | ||
filters : Array
包含当前与显示对象关联的每个滤镜对象的索引数组。
| DisplayObject | ||
height : Number
[write-only]
一个数字,指定 VideoPlayer 实例的高度,以像素为单位。
| VideoPlayer | ||
idleTimeout : Number
由于播放暂停或停止,Flash 终止与视频服务器(例如 Flash Media Server)之间的空闲连接之前等待的时间(以毫秒为单位)。
| VideoPlayer | ||
iNCManagerClass : Object = fl.video.NCManager [static]
为使所有 VideoPlayer 对象将您的自定义类用作默认的 INCManager 实现,请将 iNCManagerClass 属性设置为您的自定义类的类对象或字符串名称。
| VideoPlayer | ||
isLive : Boolean
[read-only]
一个布尔值,如果是实时视频流,则为 true。
| VideoPlayer | ||
isRTMP : Boolean
[read-only]
一个布尔值,如果正在使用 RTMP 从 Flash Media Server (FMS) 流式加载 FLV 文件,则为 true。
| VideoPlayer | ||
loaderInfo : LoaderInfo
[read-only]
返回一个 LoaderInfo 对象,其中包含加载此显示对象所属的文件的相关信息。
| DisplayObject | ||
mask : DisplayObject
调用显示对象被指定的 mask 对象遮罩。
| DisplayObject | ||
metadata : Object
[read-only]
一个对象,它是通过调用 NetSteam.onMetaData() 回调方法(如果有)而接收到的元数据信息包。
| VideoPlayer | ||
mouseX : Number
[read-only]
指示鼠标位置的 x 坐标,以像素为单位。
| DisplayObject | ||
mouseY : Number
[read-only]
指示鼠标位置的 y 坐标,以像素为单位。
| DisplayObject | ||
name : String
指示 DisplayObject 的实例名称。
| DisplayObject | ||
ncMgr : INCManager
[read-only]
一个 INCManager 对象,它提供对实现 INCManager 的类的实例的访问,而该类是 NCManager 类的接口。
| VideoPlayer | ||
netConnection : NetConnection
[read-only]
允许直接访问由视频播放器创建的 NetConnection 实例。
| VideoPlayer | ||
netStream : NetStream
[read-only]
允许直接访问由视频播放器创建的 NetStream 实例。
| VideoPlayer | ||
opaqueBackground : Object
指定显示对象是否由于具有某种背景颜色而不透明。
| DisplayObject | ||
parent : DisplayObjectContainer
[read-only]
指示包含此显示对象的 DisplayObjectContainer 对象。
| DisplayObject | ||
playheadTime : Number
一个数字,表示当前播放头的时间或位置(以秒为单位计算),可以是小数值。
| VideoPlayer | ||
playheadUpdateInterval : Number
一个数字,表示每个 playheadUpdate 事件之间的时间量,以毫秒为单位。
| VideoPlayer | ||
progressInterval : Number
一个数字,表示每个 progress 事件之间的时间量,以毫秒为单位。
| VideoPlayer | ||
prototype : Object
[static]
对类或函数对象的原型对象的引用。
| Object | ||
registrationHeight : Number
高度,用于在自动调整大小时对齐视频内容。
| VideoPlayer | ||
registrationWidth : Number
宽度,用于在自动调整大小时对齐视频内容。
| VideoPlayer | ||
registrationX : Number
x 坐标,用于在自动调整大小时对齐视频内容。
| VideoPlayer | ||
registrationY : Number
y 坐标,用于在自动调整大小时对齐视频内容。
| VideoPlayer | ||
root : DisplayObject
[read-only]
对于加载的 SWF 文件中的显示对象,root 属性是此 SWF 文件所表示的显示列表树结构部分中的顶级显示对象。
| DisplayObject | ||
rotation : Number
指示 DisplayObject 实例距其原始方向的旋转程度,以度为单位。
| DisplayObject | ||
scale9Grid : Rectangle
当前有效的缩放网格。
| DisplayObject | ||
scaleMode : String
指定在视频加载后如何调整其大小。
| VideoPlayer | ||
scaleX : Number
[write-only]
一个代表水平缩放的数字。
| VideoPlayer | ||
scaleY : Number
[write-only]
一个代表垂直缩放的数字。
| VideoPlayer | ||
scrollRect : Rectangle
显示对象的滚动矩形范围。
| DisplayObject | ||
smoothing : Boolean
指定在缩放视频时是否应进行平滑处理(插补数据)。
| Video | ||
soundTransform : SoundTransform
提供对 NetStream.soundTransform 属性的直接访问,以提供更多声音控制。
| VideoPlayer | ||
source : String
[read-only]
一个字符串,它指定要进行流式处理的 FLV 文件的 URL 以及如何对其进行流式处理。
| VideoPlayer | ||
stage : Stage
[read-only]
显示对象的舞台。
| DisplayObject | ||
state : String
[read-only]
一个字符串,指定组件的状态。
| VideoPlayer | ||
stateResponsive : Boolean
[read-only]
一个布尔值,如果处于响应状态,则为 true。
| VideoPlayer | ||
totalTime : Number
[read-only]
一个数字,表示视频的总播放时间,以秒为单位。
| VideoPlayer | ||
transform : Transform
一个对象,具有与显示对象的矩阵、颜色转换和像素范围有关的属性。
| DisplayObject | ||
videoHeight : int
[read-only]
加载的 FLV 文件的源宽度。
| VideoPlayer | ||
videoWidth : int
[read-only]
加载的 FLV 文件的源宽度。
| VideoPlayer | ||
visible : Boolean
一个布尔值,如果为 true,则 VideoPlayer 实例可见。
| VideoPlayer | ||
volume : Number
一个数字,介于 0 到 1 的范围内,指示音量控制设置。
| VideoPlayer | ||
width : Number
[write-only]
一个数字,指定舞台上 VideoPlayer 实例的宽度。
| VideoPlayer | ||
x : Number
[write-only]
一个数字,指定视频播放器的水平位置,以像素为单位。
| VideoPlayer | ||
y : Number
[write-only]
一个数字,指定视频播放器的垂直位置,以像素为单位。
| VideoPlayer |
方法 | 定义方 | ||
---|---|---|---|
创建一个具有指定宽度和高度的 VideoPlayer 对象。
| VideoPlayer | ||
addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
使用 EventDispatcher 对象注册事件侦听器对象,以使侦听器能够接收事件通知。
| EventDispatcher | ||
指定在应用程序窗口中 Video 对象的边界内显示来自摄像头的视频流。
| Video | ||
指定在应用程序窗口中 Video 对象的边界内显示视频流。
| Video | ||
清除该 Video 对象中当前显示的图像。
| Video | ||
强制关闭视频流和 Flash Media Server 连接。
| VideoPlayer | ||
将事件调度到事件流中。
| EventDispatcher | ||
返回一个矩形,该矩形定义相对于 targetCoordinateSpace 对象坐标系的显示对象区域。
| DisplayObject | ||
返回一个矩形,该矩形根据 targetCoordinateSpace 参数定义的坐标系定义显示对象的边界,但不包括形状上的任何笔触。
| DisplayObject | ||
将 point 对象从舞台(全局)坐标转换为显示对象的(本地)坐标。
| DisplayObject | ||
检查 EventDispatcher 对象是否为特定事件类型注册了任何侦听器。
| EventDispatcher | ||
指示对象是否已经定义了指定的属性。
| Object | ||
计算显示对象,以确定它是否与 obj 显示对象重叠或相交。
| DisplayObject | ||
计算显示对象,以确定它是否与 x 和 y 参数指定的点重叠或相交。
| DisplayObject | ||
指示 Object 类的实例是否在指定为参数的对象的原型链中。
| Object | ||
与 play() 方法类似,但使 FLV 文件加载而不播放。
| VideoPlayer | ||
将 point 对象从显示对象的(本地)坐标转换为舞台(全局)坐标。
| DisplayObject | ||
在调用 INCManager.connectToURL() 方法后,连接完成或失败后由 INCManager 调用。
| VideoPlayer | ||
在调用 INCManager.reconnect() 方法后,重新连接完成或失败后由 INCManager 调用。
| VideoPlayer | ||
暂停视频回放。
| VideoPlayer | ||
让视频播放。
| VideoPlayer | ||
当下载到足以播放时播放 FLV 文件。
| VideoPlayer | ||
指示指定的属性是否存在、是否可枚举。
| Object | ||
从 EventDispatcher 对象中删除侦听器。
| EventDispatcher | ||
在文件中搜索到给定时间,以秒为单位指定,精确到小数点后三位(毫秒)。
| VideoPlayer | ||
设置循环操作动态属性的可用性。
| Object | ||
同时设置 scaleX 和 scaleY 属性。
| VideoPlayer | ||
同时设置 width 和 height 属性。
| VideoPlayer | ||
停止视频回放。
| VideoPlayer | ||
返回指定对象的字符串表示形式。
| Object | ||
返回指定对象的原始值。
| Object | ||
检查是否用此 EventDispatcher 对象或其任何始祖为指定事件类型注册了事件侦听器。
| EventDispatcher |
事件 | 摘要 | 定义方 | ||
---|---|---|---|---|
Flash Player 获得操作系统焦点并变为活动状态时调度。 | EventDispatcher | |||
将显示对象添加到显示列表中时调度。 | DisplayObject | |||
在将显示对象直接添加到舞台显示列表或将包含显示对象的子树添加至舞台显示列表中时调度。 | DisplayObject | |||
由于 autoRewind 属性设置为 true 而将播放头移至视频播放器的开始位置时调度。 | VideoPlayer | |||
在以下情况下,VideoPlayer 实例会调度此事件:由于超时或通过调用 close() 方法而关闭 NetConnection,或者您调用了 load() 或 play() 方法或设置了 source 属性,从而导致 RTMP 连接关闭。 | VideoPlayer | |||
因为播放器到达 FLV 文件的末尾而完成播放时进行调度。 | VideoPlayer | |||
到达提示点时调度。 | VideoPlayer | |||
Flash Player 失去操作系统焦点并变为非活动状态时调度。 | EventDispatcher | |||
播放头进入新帧时调度。 | DisplayObject | |||
在调整视频播放器大小或布置视频播放器时调度。 | VideoPlayer | |||
第一次到达 FLV 文件的元数据时调度。 | VideoPlayer | |||
在 FLV 文件按 playheadUpdateInterval 属性所指定的频率播放或者开始后退时调度该事件。 | VideoPlayer | |||
根据已加载的字节数指示完成的进度。 | VideoPlayer | |||
FLV 文件已加载并可以显示时调度此事件。 | VideoPlayer | |||
将要从显示列表中删除显示对象时调度。 | DisplayObject | |||
在从显示列表中直接删除显示对象或删除包含显示对象的子树时调度。 | DisplayObject | |||
将要更新和呈现显示列表时调度。 | DisplayObject | |||
回放状态发生更改时调度。 | VideoPlayer |
常量 | 定义方 | ||
---|---|---|---|
SHORT_VERSION : String = "2.0" [static]
指示组件短版本号的状态变量。
| VideoPlayer | ||
VERSION : String = "2.0.0.31" [static]
指示组件长版本号的状态变量。
| VideoPlayer |
align | 属性 |
align:String
[read-write]
语言版本 : | ActionScript 3.0 |
Player 版本 : | Flash Player 9.0.28.0 |
指定如何相对于 registrationX
、registrationY
、registrationWidth
和 registrationHeight
属性显示视频。 当将 scaleMode
属性设置为 VideoScaleMode.MAINTAIN_ASPECT_RATIO
或 VideoScaleMode.NO_SCALE
时,align
属性执行该自动布局。 在加载 FLV 文件后更改该属性会使自动布局立即开始。 值来自 VideoAlign 类。
默认值为 VideoAlign.CENTER
.
public function get align():String
public function set align(value:String):void
另请参见
autoRewind | 属性 |
autoRewind:Boolean
[read-write]
语言版本 : | ActionScript 3.0 |
Player 版本 : | Flash Player 9.0.28.0 |
一个布尔值,如果为 true
,则播放停止时(由于播放器到达流的末端或调用了 stop()
方法),会使 FLV 文件后退到第 1 帧。 此属性对于实时流无意义。
默认值为 false
.
public function get autoRewind():Boolean
public function set autoRewind(value:Boolean):void
bufferTime | 属性 |
bufferTime:Number
[read-write]
语言版本 : | ActionScript 3.0 |
Player 版本 : | Flash Player 9.0.28.0 |
一个数字,指定开始播放视频流前要在内存中缓冲的秒数。 对于通过 RTMP 流式处理的 FLV 文件(它们并不下载并且只在内存中缓冲),使该设置的值大于默认值 0.1 十分重要。对于通过 HTTP 渐进式下载的 FLV 文件,增加该值只会带来很小的好处,尽管它可以改善在旧式、速度较慢的计算机上查看高质量视频的效果。
对于预先录制(非实时)的视频,请不要将 bufferTime
属性设置为 0
;应使用默认缓冲时间或增加缓冲时间。
此属性并不指定在开始回放前要下载的 FLV 文件量。
public function get bufferTime():Number
public function set bufferTime(value:Number):void
另请参见
bytesLoaded | 属性 |
bytesLoaded:uint
[read-only]
语言版本 : | ActionScript 3.0 |
Player 版本 : | Flash Player 9.0.28.0 |
一个数字,指示 HTTP 下载的下载程度,以字节数表示。 在没有流时、流来自 Flash Media Server (FMS) 时或者没有可用信息时,返回 0。 返回值只用于 HTTP 下载。
public function get bytesLoaded():uint
bytesTotal | 属性 |
bytesTotal:uint
[read-only]
语言版本 : | ActionScript 3.0 |
Player 版本 : | Flash Player 9.0.28.0 |
一个数字,指定 HTTP 下载的总下载字节数。 在没有流时、流来自 Flash Media Server (FMS) 时或者没有可用信息时,返回 -1。 返回值只用于 HTTP 下载。
public function get bytesTotal():uint
height | 属性 |
height:Number
[write-only]
语言版本 : | ActionScript 3.0 |
Player 版本 : | Flash Player 9.0.28.0 |
一个数字,指定 VideoPlayer 实例的高度,以像素为单位。
注意:请勿将该属性与类似于 fl.video.VideoPlayer.videoHeight
属性的 flash.media.Video.height
属性混淆。
public function set height(value:Number):void
另请参见
idleTimeout | 属性 |
idleTimeout:Number
[read-write]
语言版本 : | ActionScript 3.0 |
Player 版本 : | Flash Player 9.0.28.0 |
由于播放暂停或停止,Flash 终止与视频服务器(例如 Flash Media Server)之间的空闲连接之前等待的时间(以毫秒为单位)。 此属性对通过 HTTP 的 FLV 文件下载没有影响。
如果设置了此属性,则视频流空闲时,会用新值重新开始超时期间。
public function get idleTimeout():Number
public function set idleTimeout(value:Number):void
iNCManagerClass | 属性 |
public static var iNCManagerClass:Object = fl.video.NCManager
语言版本 : | ActionScript 3.0 |
Player 版本 : | Flash Player 9.0.28.0 |
为使所有 VideoPlayer 对象将您的自定义类用作默认的 INCManager 实现,请将 iNCManagerClass
属性设置为您的自定义类的类对象或字符串名称。 FLVPlayback 类包含自定义类的定义,而视频播放器则不包含。
默认值为 "fl.video.NCManager" as a string
.
isLive | 属性 |
isLive:Boolean
[read-only]
语言版本 : | ActionScript 3.0 |
Player 版本 : | Flash Player 9.0.28.0 |
一个布尔值,如果是实时视频流,则为 true
。 只有从视频服务器(例如 Flash Media Server)或其它 Flash 视频流服务进行流式加载时,此属性才有效。 对于 HTTP 下载,会忽略此属性的值。
将预先录制的视频流发送到视频播放器时,将 isLive
属性设置为 false
;发送实时数据(如实时广播)时将该属性设置为 true
。 为提高性能,请在将 isLive
属性设置为 false
时不要将 bufferTime
属性设置为 0
。
public function get isLive():Boolean
另请参见
isRTMP | 属性 |
isRTMP:Boolean
[read-only]
语言版本 : | ActionScript 3.0 |
Player 版本 : | Flash Player 9.0.28.0 |
一个布尔值,如果正在使用 RTMP 从 Flash Media Server (FMS) 流式加载 FLV 文件,则为 true
。 对于任何其它 FLV 文件源,它的值都是 false
。
public function get isRTMP():Boolean
另请参见
metadata | 属性 |
metadata:Object
[read-only]
语言版本 : | ActionScript 3.0 |
Player 版本 : | Flash Player 9.0.28.0 |
一个对象,它是通过调用 NetSteam.onMetaData()
回调方法(如果有)而接收到的元数据信息包。 调度 metadataReceived
事件后准备就绪。
如果 FLV 文件是用 Flash 8 编码器编码的,则 metadata
属性包含以下信息。 早期的 FLV 文件只包含 height
、width
和 duration
值。
参数 | 描述 |
---|---|
canSeekToEnd | 一个布尔值,如果 FLV 文件是用最后一帧(它允许定位到渐进式下载影片剪辑的末尾)上的关键帧编码的,则该值为 true 。 如果 FLV 文件不是用最后一帧上的关键帧编码的,则该值为 false 。 |
cuePoints | 嵌入在 FLV 文件中的提示点对象组成的数组,每个提示点对应一个对象。 如果 FLV 文件不包含任何提示点,则值是未定义的。 每个对象都具有以下属性:
|
audiocodecid | 一个数字,指示已使用的音频编解码器(编码/解码技术)。 |
audiodelay | 一个数字,在源文件中表示时间 0 ,从该时间起对 FLV 文件进行编码。
视频内容延迟很短的一段时间,以便与音频同步。 例如,如果 请注意,FLVPlayback 和 VideoPlayer 类将在其时间设置中补偿该延迟。 这意味着您可以继续使用在源文件中所使用的时间设置。 |
audiodatarate | 一个数字,表示每秒音频的千字节数。 |
videocodecid | 一个数字,表示用于对视频进行编码的编解码器版本。 |
framerate | 一个数字,表示 FLV 文件的帧频。 |
videodatarate | 一个数字,表示 FLV 文件的视频数据速率。 |
height | 一个数字,表示 FLV 文件的高度。 |
width | 一个数字,表示 FLV 文件的宽度。 |
duration | 一个数字,以秒为单位指定 FLV 文件的持续时间。 |
public function get metadata():Object
另请参见
ncMgr | 属性 |
ncMgr:INCManager
[read-only]
语言版本 : | ActionScript 3.0 |
Player 版本 : | Flash Player 9.0.28.0 |
一个 INCManager 对象,它提供对实现 INCManager
的类的实例的访问,而该类是 NCManager 类的接口。
您可以使用此属性来实现需要自定义初始化的自定义 INCManager。
public function get ncMgr():INCManager
另请参见
netConnection | 属性 |
netConnection:NetConnection
[read-only]
语言版本 : | ActionScript 3.0 |
Player 版本 : | Flash Player 9.0.28.0 |
允许直接访问由视频播放器创建的 NetConnection 实例。
public function get netConnection():NetConnection
netStream | 属性 |
netStream:NetStream
[read-only]
语言版本 : | ActionScript 3.0 |
Player 版本 : | Flash Player 9.0.28.0 |
允许直接访问由视频播放器创建的 NetStream 实例。
public function get netStream():NetStream
playheadTime | 属性 |
playheadTime:Number
[read-write]
语言版本 : | ActionScript 3.0 |
Player 版本 : | Flash Player 9.0.28.0 |
一个数字,表示当前播放头的时间或位置(以秒为单位计算),可以是小数值。 设置此属性会触发搜索,并具有搜索的所有限制。
播放头时间发生变化(包括播放 FLV 文件时每隔 0.25 秒更改一次)时,该组件会调度 playheadUpdate
事件。
由于几种原因,在调用一种搜索方法或者设置 playheadTime
以引发搜索后,playheadTime
属性中不太可能立即包含预期值。 首先,对于渐进式下载,由于只能搜索关键帧,因此搜索将转到指定时间后第一个关键帧的时间。 (对于流式下载,搜索总是转到指定的确切时间,即使 FLV 源文件在此处没有关键帧也是如此。) 其次,由于搜索是异步执行的,因此,如果调用 seek 方法或者设置 playheadTime 属性,则 playheadTime
不会立即更新。 若要在搜索完成后获取时间,请侦听 seek
事件,该事件在 playheadTime
属性更新后才会引发。
public function get playheadTime():Number
public function set playheadTime(value:Number):void
另请参见
playheadUpdateInterval | 属性 |
playheadUpdateInterval:Number
[read-write]
语言版本 : | ActionScript 3.0 |
Player 版本 : | Flash Player 9.0.28.0 |
一个数字,表示每个 playheadUpdate
事件之间的时间量,以毫秒为单位。 播放 FLV 文件时设置此属性会重新启动计时器。
因为 ActionScript 提示点在播放头更新时开始,所以,降低 playheadUpdateInterval
属性的值可增加 ActionScript 提示点的精确度。
因为播放头更新间隔是通过调用全局 setInterval()
方法设置的,所以,更新操作无法比 SWF 文件帧频更频繁地触发,这与此方法设置的任何间隔一样。 因此,举例来说,对于每秒 12 帧的默认帧频而言,您可以创建的最低有效间隔大约为 83 毫秒,或者 1 秒(1000 毫秒)的 12 分之 1。
默认值为 250
.
public function get playheadUpdateInterval():Number
public function set playheadUpdateInterval(value:Number):void
另请参见
progressInterval | 属性 |
progressInterval:Number
[read-write]
语言版本 : | ActionScript 3.0 |
Player 版本 : | Flash Player 9.0.28.0 |
一个数字,表示每个 progress
事件之间的时间量,以毫秒为单位。 如果您在播放视频流时设置此属性,则会重新启动记时器。
public function get progressInterval():Number
public function set progressInterval(value:Number):void
registrationHeight | 属性 |
registrationHeight:Number
[read-write]
语言版本 : | ActionScript 3.0 |
Player 版本 : | Flash Player 9.0.28.0 |
高度,用于在自动调整大小时对齐视频内容。 请勿将 registrationHeight
属性与 height
属性混淆。 height
属性反映视频内容的实际宽度。
示例 1,使用下列设置加载一 80x80 FLV 文件:
registrationX
= 100registrationY
= 100registrationWidth
= 60registrationHeight
= 40align
= VideoAlign.CENTER
scaleMode
= VideoScaleMode.NO_SCALE
x
= 90y
= 80width
= 80height
= 80示例 2,使用下列设置加载与示例 1 相同的场景:
scaleMode
= VideoScaleMode.MAINTAIN_ASPECT_RATIO
x
= 110y
= 100width
= 40height
= 80示例 3,使用下列设置加载与示例 2 相同的场景:
scaleMode
= VideoScaleMode.EXACT_FIT
x
= 100y
= 100width
= 60height
= 40设置 registrationHeight
属性等同于设置 height
属性,反之亦然。 设置任何其它属性或调用更改高度的任何方法(例如 scaleX
、setSize
和 setScale
)也会使 height
和 registrationHeight
保持同步。
public function get registrationHeight():Number
public function set registrationHeight(value:Number):void
另请参见
registrationWidth | 属性 |
registrationWidth:Number
[read-write]
语言版本 : | ActionScript 3.0 |
Player 版本 : | Flash Player 9.0.28.0 |
宽度,用于在自动调整大小时对齐视频内容。 请勿将 registrationWidth
属性与 width
属性混淆。 width
属性反映视频内容的实际宽度。
示例 1,使用下列设置加载一 80x80 FLV 文件:
registrationX
= 100registrationY
= 100registrationWidth
= 60registrationHeight
= 40align
= VideoAlign.CENTER
scaleMode
= VideoScaleMode.NO_SCALE
x
= 90y
= 80width
= 80height
= 80示例 2,使用下列设置加载与示例 1 相同的场景:
scaleMode
= VideoScaleMode.MAINTAIN_ASPECT_RATIO
x
= 110y
= 100width
= 40height
= 80示例 3,使用下列设置加载与示例 2 相同的场景:
scaleMode
= VideoScaleMode.EXACT_FIT
x
= 100y
= 100width
= 60height
= 40设置 registrationWidth
属性等同于设置 width
属性,反之亦然。 设置任何其它属性或调用更改宽度的任何方法(例如 scaleX
、setSize
和 setScale
)也会使 width
和 registrationWidth
保持同步。
public function get registrationWidth():Number
public function set registrationWidth(value:Number):void
另请参见
registrationX | 属性 |
registrationX:Number
[read-write]
语言版本 : | ActionScript 3.0 |
Player 版本 : | Flash Player 9.0.28.0 |
x 坐标,用于在自动调整大小时对齐视频内容。 请勿将其与反映视频内容实际位置的 x
属性混淆。
示例 1,使用下列设置加载一 80x80 FLV 文件:
registrationX
= 100registrationY
= 100registrationWidth
= 60registrationHeight
= 40align
= VideoAlign.CENTER
scaleMode
= VideoScaleMode.NO_SCALE
x
= 90y
= 80width
= 80height
= 80示例 2,使用下列设置加载与示例 1 相同的场景:
scaleMode
= VideoScaleMode.MAINTAIN_ASPECT_RATIO
x
= 110y
= 100width
= 40height
= 80示例 3,使用下列设置加载与示例 2 相同的场景:
scaleMode
= VideoScaleMode.EXACT_FIT
x
= 100y
= 100width
= 60height
= 40如果设置了 x
或 registrationX
属性,则第二个属性会更改以维持其与第一个属性的偏移量。 例如,如果 x
= 10 且 registrationX
= 20,则设置 x
= 110 的同时也会设置 registrationX
= 120。
public function get registrationX():Number
public function set registrationX(value:Number):void
另请参见
registrationY | 属性 |
registrationY:Number
[read-write]
语言版本 : | ActionScript 3.0 |
Player 版本 : | Flash Player 9.0.28.0 |
y 坐标,用于在自动调整大小时对齐视频内容。 请勿将其与反映视频内容实际位置的 y
属性混淆。
示例 1,使用下列设置加载一 80x80 FLV 文件:
registrationX
= 100registrationY
= 100registrationWidth
= 60registrationHeight
= 40align
= VideoAlign.CENTER
scaleMode
= VideoScaleMode.NO_SCALE
x
= 90y
= 80width
= 80height
= 80示例 2,使用下列设置加载与示例 1 相同的场景:
scaleMode
= VideoScaleMode.MAINTAIN_ASPECT_RATIO
x
= 110y
= 100width
= 40height
= 80示例 3,使用下列设置加载与示例 2 相同的场景:
scaleMode
= VideoScaleMode.EXACT_FIT
x
= 100y
= 100width
= 60height
= 40如果设置了 y
或 registrationY
属性,则第二个属性会更改以维持其与第一个属性的偏移量。 例如,如果 y
= 10 且 registrationY
= 20,则设置 y
= 110 的同时也会设置 registrationY
= 120。
public function get registrationY():Number
public function set registrationY(value:Number):void
另请参见
scaleMode | 属性 |
scaleMode:String
[read-write]
语言版本 : | ActionScript 3.0 |
Player 版本 : | Flash Player 9.0.28.0 |
指定在视频加载后如何调整其大小。 如果设置为 VideoScaleMode.MAINTAIN_ASPECT_RATIO
,则将视频高宽比保持在由 registrationX
、registrationY
、registrationWidth
和 registrationHeight
所定义的矩形内。 如果设置为 VideoScaleMode.NO_SCALE
,则会使视频自动调整为源 FLV 文件尺寸大小。 如果设置为 VideoScaleMode.EXACT_FIT
,则忽略源 FLV 文件的尺寸大小,并将视频拉伸到适合 registrationX
、registrationY
、registrationWidth
和 registrationHeight
所定义的矩形。 如果在加载 FLV 文件后设置该属性,则立即开始自动布局。 值来自 VideoScaleMode
。
默认值为 VideoScaleMode.MAINTAIN_ASPECT_RATIO
.
public function get scaleMode():String
public function set scaleMode(value:String):void
另请参见
scaleX | 属性 |
scaleX:Number
[write-only]
语言版本 : | ActionScript 3.0 |
Player 版本 : | Flash Player 9.0.28.0 |
一个代表水平缩放的数字。
默认值为 1
.
public function set scaleX(value:Number):void
另请参见
scaleY | 属性 |
scaleY:Number
[write-only]
语言版本 : | ActionScript 3.0 |
Player 版本 : | Flash Player 9.0.28.0 |
一个代表垂直缩放的数字。
默认值为 1
.
public function set scaleY(value:Number):void
另请参见
soundTransform | 属性 |
soundTransform:SoundTransform
[read-write]
语言版本 : | ActionScript 3.0 |
Player 版本 : | Flash Player 9.0.28.0 |
提供对 NetStream.soundTransform
属性的直接访问,以提供更多声音控制。 设置此属性以更改设置;使用此属性的 getter 存取器方法来恢复当前设置。
public function get soundTransform():SoundTransform
public function set soundTransform(value:SoundTransform):void
另请参见
source | 属性 |
source:String
[read-only]
语言版本 : | ActionScript 3.0 |
Player 版本 : | Flash Player 9.0.28.0 |
一个字符串,它指定要进行流式处理的 FLV 文件的 URL 以及如何对其进行流式处理。 URL 可以是指向 FLV 文件的 HTTP URL、指向流的 RTMP URL,也可以是指向 XML 文件的 HTTP URL。
如果您通过组件检查器或属性检查器设置了此属性,则 FLV 文件在发生下一个 enterFrame
事件时开始加载和播放。 在延迟期间可以设置影响加载的 isLive
、autoPlay
和 cuePoints
等属性。 它还允许放置在第一帧上的 ActionScript 在 FLVPlayback 组件开始播放前对其产生影响。
如果您通过 ActionScript 设置该属性,则它会在 autoPlay
属性设置为 false
时,立即调用 VideoPlayer.load()
方法。 或者,它会在 autoPlay
属性设置为 true
时调用 VideoPlayer.play()
方法。 autoPlay
、totalTime
和 isLive
属性影响新 FLV 文件的加载方式,因此,如果您要设置这些属性,则必须在设置 source
属性前设置它们。
通过将 autoPlay
属性设置为 false
,可以防止自动播放新的 FLV 文件。
public function get source():String
另请参见
state | 属性 |
state:String
[read-only]
语言版本 : | ActionScript 3.0 |
Player 版本 : | Flash Player 9.0.28.0 |
一个字符串,指定组件的状态。 该属性通过 load()
、play()
、stop()
、pause()
和 seek()
方法进行设置。
state 属性的可能值包括:buffering
、connectionError
、disconnected
、loading
、paused
、playing
、rewinding
、seeking
和 stopped
。 您可以使用 FLVPlayback 类属性测试这些状态。
public function get state():String
另请参见
stateResponsive | 属性 |
stateResponsive:Boolean
[read-only]
语言版本 : | ActionScript 3.0 |
Player 版本 : | Flash Player 9.0.28.0 |
一个布尔值,如果处于响应状态,则为 true
。 如果状态为不可响应状态,则对 play()
、load()
、stop()
、pause()
和 seek()
方法的调用将被排队,以供以后在状态更改为可响应状态时执行。 因为这些调用被排队并在以后执行,所以,通常不必跟踪 stateResponsive
属性的值。 可响应状态是:stopped
、playing
、paused
和 buffering
。
public function get stateResponsive():Boolean
另请参见
totalTime | 属性 |
totalTime:Number
[read-only]
语言版本 : | ActionScript 3.0 |
Player 版本 : | Flash Player 9.0.28.0 |
一个数字,表示视频的总播放时间,以秒为单位。
在从 Flash Media Server (FMS) 进行流式加载并使用默认的 NCManager
时,服务器端应用程序编程接口 (API) 会自动确定此值,并且该值会覆盖通过此属性设置或从元数据中收集的任何值。 设置 source
属性后,可以在到达 stopped
或 playing
状态时读取此属性。 此属性对于来自 FMS 的实时流无意义。
对于 HTTP 下载,如果 FLV 文件嵌入了元数据,则会自动确定该值;如果未嵌入元数据,则应显式设置该值,否则该值将为 NaN。 如果显式设置该值,则将忽略流中的元数据值。
设置此属性时,该值会影响通过设置 source
加载的下一个 FLV 文件。 但它对已加载的 FLV 文件没有任何影响。 而且,在加载 FLV 文件之后,此属性才会返回传递到其中的新值。
如果从未设置此属性(显式或自动),则回放仍有效,但可能会导致搜索控件出问题。
除非显式设置该值,否则在将其设置为一个来自元数据的有效值之前,该值一直为 NaN。
public function get totalTime():Number
另请参见
videoHeight | 属性 |
videoHeight:int
[read-only]
语言版本 : | ActionScript 3.0 |
Player 版本 : | Flash Player 9.0.28.0 |
加载的 FLV 文件的源宽度。 如果还没有可用的信息,则该属性返回 -1。
public function get videoHeight():int
另请参见
videoWidth | 属性 |
videoWidth:int
[read-only]
语言版本 : | ActionScript 3.0 |
Player 版本 : | Flash Player 9.0.28.0 |
加载的 FLV 文件的源宽度。 如果还没有可用的信息,则该属性返回 -1。
public function get videoWidth():int
另请参见
visible | 属性 |
visible:Boolean
[read-write]
语言版本 : | ActionScript 3.0 |
Player 版本 : | Flash Player 9.0.28.0 |
一个布尔值,如果为 true
,则 VideoPlayer 实例可见。 如果为 false
,则会使实例不可见。
默认值为 true
.
public function get visible():Boolean
public function set visible(value:Boolean):void
volume | 属性 |
volume:Number
[read-write]
语言版本 : | ActionScript 3.0 |
Player 版本 : | Flash Player 9.0.28.0 |
一个数字,介于 0 到 1 的范围内,指示音量控制设置。
默认值为 1
.
public function get volume():Number
public function set volume(value:Number):void
另请参见
width | 属性 |
width:Number
[write-only]
语言版本 : | ActionScript 3.0 |
Player 版本 : | Flash Player 9.0.28.0 |
一个数字,指定舞台上 VideoPlayer 实例的宽度。
注意:flash.media.Video.width
属性与 fl.video.VideoPlayer.videoWidth
属性类似。
public function set width(value:Number):void
另请参见
x | 属性 |
x:Number
[write-only]
语言版本 : | ActionScript 3.0 |
Player 版本 : | Flash Player 9.0.28.0 |
一个数字,指定视频播放器的水平位置,以像素为单位。
设置 x
属性也会影响到 registrationX
属性。 如果设置了 x
或 registrationX
属性,则第二个属性会更改以维持其与第一个属性的偏移量。 例如,如果 x
= 10 且 registrationX
= 20,则设置 x
= 110 的同时也会设置 registrationX
= 120。
public function set x(value:Number):void
另请参见
y | 属性 |
y:Number
[write-only]
语言版本 : | ActionScript 3.0 |
Player 版本 : | Flash Player 9.0.28.0 |
一个数字,指定视频播放器的垂直位置,以像素为单位。
设置 y
属性也会影响到 registrationY
属性。 如果设置了 y
或 registrationY
属性,则第二个属性会更改以维持其与第一个属性的偏移量。 例如,如果 y
= 10 且 registrationY
= 20,则设置 y
= 110 的同时也会设置 registrationY
= 120。
public function set y(value:Number):void
另请参见
VideoPlayer | () | 构造函数 |
public function VideoPlayer(width:int = 320, height:int = 240)
语言版本 : | ActionScript 3.0 |
Player 版本 : | Flash Player 9.0.28.0 |
创建一个具有指定宽度和高度的 VideoPlayer 对象。
参数width:int (default = 320 ) — 视频播放器的宽度,以像素为单位。
|
|
height:int (default = 240 ) — 视频播放器的高度,以像素为单位。
|
另请参见
close | () | 方法 |
public function close():void
语言版本 : | ActionScript 3.0 |
Player 版本 : | Flash Player 9.0.28.0 |
强制关闭视频流和 Flash Media Server 连接。 此方法触发 close
事件。 由于闲置超时功能会关闭流,因此通常无需直接调用该方法。
另请参见
load | () | 方法 |
public function load(url:String, totalTime:Number, isLive:Boolean = false):void
语言版本 : | ActionScript 3.0 |
Player 版本 : | Flash Player 9.0.28.0 |
与 play()
方法类似,但使 FLV 文件加载而不播放。 适当时会自动调整大小,并且显示 FLV 文件的第一帧。 初次加载和自动布局后,状态将为 VideoState.PAUSED
。
该方法使用与 play()
方法相同的参数,但如果没有 URL,则无法调用 load()
方法。 否则,将会引发错误。 如果视频播放器处于不可响应状态,则 load()
方法会将请求排队。
参数
url:String — 一个要加载的 FLV 文件的 URL 字符串。 如果不为 URL 传递任何值,则将引发带有消息 null URL sent to VideoPlayer.load 的错误。
|
|
totalTime:Number — FLV 文件的长度。 传入 0、null 或未定义的值将自动从元数据、服务器或 XML 中检测长度。
|
|
isLive:Boolean (default = false ) — 如果从 Flash Media Server (FMS) 流式加载实时输入信号,则值为 true 。
|
另请参见
ncConnected | () | 方法 |
public function ncConnected():void
语言版本 : | ActionScript 3.0 |
Player 版本 : | Flash Player 9.0.28.0 |
在调用 INCManager.connectToURL()
方法后,连接完成或失败后由 INCManager 调用。 如果连接失败,请在调用之前将 INCManager.netConnection
属性设置为 null
或未定义的值。
另请参见
ncReconnected | () | 方法 |
public function ncReconnected():void
语言版本 : | ActionScript 3.0 |
Player 版本 : | Flash Player 9.0.28.0 |
在调用 INCManager.reconnect()
方法后,重新连接完成或失败后由 INCManager 调用。 如果连接失败,请在调用之前将 INCManager.netconnection
属性设置为 null
。
另请参见
pause | () | 方法 |
public function pause():void
语言版本 : | ActionScript 3.0 |
Player 版本 : | Flash Player 9.0.28.0 |
暂停视频回放。 如果视频已经暂停或停止,则此方法没有任何作用。 若要再次开始回放,请调用 play()
。 不使用任何参数。
如果播放器处于不可响应状态,则 pause()
方法会将请求排队。
如果在没有连接任何流的情况下调用,则将引发异常。 使用 stateChange
事件和 connected
属性可以确定何时调用此方法才是安全的。
如果播放器处于停止状态,则调用 pause()
方法没有任何作用,播放器保持在停止状态。
另请参见
play | () | 方法 |
public function play(url:String = null, totalTime:Number, isLive:Boolean = false):void
语言版本 : | ActionScript 3.0 |
Player 版本 : | Flash Player 9.0.28.0 |
让视频播放。 可以在视频暂停、停止或已经在播放时调用。 调用此方法时不带任何参数将播放已加载的视频,或传入 URL 来加载新的流。
如果播放器处于不可响应状态,则会将请求排队。
如果在未连接任何流的情况下进行不带任何参数的调用,将引发异常。 使用 stateChange
事件和 connected
属性可以确定何时调用此方法才是安全的。
参数
url:String (default = null ) — 如果要加载和播放新的 FLV 文件,则传入 URL 字符串。 如果已经加载了一个 FLV 文件,并想继续播放它,则传入 null 。
|
|
totalTime:Number — 传入 FLV 文件的长度。 传入 0 或 NaN 将自动从元数据、服务器或 XML 中检测长度。 如果在调用 ncConnected 属性时 INCManager.streamLength 属性不是 0 、null 或未定义,则其值优先于此值。
|
|
isLive:Boolean (default = false ) — 如果从 Flash Media Server (FMS) 流式加载实时输入信号,则传入 true 。
|
另请参见
playWhenEnoughDownloaded | () | 方法 |
public function playWhenEnoughDownloaded():void
语言版本 : | ActionScript 3.0 |
Player 版本 : | Flash Player 9.0.28.0 |
当下载到足以播放时播放 FLV 文件。 当 FLV 文件下载完成或从 Flash Media Server (FMS) 进行流式加载时,调用 playWhenEnoughDownloaded()
方法等同于调用不带参数的 play()
方法。 调用该方法不会暂停回放,因此,在大多数情况下,您可能需要在调用该方法前调用 pause()
方法。
seek | () | 方法 |
public function seek(time:Number):void
语言版本 : | ActionScript 3.0 |
Player 版本 : | Flash Player 9.0.28.0 |
在文件中搜索到给定时间,以秒为单位指定,精确到小数点后三位(毫秒)。 如果正在播放视频,则视频将继续从该点播放。 如果视频已暂停,则视频将搜索到该点并保持暂停状态。 如果视频已停止,则视频搜索到该点并进入暂停状态。 使用实时流时,不起任何作用。
在调用一种搜索方法或者设置 playheadTime
以引发搜索后,playheadTime
属性可能不会立即包含预期值。 对于渐进式下载,由于只能搜索关键帧,因此搜索将转到指定时间后第一个关键帧的时间。
注意:对于流式下载,搜索总是转到指定的确切时间,即使 FLV 源文件在此处没有关键帧也是如此。
由于搜索是异步执行的,因此,如果调用 seek 方法或者设置 playheadTime
属性,则 playheadTime
将不会立即更新。 若要在搜索完成后获得这一时间,需要侦听 seek
事件,该事件只在 playheadTime
属性更新后才启动。
如果在没有连接任何流的情况下调用,则将引发异常。 使用 stateChange
事件和 connected
属性可以确定何时调用此方法才是安全的。
参数
time:Number — 一个数字,指定放置播放头的时间,以秒为单位。
|
VideoError — 如果时间 < 0 或者为 NaN 。
|
另请参见
setScale | () | 方法 |
public function setScale(scaleX:Number, scaleY:Number):void
语言版本 : | ActionScript 3.0 |
Player 版本 : | Flash Player 9.0.28.0 |
同时设置 scaleX
和 scaleY
属性。 单独设置 scaleX
或 scaleY
会触发两次 autolayout
事件,而调用 setScale()
方法将只引发一次 autolayout
事件。
如果 scaleMode
属性为 VideoScaleMode.MAINTAIN_ASPECT_RATIO
或 VideoScaleMode.NO_SCALE
,则调用该方法会立即引发 autolayout
事件。
参数
scaleX:Number — 一个代表水平缩放的数字。
|
|
scaleY:Number — 一个代表垂直缩放的数字。
|
另请参见
setSize | () | 方法 |
public function setSize(width:Number, height:Number):void
语言版本 : | ActionScript 3.0 |
Player 版本 : | Flash Player 9.0.28.0 |
同时设置 width
和 height
属性。 单独设置 width
或 height
会触发两次 autolayout
事件,而调用 setSize()
方法将只引发一次 autolayout
事件。
如果 scaleMode
属性为 VideoScaleMode.MAINTAIN_ASPECT_RATIO
或 VideoScaleMode.NO_SCALE
,则调用该方法会立即触发 autolayout
事件。
参数
width:Number — 视频播放器的宽度。
|
|
height:Number — 视频播放器的高度。
|
另请参见
stop | () | 方法 |
public function stop():void
语言版本 : | ActionScript 3.0 |
Player 版本 : | Flash Player 9.0.28.0 |
停止视频回放。 如果 autoRewind
设置为 true
,则后退到第一帧。 如果视频已经停止,则此方法没有任何作用。 若要再次开始回放,请调用 play()
。 不使用任何参数。
如果播放器处于不可响应状态,则会将请求排队。
如果在没有连接任何流的情况下调用,则将引发异常。 使用 stateChange
事件和 connected
属性可以确定何时调用此方法才是安全的。
另请参见
autoRewound | 事件 |
fl.video.VideoEvent
fl.video.VideoEvent.AUTO_REWOUND
语言版本 : | ActionScript 3.0 |
Player 版本 : | Flash Player 9.0.28.0 |
由于 autoRewind
属性设置为 true
而将播放头移至视频播放器的开始位置时调度。
autoRewound
事件为 VideoEvent 类型,并具有常量 VideoEvent.AUTO_REWOUND
。
autoRewound
事件对象的 type
属性值。
此事件具有以下属性:
属性 | 值 |
---|---|
bubbles | false |
cancelable | false ;没有要取消的默认行为。 |
state | 一个字符串,标识来自 VideoState 类的用于描述组件回放状态的常量。 |
playheadTime | 一个数字,表示当前播放头的时间或位置。 |
vp | VideoPlayer 对象的索引。 |
另请参见
close | 事件 |
fl.video.VideoEvent
fl.video.VideoEvent.CLOSE
语言版本 : | ActionScript 3.0 |
Player 版本 : | Flash Player 9.0.28.0 |
在以下情况下,VideoPlayer 实例会调度此事件:由于超时或通过调用 close()
方法而关闭 NetConnection,或者您调用了 load()
或 play()
方法或设置了 source
属性,从而导致 RTMP 连接关闭。 只有从 Flash Media Server (FMS) 或其它 Flash 视频流服务 (FVSS) 进行流式加载时,FLVPlayback 实例才调度此事件。
close
事件为 VideoEvent 类型,并具有常量 VideoEvent.CLOSE
。
close
事件对象的 type
属性值。
此事件具有以下属性:
属性 | 值 |
---|---|
bubbles | false |
cancelable | false ;没有要取消的默认行为。 |
state | 一个字符串,标识来自 VideoState 类的用于描述组件回放状态的常量。 |
playheadTime | 一个数字,表示当前播放头的时间或位置。 |
vp | VideoPlayer 对象的索引。 |
另请参见
complete | 事件 |
fl.video.VideoEvent
fl.video.VideoEvent.COMPLETE
语言版本 : | ActionScript 3.0 |
Player 版本 : | Flash Player 9.0.28.0 |
因为播放器到达 FLV 文件的末尾而完成播放时进行调度。 如果您调用 stop()
或 pause()
方法或者单击相应的控件,则组件将不会调度该事件。
当应用程序使用渐进式下载时,将不会显式设置 totalTime
属性,还会下载未在元数据中指定持续时间的 FLV 文件。 视频播放器在调度此事件前将 totalTime
属性设置为近似的总时间值。
视频播放器还会调度 stateChange
和 stopped
事件。
complete
事件为 VideoEvent 类型,并具有常量 VideoEvent.COMPLETE
。
complete
事件对象的 type
属性值。
此事件具有以下属性:
属性 | 值 |
---|---|
bubbles | false |
cancelable | false ;没有要取消的默认行为。 |
state | 一个字符串,标识来自 VideoState 类的用于描述组件回放状态的常量。 |
playheadTime | 一个数字,表示当前播放头的时间或位置。 |
vp | VideoPlayer 对象的索引。 |
另请参见
cuePoint | 事件 |
fl.video.MetadataEvent
fl.video.MetadataEvent.CUE_POINT
语言版本 : | ActionScript 3.0 |
Player 版本 : | Flash Player 9.0.28.0 |
到达提示点时调度。 事件对象具有一个 info
属性,该属性包含 FLV 文件提示点的 NetStream.onCuePoint
事件回调接收的 info 对象。 对于 ActionScript 提示点,它包含传递到 ActionScript 提示点方法或属性的对象。
cuePoint
事件为 MetadataEvent 类型,并具有常量 MetadataEvent.CUE_POINT
。
cuePoint
事件对象的 type
属性值。
此事件具有以下属性:
属性 | 值 |
---|---|
bubbles | false |
cancelable | false ;没有要取消的默认行为。 |
info | 具有描述提示点的属性的对象。 |
vp | VideoPlayer 对象的索引。 |
另请参见
layout | 事件 |
fl.video.LayoutEvent
fl.video.LayoutEvent.LAYOUT
语言版本 : | ActionScript 3.0 |
Player 版本 : | Flash Player 9.0.28.0 |
在调整视频播放器大小或布置视频播放器时调度。 布局有以下两种情况:
autoLayout
事件、调用 setScale()
或 setSize()
方法或更改 width
、height
、scaleX
和 scaleY
属性布置视频播放器。visibleVideoPlayerIndex
属性从一个视频播放器切换到另一个视频播放器。layout
事件为 LayoutEvent 类型,并具有常量 LayoutEvent.LAYOUT
。
layout
事件对象的 type
属性值。
此事件具有以下属性:
属性 | 值 |
---|---|
bubbles | false |
cancelable | false ;没有要取消的默认行为。 |
oldBounds | layout 事件发生前,目标的 x 、y 、width 和 height 属性的值。 |
oldRegistrationBounds | layout 事件发生前,目标的 registrationX 、registrationY 、registrationWidth 和 registrationHeight 属性的值。 |
另请参见
metadataReceived | 事件 |
fl.video.MetadataEvent
fl.video.MetadataEvent.METADATA_RECEIVED
语言版本 : | ActionScript 3.0 |
Player 版本 : | Flash Player 9.0.28.0 |
第一次到达 FLV 文件的元数据时调度。 事件对象具有一个 info
属性,该属性包含 NetStream.onMetaData
事件回调接收的 info 对象。
metadataReceived
事件为 MetadataEvent 类型,并具有常量 MetadataEvent.METADATA_RECEIVED
。
metadataReceived
事件对象的 type
属性值。
此事件具有以下属性:
属性 | 值 |
---|---|
bubbles | false |
cancelable | false ;没有要取消的默认行为。 |
info | 具有描述 FLV 文件的属性的对象。 |
vp | VideoPlayer 对象的索引。 |
另请参见
playheadUpdate | 事件 |
fl.video.VideoEvent
fl.video.VideoEvent.PLAYHEAD_UPDATE
语言版本 : | ActionScript 3.0 |
Player 版本 : | Flash Player 9.0.28.0 |
在 FLV 文件按 playheadUpdateInterval
属性所指定的频率播放或者开始后退时调度该事件。 当视频播放器处于暂停或停止状态时,该组件不调度此事件(除非发生搜索)。
playheadUpdate
事件为 VideoEvent 类型,并具有常量 VideoEvent.PLAYHEAD_UPDATE
。
playheadUpdate
事件对象的 type
属性值。
此事件具有以下属性:
属性 | 值 |
---|---|
bubbles | false |
cancelable | false ;没有要取消的默认行为。 |
state | 一个字符串,标识来自 VideoState 类的用于描述组件回放状态的常量。 |
playheadTime | 一个数字,表示当前播放头的时间或位置。 |
vp | VideoPlayer 对象的索引。 |
另请参见
progress | 事件 |
fl.video.VideoProgressEvent
fl.video.VideoProgressEvent.PROGRESS
语言版本 : | ActionScript 3.0 |
Player 版本 : | Flash Player 9.0.28.0 |
根据已加载的字节数指示完成的进度。 按 progressInterval
属性所指定的频率调度,从加载开始时开始,到所有字节加载结束或者出现网络错误时结束。 默认为每隔 0.25 秒调度一次,从调用 load 时开始,到所有字节加载结束或者出现网络错误时结束。 使用此事件可以检查已加载的字节数或缓冲区中的字节数。
仅针对渐进式 HTTP 下载进行调度。 根据已加载的字节数指示进度。 该事件对象具有 bytesLoaded
和 bytesTotal
属性,它们与具有相同名称的 FLVPlayback 属性相同。
progress
事件为 VideoProgressEvent 类型,并具有常量 VideoProgressEvent.PROGRESS
。
progress
事件对象的 type
属性值。
此事件具有以下属性:
属性 | 值 |
---|---|
bubbles | false |
cancelable | false ;没有要取消的默认行为。 |
bytesLoaded | 在侦听器处理事件时加载的项数或字节数。 |
bytesTotal | 如果加载过程成功,将加载的总项数或总字节数。 |
vp | VideoPlayer 对象的索引。 |
另请参见
ready | 事件 |
fl.video.VideoEvent
fl.video.VideoEvent.READY
语言版本 : | ActionScript 3.0 |
Player 版本 : | Flash Player 9.0.28.0 |
FLV 文件已加载并可以显示时调度此事件。 在您使用 play()
或 load()
方法加载新的 FLV 文件后首次进入可响应状态时,该事件发生。 它只为加载的每个 FLV 文件发生一次。
ready
事件为 VideoEvent 类型,并具有常量 VideoEvent.READY
。
ready
事件对象的 type
属性值。
此事件具有以下属性:
属性 | 值 |
---|---|
bubbles | false |
cancelable | false ;没有要取消的默认行为。 |
state | 一个字符串,标识来自 VideoState 类的用于描述组件回放状态的常量。 |
playheadTime | 一个数字,表示当前播放头的时间或位置。 |
vp | VideoPlayer 对象的索引。 |
另请参见
stateChange | 事件 |
fl.video.VideoEvent
fl.video.VideoEvent.STATE_CHANGE
语言版本 : | ActionScript 3.0 |
Player 版本 : | Flash Player 9.0.28.0 |
回放状态发生更改时调度。 当 autoRewind
调用完成时,将在后退状态下调度 stateChange
事件。 stateChange
事件在后退完成前不会启动。
此事件可用于跟踪回放何时进入或离开不可响应状态(例如在连接、调整大小或后退过程中)。 当播放器进入可响应状态时,play()
、pause()
、stop()
和 seek()
方法会将要执行的请求排队。
stateChange
事件为 VideoEvent 类型,并具有常量 VideoEvent.STATE_CHANGE
。
stateChange
事件对象的 type
属性值。
此事件具有以下属性:
属性 | 值 |
---|---|
bubbles | false |
cancelable | false ;没有要取消的默认行为。 |
state | 一个字符串,标识来自 VideoState 类的用于描述组件回放状态的常量。 |
playheadTime | 一个数字,表示当前播放头的时间或位置。 |
vp | VideoPlayer 对象的索引。 |
另请参见
SHORT_VERSION | 常量 |
public static const SHORT_VERSION:String = "2.0"
语言版本 : | ActionScript 3.0 |
Player 版本 : | Flash Player 9.0.28.0 |
指示组件短版本号的状态变量。 版本号在您有 FLA 文件并且需要知道组件版本时很有用。 要确定组件版本,请在 FLA 文件中键入下列 trace 代码:
FLVPlayback.SHORT_VERSION
SHORT_VERSION
变量仅包含主版本号和次版本号,例如:2.0。VERSION
变量包含主版本号和次版本号,以及修订版本号和生成版本号,例如:2.0.0.11。
另请参见
VERSION | 常量 |
public static const VERSION:String = "2.0.0.31"
语言版本 : | ActionScript 3.0 |
Player 版本 : | Flash Player 9.0.28.0 |
指示组件长版本号的状态变量。 版本号在您有 FLA 文件并且需要知道组件版本时很有用。 要确定组件版本,请在 FLA 文件中键入下列 trace 代码:
FLVPlayback.VERSION
VERSION
变量包含主版本号和次版本号,以及修订版本号和生成版本号,例如:2.0.0.11。SHORT_VERSION
变量仅包含主版本号和次版本号,例如:2.0。
另请参见
若要运行该示例,请按照下列步骤操作:
testVideoPath
替换为一 FLV 文件的绝对路径或相对路径。package { import fl.video.VideoPlayer; import flash.display.Sprite; import flash.filters.BlurFilter; public class VideoPlayerExample extends Sprite { private var videoPath:String = "http://www.helpexamples.com/flash/video/sheep.flv" private var player:VideoPlayer; private var blurryPlayer:VideoPlayer; public function VideoPlayerExample() { player = new VideoPlayer(); player.play(videoPath); player.setScale(0.75, 0.75); addChild(player); blurryPlayer = new VideoPlayer(); blurryPlayer.play(videoPath); blurryPlayer.setScale(0.75,0.75); blurryPlayer.filters = [ new BlurFilter(8, 8, 1) ]; blurryPlayer.x = 250; addChild(blurryPlayer); } } }
当前页: http://livedocs.adobe.com/flash/9.0_cn/ActionScriptLangRefV3/fl/video/VideoPlayer.html