指定 VideoDisplay 控件是否应使用内置自动带宽检测功能。如果为 false，则无需将 Flash Media Server (FMS) 2 上的 main.asc 文件连接到 FMS。如果为 true，则需要在 FMS 的目录结构中实现 main.asc 并存储它。Main.asc 文件必须定义下列功能：

•       application.onConnect = function(p_client, p_autoSenseBW)
        {
          //Add security code here.     
          this.acceptConnection(p_client);      
          if (p_autoSenseBW)
            this.calculateClientBw(p_client);
          else
            p_client.call("onBWDone");
        }

•       application.calculateClientBw = function(p_client)
        {
          // Add code to set the clients BandWidth.
          // Use p_client.getStats() which returns bytes_in 
          // and bytes_Out and check your bandWidth using 
          // p_client.call("onBWCheck", result, p_client.payload).
          p_client.call("onBWDone");
        }
        

•       Client.prototype.getStreamLength = function(p_streamName)
        {
          return Stream.length(p_streamName);
        }

默认值为 false.

此属性可用作数据绑定的源。

指定设置 source 属性后视频是否应立即开始播放。如果为 true，则视频文件立即开始缓冲并播放。

即使 autoPlay 设置为 false，在调用 initialize() 方法后 Flex 也会开始加载视频。对于 Flash Media Server，这意味着创建此流并加载第一帧以供显示（如果 autoSize 或 aspectRatio 设置为 true，则加载更多内容）。对于 HTTP 下载，Flex 则开始下载流并显示第一帧。

默认值为 true.

指定当播放停止时是否应通过调用 stop() 方法或到达流末尾使 FLV 文件后退到第一帧。此属性对实时流视频不起作用。

默认值为 true.

此属性可用作数据绑定的源。

该控件的边框对象。

返回 EdgeMetrics 对象，它具有四个属性：left、top、right 和 bottom。每个属性值等于控件周围边框一侧的粗度值（以像素为单位）。

开始播放视频文件前在内存中缓冲视频的秒数。对于通过 RTMP 进行流式传输的缓慢连接，增加此属性的默认值非常重要。

默认值为 0.1.

此属性可用作数据绑定的源。

已加载的可播放字节数。此值仅适用于使用 HTTP 加载的媒体。

当没有输入流时、当流来自 Flash Media Server 时或没有可用信息时，返回 -1。

此属性可用作数据绑定的源。

要加载的总字节数。此值仅适用于使用 HTTP 加载的媒体。

当没有输入流时、当流来自 Flash Media Server 时或没有可用信息时，返回 -1。

此属性可用作数据绑定的源。

与 VideoPlayer 控件关联的 CuePointManager 类的实例。可以使用此对象控制提示点，或使用 cuePoints 属性。

当视频回放到达指定的位置时，使用提示点触发 cuePoint 事件。要设置提示点，请使用 CuePointManager 类的方法。

嵌入到 FLV 中的提示点不能通过 cuePoints 或 cuePointManager 获得。要检索它们，您可以访问 metadata 属性或 metadataReceived 事件。

另请参见

要使用的提示点管理器。将其设置为 mx.controls.videoClasses.CuePointManager 可启用提示点管理。

另请参见

与控件关联的提示点的 Array。可以使用此属性控制提示点，或使用 cuePointManager 属性。

当视频回放到达指定的位置时，使用提示点触发 cuePoint 事件。要设置提示点，请向 cuePoints 属性传递一个 Array。

嵌入到 FLV 中的提示点不能通过 cuePoints 或 cuePointManager 获得。要检索它们，您可以访问 metadata 属性或 metadataReceived 事件。

Array 中的每个元素都包含两个字段：

• name 字段包含提示点的任意名称。
• time 字段包含与提示点关联的 VideoDisplay 控件的播放头位置（以秒为单位）。

此属性可用作数据绑定的源。

指定在与 Flash Media Server 的连接处于空闲状态（暂停或停止播放）多长时间后（以毫秒为单位）停止该连接。此属性对 FLV 文件的 HTTP 下载不起作用。如果设置了此属性，则当流空闲时，会使用新值重新开始空闲超时。

默认值为 300000 (five minutes).

指定控件是否正在流式加载实时输入信号。当从 Flash Media Server 流式加载实时输入信号时将此属性设置为 true。

默认值为 false.

指定在调整视频大小时控件是否应该保持原始高宽比。

默认值为 true.

此属性可用作数据绑定的源。

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

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

此属性可用作数据绑定的源。

播放头位置，以秒为单位，从视频开始播放时起算。许多 VideoPlay 事件的事件对象都包括播放头位置，以便您能确定视频文件中发生该事件的位置。

将此属性设置为一个以秒为单位的值将执行搜索操作。如果当前正在播放视频，则会从新的播放头位置继续播放。如果视频处于暂停状态，它将搜索到新播放头位置，并保持暂停状态。如果视频处于停止状态，它将搜索到新播放头位置，并进入暂停状态。设置此属性对实时视频流不起作用。

如果新的播放头位置小于 0 或为 NaN，则控件将引发异常。如果新的播放头位置跳过视频的结尾，或超出目前为止已下载的视频文件量，控件仍将尝试进行搜索。

对于 FLV 文件，设置 playheadTime 属性可搜索距指定位置最近的关键帧，此处的关键帧是编码期间在 FLV 文件中指定的。因此，如果在该位置没有指定关键帧，您可能无法搜索到准确时间。

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

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

默认值为 NaN.

此属性可用作数据绑定的源。

指定每两个 playheadUpdate 事件之间的时间量（以毫秒为单位）。

