fl.video
public class VideoPlayer
继承VideoPlayer Inheritance Video Inheritance DisplayObject Inheritance EventDispatcher Inheritance Object

语言版本 : ActionScript 3.0
Player 版本 : Flash Player 9.0.28.0

与使用 FLVPlayback 组件相比,VideoPlayer 类可以让您创建出 SWF 文件稍微小一些的视频播放器。 与 FLVPlayback 组件不同的是,VideoPlayer 类不让您包含外观或回放控件,而且,尽管您无法查找或搜索提示点,但仍会发生 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 的一个子集。

查看示例

另请参见

NCManager
FLVPlayback



公共 属性
 属性定义方
 InheritedaccessibilityProperties : AccessibilityProperties
此显示对象的当前辅助功能选项。
DisplayObject
  align : String
指定如何相对于 registrationX、registrationY、registrationWidth 和 registrationHeight 属性显示视频。
VideoPlayer
 Inheritedalpha : Number
指示指定对象的 Alpha 透明度值。
DisplayObject
  autoRewind : Boolean
一个布尔值,如果为 true,则播放停止时(由于播放器到达流的末端或调用了 stop() 方法),会使 FLV 文件后退到第 1 帧。
VideoPlayer
 InheritedblendMode : String
BlendMode 类中的一个值,用于指定要使用的混合模式。
DisplayObject
  bufferTime : Number
一个数字,指定开始播放视频流前要在内存中缓冲的秒数。
VideoPlayer
  bytesLoaded : uint
[read-only] 一个数字,指示 HTTP 下载的下载程度,以字节数表示。
VideoPlayer
  bytesTotal : uint
[read-only] 一个数字,指定 HTTP 下载的总下载字节数。
VideoPlayer
 InheritedcacheAsBitmap : Boolean
如果设置为 true,则 Flash Player 将缓存显示对象的内部位图表示形式。
DisplayObject
 Inheritedconstructor : Object
对类对象或给定对象实例的构造函数的引用。
Object
 Inheriteddeblocking : int
指示作为后处理的一部分应用于已解码视频的滤镜的类型。
Video
 Inheritedfilters : 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
 InheritedloaderInfo : LoaderInfo
[read-only] 返回一个 LoaderInfo 对象,其中包含加载此显示对象所属的文件的相关信息。
DisplayObject
 Inheritedmask : DisplayObject
调用显示对象被指定的 mask 对象遮罩。
DisplayObject
  metadata : Object
[read-only] 一个对象,它是通过调用 NetSteam.onMetaData() 回调方法(如果有)而接收到的元数据信息包。
VideoPlayer
 InheritedmouseX : Number
[read-only] 指示鼠标位置的 x 坐标,以像素为单位。
DisplayObject
 InheritedmouseY : Number
[read-only] 指示鼠标位置的 y 坐标,以像素为单位。
DisplayObject
 Inheritedname : String
指示 DisplayObject 的实例名称。
DisplayObject
  ncMgr : INCManager
[read-only] 一个 INCManager 对象,它提供对实现 INCManager 的类的实例的访问,而该类是 NCManager 类的接口。
VideoPlayer
  netConnection : NetConnection
[read-only] 允许直接访问由视频播放器创建的 NetConnection 实例。
VideoPlayer
  netStream : NetStream
[read-only] 允许直接访问由视频播放器创建的 NetStream 实例。
VideoPlayer
 InheritedopaqueBackground : Object
指定显示对象是否由于具有某种背景颜色而不透明。
DisplayObject
 Inheritedparent : DisplayObjectContainer
[read-only] 指示包含此显示对象的 DisplayObjectContainer 对象。
DisplayObject
  playheadTime : Number
一个数字,表示当前播放头的时间或位置(以秒为单位计算),可以是小数值。
VideoPlayer
  playheadUpdateInterval : Number
一个数字,表示每个 playheadUpdate 事件之间的时间量,以毫秒为单位。
VideoPlayer
  progressInterval : Number
一个数字,表示每个 progress 事件之间的时间量,以毫秒为单位。
VideoPlayer
 Inheritedprototype : Object
