FLVPlayback  - AS3 Flash

一个数字，指定哪个视频播放器实例受其他应用程序编程接口 (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。

相关 API 元素

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

相关 API 元素

一个布尔值，如果设置为 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。

相关 API 元素

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

默认值为 false。

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

相关 API 元素

一个数字，指定用于传输 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。

相关 API 元素

一个数字，指示 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() 方法。

相关 API 元素

返回 FLVPlayback 控件后的下一个可用 tabIndex 值。该值在调用 assignTabIndexes 方法后进行设置。

相关 API 元素

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

相关 API 元素

在全屏管理模式中使用的背景颜色。 如果视频根据 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 属性设置为相同的值。

相关 API 元素

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

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

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

相关 API 元素

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

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

将预先录制的视频流发送到视频播放器时，将 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 元素

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

FLVPlayback.metadata != null

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

相关 API 元素

静音按钮控件。

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

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

相关 API 元素

暂停按钮控件。

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

播放按钮控件。

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

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

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

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

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

相关 API 元素

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

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

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

默认值为 250。

相关 API 元素

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

播放/暂停按钮控件。

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

相关 API 元素

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

相关 API 元素

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

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

默认值为 250。

相关 API 元素

高度，用于在自动调整大小时对齐视频内容。 请勿将 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 保持同步。

宽度，用于在自动调整大小时对齐视频内容。 请勿将 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 保持同步。

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。

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。

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

一个布尔值，如果用户使用 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。

相关 API 元素

外观背景的颜色 (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。

相关 API 元素

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

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

此属性指定 FLVPlayback 进入全屏模式（使用支持硬件加速功能的 Flash Player）后放大其外观时使用的最大倍数。 通过使用硬件加速功能，可以按相同的系数缩放视频和外观。 默认情况下，FLVPlayback 按原始尺寸呈现视频，并允许使用硬件加速功能进行其余的缩放。 例如，如果视频尺寸为 640 x 512，并在分辨率为 1280 x 1024 的显示器上全屏显示，视频和外观尺寸将放大 2 倍。

在使用硬件加速功能时，此属性允许基于要缩放的特定内容以及您对较大外观的审美观来限制外观的缩放比例。 若要将外观缩放比例限制为指定的倍数，FLVPlayback 将混合使用软件和硬件外观缩放，这可能会对视频播放性能和 FLV 外观产生不利的影响。

例如，如果将此属性设置为 5.0 或更大，并在分辨率为 1600 x 1200 的显示器上以全屏模式播放尺寸为 320 x 240 的视频，则会将外观放大 5 倍。 如果将此属性设置为 2.5，播放器将以 640 x 480 呈现视频（而不是外观），这是其原始尺寸的 2 倍，硬件加速功能将完成其余的缩放操作（640 x 2.5 = 1600，480 x 2.5 = 1200）。

如果在已进入全屏模式后设置此属性，在 FLVPlayback 下次进入全屏模式后，此设置才会生效。

如果 FLV 很大（例如，640 个像素或更宽，480 个像素或更高），则不应将此属性设置为较小的值，因为这可能会导致在较大显示器上出现非常严重的性能问题。

默认值为 4.0。

相关 API 元素

// Requires FLVPlayback component in library
// Requires SkinOverPlayFullscreen.swf to be in the same folder as the .fla file.
  
import fl.video.FLVPlayback;

var myFLVPlybk:FLVPlayback = new FLVPlayback();

addChild(myFLVPlybk);
myFLVPlybk.skin = "SkinOverPlayFullscreen.swf";
myFLVPlybk.skinScaleMaximum = 2.5;
myFLVPlybk.source = "http://helpexamples.com/flash/video/water.flv";

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

相关 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 元素

为 FLVPlayback 控件返回第一个 tabIndex 值。该值在调用 assignTabIndexes 方法后进行设置。

相关 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 元素

Stop 按钮控件。

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

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

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

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

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

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

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

相关 API 元素

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

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

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

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

默认值为 0。

相关 API 元素

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

默认值为 1。

相关 API 元素

音量栏控件。

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

默认值为 250。

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

默认值为 0。

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

相关 API 元素

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

设置 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() 方法在舞台上或其他显示对象容器上放置实例。

相关 API 元素

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

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

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

参数

相关 API 元素

按照 FLVPlayback 控件的位置从左向右水平排序，为每个 FLVPlayback 控件分配一个 tabIndex 值。此方法将返回下一个可用的 tabIndex 值。

如果使用 NaN 作为 startTabbing 参数来调用 assignTabIndexes，并且已经为 FLVPlayback 组件实例分配一个 tabIndex 值，则该方法将使用为 FLVPlayback 组件实例分配的 tabIndex 作为 startTabIndex。

若指定 FLVPlayback 外观，则应在 FLVPlayback.SKIN_LOADED 事件后等待一个帧以让外观控件进行初始化，然后再调用此方法。

若使用自定义控件，则应在 FLVPlayback.READY 事件后等待一个帧以让自定义控件进行初始化，然后再调用此方法。

参数

相关 API 元素

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

参数

相关 API 元素

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

参数

相关 API 元素

将 FLVPlayback 视频播放器设置为全屏模式。 调用此方法与单击某些 FLVPlayback 外观内置的全屏切换按钮具有相同的效果，还可以通过“组件”面板的“视频”部分中的 FullScreenButton 执行此操作。

此方法在 Flash Player 中支持使用硬件加速功能以全屏模式播放视频。 如果用户的 Flash Player 版本不支持硬件加速功能，此方法仍有效，视频全屏播放的工作方式与没有硬件加速支持时相同。

由于对此方法的调用将 Stage 类的 displayState 属性设置为 StageDisplayState.FULL_SCREEN，因此它具有与 displayState 属性相同的限制。 如果不调用此方法而直接将 stage.displayState 属性设置为 StageDisplayState.FULL_SCREEN 以实现全屏模式，则不会使用硬件加速功能。

仅当将 fullScreenTakeOver 属性设置为 true（默认值）时，才会提供全屏支持。

相关 API 元素

// Requires Button and FLVPlayback components in library.
 
import fl.video.FLVPlayback;
import fl.controls.Button;
var myButton:Button = new Button();
var myFLVPlybk:FLVPlayback = new FLVPlayback();
myButton.move(100, 240);
myButton.label = "Full Screen";
addChild(myButton);
addChild(myFLVPlybk);
 
myFLVPlybk.source = "http://helpexamples.com/flash/video/water.flv";
myButton.addEventListener(MouseEvent.CLICK, handleClick);
function handleClick(e:MouseEvent):void {
    myFLVPlybk.enterFullScreenDisplayState();
}

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

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

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

参数

相关 API 元素

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

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

参数