一个数字，指定哪个视频播放器实例受其它应用程序编程接口 (API) 影响。 此属性用于管理多个 FLV 文件流。

该属性不会使视频播放器可见；使用 visibleVideoPlayerIndex 属性可使视频播放器可见。

首次将 activeVideoPlayerIndex 设置为数值时，会创建一个新视频播放器。 创建新视频播放器时，它的属性设置为默认视频播放器的值 (activeVideoPlayerIndex == 0)，source、totalTime 和 isLive 除外，它们始终设置为默认值（分别为空字符串、NaN 和 false），而 autoPlay 始终设置为 false（仅对于默认视频播放器，即 0，该默认值为 true）。 cuePoints 属性没有任何影响，因为它对于随后加载到默认视频播放器中没有任何影响。

控制音量、位置、尺寸、可见性和用户界面控件的 API 始终是全局的，它们的行为不受 activeVideoPlayerIndex 设置的影响。 具体而言，设置 activeVideoPlayerIndex 属性并不影响以下属性和方法：

注意：visibleVideoPlayerIndex 属性（不是 activeVideoPlayerIndex 属性）确定外观所控制的视频播放器。 此外，控制尺寸的 API 会与 visibleVideoPlayerIndex 属性进行交互。

其余 API 根据 activeVideoPlayerIndex 的设置将特定视频播放器作为目标。

若要在背景中加载另一个 FLV 文件，可将 activeVideoPlayerIndex 设置为 1，并调用 load() 方法。 若要准备显示此 FLV 文件而隐藏第一个 FLV 文件时，可将 visibleVideoPlayerIndex 设置为 1。

默认值为 0.

另请参见

在 scaleMode 属性设置为 VideoScaleMode.MAINTAIN_ASPECT_RATIO 或 VideoScaleMode.NO_SCALE 时指定视频布局。 视频尺寸由 registrationX、registrationY、registrationWidth 和 registrationHeight 属性确定。 当设置 align 属性时，值来自 VideoAlign 类。 默认值为 VideoAlign.CENTER。

另请参见

一个布尔值，如果设置为 true，则在设置 source 属性后自动开始播放 FLV 文件。 如果将其设置为 false，则加载 FLV 文件，但在调用 play() 或 playWhenEnoughDownloaded() 方法前不开始播放。

当从 Flash Media Server (FMS) 流式加载 FLV 文件且 autoPlay 属性设置为 true 时，立即开始回放。 但在通过渐进式下载加载 FLV 文件时，仅当已下载足够的 FLV 文件时，才开始回放，以便可以从头至尾地播放 FLV 文件。

要在下载足够的 FLV 文件之前强制回放，请调用不带参数的 play() 方法。 如果已开始回放，而您想返回到等待下载充足的状态，然后自动开始回放，请先调用 pause() 方法，然后调用 playWhenEnoughDownloaded() 方法。

如果在加载新 FLV 文件期间将该属性设置为 true，则除非设置了 source 属性，否则该属性不起作用。

将 autoPlay 属性设置为 true，然后将 source 属性设置为一 URL 的效果与使用该 URL 调用 play() 方法相同。

使用 URL 调用 load() 方法与将 source 属性设置为该 URL 且将 autoPlay 属性设置为 false 的效果相同。

默认值为 true.

另请参见

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

默认值为 false.

BackButton 回放控件。 单击调用 seekToPrevNavCuePoint() 方法。

另请参见

一个数字，指定用于传输 FLV 文件的每秒比特数。

当从支持本机带宽检测的 Flash 视频流服务进行流式加载时，您可以提供一个描述如何根据带宽在多个流间进行切换的 SMIL 文件。 根据您的 FVSS，可能会自动检测带宽，在这种情况下将忽略设置的值。

进行 HTTP 渐进式下载时，可以使用相同的 SMIL 格式，但必须设置比特率，因为不会进行自动检测。

一个布尔值，如果视频处于缓冲状态，则为 true。

缓冲栏控件。 当 FLV 文件处于加载状态或缓冲状态时显示此控件。