[static] 对类或函数对象的原型对象的引用。
Object
  registrationHeight : Number
高度,用于在自动调整大小时对齐视频内容。
VideoPlayer
  registrationWidth : Number
宽度,用于在自动调整大小时对齐视频内容。
VideoPlayer
  registrationX : Number
x 坐标,用于在自动调整大小时对齐视频内容。
VideoPlayer
  registrationY : Number
y 坐标,用于在自动调整大小时对齐视频内容。
VideoPlayer
 Inheritedroot : DisplayObject
[read-only] 对于加载的 SWF 文件中的显示对象,root 属性是此 SWF 文件所表示的显示列表树结构部分中的顶级显示对象。
DisplayObject
 Inheritedrotation : Number
指示 DisplayObject 实例距其原始方向的旋转程度,以度为单位。
DisplayObject
 Inheritedscale9Grid : Rectangle
当前有效的缩放网格。
DisplayObject
  scaleMode : String
指定在视频加载后如何调整其大小。
VideoPlayer
  scaleX : Number
[write-only] 一个代表水平缩放的数字。
VideoPlayer
  scaleY : Number
[write-only] 一个代表垂直缩放的数字。
VideoPlayer
 InheritedscrollRect : Rectangle
显示对象的滚动矩形范围。
DisplayObject
 Inheritedsmoothing : Boolean
指定在缩放视频时是否应进行平滑处理(插补数据)。
Video
  soundTransform : SoundTransform
提供对 NetStream.soundTransform 属性的直接访问,以提供更多声音控制。
VideoPlayer
  source : String
[read-only] 一个字符串,它指定要进行流式处理的 FLV 文件的 URL 以及如何对其进行流式处理。
VideoPlayer
 Inheritedstage : Stage
[read-only] 显示对象的舞台。
DisplayObject
  state : String
[read-only] 一个字符串,指定组件的状态。
VideoPlayer
  stateResponsive : Boolean
[read-only] 一个布尔值,如果处于响应状态,则为 true。
VideoPlayer
  totalTime : Number
[read-only] 一个数字,表示视频的总播放时间,以秒为单位。
VideoPlayer
 Inheritedtransform : 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(width:int = 320, height:int = 240)
创建一个具有指定宽度和高度的 VideoPlayer 对象。
VideoPlayer
 Inherited
addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
使用 EventDispatcher 对象注册事件侦听器对象,以使侦听器能够接收事件通知。
EventDispatcher
 Inherited
指定在应用程序窗口中 Video 对象的边界内显示来自摄像头的视频流。
Video
 Inherited
指定在应用程序窗口中 Video 对象的边界内显示视频流。
Video
 Inherited
清除该 Video 对象中当前显示的图像。
Video
  
强制关闭视频流和 Flash Media Server 连接。
VideoPlayer
 Inherited
将事件调度到事件流中。
EventDispatcher
 Inherited
getBounds(targetCoordinateSpace:DisplayObject):Rectangle
返回一个矩形,该矩形定义相对于 targetCoordinateSpace 对象坐标系的显示对象区域。
DisplayObject
 Inherited
getRect(targetCoordinateSpace:DisplayObject):Rectangle
返回一个矩形,该矩形根据 targetCoordinateSpace 参数定义的坐标系定义显示对象的边界,但不包括形状上的任何笔触。
DisplayObject
 Inherited
将 point 对象从舞台(全局)坐标转换为显示对象的(本地)坐标。
DisplayObject
 Inherited
检查 EventDispatcher 对象是否为特定事件类型注册了任何侦听器。
EventDispatcher
 Inherited
指示对象是否已经定义了指定的属性。
Object
 Inherited
计算显示对象,以确定它是否与 obj 显示对象重叠或相交。
DisplayObject
 Inherited
hitTestPoint(x:Number, y:Number, shapeFlag:Boolean = false):Boolean
计算显示对象,以确定它是否与 x 和 y 参数指定的点重叠或相交。
DisplayObject
 Inherited
指示 Object 类的实例是否在指定为参数的对象的原型链中。
Object
  
