System.onStatus

可用性

Flash Player 6。

说明

事件处理函数：为某些对象提供“超级”事件处理函数。

LocalConnection、etStream 和SharedObject 对象提供 onStatus 事件处理函数，该事件处理函数使用信息对象提供信息、状态或错误消息。若要响应此事件处理函数，您必须创建一个函数来处理信息对象，同时还必须了解所返回的信息对象的格式和内容。

除了为上面列出的对象提供特定的 onStatus 方法之外，Flash 还提供名为 System.onStatus 的“超级”函数。如果为 level 属性为 "error" 的特定对象调用了 onStatus 但未分配任何函数对其进行响应，则 Flash 将处理分配到 System.onStatus 的函数（如果存在）。

注意：Camera 和 Microphone 类也具有 onStatus 处理函数，但不传递 level 属性为 "error" 的信息对象。因此，如果不为这些处理函数指定函数，则将不调用 System.onStatus。

下面的示例说明如何创建通用和特定函数来处理 onStatus 方法发送的信息对象。

// 创建通用函数
System.onStatus = function(genericError)
{
  // 您的脚本将在此处执行更有意义的操作
  trace("An error has occurred.Please try again.");
}

// 为 NetStream 对象创建函数
// 如果 NetStream 对象返回的信息对象不同于
// 下面列出的对象，其 level 属性为 "error"，
// 则将调用 System.onStatus

videoStream_ns.onStatus = function(infoObject) {
  if (infoObject.code == "NetStream.Play.StreamNotFound") {
    trace("Could not find video file.");
  }
}

另请参见

Camera.onStatus、LocalConnection.onStatus、Microphone.onStatus、
NetStream.onStatus、SharedObject.onStatus