VideoPlayer  - AS3 Flash

指定如何相对于 registrationX、registrationY、registrationWidth 和 registrationHeight 属性显示视频。 当将 scaleMode 属性设置为 VideoScaleMode.MAINTAIN_ASPECT_RATIO 或 VideoScaleMode.NO_SCALE 时，align 属性执行该自动布局。 在加载 FLV 文件后更改该属性会使自动布局立即开始。 值来自 VideoAlign 类。

默认值为 VideoAlign.CENTER。

相关 API 元素

一个布尔值，如果为 true，则播放停止时（由于播放器到达流的末端或调用了 stop() 方法），会使 FLV 文件后退到第 1 帧。 此属性对于实时流无意义。

默认值为 false。

一个数字，指定开始播放视频流前要在内存中缓冲的秒数。 对于通过 RTMP 流式处理的 FLV 文件（它们并不下载并且只在内存中缓冲），使该设置的值大于默认值 0.1 十分重要。对于通过 HTTP 渐进式下载的 FLV 文件，增加该值只会带来很小的好处，尽管它可以改善在旧式、速度较慢的计算机上查看高质量视频的效果。

对于预先录制（非实时）的视频，请不要将 bufferTime 属性设置为 0；应使用默认缓冲时间或增加缓冲时间。

此属性并不指定在开始播放前要下载的 FLV 文件量。

相关 API 元素

一个数字，指示 HTTP 下载的下载程度，以字节数表示。 在没有流时、流来自 Flash Media Server (FMS) 时或者没有可用信息时，返回 0。 返回值只用于 HTTP 下载。

一个数字，指定 HTTP 下载的总下载字节数。 在没有流时、流来自 Flash Media Server (FMS) 时或者没有可用信息时，返回 -1。 返回值只用于 HTTP 下载。

一个数字，指定 VideoPlayer 实例的高度，以像素为单位。

注意：请勿将该属性与类似于 fl.video.VideoPlayer.videoHeight 属性的 flash.media.Video.height 属性混淆。

相关 API 元素

由于播放暂停或停止，Flash 终止与视频服务器（例如 Flash Media Server）之间的空闲连接之前等待的时间（以毫秒为单位）。此属性对通过 HTTP 的 FLV 文件下载没有影响。

如果设置了此属性，则视频流空闲时，会用新值重新开始超时期间。

为使所有 VideoPlayer 对象将您的自定义类用作默认的 INCManager 实现，请将 iNCManagerClass 属性设置为您的自定义类的类对象或字符串名称。 FLVPlayback 类包含自定义类的定义，而视频播放器则不包含。

默认值为“fl.video.NCManager”字符串。

一个布尔值，如果是实时视频流，则为 true。只有从视频服务器（例如 Flash Media Server）或其他 Flash 视频流服务进行流式加载时，此属性才有效。 对于 HTTP 下载，会忽略此属性的值。

将预先录制的视频流发送到视频播放器时，将 isLive 属性设置为 false；发送实时数据（如实时广播）时将该属性设置为 true。为提高性能，请在将 isLive 属性设置为 false 时不要将 bufferTime 属性设置为 0。

相关 API 元素

一个布尔值，如果正在使用 RTMP 从 Flash Media Server (FMS) 流式加载 FLV 文件，则为 true。对于任何其他 FLV 文件源，它的值都是 false。

相关 API 元素

一个对象，它是通过调用 NetSteam.onMetaData() 回调方法（如果有）而接收到的元数据信息包。 调度 metadataReceived 事件后准备就绪。

如果 FLV 文件是用 Flash 8 编码器编码的，则 metadata 属性包含以下信息。早期的 FLV 文件只包含 height、width 和 duration 值。

相关 API 元素

一个 INCManager 对象，它提供对实现 INCManager 的类的实例的访问，而该类是 NCManager 类的接口。

您可以使用此属性来实现需要自定义初始化的自定义 INCManager。