load(url:String, totalTime:Number, isLive:Boolean = false):void
与 play() 方法类似,但使 FLV 文件加载而不播放。
VideoPlayer
 Inherited
将 point 对象从显示对象的(本地)坐标转换为舞台(全局)坐标。
DisplayObject
  
在调用 INCManager.connectToURL() 方法后,连接完成或失败后由 INCManager 调用。
VideoPlayer
  
在调用 INCManager.reconnect() 方法后,重新连接完成或失败后由 INCManager 调用。
VideoPlayer
  
暂停视频回放。
VideoPlayer
  
play(url:String = null, totalTime:Number, isLive:Boolean = false):void
让视频播放。
VideoPlayer
  
当下载到足以播放时播放 FLV 文件。
VideoPlayer
 Inherited
指示指定的属性是否存在、是否可枚举。
Object
 Inherited
removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void
从 EventDispatcher 对象中删除侦听器。
EventDispatcher
  
seek(time:Number):void
在文件中搜索到给定时间,以秒为单位指定,精确到小数点后三位(毫秒)。
VideoPlayer
 Inherited
设置循环操作动态属性的可用性。
Object
  
setScale(scaleX:Number, scaleY:Number):void
同时设置 scaleX 和 scaleY 属性。
VideoPlayer
  
setSize(width:Number, height:Number):void
同时设置 width 和 height 属性。
VideoPlayer
  
停止视频回放。
VideoPlayer
 Inherited
返回指定对象的字符串表示形式。
Object
 Inherited
返回指定对象的原始值。
Object
 Inherited
检查是否用此 EventDispatcher 对象或其任何始祖为指定事件类型注册了事件侦听器。
EventDispatcher
事件
 事件摘要定义方
 Inherited Flash Player 获得操作系统焦点并变为活动状态时调度。EventDispatcher
 Inherited 将显示对象添加到显示列表中时调度。DisplayObject
 Inherited 在将显示对象直接添加到舞台显示列表或将包含显示对象的子树添加至舞台显示列表中时调度。DisplayObject
   由于 autoRewind 属性设置为 true 而将播放头移至视频播放器的开始位置时调度。VideoPlayer
   在以下情况下,VideoPlayer 实例会调度此事件:由于超时或通过调用 close() 方法而关闭 NetConnection,或者您调用了 load() 或 play() 方法或设置了 source 属性,从而导致 RTMP 连接关闭。VideoPlayer
   因为播放器到达 FLV 文件的末尾而完成播放时进行调度。VideoPlayer
   到达提示点时调度。VideoPlayer
 Inherited Flash Player 失去操作系统焦点并变为非活动状态时调度。EventDispatcher
 Inherited 播放头进入新帧时调度。DisplayObject
   在调整视频播放器大小或布置视频播放器时调度。VideoPlayer
   第一次到达 FLV 文件的元数据时调度。VideoPlayer
   在 FLV 文件按 playheadUpdateInterval 属性所指定的频率播放或者开始后退时调度该事件。VideoPlayer
   根据已加载的字节数指示完成的进度。VideoPlayer
   FLV 文件已加载并可以显示时调度此事件。VideoPlayer
 Inherited 将要从显示列表中删除显示对象时调度。DisplayObject
 Inherited 在从显示列表中直接删除显示对象或删除包含显示对象的子树时调度。DisplayObject
 Inherited 将要更新和呈现显示列表时调度。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

指定如何相对于 registrationXregistrationYregistrationWidthregistrationHeight 属性显示视频。 当将 scaleMode 属性设置为 VideoScaleMode.MAINTAIN_ASPECT_RATIOVideoScaleMode.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 文件只包含 heightwidthduration 值。

参数描述
canSeekToEnd一个布尔值,如果 FLV 文件是用最后一帧(它允许定位到渐进式下载影片剪辑的末尾)上的关键帧编码的,则该值为 true。 如果 FLV 文件不是用最后一帧上的关键帧编码的,则该值为 false
cuePoints嵌入在 FLV 文件中的提示点对象组成的数组,每个提示点对应一个对象。 如果 FLV 文件不包含任何提示点,则值是未定义的。 每个对象都具有以下属性:
  • type -- 一个字符串,它将提示点的类型指定为“navigation”或“event”。
  • name -- 一个字符串,表示提示点的名称。
  • time -- 一个数字,表示以秒为单位的提示点的时间,精确到三位小数(毫秒)。
  • parameters -- 一个可选对象,具有用户在创建提示点时指定的名称-值对。
