VideoDisplay  - AS3 Flex

指定 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。

此属性可用作数据绑定的源。修改此属性后，将调度 autoBandWidthDetection 事件。

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

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

默认值为 true。

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

默认值为 true。

此属性可用作数据绑定的源。修改此属性后，将调度 autoRewindChanged 事件。

该控件的边框对象。

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

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

默认值为 0.1。

此属性可用作数据绑定的源。修改此属性后，将调度 bufferTimeChanged 事件。

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

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

此属性可用作数据绑定的源。修改此属性后，将调度 progress 事件。

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

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

此属性可用作数据绑定的源。修改此属性后，将调度 progress 事件。

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

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

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

相关 API 元素

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

相关 API 元素

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

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

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

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

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

此属性可用作数据绑定的源。修改此属性后，将调度 cuePointsChanged 事件。

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

默认值为 300000 (five minutes)。

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

默认值为 false。

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

默认值为 true。

此属性可用作数据绑定的源。修改此属性后，将调度 maintainAspectRatioChanged 事件。

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

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

此属性可用作数据绑定的源。修改此属性后，将调度 metadataReceived 事件。

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

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

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

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

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

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

默认值为 NaN。

此属性可用作数据绑定的源。修改此属性后，将调度 playheadUpdate 事件。

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

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

默认值为 250。

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

此属性可用作数据绑定的源。修改此属性后，将调度 stateChange 事件。

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

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

默认值为 250。

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

此属性可用作数据绑定的源。修改此属性后，将调度 sourceChanged 事件。

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。

此属性可用作数据绑定的源。修改此属性后，将调度 stateChange 事件。

相关 API 元素

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

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

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

此属性可用作数据绑定的源。修改此属性后，将调度 stateChange 事件。

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

此属性可用作数据绑定的源。修改此属性后，将调度 metadataReceived 事件。

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

此属性可用作数据绑定的源。修改此属性后，将调度 resize 事件。

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

此属性可用作数据绑定的源。修改此属性后，将调度 resize 事件。

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

默认值为 0.75。

此属性可用作数据绑定的源。修改此属性后，将调度 volumeChanged 事件。

构造函数。

指定播放来自摄像机的视频流。在应用程序窗口中的控件范围内显示视频。显示来自摄像机的视频流时，不要调用 play() 方法。

参数

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

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

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

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

参数

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

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