相关 API 元素

允许直接访问由视频播放器创建的 NetConnection 实例。

允许直接访问由视频播放器创建的 NetStream 实例。

为 NetStream 的客户端属性注册自定义类。 在默认情况下，使用 fl.video.VideoPlayerClient；此类处理 onMetaData() 和 onCuePoint() 消息。 若要为其他消息添加自定义处理，例如 onImageData() 和 onTextData()，您可以创建自己的类并将此属性设置为该类。

该类的构造函数必须使用一个 VideoPlayer 实例作为其唯一参数，而且该参数必须具有可以使用 Boolean 值的属性。 当客户端仍在等待文件开始处应有的数据消息时，此属性应该为 false。如果在接收这些消息之前 VideoPlayer 执行其调整大小或自动后退，而可能无法再收到这些消息。 默认情况下，一调用 onMetaData()，fl.video.VideoPlayerClient 就会从 ready 属性返回 true。

您可以将该属性设置为该类对象本身（如下例所示）或该类的字符串名称：

        import fl.video.
        VideoPlayer.netStreamClientClass = MyCustomClient;
        

请注意：仅仅将其设置为该类的字符串名称是无法强制该类编译到 SWF 中的。 默认值是类对象 fl.video.VideoPlayerClient，而不是字符串名称。

极力建议将任何自定义实现都作为 fl.video.VideoPlayer 的子类。 其他方式都有可能造成破坏元数据和 VideoPlayer 和 FLVPlayback 组件中内置的提示点处理。

默认值为 fl.video.VideoPlayerClient。

一个数字，表示当前播放头的时间或位置（以秒为单位计算），可以是小数值。 设置此属性会触发搜索，并具有搜索的所有限制。

播放头时间发生变化（包括播放 FLV 文件时每隔 0.25 秒更改一次）时，该组件会调度 playheadUpdate 事件。

由于几种原因，在调用一种搜索方法或者设置 playheadTime 以引发搜索后，playheadTime 属性中不太可能立即包含预期值。 首先，对于渐进式下载，由于只能搜索关键帧，因此搜索将转到指定时间后第一个关键帧的时间。（对于流式下载，搜索总是转到指定的确切时间，即使 FLV 源文件在此处没有关键帧也是如此。）其次，由于搜索是异步执行的，因此，如果调用 seek 方法或者设置 playheadTime 属性，则 playheadTime 不会立即更新。 若要在搜索完成后获取时间，请侦听 seek 事件，该事件在 playheadTime 属性更新后才会引发。

相关 API 元素

一个数字，表示每个 playheadUpdate 事件之间的时间量，以毫秒为单位。 播放 FLV 文件时设置此属性会重新启动计时器。

因为 ActionScript 提示点在播放头更新时开始，所以，降低 playheadUpdateInterval 属性的值可增加 ActionScript 提示点的精确度。

因为播放头更新间隔是通过调用全局 setInterval() 方法设置的，所以，更新操作无法比 SWF 文件帧频更频繁地触发，这与此方法设置的任何间隔一样。 因此，举例来说，对于每秒 12 帧的默认帧频而言，您可以创建的最低有效间隔大约为 83 毫秒，或者 1 秒（1000 毫秒）的 12 分之 1。

默认值为 250。

相关 API 元素

一个数字，表示每个 progress 事件之间的时间量，以毫秒为单位。 如果您在播放视频流时设置此属性，则会重新启动记时器。

高度，用于在自动调整大小时对齐视频内容。 请勿将 registrationHeight 属性与 height 属性混淆。 height 属性反映视频内容的实际高度。

示例 1，使用下列设置加载一 80x80 FLV 文件：

• registrationX = 100
• registrationY = 100
• registrationWidth = 60
• registrationHeight = 40
• align = VideoAlign.CENTER
• scaleMode = VideoScaleMode.NO_SCALE

• x = 90
• y = 80
• width = 80
• height = 80

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