audiocodecid一个数字,指示已使用的音频编解码器(编码/解码技术)。
audiodelay 一个数字,在源文件中表示时间 0,从该时间起对 FLV 文件进行编码。

视频内容延迟很短的一段时间,以便与音频同步。 例如,如果 audiodelay 值为 .038,则在源文件里从时间 0 处开始的视频在 FLV 文件里从时间 .038 处开始。

请注意,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 文件:

经过自动调整大小后,您将得到:

示例 2,使用下列设置加载与示例 1 相同的场景:

您将得到:

示例 3,使用下列设置加载与示例 2 相同的场景:

您将获得与注册值相同的所有值:

设置 registrationHeight 属性等同于设置 height 属性,反之亦然。 设置任何其它属性或调用更改高度的任何方法(例如 scaleXsetSizesetScale)也会使 heightregistrationHeight 保持同步。


实现
    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 文件:

经过自动调整大小后,您将得到:

示例 2,使用下列设置加载与示例 1 相同的场景:

您将得到:

示例 3,使用下列设置加载与示例 2 相同的场景:

您将获得与注册值相同的所有值:

设置 registrationWidth 属性等同于设置 width 属性,反之亦然。 设置任何其它属性或调用更改宽度的任何方法(例如 scaleXsetSizesetScale)也会使 widthregistrationWidth 保持同步。


实现
    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 文件:

经过自动调整大小后,您将得到:

示例 2,使用下列设置加载与示例 1 相同的场景:

您将得到:

示例 3,使用下列设置加载与示例 2 相同的场景:

您将获得与注册值相同的所有值:

如果设置了 xregistrationX 属性,则第二个属性会更改以维持其与第一个属性的偏移量。 例如,如果 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 文件:

经过自动调整大小后,您将得到:

示例 2,使用下列设置加载与示例 1 相同的场景:

您将得到:

示例 3,使用下列设置加载与示例 2 相同的场景:

您将获得与注册值相同的所有值:

如果设置了 yregistrationY 属性,则第二个属性会更改以维持其与第一个属性的偏移量。 例如,如果 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,则将视频高宽比保持在由 registrationXregistrationYregistrationWidthregistrationHeight 所定义的矩形内。 如果设置为 VideoScaleMode.NO_SCALE,则会使视频自动调整为源 FLV 文件尺寸大小。 如果设置为 VideoScaleMode.EXACT_FIT,则忽略源 FLV 文件的尺寸大小,并将视频拉伸到适合 registrationXregistrationYregistrationWidthregistrationHeight 所定义的矩形。 如果在加载 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 事件时开始加载和播放。 在延迟期间可以设置影响加载的 isLiveautoPlaycuePoints 等属性。 它还允许放置在第一帧上的 ActionScript 在 FLVPlayback 组件开始播放前对其产生影响。

如果您通过 ActionScript 设置该属性,则它会在 autoPlay 属性设置为 false 时,立即调用 VideoPlayer.load() 方法。 或者,它会在 autoPlay 属性设置为 true 时调用 VideoPlayer.play() 方法。 autoPlaytotalTimeisLive 属性影响新 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 属性的可能值包括:bufferingconnectionErrordisconnectedloadingpausedplayingrewindingseekingstopped。 您可以使用 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 属性的值。 可响应状态是:stoppedplayingpausedbuffering


实现
    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 属性后,可以在到达 stoppedplaying 状态时读取此属性。 此属性对于来自 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 属性。 如果设置了 xregistrationX 属性,则第二个属性会更改以维持其与第一个属性的偏移量。 例如,如果 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 属性。 如果设置了 yregistrationY 属性,则第二个属性会更改以维持其与第一个属性的偏移量。 例如,如果 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 文件的长度。 传入 0NaN 将自动从元数据、服务器或 XML 中检测长度。 如果在调用 ncConnected 属性时 INCManager.streamLength 属性不是 0null 或未定义,则其值优先于此值。
 
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