如果设置为 true，则在 FLV 文件处于缓冲状态时隐藏 SeekBar 控件，并禁用 Play、Pause、PlayPause、BackButton 和 ForwardButton 控件。 此属性可用于在 FLV 文件正通过慢速连接下载或流式加载时，防止用户使用这些控件尝试加快 FLV 文件的播放速度。

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

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

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

默认值为 0.1.

另请参见

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

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

一个数组，说明 ActionScript 提示点和已禁用的嵌入式 FLV 文件提示点。 此属性专门为“组件”检查器和“属性”检查器使用而创建。 通过任何其它方式进行设置均不起作用。 其值只影响加载的第一个 FLV 文件，并且只有通过在“组件”检查器或“属性”检查器中设置 source 属性来进行加载时才会起作用。

注意：在 ActionScript 中无法访问此属性。 若要在 ActionScript 中访问提示点信息，请使用 metadata 属性。

若要使用 ActionScript 添加、删除、启用或禁用提示点，请使用 addASCuePoint()、removeASCuePoint() 或 setFLVCuePointEnabled() 方法。

另请参见

快进按钮控件。 单击调用 seekToNextNavCuePoint() 方法。

另请参见

在全屏管理模式中使用的背景颜色。 如果视频根据 scaleMode 属性值未覆盖整个屏幕，则该颜色可见。

默认值为 0x000000.

FullScreen 按钮控件。

指定隐藏外观的延迟时间，以毫秒为单位。 在全屏管理模式中，如果 skinAutoHide 属性为 true，则当用户在超过 fullScreenSkinDelay 属性指示的秒数内未移动鼠标时将触发自动隐藏。 如果鼠标本身在外观上，则不会触发自动隐藏。

默认值为 3000 milliseconds (3 seconds).

舞台进入全屏模式时，FLVPlayback 组件位于所有内容的顶部并占据整个屏幕。 当舞台退出全屏模式时，屏幕将恢复到以前的样子。

全屏接管模式的推荐设置为 scaleMode = VideoScaleMode.MAINTAIN_ASPECT_RATIO 和 align = VideoAlign.CENTER。

如果加载了包含 FLVPlayback 组件的 SWF 文件，且由于安全限制而没有舞台的访问权限，则全屏接管模式不起作用。 不会引发任何错误。

默认值为 true.

一个数字，指定 FLVPlayback 实例的高度。 此属性只影响 FLVPlayback 实例的高度，并且不包括可加载的外观 SWF 文件的高度。 设置 height 属性会同时将 registrationHeight 属性设置为相同的值。

另请参见

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

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

默认值为 300,000 milliseconds (5 minutes).

另请参见

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

如果在两次加载新的 FLV 文件之间设置该属性，则直到为新的 FLV 文件设置了 source 属性，该属性才起作用。

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

另请参见

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

另请参见

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

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

另请参见

一个布尔值，如果遇到并处理了元数据包，或者如果 FLV 文件在没有元数据包的情况下被编码，则该值为 true。 换言之，如果接收了元数据，或者永远不打算获取任何元数据，则该值为 true。 因此，您可以知道自己是否拥有元数据；如果没有元数据，您知道不必等待元数据。 如果您只想知道是否具有元数据，则可以用以下代码检查该值：

FLVPlayback.metadata != null

使用此属性可以通过用于查找以及启用或禁用提示点（findCuePoint、findNearestCuePoint、findNextCuePointWithName、isFLVCuePointEnabled）的方法，检查是否可以检索有用信息。

另请参见

静音按钮控件。

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

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

另请参见

暂停按钮控件。

一个布尔值，如果 FLV 文件处于暂停状态，则为 true。

播放按钮控件。

一个数字，它将当前的 playheadTime 指定为 totalTime 属性的百分比。 此属性包含已播放时间的百分比。 如果设置此属性，则它会导致搜索操作定向到表示 FLV 文件播放时间百分比的点。

该属性的值相对于 totalTime 属性的值。

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

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

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

另请参见

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

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

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

默认值为 250.

另请参见

一个布尔值，如果 FLV 文件处于播放状态，则为 true。

播放/暂停按钮控件。

一个数字，指定源 FLV 文件的高度。 此信息在调用 play() 或 load() 方法后立即无效。 它在 ready 事件开始时生效。 如果 scaleMode 属性的值为 VideoScaleMode.MAINTAIN_ASPECT_RATIO 或 VideoScaleMode.NO_SCALE，则最好在调度 layout 事件后读取该值。 如果还没有可用的信息，则该属性返回 -1。

