Главная / Action Script 3
Пакетflash.events
Классpublic class NetStatusEvent
НаследованиеNetStatusEvent Inheritance Event Inheritance Object

Язык версии : ActionScript 3.0
Версии среды выполнения:  1.0 9

Проигрыватель Flash® Player отправляет объекты NetStatusEvent, когда объект NetConnection, NetStream, или SharedObject сообщает свое состояние. Существует только один тип события состояния: NetStatusEvent.NET_STATUS.

Посмотреть примеры

См. также

flash.net.NetConnection
flash.net.NetStream
flash.net.SharedObject
NetStatusEvent.NET_STATUS


Общедоступные свойства
 СвойствоОпределено
 Inheritedbubbles : Boolean
[только для чтения] Определяет, является ли событие "событием на цепочке".
Event
 Inheritedcancelable : Boolean
[только для чтения] Определяет, можно ли отключить поведение, связанное с событием.
Event
 Inheritedconstructor : Object
Ссылка на объект класса или функцию конструктора для данного экземпляра объекта.
Object
 InheritedcurrentTarget : Object
[только для чтения] Объект, активно обрабатывающий объект Event с помощью прослушивателя событий.
Event
 InheritedeventPhase : uint
[только для чтения] Текущая фаза в потоке событий.
Event
  info : Object
Объект со свойствами, описывающими состояние объекта или условие ошибки.
NetStatusEvent
 Inheritedprototype : Object
[статические] Ссылка на модель объекта класса или функции.
Object
 Inheritedtarget : Object
[только для чтения] Целевой объект события.
Event
 Inheritedtype : String
[только для чтения] Тип события.
Event
Общедоступные методы
 МетодОпределено
  
NetStatusEvent(type:String, bubbles:Boolean = false, cancelable:Boolean = false, info:Object = null)
Создает объект Event, содержащий сведения о событиях netStatus.
NetStatusEvent
  
Создает копию объекта NetStatusEvent и задает значение каждого свойства, совпадающее с оригиналом.
NetStatusEvent
 Inherited
formatToString(className:String, ... arguments):String
Служебная функция для реализации метода toString() в пользовательских классах ActionScript 3.0 Event.
Event
 Inherited
Показывает, определено ли заданное свойство для объекта.
Object
 Inherited
Проверяет, выполнялся ли для события вызова метода preventDefault().
Event
 Inherited
Показывает, есть ли экземпляр класса Object в цепи прототипов объекта, заданного в качестве параметра.
Object
 Inherited
Отменяет поведение по умолчанию для события, если такое поведение можно отменить.
Event
 Inherited
Показывает наличие заданного свойства и его перечисляемость.
Object
 Inherited
Задает доступность динамического свойства для операций цикла.
Object
 Inherited
Отменяет обработку прослушивателей событий в текущем узле, а также во всех узлах, которые следуют в потоке событий за текущим узлом.
Event
 Inherited
Отменяет обработку прослушивателей событий в узлах, которые следуют в потоке событий за текущим узлом.
Event
  
Возвращает строку, содержащую все свойства объекта NetStatusEvent.
NetStatusEvent
 Inherited
Возвращает элементарное значение заданного объекта.
Object
Общедоступные константы
 Константа Определено
 InheritedACTIVATE : String = "activate"
[статические] Константа Event.ACTIVATE определяет значение свойства type объекта события Activitate.
Event
 InheritedADDED : String = "added"
[статические] Константа Event.ADDED определяет значение свойства type добавленного объекта события.
Event
 InheritedADDED_TO_STAGE : String = "addedToStage"
[статические] Константа Event.ADDED_TO_STAGE определяет значение свойства type объекта события addedToStage.
Event
 InheritedCANCEL : String = "cancel"
[статические] Константа Event.CANCEL определяет значение свойства type объекта события cancel.
Event
 InheritedCHANGE : String = "change"
[статические] Константа Event.CHANGE определяет значение свойства type объекта события change.
Event
 InheritedCLEAR : String = "clear"
[статические] Задает значение свойства type для объекта события clear.
Event
 InheritedCLOSE : String = "close"
[статические] Константа Event.CLOSE определяет значение свойства type объекта события close.
Event
 InheritedAIR-only CLOSING : String = "closing"
[статические] Константа Event.CLOSING определяет значение свойства type объекта события closing.
Event
 InheritedCOMPLETE : String = "complete"
[статические] Константа Event.COMPLETE определяет значение свойства type объекта события complete.
Event
 InheritedCONNECT : String = "connect"