同时设置 scaleXscaleY 属性。 单独设置 scaleXscaleY 会触发两次 autolayout 事件,而调用 setScale() 方法将只引发一次 autolayout 事件。

如果 scaleMode 属性为 VideoScaleMode.MAINTAIN_ASPECT_RATIOVideoScaleMode.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

同时设置 widthheight 属性。 单独设置 widthheight 会触发两次 autolayout 事件,而调用 setSize() 方法将只引发一次 autolayout 事件。

如果 scaleMode 属性为 VideoScaleMode.MAINTAIN_ASPECT_RATIOVideoScaleMode.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
VideoEvent.type property = fl.video.VideoEvent.AUTO_REWOUND

语言版本 : ActionScript 3.0
Player 版本 : Flash Player 9.0.28.0

由于 autoRewind 属性设置为 true 而将播放头移至视频播放器的开始位置时调度。

autoRewound 事件为 VideoEvent 类型,并具有常量 VideoEvent.AUTO_REWOUND

定义 autoRewound 事件对象的 type 属性值。

此事件具有以下属性:

属性
bubblesfalse
cancelablefalse;没有要取消的默认行为。
state一个字符串,标识来自 VideoState 类的用于描述组件回放状态的常量。
playheadTime一个数字,表示当前播放头的时间或位置。
vpVideoPlayer 对象的索引。

另请参见

close 事件  
事件对象类型: fl.video.VideoEvent
VideoEvent.type property = 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 属性值。

此事件具有以下属性:

属性
bubblesfalse
cancelablefalse;没有要取消的默认行为。
state一个字符串,标识来自 VideoState 类的用于描述组件回放状态的常量。
playheadTime一个数字,表示当前播放头的时间或位置。
vpVideoPlayer 对象的索引。

另请参见

complete 事件  
事件对象类型: fl.video.VideoEvent
VideoEvent.type property = fl.video.VideoEvent.COMPLETE

语言版本 : ActionScript 3.0
Player 版本 : Flash Player 9.0.28.0

因为播放器到达 FLV 文件的末尾而完成播放时进行调度。 如果您调用 stop()pause() 方法或者单击相应的控件,则组件将不会调度该事件。

当应用程序使用渐进式下载时,将不会显式设置 totalTime 属性,还会下载未在元数据中指定持续时间的 FLV 文件。 视频播放器在调度此事件前将 totalTime 属性设置为近似的总时间值。

视频播放器还会调度 stateChangestopped 事件。

complete 事件为 VideoEvent 类型,并具有常量 VideoEvent.COMPLETE

定义 complete 事件对象的 type 属性值。

此事件具有以下属性:

属性
bubblesfalse
cancelablefalse;没有要取消的默认行为。
state一个字符串,标识来自 VideoState 类的用于描述组件回放状态的常量。
playheadTime一个数字,表示当前播放头的时间或位置。
vpVideoPlayer 对象的索引。

另请参见

cuePoint 事件  
事件对象类型: fl.video.MetadataEvent
MetadataEvent.type property = 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 属性值。

此事件具有以下属性:

属性
bubblesfalse
cancelablefalse;没有要取消的默认行为。
info具有描述提示点的属性的对象。
vpVideoPlayer 对象的索引。

另请参见

layout 事件  
事件对象类型: fl.video.LayoutEvent
LayoutEvent.type property = fl.video.LayoutEvent.LAYOUT

语言版本 : ActionScript 3.0
Player 版本 : Flash Player 9.0.28.0

在调整视频播放器大小或布置视频播放器时调度。 布局有以下两种情况:

layout 事件为 LayoutEvent 类型,并具有常量 LayoutEvent.LAYOUT

定义 layout 事件对象的 type 属性值。

此事件具有以下属性:

属性
bubblesfalse
cancelablefalse;没有要取消的默认行为。
oldBoundslayout 事件发生前,目标的 xywidthheight 属性的值。
oldRegistrationBoundslayout 事件发生前,目标的 registrationXregistrationYregistrationWidthregistrationHeight 属性的值。