另请参见

指定源 FLV 文件的宽度。 在调用 play() 或 load() 方法时此信息不会立即生效；它将在调度 ready 事件后生效。 如果 scaleMode 属性的值为 VideoScaleMode.MAINTAIN_ASPECT_RATIO 或 VideoScaleMode.NO_SCALE，则最好在调度 layout 事件后读取该值。 如果还没有可用的信息，则该属性返回 -1。

另请参见

仅用于实时预览。 在用于预览的 PNG 文件中读取。

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

默认值为 250.

另请参见

示例 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 保持同步。

示例 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 保持同步。

示例 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。

示例 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。

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

另请参见

一个代表水平缩放的数字。 标准缩放为 1。

另请参见

一个代表垂直缩放的数字。 标准缩放为 1。

另请参见

一个布尔值，如果用户使用 SeekBar 拖拽，则为 true，否则为 false。

拖拽指抓住 SeekBar 的手柄并沿一个方向拖动它，以定位 FLV 文件中的某个特定场景。

SeekBar 控件。

一个数字，指定进行拖拽时检查 SeekBar 手柄的频率（以毫秒为单位）。

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

默认值为 250.

一个数字，指定发生更新之前用户可以移动 SeekBar 手柄的距离。 该值以百分比指定，范围从 1 至 100。

默认值为 5.

seekToPrevNavCuePoint() 方法将它的时间与上一个提示点的时间进行比较时使用的秒数。 如果您刚好处于某个提示点之前，则该方法使用该值可以确保您能够跳过该提示点到达上一个提示点，而不必转到刚发生的同一个提示点。

默认值为 1.

一个字符串，指定外观 SWF 文件的 URL。 此字符串可以包含文件名、相对路径（如 Skins/MySkin.swf）或绝对 URL（如 http://www.%somedomain%.com/MySkin.swf）。

一个布尔值，如果为 true，则鼠标未在视频上时隐藏组件外观。 此属性只影响通过设置 skin 属性加载的外观，而不影响从 FLVPlayback 自定义用户界面组件创建的外观。

当组件处于全屏管理模式且外观为不覆盖视频的外观时，将自动启用 skinAutoHide 模式。 进入全屏模式后设置 skinAutoHide = false 会覆盖此行为。 另外，当组件处于全屏管理模式时，除非鼠标本身在外观上，否则当用户在超过 fullScreenSkinDelay 秒内未移动鼠标时将触发自动隐藏。

默认值为 false.

外观背景的 Alpha 透明度。 skinBackgroundAlpha 属性只能与通过使用 skin 属性加载了外观的 SWF 文件以及支持颜色和 alpha 设置的外观一起使用。 可以将 skinBackgroundAlpha 属性设置为一个 0.0 到 1.0 之间的数字。默认值为用户上次选择的默认值。

要获取 ActionScript 2.0 FLVPlayback 组件自带的外观颜色，请使用 skinBackgroundAlpha 和 skinBackgroundColor 属性的下列值：Arctic - 0.85，0x47ABCB；Clear - 0.20，0xFFFFFF；Mojave - 0.85，0xBFBD9F；Steel - 0.85，0x666666。 默认值为 0.85。

另请参见

外观背景的颜色 (0xRRGGBB)。 skinBackgroundColor 属性只能与通过使用 skin 属性加载了外观的 SWF 文件以及支持颜色和 alpha 设置的外观一起使用。 默认值为用户上次选择的默认值。

要获取 ActionScript 2.0 FLVPlayback 组件自带的外观颜色，请使用 skinBackgroundAlpha 和 skinBackgroundColor 属性的下列值：Arctic - 0.85，0x47ABCB；Clear - 0.20，0xFFFFFF；Mojave - 0.85，0xBFBD9F；Steel - 0.85，0x666666。 默认值为 0x47ABCB。

另请参见

隐藏或显示时外观淡入或淡出的时间，以毫秒为单位。 由于 skinAutoHide 属性设置为 true，因此会出现隐藏和显示的行为。 将 skinFadeTime 属性设置为 0 可以消除淡化效果。

