NetStream.onStatus

可用性

Flash Player 7。

注意:当与 Flash Communication Server 一起使用时,Flash Player 6 也支持此处理函数。有关更多信息,请参见 Flash Communication Server 文档。

用法

my_ns.onStatus = function(infoObject) {
  // 此处是您的代码
}

参数

infoObject 按照状态或错误信息定义的参数。有关此参数的更多信息,请参见下面的“说明”。

返回

无。

说明

事件处理函数;每当状态发生更改或发布针对 NetStream 对象的错误时调用。如果要对此事件处理函数做出响应,则必须创建一个函数来处理该信息对象。

该信息对象具有一个 code 属性(包含描述 onStatus 处理函数的结果的字符串)和 level 属性(包含或者为 "Status"、或者为 "Error" 的字符串)。

除了此 onStatus 处理函数外,Flash 还提供称作 System.onStatus 的“超级”函数。如果为特定对象调用了 onStatus 但未分配任何函数对其进行响应,则 Flash 将处理分配到
system.onStatus 的函数(如果存在)。

以下事件在发生某些 NetStream 活动时通知您。

Code 属性

Level 属性

含义

NetStream.Buffer.Empty

Status

数据的接收速度不足以填充缓冲区。数据流将在缓冲区重新填充前中断,此时将发送 NetStream.Buffer.Full 消息,并且该流将再次开始播放。

NetStream.Buffer.Full

Status

缓冲区已满并且流将开始播放。

NetStream.Play.Start

Status

回放已开始。

NetStream.Play.Stop

Status

回放已结束。

NetStream.Play.StreamNotFound

Error

无法找到传递到 play() 方法的 FLV。

示例

以下示例将有关流的数据写入日志文件。

my_ns.onStatus = function(info)
{
  _root.log_stream += "Stream status.\n";
  _root.log_stream += "Event:" + info.code + "\n";
  _root.log_stream += "Type:" + info.level + "\n";
}

另请参见

System.onStatus