[статические] Константа Event.CONNECT определяет значение свойства type объекта события connect.
Event
 InheritedCOPY : String = "copy"
[статические] Задает значение свойства type для объекта события copy.
Event
 InheritedCUT : String = "cut"
[статические] Задает значение свойства type для объекта события cut.
Event
 InheritedDEACTIVATE : String = "deactivate"
[статические] Константа Event.DEACTIVATE определяет значение свойства type объекта события deactivate.
Event
 InheritedDISPLAYING : String = "displaying"
[статические] Задает значение свойства type для объекта события displaying.
Event
 InheritedENTER_FRAME : String = "enterFrame"
[статические] Константа Event.ENTER_FRAME определяет значение свойства type объекта события enterFrame.
Event
 InheritedEXIT_FRAME : String = "exitFrame"
[статические] Определяет значение свойства type объекта exitFrame.
Event
 InheritedAIR-only EXITING : String = "exiting"
[статические] Константа Event.EXITING определяет значение свойства type объекта exiting.
Event
 InheritedFRAME_CONSTRUCTED : String = "frameConstructed"
[статические] Задает значение свойства type для объекта события frameConstructed.
Event
 InheritedFULLSCREEN : String = "fullScreen"
[статические] Константа Event.FULL_SCREEN определяет значение свойства type для объекта события fullScreen.
Event
 InheritedAIR-only HTML_BOUNDS_CHANGE : String = "htmlBoundsChange"
[статические] Константа Event.HTML_BOUNDS_CHANGE определяет значение свойства type объекта htmlBoundsChange.
Event
 InheritedAIR-only HTML_DOM_INITIALIZE : String = "htmlDOMInitialize"
[статические] Константа Event.HTML_DOM_INITIALIZE определяет значение свойства type объекта события htmlDOMInitialize.
Event
 InheritedAIR-only HTML_RENDER : String = "htmlRender"
[статические] Константа Event.HTML_RENDER определяет значение свойства type объекта события htmlRender.
Event
 InheritedID3 : String = "id3"
[статические] Константа Event.ID3 определяет значение свойства type объекта id3.
Event
 InheritedINIT : String = "init"
[статические] Константа Event.INIT определяет значение свойства type объекта init.
Event
 InheritedAIR-only LOCATION_CHANGE : String = "locationChange"
[статические] Константа Event.LOCATION_CHANGE определяет значение свойства type объекта события locationChange.
Event
 InheritedMOUSE_LEAVE : String = "mouseLeave"
[статические] Константа Event.MOUSE_LEAVE определяет значение свойства type объекта события mouseLeave.
Event
  NET_STATUS : String = "netStatus"
[статические] Задает значение свойства type для объекта события netStatus.
NetStatusEvent
 InheritedAIR-only NETWORK_CHANGE : String = "networkChange"
[статические] Константа Event.NETWORK_CHANGE определяет значение свойства type объекта события networkChange.
Event
 InheritedOPEN : String = "open"
[статические] Константа Event.OPEN определяет значение свойства type объекта open.
Event
 InheritedPASTE : String = "paste"
[статические] Задает значение свойства type для объекта события paste.
Event
 InheritedREMOVED : String = "removed"
[статические] Константа Event.REMOVED определяет значение свойства type объекта события removed.
Event
 InheritedREMOVED_FROM_STAGE : String = "removedFromStage"
[статические] Константа REMOVED_FROM_STAGE определяет значение свойства type объекта события removedFromStage.
Event
 InheritedRENDER : String = "render"
[статические] Константа Event.RENDER определяет значение свойства type объекта события render.
Event
 InheritedRESIZE : String = "resize"
[статические] Константа Event.RESIZE определяет значение свойства type объекта события resize.
Event
 InheritedSCROLL : String = "scroll"
[статические] Константа Event.SCROLL определяет значение свойства type объекта события scroll.
Event
 InheritedSELECT : String = "select"
[статические] Константа Event.SELECT определяет значение свойства type объекта события select.
Event
 InheritedSELECT_ALL : String = "selectAll"
[статические] Задает значение свойства type для объекта события selectAll.
Event
 InheritedSOUND_COMPLETE : String = "soundComplete"
[статические] Константа Event.SOUND_COMPLETE определяет значение свойства type объекта события soundComplete.
Event
 InheritedTAB_CHILDREN_CHANGE : String = "tabChildrenChange"