默认值为 500 milliseconds (.5 seconds).

提供对 VideoPlayer.soundTransform 属性的直接访问，以提供更多声音控制。 您需要设置此属性以便使更改生效，或者您可以获取此属性的值以获取当前设置的副本。

另请参见

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

另请参见

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

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

另请参见

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

另请参见

Stop 按钮控件。

一个布尔值，如果 FLVPlayback 实例的状态为 stopped，则该值为 true。

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

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

对于 HTTP 下载，如果 FLV 文件含有嵌入的元数据，则会自动确定该值，否则应显式设置该值或者设置为 NaN。 如果显式设置该值，则将忽略流中的元数据值。

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

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

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

另请参见

一个数字，可用于管理多个 FLV 文件流。 设置哪个视频播放器实例可见、可听到以及是由外观或回放控件控制的，而其余视频播放器将隐藏和静音。 它并不使视频播放器成为可供大多数 API 使用的目标；要实现此目的，请使用 activeVideoPlayerIndex 属性。

用于控制影响此属性的尺寸的方法和属性。 设置此视频播放器尺寸的方法和属性（setScale()、setSize()、width、height、scaleX、scaleY）可用于所有视频播放器。 但是，根据这些视频播放器上的 scaleMode 属性值，播放器可能会有不同的尺寸。 使用 width、height、scaleX, 和 scaleY 属性读取尺寸时，只能为您提供可见视频播放器的尺寸。 其它视频播放器的尺寸可能相同，也可能不同。

若要在各个视频播放器不可见时获取它们的尺寸，可侦听 layout 事件并存储大小值。

从总体上来说，此属性不会暗示组件是否可见，它只能指示组件可见时哪个视频播放器可见。 若要设置整个组件的可见性，请使用 visible 属性。

默认值为 0.

另请参见

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

默认值为 1.

另请参见

音量栏控件。

一个数字，指定拖拽时检查音量栏手柄位置的频率，以毫秒为单位。

默认值为 250.

一个数字，指定更新之前用户可以移动音量栏手柄的距离。 该值以百分比表示，范围从 1 至 100。 设置为 0 表明没有清理容差。 无论用户将手柄移动多远，始终按 volumeBarInterval 更新音量。

默认值为 0.

一个数字，指定舞台上 FLVPlayback 实例的宽度。 此属性只影响 FLVPlayback 实例的宽度，不包括可被加载的外观 SWF 文件的宽度。 使用 FLVPlayback width 属性，而不使用 DisplayObject.width 属性，因为如果加载外观 SWF 文件，width 属性可能会给出不同值。 设置 width 属性会同时将 registrationWidth 属性设置为相同的值。

另请参见

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

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

创建新的 FLVPlayback 实例。 创建 FLVPlayback 实例后，调用 addChild() 或 addChildAt() 方法在舞台上或其它显示对象容器上放置实例。

另请参见

添加 ActionScript 提示点，并与使用“提示点”对话框添加 ActionScript 提示点具有几乎相同的效果，只是后者在应用程序执行时发生，而不是在应用程序开发期间发生。

设置 source 属性会清除提示点信息。 若要为下一个要加载的 FLV 文件设置提示点信息，应首先设置 source 属性。

可以添加多个具有相同名称和时间的 ActionScript 提示点。 在使用 removeASCuePoint() 方法删除 ActionScript 提示点时，具有相同名称和时间的所有提示点都将被删除。

参数

另请参见

将一个视频播放器置于堆叠的视频播放器的前面。 对于在视频播放器之间进行自定义切换非常有用。 默认的堆叠顺序与 activeVideoPlayerIndex 属性的顺序相同：0 表示位于底部，1 在 0 之上，2 在 1 之上，依此类推。 但是，在调用 bringVideoPlayerToFront() 方法时，该顺序可能会更改。 例如，2 可能为底部。

参数

另请参见

关闭 NetStream 并删除由 index 参数指定的视频播放器。 如果已关闭的视频播放器是活动或可见的视频播放器，则 FLVPlayback 实例将活动和/或可见的视频播放器设置为默认播放器（索引为 0）。 您无法关闭默认播放器；如果试图这样做，将导致组件引发错误。