• scaleMode = VideoScaleMode.MAINTAIN_ASPECT_RATIO

• x = 110
• y = 100
• width = 40
• height = 80

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

• scaleMode = VideoScaleMode.EXACT_FIT

• x = 100
• y = 100
• width = 60
• height = 40

设置 registrationHeight 属性等同于设置 height 属性，反之亦然。 设置任何其他属性或调用更改高度的任何方法（例如 scaleX、setSize 和 setScale）也会使 height 和 registrationHeight 保持同步。

相关 API 元素

宽度，用于在自动调整大小时对齐视频内容。 请勿将 registrationWidth 属性与 width 属性混淆。 width 属性反映视频内容的实际宽度。

示例 1，使用下列设置加载一 80x80 FLV 文件：

• registrationX = 100
• registrationY = 100
• registrationWidth = 60
• registrationHeight = 40
• align = VideoAlign.CENTER
• scaleMode = VideoScaleMode.NO_SCALE

• x = 90
• y = 80
• width = 80
• height = 80

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

• scaleMode = VideoScaleMode.MAINTAIN_ASPECT_RATIO

• x = 110
• y = 100
• width = 40
• height = 80

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

• scaleMode = VideoScaleMode.EXACT_FIT

• x = 100
• y = 100
• width = 60
• height = 40

设置 registrationWidth 属性等同于设置 width 属性，反之亦然。 设置任何其他属性或调用更改宽度的任何方法（例如 scaleX、setSize 和 setScale）也会使 width 和 registrationWidth 保持同步。

相关 API 元素

x 坐标，用于在自动调整大小时对齐视频内容。 请勿将其与反映视频内容实际位置的 x 属性混淆。

示例 1，使用下列设置加载一 80x80 FLV 文件：

• registrationX = 100
• registrationY = 100
• registrationWidth = 60
• registrationHeight = 40
• align = VideoAlign.CENTER
• scaleMode = VideoScaleMode.NO_SCALE

• x = 90
• y = 80
• width = 80
• height = 80

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

• scaleMode = VideoScaleMode.MAINTAIN_ASPECT_RATIO

• x = 110
• y = 100
• width = 40
• height = 80

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

• scaleMode = VideoScaleMode.EXACT_FIT

• x = 100
• y = 100
• width = 60
• height = 40

如果设置了 x 或 registrationX 属性，则第二个属性会更改以维持其与第一个属性的偏移量。 例如，如果 x = 10 且 registrationX = 20，则设置 x = 110 的同时也会设置 registrationX = 120。

相关 API 元素

y 坐标，用于在自动调整大小时对齐视频内容。 请勿将其与反映视频内容实际位置的 y 属性混淆。

示例 1，使用下列设置加载一 80x80 FLV 文件：

• registrationX = 100
• registrationY = 100
• registrationWidth = 60
• registrationHeight = 40
• align = VideoAlign.CENTER
• scaleMode = VideoScaleMode.NO_SCALE

• x = 90
• y = 80
• width = 80
• height = 80

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

• scaleMode = VideoScaleMode.MAINTAIN_ASPECT_RATIO

• x = 110
• y = 100
• width = 40
• height = 80

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

• scaleMode = VideoScaleMode.EXACT_FIT

• x = 100
• y = 100
• width = 60
• height = 40

如果设置了 y 或 registrationY 属性，则第二个属性会更改以维持其与第一个属性的偏移量。 例如，如果 y = 10 且 registrationY = 20，则设置 y = 110 的同时也会设置 registrationY = 120。

相关 API 元素

指定在视频加载后如何调整其大小。 如果设置为 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。

相关 API 元素

一个代表水平缩放的数字。

默认值为 1。

相关 API 元素

一个代表垂直缩放的数字。

默认值为 1。

相关 API 元素

提供对 NetStream.soundTransform 属性的直接访问，以提供更多声音控制。 设置此属性以更改设置；使用此属性的 getter 存取器方法来恢复当前设置。