另请参见

metadataReceived 事件  
事件对象类型: fl.video.MetadataEvent
MetadataEvent.type property = 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 属性值。

此事件具有以下属性:

属性
bubblesfalse
cancelablefalse;没有要取消的默认行为。
info具有描述 FLV 文件的属性的对象。
vpVideoPlayer 对象的索引。

另请参见

playheadUpdate 事件  
事件对象类型: fl.video.VideoEvent
VideoEvent.type property = fl.video.VideoEvent.PLAYHEAD_UPDATE

语言版本 : ActionScript 3.0
Player 版本 : Flash Player 9.0.28.0

在 FLV 文件按 playheadUpdateInterval 属性所指定的频率播放或者开始后退时调度该事件。 当视频播放器处于暂停或停止状态时,该组件不调度此事件(除非发生搜索)。

playheadUpdate 事件为 VideoEvent 类型,并具有常量 VideoEvent.PLAYHEAD_UPDATE

定义 playheadUpdate 事件对象的 type 属性值。

此事件具有以下属性:

属性
bubblesfalse
cancelablefalse;没有要取消的默认行为。
state一个字符串,标识来自 VideoState 类的用于描述组件回放状态的常量。
playheadTime一个数字,表示当前播放头的时间或位置。
vpVideoPlayer 对象的索引。

另请参见

progress 事件  
事件对象类型: fl.video.VideoProgressEvent
VideoProgressEvent.type property = fl.video.VideoProgressEvent.PROGRESS

语言版本 : ActionScript 3.0
Player 版本 : Flash Player 9.0.28.0

根据已加载的字节数指示完成的进度。 按 progressInterval 属性所指定的频率调度,从加载开始时开始,到所有字节加载结束或者出现网络错误时结束。 默认为每隔 0.25 秒调度一次,从调用 load 时开始,到所有字节加载结束或者出现网络错误时结束。 使用此事件可以检查已加载的字节数或缓冲区中的字节数。

仅针对渐进式 HTTP 下载进行调度。 根据已加载的字节数指示进度。 该事件对象具有 bytesLoadedbytesTotal 属性,它们与具有相同名称的 FLVPlayback 属性相同。

progress 事件为 VideoProgressEvent 类型,并具有常量 VideoProgressEvent.PROGRESS

定义 progress 事件对象的 type 属性值。

此事件具有以下属性:

属性
bubblesfalse
cancelablefalse;没有要取消的默认行为。
bytesLoaded在侦听器处理事件时加载的项数或字节数。
bytesTotal如果加载过程成功,将加载的总项数或总字节数。
vpVideoPlayer 对象的索引。

另请参见

ready 事件  
事件对象类型: fl.video.VideoEvent
VideoEvent.type property = 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 属性值。

此事件具有以下属性:

属性
bubblesfalse
cancelablefalse;没有要取消的默认行为。
state一个字符串,标识来自 VideoState 类的用于描述组件回放状态的常量。
playheadTime一个数字,表示当前播放头的时间或位置。
vpVideoPlayer 对象的索引。

另请参见

stateChange 事件  
事件对象类型: fl.video.VideoEvent
VideoEvent.type property = 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 属性值。

此事件具有以下属性:

属性
bubblesfalse
cancelablefalse;没有要取消的默认行为。
state一个字符串,标识来自 VideoState 类的用于描述组件回放状态的常量。
playheadTime一个数字,表示当前播放头的时间或位置。
vpVideoPlayer 对象的索引。

另请参见

常量详细信息
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。

另请参见

示例 如何使用示例

此示例动态创建两个 VideoPlayer 实例,并为其中一个实例设置了模糊滤镜。

若要运行该示例,请按照下列步骤操作:

  1. 在库中添加 FLVPlayback 组件。
  2. testVideoPath 替换为一 FLV 文件的绝对路径或相对路径。
  3. 将该代码作为 VideoPlayerExample.as 另存到 FLA 文件所在的同一目录中。
  4. 将 FLA 文件中的 Document 类设置为 VideoPlayerExample。
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