[статические] Константа Event.TAB_CHILDREN_CHANGE определяет значение свойства type объекта события tabChildrenChange.
Event
 InheritedTAB_ENABLED_CHANGE : String = "tabEnabledChange"
[статические] Константа Event.TAB_ENABLED_CHANGE определяет значение свойства type объекта события tabEnabledChange.
Event
 InheritedTAB_INDEX_CHANGE : String = "tabIndexChange"
[статические] Константа Event.TAB_INDEX_CHANGE определяет значение свойства type объекта события tabIndexChange.
Event
 InheritedUNLOAD : String = "unload"
[статические] Константа Event.UNLOAD определяет значение свойства type объекта unload.
Event
 InheritedAIR-only USER_IDLE : String = "userIdle"
[статические] Константа Event.USER_IDLE определяет значение свойства type объекта события userIdle.
Event
 InheritedAIR-only USER_PRESENT : String = "userPresent"
[статические] Константа Event.USER_PRESENT определяет значение свойства type объекта события userPresent.
Event
Сведения о свойстве
infoсвойство
info:Object  [чтение и запись]

Язык версии : ActionScript 3.0
Версии среды выполнения:  1.0 9

Объект со свойствами, описывающими состояние объекта или условие ошибки.

Информационный объект может иметь свойство code, содержащее строку, представляющую конкретное событие, или свойство level, содержащее строку, являющуюся"состоянием" или "ошибкой".

Информационный объект может быть и другим. Свойства code и level могут не поддерживаться для некоторых реализаций, также некоторые серверы могут отправлять другие объекты.

Подключения P2P отправляют сообщения для NetConnection параметром stream в информационном объекте, указывающим, к какому объекту NetStream относится сообщение.

В следующей таблице описываются возможные строковые значения свойств code и level.