如果在播放视频时设置此属性，则计时器将在 0 处重新开始计时，下一个 playheadUpdate 事件在新时间间隔之后发生。

默认值为 250.

如果为 true，则表示当前正在播放媒体。

此属性可用作数据绑定的源。

指定每两个 progress 事件之间的时间量（以毫秒为单位）。progress 事件在视频文件下载完成前不断发生。

如果在下载视频时设置此属性，则计时器将在 0 处重新开始计时，下一个 progress 事件在新时间间隔之后发生。

默认值为 250.

要流式传输的 FLV 文件的相对路径和文件名。

此属性可用作数据绑定的源。

VideoDisplay 控件的当前状态。通过调用 load()、play()、stop() 和 pause() 方法并设置 playHeadTime 属性即可设置此属性。

此属性可在 VideoEvent 类中定义下列值：VideoEvent.BUFFERING、VideoEvent.CONNECTION_ERROR、VideoEvent.DISCONNECTED、VideoEvent.EXEC_QUEUED_CMD、VideoEvent.LOADING、VideoEvent.PAUSED、VideoEvent.PLAYING、VideoEvent.RESIZING、VideoEvent.REWINDING、VideoEvent.SEEKING 和 VideoEvent.STOPPED。

默认值为 VideoEvent.DISCONNECTED.

此属性可用作数据绑定的源。

另请参见

指定 VideoDisplay 控件是否处于可响应状态。如果是，则为 true；否则，为 false。当加载或后退视频时，控件将进入不可响应状态。

当 state 属性为 VideoEvent.CONNECTION_ERROR、VideoEvent.EXEC_QUEUED_CMD、VideoEvent.RESIZING 或 VideoEvent.SEEKING 时，控件同样处于可响应状态。

如果控件为不可响应，将对 play()、load()、stop() 和 pause() 方法的调用进行排序，然后当控件更改为可响应状态时执行这些方法。

此属性可用作数据绑定的源。

媒体的总长度（以秒为单位）。对于 FLV 1.0 视频文件，需手动设置此属性。对于 FLV 1.1 和更高版本，此控件将自动计算此值。

此属性可用作数据绑定的源。

加载的 FLV 文件的高度。如果尚未加载 FLV 文件，则为 -1。

此属性可用作数据绑定的源。

加载的 FLV 文件的宽度。如果尚未加载 FLV 文件，则为 -1。

此属性可用作数据绑定的源。

音量级别，指定一个介于 0 和 1 之间的值。

默认值为 0.75.

此属性可用作数据绑定的源。

构造函数。

指定是否播放来自摄像头的视频流。在应用程序窗口中的控件范围内显示视频。

参数

强制关闭输入流以及与 Flash Media Server 的连接。调用此方法以调度 close 事件。通常无需直接调用此方法，因为根据 idleTimeout 属性的定义，空闲时间超时后连接会自动关闭。

为此组件创建边框。通常，边框由 borderStyle 和 borderSkin 样式确定。它必须将边框属性设置为边框实例。

通过设置边框的位置和大小以响应对大小的更改。

VideoDisplay.layoutChrome() 方法设置 VideoDisplay 边框的位置和大小。在 VideoDisplay 的每个子类中，子类的 layoutChrome() 方法应调用 super.layoutChrome() 方法，以便正确定位边框。

参数

加载媒体文件，但不播放。

此方法类似于 play() 方法，但它只加载文件，并不播放。适当时会自动调整大小。加载并自动调整大小后，控件的状态将设置为 VideoEvent.PAUSED。

在不移动播放头情况下暂停回放。如果回放已经暂停或停止，此方法无效。

若要再次开始回放，请调用 play() 方法。

如果控件处于不可响应状态，则会将请求排队。

播放媒体文件。如果文件尚未加载，则会加载它。当回放暂停、停止或控件正在播放时，可以调用此方法。

如果控件处于不可响应状态，则会将请求排队。

停止回放。如果 autoRewind 属性设置为 true，则后退到第一帧。

若要再次开始回放，请调用 play() 方法。

如果回放已经停止，则此方法无效。如果控件处于不可响应状态，则会将请求排队。

当 NetConnection 对象因超时或调用 close() 方法而关闭时调度。使用 Flash Media Server 时使用此事件。

事件对象的属性有下列值：

播放头到达 FLV 文件结尾处时调度。

事件对象的属性有下列值：

当提示点的 time 属性值等于当前播放头位置时调度。

事件对象的属性有下列值：

当第一次到达 FLV 文件中的元数据时调度。

此事件具有以下属性：

在视频正在播放时继续调度。事件之间的间隔（以毫秒为单位）由 playheadUpdateInterval 属性指定，默认为 250 毫秒。视频处于暂停或停止状态时，不调度此事件。

事件对象的属性有下列值：

继续调度直到 FLV 文件完全下载。

您可以使用此事件检查加载的字节数或缓冲区中的字节数。首次调用 load() 或 play() 方法时开始调度此事件，而当所有字节加载完成或出现网络错误时结束调度此事件。

此事件具有以下属性：

当 FLV 文件已加载并且播放准备就绪时调度。

load() 或 play() 方法加载新的 FLV 文件后，当 VideoDisplay 控件首次进入可响应状态时调度此事件。它对每个加载的 FLV 文件只调度一次。

事件对象的属性有下列值：

当控件自动后退时调度。

事件对象的属性有下列值：

另请参见

当控件的状态更改时调度。

您可以使用此事件跟踪回放何时进入和离开不可响应状态（例如，在连接、调整大小或后退过程中）、何时对调用 play()、pause() 和 stop() 方法并写入 playHeadTime 属性进行排队并随后在播放器进入可响应状态时执行这些操作。

事件对象的属性有下列值：