参数

另请参见

查找属于 type 参数所指定的类型并且具有您通过这些参数指定的时间、名称或二者组合的提示点。

如果没有为提示点的时间或名称提供值，或者时间为 null、未定义或小于零，名称为 null 或未定义，则该方法将引发 VideoError 错误 1002。

该方法在搜索中包括禁用的提示点。 使用 isFLVCuePointEnabled() 方法可确定提示点是否已禁用。

参数

另请参见

查找与指定时间匹配或早于指定时间的指定类型提示点。 如果您同时指定了时间和名称，并且没有较早的提示点与该名称匹配，则查找与该指定名称匹配的提示点。 否则，将返回 null。 默认情况下搜索所有指示点。

该方法在搜索中包括禁用的提示点。 使用 isFLVCuePointEnabled() 方法可确定提示点是否已禁用。

参数

另请参见

在 my_cuePoint.array 中查找与 my_cuePoint.name 同名的下一个提示点。 my_cuePoint 必须是一个由 findCuePoint() 方法、findNearestCuePoint() 方法或者以前对此方法的调用返回的提示点对象。 此方法使用 array 参数（上面这些方法将该参数添加到 CuePoint 对象）。

该方法在搜索中包括禁用的提示点。 使用 isFLVCuePointEnabled() 方法可确定提示点是否已禁用。

参数

获取由 index 参数指定的视频播放器。 如果可能，最好使用 FLVPlayback 方法和属性访问 VideoPlayer 方法和属性。 每个 DisplayObject.name 属性都是其转换为字符串的索引。

参数

如果禁用 FLV 文件嵌入式提示点，则返回 false。 您可以通过以下两种方法之一禁用提示点：通过“Flash 视频提示点”对话框设置 cuePoints 属性，或者调用 setFLVCuePointEnabled() 方法。

只有在 metadataLoaded 属性为 true，metadata 属性不为 null 时，或者在 metadataReceived 事件发生之后，此函数的返回值才有意义。 当 metadataLoaded 为 false 时，此函数始终返回 true。

参数

另请参见

开始加载 FLV 文件，并提供快捷方式，用于将 autoPlay 属性设置为 false，并且设置 source、totalTime 和 isLive 属性（如果指定）。 如果未定义 totalTime 和 isLive 属性，则不会对它们进行设置。 如果 source 属性未定义，或者为 null 或空字符串，则此方法不执行任何操作。

参数

另请参见

暂停播放视频流。

如果已开始回放，而您想返回到等待下载充足的状态，然后自动开始回放，请先调用 pause() 方法，然后调用 playWhenEnoughDownloaded() 方法。

播放视频流。 不带参数时，此方法只将 FLV 文件从暂停或停止状态转换为播放状态。

如果使用参数，则使用此方法可以更快捷地将 autoPlay 属性设置为 true，并设置 isLive、totalTime 和 source 属性。 如果未定义 totalTime 和 isLive 属性，则不会对它们进行设置。

在播放自动开始之前等待渐进式下载 FLV 加载足够内容时，可以调用不带任何参数的 play() 方法来强制回放立即开始。

参数

另请参见

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

从当前已加载的 FLV 文件中删除 ActionScript 提示点。 只使用 timeNameOrCuePoint 参数中的 name 和 time 属性来查找要删除的提示点。

如果有多个 ActionScript 提示点与搜索条件匹配，则只删除其中一个。 要删除所有提示点，可在循环中用相同的参数反复调用此函数，直到返回 null。

当设置了 source 属性时，会清除提示点信息，因此，若要为下一个要加载的 FLV 文件设置提示点信息，应先设置 source 属性。

参数

另请参见

在文件中搜索到给定时间，以秒为单位指定，精确到小数点后三位（毫秒）。

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

参数

另请参见

搜索到文件的某个百分比处并将播放头放置在那里。 该百分比是介于 0 和 100 之间的数值。

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

参数

另请参见

在文件中搜索到给定时间，以秒为单位指定，精确到小数点后三位（毫秒）。 此方法执行与 seek() 方法相同的操作；提供此方法是为了与 seekPercent() 方法对称。

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

参数

另请参见