Свойство codeСвойство levelЗначение
"NetStream.Buffer.Empty""cостояние"Данные поступают недостаточно быстро для заполнения буфера. Поток данных будет прерван до повторного заполнения буфера, после чего будет отправлено сообщение NetStream.Buffer.Full и возобновится потоковое воспроизведение.
"NetStream.Buffer.Full""cостояние"Буфер заполнен, начнется потоковое воспроизведение.
"NetStream.Buffer.Flush""cостояние"Потоковое воспроизведение данных прекратилось, оставшийся буфер будет очищен.
"NetStream.Failed" "Ошибка"Только для Flash Media Server. Произошла ошибка по причине, не указанной среди других кодов событий.
"NetStream.Publish.Start""cостояние"Публикация выполнена успешно.
"NetStream.Publish.BadName""ошибка"Попытка опубликовать поток, уже публикуемый другим пользователем.
"NetStream.Publish.Idle""cостояние"Сервер публикации потока свободен и не передает данных.
"NetStream.Unpublish.Success""cостояние"Операция отмены публикации выполнена успешно.
"NetStream.Play.Start""cостояние"Началось воспроизведение.
"NetStream.Play.Stop""cостояние"Воспроизведение остановлено.
"NetStream.Play.Failed""ошибка"Произошла ошибка при воспроизведении по причине, не указанной в таблице, например, у подписчика нет доступа для чтения.
"NetStream.Play.StreamNotFound""ошибка"FLV-файл, переданный методу play(), не найден.
"NetStream.Play.Reset""cостояние"Вызвано сбросом списка воспроизведения.
"NetStream.Play.PublishNotify""cостояние"Исходная публикация потока отправляется всем подписчикам.
"NetStream.Play.UnpublishNotify""cостояние"Отмена публикации потока отправляется всем подписчикам.
"NetStream.Play.InsufficientBW" "предупреждение"Только для Flash Media Server. Пропускной способности клиента недостаточно для воспроизведения данных с нормальной скоростью.
"NetStream.Play.FileStructureInvalid""ошибка"Проигрыватель обнаруживает недопустимую структуру файла и не будет пытаться воспроизвести данный тип файла. Для проигрывателя Flash Player версии 9.0.115.0 и более поздних версий.
"NetStream.Play.NoSupportedTrackFound""ошибка"Проигрыватель не обнаруживает поддерживаемых каналов (видео, аудио или данных) и не будет пытаться воспроизвести файл. Для проигрывателя Flash Player версии 9.0.115.0 и более поздних версий.
"NetStream.Play.Transition""status"Только Flash Media Server 3.5 и более поздней версии. Сервер получает команду перехода к другому потоку в результате переключения потока битовой передачи данных. Данный код означает состояние успешного выполнения вызова NetStream.play2() для инициации переключения потоков. Если переключение не выполнено, сервер отправляет событие NetStream.Play.Failed. При переключении потока выполняется отправка события onPlayStatus с кодом NetStream.Play.TransitionComplete. Для проигрывателя Flash Player версии 10 и более поздних версий.
"NetStream.Pause.Notify""cостояние"Поток приостановлен.
"NetStream.Unpause.Notify""cостояние"Поток возобновлен.
"NetStream.Record.Start""cостояние"Началась запись.
"NetStream.Record.NoAccess""ошибка"Попытка записать поток, который все еще воспроизводится или к которому у клиента нет права доступа.
"NetStream.Record.Stop""cостояние"Запись остановлена.
"NetStream.Record.Failed""ошибка"Попытка записи потока не удалась.
"NetStream.Seek.Failed""ошибка"Поиск выполнить не удалось, это происходит, если поток не поддерживает поиск.
"NetStream.Seek.InvalidTime""ошибка"В ходе загрузки видео в прогрессивном режиме пользователь попытался найти или воспроизвести еще не загруженные на данный момент видеоданные или данные, находящиеся за пределами полностью загруженного файла. Свойство message.details содержит код временной код, указывающий последнюю действительную позицию, доступную для поиска.
"NetStream.Seek.Notify""cостояние"Операция поиска выполнена.
"NetConnection.Call.BadVersion""ошибка"Пакет закодирован в неопределенном формате.
"NetConnection.Call.Failed""ошибка"Методу NetConnection.call не удалось вызвать метод или команду на сервере.
"NetConnection.Call.Prohibited""ошибка"Выполнение операции Action Message Format (AMF) предотвращено по соображениям безопасности. URL-адрес AMF не находится в домене SWF-файла, или на сервере AMF нет файла политики, доверяющего домену SWF-файла.
"NetConnection.Connect.Closed""cостояние"Подключение успешно разорвано.
"NetConnection.Connect.Failed""ошибка"Попытка подключения не удалась.
"NetConnection.Connect.Success""cостояние"Попытка подключения удалась.
"NetConnection.Connect.Rejected""ошибка"Попытка подключения не получила права доступа к приложению.
"NetStream.Connect.Closed""cостояние"Подключение Р2Р успешно разорвано. Свойство info.stream указывает на то, что поток закрыт.
"NetStream.Connect.Failed""ошибка"Попытка подключения Р2Р не удалась. Свойство info.stream указывает на то, что поток не открыт.
"NetStream.Connect.Success""cостояние"Попытка подключения Р2Р удалась. Свойство info.stream указывает на то, что поток открыт.
"NetStream.Connect.Rejected""ошибка"Попытка подключения Р2Р не получила права доступа к приложению. Свойство info.stream указывает на то, что поток отклонен.
"NetConnection.Connect.AppShutdown""ошибка"Завершается работа указанного приложения.
"NetConnection.Connect.InvalidApp""ошибка"При подключении указано недопустимое имя приложения.
"SharedObject.Flush.Success""cостояние"Состояние ожидания "pending" разрешено, и вызов SharedObject.flush() выполнен успешно.
"SharedObject.Flush.Failed""ошибка"Состояние ожидания "pending" разрешено, но вызов SharedObject.flush() не удался.
"SharedObject.BadPersistence""ошибка"Запрос на создание общего объекта с флагами постоянства отправлен, но не удовлетворен, так как объект уже создан с другими флагами.
"SharedObject.UriMismatch""ошибка"Предпринята попытка подключения к объекту NetConnection, URI (URL) которого не совпадает с общим объектом.

Если постоянно появляются ошибки, связанные с буфером, попробуйте изменить его с помощью свойства NetStream.bufferTime.



Реализация
    public function get info():Object
    public function set info(value:Object):void

См. также

Сведения о конструкторе
NetStatusEvent()Конструктор
public function NetStatusEvent(type:String, bubbles:Boolean = false, cancelable:Boolean = false, info:Object = null)

Язык версии : ActionScript 3.0
Версии среды выполнения:  1.0 9

Создает объект Event, содержащий сведения о событиях netStatus. Объекты Event передаются прослушивателям событий в качестве параметров.

Параметры
type:String — Тип события. Прослушиватели событий могут получать эту информацию через унаследованное свойство type. Существует только один тип события состояния: NetStatusEvent.NET_STATUS.
 