相关 API 元素

一个字符串，它指定要进行流式处理的 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 文件。

相关 API 元素

一个字符串，指定组件的状态。 该属性通过 load()、play()、stop()、pause() 和 seek() 方法进行设置。

state 属性的可能值包括：buffering、connectionError、disconnected、loading、paused、playing、rewinding、seeking 和 stopped。您可以使用 FLVPlayback 类属性测试这些状态。

相关 API 元素

一个布尔值，如果处于响应状态，则为 true。如果状态为不可响应状态，则对 play()、load()、stop()、pause() 和 seek() 方法的调用将被排队，以供以后在状态更改为可响应状态时执行。 因为这些调用被排队并在以后执行，所以，通常不必跟踪 stateResponsive 属性的值。 可响应状态是：stopped、playing、paused 和 buffering。

相关 API 元素

一个数字，表示视频的总播放时间，以秒为单位。

在从 Flash Media Server (FMS) 进行流式加载并使用默认的 NCManager 时，服务器端应用程序编程接口 (API) 会自动确定此值，并且该值会覆盖通过此属性设置或从元数据中收集的任何值。 设置 source 属性后，可以在到达 stopped 或 playing 状态时读取此属性。 此属性对于来自 FMS 的实时流无意义。

对于 HTTP 下载，如果 FLV 文件嵌入了元数据，则会自动确定该值；如果未嵌入元数据，则应明确设置该值，否则该值将为 NaN。 如果明确设置该值，则将忽略流中的元数据值。

设置此属性时，该值会影响通过设置 source 加载的下一个 FLV 文件。 但它对已加载的 FLV 文件没有任何影响。 而且，在加载 FLV 文件之后，此属性才会返回传递到其中的新值。

如果从未设置此属性（明确或自动），则播放仍有效，但可能会导致搜索控件出问题。

除非明确设置该值，否则在将其设置为一个来自元数据的有效值之前，该值一直为 NaN。

相关 API 元素

加载的 FLV 文件的源宽度。 如果还没有可用的信息，则该属性返回 -1。

相关 API 元素

加载的 FLV 文件的源宽度。 如果还没有可用的信息，则该属性返回 -1。

相关 API 元素

一个布尔值，如果为 true，则 VideoPlayer 实例可见。 如果为 false，则会使实例不可见。

默认值为 true。

一个数字，介于 0 到 1 的范围内，指示音量控制设置。

默认值为 1。

相关 API 元素

一个数字，指定舞台上 VideoPlayer 实例的宽度。

注意：flash.media.Video.width 属性与 fl.video.VideoPlayer.videoWidth 属性类似。

相关 API 元素

一个数字，指定视频播放器的水平位置，以像素为单位。

设置 x 属性也会影响到 registrationX 属性。 如果设置了 x 或 registrationX 属性，则第二个属性会更改以维持其与第一个属性的偏移量。 例如，如果 x = 10 且 registrationX = 20，则设置 x = 110 的同时也会设置 registrationX = 120。

相关 API 元素

一个数字，指定视频播放器的垂直位置，以像素为单位。

设置 y 属性也会影响到 registrationY 属性。 如果设置了 y 或 registrationY 属性，则第二个属性会更改以维持其与第一个属性的偏移量。 例如，如果 y = 10 且 registrationY = 20，则设置 y = 110 的同时也会设置 registrationY = 120。

相关 API 元素

创建一个具有指定宽度和高度的 VideoPlayer 对象。

相关 API 元素

强制关闭视频流和 Flash Media Server 连接。 此方法触发 close 事件。 由于闲置超时功能会关闭流，因此通常无需直接调用该方法。

相关 API 元素

与 play() 方法类似，但使 FLV 文件加载而不播放。 适当时会自动调整大小，并且显示 FLV 文件的第一帧。 初次加载和自动布局后，状态将为 VideoState.PAUSED。