搜索到与指定时间、名称或时间及名称匹配的导航提示点。

该时间为查找下一个导航提示点的开始时间，以秒为单位。 默认值是当前的 playheadTime 属性。 如果您指定一个时间，则该方法搜索到匹配该时间或更晚的提示点。 如果时间未定义、为 null 或小于 0，则该方法在时间 0 处开始进行搜索。

该名称为要搜索的提示点。 该方法搜索到具有此名称的第一个启用的导航提示点。

时间和名称一起为指定时间之后具有指定名称的导航提示点。

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

参数

另请参见

根据当前的 playheadTime 属性值搜索到下一个导航提示点。 该方法跳过已禁用的导航提示点，并在没有其它提示点的情况下转到 FLV 文件的末尾。

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

参数

另请参见

根据当前的 playheadTime 属性值搜索到上一个导航提示点。 如果没有上一个提示点，则会转到开始处。 此方法会跳过已禁用的导航提示点。

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

参数

另请参见

启用或禁用一个或多个 FLV 文件提示点。 之所以禁用提示点，是因为要将它们作为事件进行调度，或者要使用 seekToPrevNavCuePoint()、seekToNextNavCuePoint() 和 seekToNavCuePoint() 方法定位到它们。

在将 source 属性设置为另一个 FLV 文件时，会删除提示点信息，因此，在为下一个要加载的 FLV 文件设置提示点信息前，应当先设置 source 属性。

在加载元数据后，对 isFLVCuePointEnabled() 方法的调用才反映此方法所导致的更改。

参数

另请参见

同时设置 scaleX 和 scaleY 属性。 由于单独设置任一属性都可能导致自动调整大小，因此同时设置 scaleX 和 scaleY 属性可能比单独设置它们效率更高。

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

参数

另请参见

同时设置 width 和 height。 由于单独设置任一属性都可能导致自动调整大小，因此同时设置 width 和 height 属性比单独设置它们效率更高。

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

参数

另请参见

停止播放视频。 如果 autoRewind 属性为 true，则 FLV 文件会后退到开始处。

当自动调整视频播放器大小或布置视频播放器时调度。 当加载新的 FLV 文件或 align 和 scaleMode 属性之一发生更改时，根据这两个属性的值自动布置视频播放器。

autoLayout 事件为 AutoLayoutEvent 类型，并具有常量 AutoLayoutEvent.AUTO_LAYOUT。

尝试对视频播放器进行自动布局后，即使没有更改尺寸也将调度该事件对象。

在以下三种情况下也会调度 LayoutEvent：

• 视频播放器在布局后可见。
• 有两个大小或位置不同的视频播放器，并且将 visibleVideoPlayerIndex 属性从一个视频播放器切换到另一个视频播放器。
• 调用了更改视频播放器大小的方法或属性，例如：setSize()、setScale()、width、height、scaleX、scaleY、registrationWidth 和 registrationHeight。

如果正在使用多个视频播放器实例，则该事件可能不会应用于可见的视频播放器。

此事件具有以下属性：

另请参见

由于 autoRewind 属性设置为 true 而将播放头移至视频播放器的开始位置时调度。 调度 autoRewound 事件时，还会调度 rewind 事件。

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

此事件具有以下属性：

另请参见

当 FLVPlayback 实例进入缓冲状态时调度。 在调用 play() 方法或者单击 Play 控件之后，FLVPlayback 实例通常会立即进入此状态，然后再进入播放状态。

还调度 stateChange 事件。

bufferingStateEntered 事件为 VideoEvent 类型，并具有常量 VideoEvent.BUFFERING_STATE_ENTERED。

此事件具有以下属性：

另请参见

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

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

此事件具有以下属性：

另请参见

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

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

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

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

此事件具有以下属性：

另请参见

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

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

此事件具有以下属性：

另请参见

在播放头的位置由于调用 seek() 方法或单击 ForwardButton 控件而前移时调度。

FLVPlayback 实例还会调度 playheadUpdate 事件。

fastForward 事件为 VideoEvent 类型，并具有常量 VideoEvent.FAST_FORWARD。

此事件具有以下属性：

另请参见

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

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

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

此事件具有以下属性：

另请参见

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

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

此事件具有以下属性：

另请参见