bubbles:Boolean (default = false) — Определяет, участвует ли объект Event на этапе восходящей цепочки процесса события. Прослушиватели событий могут получать эту информацию через унаследованное свойство bubbles.
 
cancelable:Boolean (default = false) — Определяет, можно ли отменить объект Event. Прослушиватели событий могут получать эту информацию через унаследованное свойство cancelable.
 
info:Object (default = null) — Объект, содержащий свойства, описывающие состояние объекта. Прослушиватели событий могут получать этот объект через свойство info.

См. также

Сведения о методе
clone()метод
override public function clone():Event

Язык версии : ActionScript 3.0
Версии среды выполнения:  1.0 9

Создает копию объекта NetStatusEvent и задает значение каждого свойства, совпадающее с оригиналом.

Возвращает
Event — Новый объект NetStatusEvent, значения свойств которого соответствуют значениям оригинала.
toString()метод 
override public function toString():String

Язык версии : ActionScript 3.0
Версии среды выполнения:  1.0 9

Возвращает строку, содержащую все свойства объекта NetStatusEvent. Строка имеет следующий формат:

[NetStatusEvent type=значение bubbles=значение cancelable=значение info=значение]

Возвращает
String — Строка, содержащая все свойства объекта NetStatusEvent.
Сведения о константе
NET_STATUSКонстанта
public static const NET_STATUS:String = "netStatus"

Язык версии : ActionScript 3.0
Версии среды выполнения:  1.0 9

Задает значение свойства type для объекта события netStatus.

Данное событие имеет следующие свойства.

СвойствоЗначение
bubblesfalse
cancelablefalse; нет поведения по умолчанию для отмены.
currentTargetОбъект, активно обрабатывающий объект Event с помощью прослушивателя событий.
infoОбъект со свойствами, описывающими состояние объекта или условие ошибки.
targetОбъект NetConnection или NetStream, сообщающий свое состояние.

См. также

Примеры Как пользоваться примерами
NetStatusEventExample.as

В следующем примере объект Video с классами NetConnection и NetStream используется для загрузки и воспроизведения FLV-файла.

Здесь метод netStatusHandler регистрируется в качестве прослушивателя события NetStatusEvent — NetConnection.netStatus. Когда определяется состояние (успешно или неуспешно) попытки выполнить NetConnection.connect(), событие netStatus запускает этот метод. Если попытка подключиться к объекту NetConnection успешная (другими словами, если свойство info объекта NetStatusEvent, отправленного событием netStatus, имеет свойство code с указанием успешного выполнения), код создает объекты Video и NetStream и вызывает методы Video.attachNetStream() и NetStream.play().

Примечание. Чтобы запустить данный пример, вам потребуется FLV-файл, имя и место расположения которого совпадают с переменной, переданной videoURL. В данном случае, FLV-файл Video.flv находится в том же каталоге, где размещается SWF-файл.


 package {
    import flash.display.Sprite;
    import flash.events.*;
    import flash.media.Video;
    import flash.net.NetConnection;
    import flash.net.NetStream;

    public class NetStatusEventExample extends Sprite {
        private var videoURL:String = "Video.flv";
        private var connection:NetConnection;
        private var stream:NetStream;

        public function NetStatusEventExample() {
            connection = new NetConnection();
            connection.addEventListener(NetStatusEvent.NET_STATUS, netStatusHandler);
            connection.addEventListener(SecurityErrorEvent.SECURITY_ERROR, securityErrorHandler);
            connection.connect(null);
        }

        private function netStatusHandler(event:NetStatusEvent):void {
            switch (event.info.code) {
                case "NetConnection.Connect.Success":
                    connectStream();
                    break;
                case "NetStream.Play.StreamNotFound":
                    trace("Unable to locate video: " + videoURL);
                    break;
            }
        }

        private function connectStream():void {
            var stream:NetStream = new NetStream(connection);
            stream.addEventListener(NetStatusEvent.NET_STATUS, netStatusHandler);
            stream.addEventListener(AsyncErrorEvent.ASYNC_ERROR, asyncErrorHandler);
            var video:Video = new Video();
            video.attachNetStream(stream);
            stream.play(videoURL);
            addChild(video);
        }

        private function securityErrorHandler(event:SecurityErrorEvent):void {
            trace("securityErrorHandler: " + event);
        }
        
        private function asyncErrorHandler(event:AsyncErrorEvent):void {
            // ignore AsyncErrorEvent events.
        }

    }
 }