该方法使用与 play() 方法相同的参数，但如果没有 URL，则无法调用 load() 方法。 否则，将会引发错误。 如果视频播放器处于不可响应状态，则 load() 方法会将请求排队。

参数

相关 API 元素

在调用 INCManager.connectToURL() 方法后，连接完成或失败后由 INCManager 调用。 如果连接失败，请在调用之前将 INCManager.netConnection 属性设置为 null 或未定义的值。

相关 API 元素

在调用 INCManager.reconnect() 方法后，重新连接完成或失败后由 INCManager 调用。 如果连接失败，请在调用之前将 INCManager.netconnection 属性设置为 null。

相关 API 元素

暂停视频播放。 如果视频已经暂停或停止，则此方法没有任何作用。若要再次开始播放，请调用 play()。不使用任何参数。

如果播放器处于不可响应状态，则 pause() 方法会将请求排队。

如果在没有连接任何流的情况下调用，则将引发异常。使用 stateChange 事件和 connected 属性可以确定何时调用此方法才是安全的。

如果播放器处于停止状态，则调用 pause() 方法没有任何作用，播放器保持在停止状态。

相关 API 元素

让视频播放。可以在视频暂停、停止或已经在播放时调用。 调用此方法时不带任何参数将播放已加载的视频，或传入 URL 来加载新的流。

如果播放器处于不可响应状态，则会将请求排队。

如果在未连接任何流的情况下进行不带任何参数的调用，将引发异常。 使用 stateChange 事件和 connected 属性可以确定何时调用此方法才是安全的。

参数

相关 API 元素

当下载到足以播放时播放 FLV 文件。 当 FLV 文件下载完成或从 Flash Media Server (FMS) 进行流式加载时，调用 playWhenEnoughDownloaded() 方法等同于调用不带参数的 play() 方法。 调用该方法不会暂停播放，因此，在大多数情况下，您可能需要在调用该方法前调用 pause() 方法。

在文件中搜索到给定时间，以秒为单位指定，精确到小数点后三位（毫秒）。如果正在播放视频，则视频将继续从该点播放。 如果视频已暂停，则视频将搜索到该点并保持暂停状态。 如果视频已停止，则视频搜索到该点并进入暂停状态。 使用实时流时，不起任何作用。

在调用一种搜索方法或者设置 playheadTime 以引发搜索后，playheadTime 属性可能不会立即包含预期值。 对于渐进式下载，由于只能搜索关键帧，因此搜索将转到指定时间后第一个关键帧的时间。

注意：对于流式下载，搜索总是转到指定的确切时间，即使 FLV 源文件在此处没有关键帧也是如此。

由于搜索是异步执行的，因此，如果调用 seek 方法或者设置 playheadTime 属性，则 playheadTime 将不会立即更新。 若要在搜索完成后获得这一时间，需要侦听 seek 事件，该事件只在 playheadTime 属性更新后才启动。

如果在没有连接任何流的情况下调用，则将引发异常。使用 stateChange 事件和 connected 属性可以确定何时调用此方法才是安全的。

参数

相关 API 元素

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

如果 scaleMode 属性为 VideoScaleMode.MAINTAIN_ASPECT_RATIO 或 VideoScaleMode.NO_SCALE，则调用该方法会立即引发 autolayout 事件。

参数

相关 API 元素

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

如果 scaleMode 属性为 VideoScaleMode.MAINTAIN_ASPECT_RATIO 或 VideoScaleMode.NO_SCALE，则调用该方法会立即触发 autolayout 事件。

参数

相关 API 元素

停止视频播放。如果 autoRewind 设置为 true，则后退到第一帧。如果视频已经停止，则此方法没有任何作用。若要再次开始播放，请调用 play()。不使用任何参数。

如果播放器处于不可响应状态，则会将请求排队。

如果在没有连接任何流的情况下调用，则将引发异常。使用 stateChange 事件和 connected 属性可以确定何时调用此方法才是安全的。

相关 API 元素

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

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

此事件具有以下属性：

相关 API 元素

在以下情况下，VideoPlayer 实例会调度此事件：由于超时或通过调用 close() 方法而关闭 NetConnection，或者您调用了 load() 或 play() 方法或设置了 source 属性，从而导致 RTMP 连接关闭。 只有从 Flash Media Server (FMS) 或其他 Flash 视频流服务 (FVSS) 进行流式加载时，FLVPlayback 实例才调度此事件。

close 事件为 VideoEvent 类型，并具有常量 VideoEvent.CLOSE。

此事件具有以下属性：

相关 API 元素

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

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

视频播放器还会调度 stateChange 和 stopped 事件。

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

此事件具有以下属性：

相关 API 元素

到达提示点时调度。 事件对象具有一个 info 属性，该属性包含 FLV 文件提示点的 NetStream.onCuePoint 事件回调接收的 info 对象。 对于 ActionScript 提示点，它包含传递到 ActionScript 提示点方法或属性的对象。

cuePoint 事件为 MetadataEvent 类型，并具有常量 MetadataEvent.CUE_POINT。

此事件具有以下属性：

相关 API 元素

drmAuthenticate 事件

drmError 事件

drmError 事件

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

• 通过使用 autoLayout 事件、调用 setScale() 或 setSize() 方法或更改 width、height、scaleX 和 scaleY 属性布置视频播放器。
• 有两个大小不同的视频播放器，并且将 visibleVideoPlayerIndex 属性从一个视频播放器切换到另一个视频播放器。

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

此事件具有以下属性：

相关 API 元素

第一次到达 FLV 文件的元数据时调度。事件对象具有一个 info 属性，该属性包含 NetStream.onMetaData 事件回调接收的 info 对象。

metadataReceived 事件为 MetadataEvent 类型，并具有常量 MetadataEvent.METADATA_RECEIVED。

此事件具有以下属性：

相关 API 元素

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

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

此事件具有以下属性：

相关 API 元素

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

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

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

此事件具有以下属性：

相关 API 元素

FLV 文件已加载并可以显示时调度此事件。 在您使用 play() 或 load() 方法加载新的 FLV 文件后首次进入可响应状态时，该事件发生。 它只为加载的每个 FLV 文件发生一次。

ready 事件为 VideoEvent 类型，并具有常量 VideoEvent.READY。

此事件具有以下属性：

相关 API 元素

播放状态发生更改时调度。 当 autoRewind 调用完成时，将在后退状态下调度 stateChange 事件。 stateChange 事件在后退完成前不会启动。

此事件可用于跟踪播放何时进入或离开不可响应状态（例如在连接、调整大小或后退过程中）。当播放器进入可响应状态时，play()、pause()、stop() 和 seek() 方法会将要执行的请求排队。

stateChange 事件为 VideoEvent 类型，并具有常量 VideoEvent.STATE_CHANGE。

此事件具有以下属性：

相关 API 元素

指示组件短版本号的状态变量。 版本号在您有 FLA 文件并且需要知道组件版本时很有用。 要确定组件版本，请在 FLA 文件中键入下列 trace 代码：

FLVPlayback.SHORT_VERSION

SHORT_VERSION 变量仅包含主版本号和次版本号，例如：2.0。VERSION 变量包含主版本号和次版本号，以及修订版本号和生成版本号，例如：2.0.0.11。

相关 API 元素

指示组件长版本号的状态变量。 版本号在您有 FLA 文件并且需要知道组件版本时很有用。 要确定组件版本，请在 FLA 文件中键入下列 trace 代码：

FLVPlayback.VERSION

VERSION 变量包含主版本号和次版本号，以及修订版本号和生成版本号，例如：2.0.0.11。SHORT_VERSION 变量仅包含主版本号和次版本号，例如：2.0。

相关 API 元素

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

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);            
        }
    }
}