Пакет | flash.events |
Класс | public class NetStatusEvent |
Наследование | NetStatusEvent Event Object |
Язык версии: | ActionScript 3.0 |
Версии среды выполнения: | AIR 1.0, Flash Player 9, Flash Lite 4 |
NetStatusEvent.NET_STATUS
.
Связанные элементы API
Свойство | Определено | ||
---|---|---|---|
bubbles : Boolean [только для чтения]
Определяет, является ли событие событием восходящей цепочки. | Event | ||
cancelable : Boolean [только для чтения]
Указывает, можно ли предотвратить поведение, связанное с событием. | Event | ||
constructor : Object
Ссылка на объект класса или функцию конструктора для данного экземпляра объекта. | Object | ||
currentTarget : Object [только для чтения]
Объект, активно обрабатывающий объект Event с помощью прослушивателя событий. | Event | ||
eventPhase : uint [только для чтения]
Текущая фаза в потоке событий. | Event | ||
info : Object
Объект со свойствами, описывающими состояние объекта или условие ошибки. | NetStatusEvent | ||
target : Object [только для чтения]
Целевой объект события. | Event | ||
type : String [только для чтения]
Тип события. | Event |
Метод | Определено | ||
---|---|---|---|
NetStatusEvent(type:String, bubbles:Boolean = false, cancelable:Boolean = false, info:Object = null)
Создает объект Event, содержащий сведения о событиях netStatus. | NetStatusEvent | ||
[переопределить]
Создает копию объекта NetStatusEvent и задает значение каждого свойства, совпадающее с оригиналом. | NetStatusEvent | ||
Служебная функция для реализации метода toString() в пользовательских классах ActionScript 3.0 Event. | Event | ||
Показывает, определено ли заданное свойство для объекта. | Object | ||
Проверяет, выполнялся ли для события вызова метода preventDefault(). | Event | ||
Показывает, есть ли экземпляр класса Object в цепи прототипов объекта, заданного в качестве параметра. | Object | ||
Отменяет поведение по умолчанию для события, если такое поведение можно отменить. | Event | ||
Показывает наличие заданного свойства и его перечисляемость. | Object | ||
Задает доступность динамического свойства для операций цикла. | Object | ||
Отменяет обработку прослушивателей событий в текущем узле, а также во всех узлах, которые следуют в потоке событий за текущим узлом. | Event | ||
Отменяет обработку прослушивателей событий в узлах, которые следуют в потоке событий за текущим узлом. | Event | ||
Возвращает строковое представление этого объекта, отформатированного в соответствии со стандартами, принятыми для данной локали. | Object | ||
[переопределить]
Возвращает строку, содержащую все свойства объекта NetStatusEvent. | NetStatusEvent | ||
Возвращает элементарное значение заданного объекта. | Object |
Константа | Определено | ||
---|---|---|---|
NET_STATUS : String = "netStatus" [статические]
Задает значение свойства type для объекта события netStatus. | NetStatusEvent |
info | свойство |
info:Object
Язык версии: | ActionScript 3.0 |
Версии среды выполнения: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Объект со свойствами, описывающими состояние объекта или условие ошибки.
Информационный объект может иметь свойство code
, содержащее строку, представляющую конкретное событие, или свойство level
, содержащее строку, являющуюсяstatus
или error
.
Информационный объект может быть и другим. Свойства code
и level
могут не поддерживаться для некоторых реализаций, также некоторые серверы могут отправлять другие объекты.
Подключения P2P отправляют сообщения для NetConnection
с параметром stream
в информационном объекте, который указывает, к какому объекту NetStream
относится сообщение.
Например, система Flex Data Services отправляет объекты Message, которые являются причиной ошибок поведения типа данных, при попытке доступа к свойству code
или level
.
В следующей таблице описываются возможные строковые значения свойств code
и level
.
Свойство code | Свойство level | Значение |
---|---|---|
"NetConnection.Call.BadVersion" | "error" | Пакет закодирован в неопределенном формате. |
"NetConnection.Call.Failed" | "error" | Методу NetConnection.call() не удалось вызвать метод или команду на сервере. |
"NetConnection.Call.Prohibited" | "error" | Выполнение операции Action Message Format (AMF) предотвращено по соображениям безопасности. Либо URL-адрес AMF не принадлежит тому же домену, что и файл, содержащий код, который вызывает метод NetConnection.call() , либо на сервере AMF отсутствует файл политики, устанавливающий отношения доверия с доменом файла, содержащего код, который вызывает метод NetConnection.call() . |
"NetConnection.Connect.AppShutdown" | "error" | Завершается работа серверного приложения. |
"NetConnection.Connect.Closed" | status | Подключение успешно разорвано. |
"NetConnection.Connect.Failed" | "error" | Попытка подключения не удалась. |
"NetConnection.Connect.IdleTimeout" | status | Сервер Flash Media Server отключил клиента, поскольку время бездействия клиента превысило значение, настроенное для параметра <MaxIdleTime> . На сервере Flash Media Server параметр <AutoCloseIdleClients> отключен по умолчанию. При включении время ожидания по умолчанию равно 3600 секундам (1 час). Для получения дополнительной информации см. веб-страницу «Закрытие ожидающих подключений». |
"NetConnection.Connect.InvalidApp" | "error" | Имя приложения, указанное в вызове метода NetConnection.connect() , является недействительным. |
"NetConnection.Connect.NetworkChange" | status | Flash Player обнаружил изменение в сети, например, разорвано беспроводное подключение, успешно установлено беспроводное подключение, или отключен сетевой кабель. Используйте это событие для проверки изменений в сетевом интерфейсе. Не используйте это событие для внедрения логики повторного подключения NetConnection. Используйте |
"NetConnection.Connect.Rejected" | "error" | При попытке подключения отсутствовали права на доступ к приложению. |
"NetConnection.Connect.Success" | status | Попытка подключения удалась. |
"NetGroup.Connect.Failed" | "error" | Попытка подключения NetGroup не удалась. Свойство info.group указывает, какой объект NetGroup не удалось создать. |
"NetGroup.Connect.Rejected" | "error" | Объект NetGroup не авторизован. Свойство info.group указывает, какому объекту NetGroup не предоставлена авторизация. |
"NetGroup.Connect.Success" | status | Объект NetGroup успешно создан и авторизован. Свойство info.group указывает, какой объект NetGroup yспешно создан. |
"NetGroup.LocalCoverage.Notify" | status | Отправляется, когда меняется часть пространства групповых адресов, за которые отвечает данный узел. |
"NetGroup.MulticastStream.PublishNotify" | status | Отправляется, когда в группе NetGroup обнаруживается новый именованный поток. Свойство info.name:String содержит имя обнаруженного потока. |
"NetGroup.MulticastStream.UnpublishNotify" | status | Отправляется, когда именованный поток перестает быть доступным в группе. Свойство info.name:String содержит имя пропавшего потока. |
"NetGroup.Neighbor.Connect" | status | Отправляется, когда к этому узлу подключается соседний. Свойство info.neighbor:String содержит групповой адрес соседнего узла. Свойство info.peerID:String содержит идентификатор соседнего однорангового узла. |
"NetGroup.Neighbor.Disconnect" | status | Отправляется, когда от этого узла отключается соседний. Свойство info.neighbor:String содержит групповой адрес соседнего узла. Свойство info.peerID:String содержит идентификатор соседнего однорангового узла. |
"NetGroup.Posting.Notify" | status | Отправляется при получении новой групповой публикации. Свойство info.message:Object представляет собой сообщение. Свойство info.messageID:String содержит идентификатор этого сообщения (messageID). |
"NetGroup.Replication.Fetch.Failed" | status | Отправляется, когда не удается отправить запрос на получение (объявленный с помощью NetGroup.Replication.Fetch.SendNotify) или когда он отклоняется. Если запрашиваемый объект по-прежнему нужен, будут предприниматься новые попытки. Свойство info.index:Number содержит индекс запрашиваемого объекта. |
"NetGroup.Replication.Fetch.Result" | status | Отправляется, когда соседний узел удовлетворяет запрос на получение. Свойство info.index:Number содержит индекс результирующего объекта. Свойство info.object:Object содержит значение этого объекта. Этот индекс автоматически удаляется из набора запрашиваемых объектов (Want). Если объект недействителен, этот индекс можно добавить в набор запрашиваемых объектов (Want) с помощью метода NetGroup.addWantObjects() . |
"NetGroup.Replication.Fetch.SendNotify" | status | Отправляется, когда система репликации объектов готовится отправить соседнему узлу запрос на объект. Свойство info.index:Number содержит индекс запрашиваемого объекта. |
"NetGroup.Replication.Request" | status | Отправляется после того, как соседний узел запросил объект, объявленный этим узлом с помощью метода NetGroup.addHaveObjects() . В качестве ответа на этот запрос должен быть вызван метод NetGroup.writeRequestedObject() или NetGroup.denyRequestedObject() . Обратите внимание, что ответ может быть асинхронным. Свойство info.index:Number содержит индекс запрашиваемого объекта. Свойство info.requestID:int содержит идентификатор этого запроса, который должен быть использован при вызове метода NetGroup.writeRequestedObject() или NetGroup.denyRequestedObject() . |
"NetGroup.SendTo.Notify" | status | Отправляется при получении сообщения, отправленного этому узлу. Свойство info.message:Object представляет собой сообщение. Свойство info.from:String является объектом groupAddress, с которого отправлено полученное сообщение. Свойство info.fromLocal:Boolean имеет значение TRUE , если сообщение отправлено этим узлом (с учетом того, что локальный узел является ближайшим к групповому адресу назначения), или значение FALSE , если сообщение получено с другого узла. Чтобы обеспечить рекурсивную маршрутизацию, сообщение необходимо повторно отправить с помощью метода NetGroup.sendToNearest() , если свойство info.fromLocal имеет значение FALSE . |
"NetStream.Buffer.Empty" | status | Flash Player не получает данные достаточно быстро для заполнения буфера. Поток данных прерывается до повторного заполнения буфера, после чего отправляется сообщение NetStream.Buffer.Full , и возобновляется потоковое воспроизведение. |
"NetStream.Buffer.Flush" | status | Потоковое воспроизведение данных прекратилось, оставшийся буфер очищается. Примечание. Не поддерживается в среде AIR 3.0 для iOS. |
"NetStream.Buffer.Full" | status | Буфер заполнен, начинается потоковое воспроизведение. |
"NetStream.Connect.Closed" | status | Подключение Р2Р успешно разорвано. Свойство info.stream указывает на то, что поток закрыт. Примечание. Не поддерживается в среде AIR 3.0 для iOS. |
"NetStream.Connect.Failed" | "error" | Попытка подключения Р2Р не удалась. Свойство info.stream указывает на то, что поток не открыт. Примечание. Не поддерживается в среде AIR 3.0 для iOS. |
"NetStream.Connect.Rejected" | "error" | При попытке подключения Р2Р отсутствовали права на доступ к другому одноранговому приложению. Свойство info.stream указывает на то, что поток отклонен. Примечание. Не поддерживается в среде AIR 3.0 для iOS. |
"NetStream.Connect.Success" | status | Попытка подключения Р2Р удалась. Свойство info.stream указывает на то, что поток открыт. Примечание. Не поддерживается в среде AIR 3.0 для iOS. |
"NetStream.DRM.UpdateNeeded" | status | Объект NetStream пытается воспроизвести защищенное содержимое, но необходимый модуль Flash Access отсутствует, запрещен текущей политикой для содержимого или несовместим с текущим экземпляром проигрывателя. Чтобы обновить модуль или проигрыватель, используйте метод update() класса flash.system.SystemUpdater. Примечание. Не поддерживается в среде AIR 3.0 для iOS. |
"NetStream.Failed" | "error" | (Flash Media Server) Произошла ошибка по причине, не указанной среди других кодов событий. |
"NetStream.MulticastStream.Reset" | status | Групповая подписка изменила фокус на другой поток, опубликованный с тем же именем в той же группе. Локальные переопределения параметров потока многоадресной рассылки потеряны. Повторно примените локальные переопределения, в противном случае будут использованы параметры по умолчанию нового потока. |
"NetStream.Pause.Notify" | status | Поток приостановлен. |
"NetStream.Play.Failed" | "error" | Произошла ошибка при воспроизведении по причине, не указанной в таблице, например, у подписчика нет доступа для чтения. Примечание. Не поддерживается в среде AIR 3.0 для iOS. |
"NetStream.Play.FileStructureInvalid" | "error" | (AIR и Flash Player 9.0.115.0) Приложение обнаруживает недопустимую структуру файла и не будет пытаться воспроизвести данный тип файла. Примечание. Не поддерживается в среде AIR 3.0 для iOS. |
"NetStream.Play.InsufficientBW" | "warning" | (Flash Media Server) Пропускной способности клиента недостаточно для воспроизведения данных с нормальной скоростью. Примечание. Не поддерживается в среде AIR 3.0 для iOS. |
"NetStream.Play.NoSupportedTrackFound" | status | (AIR и Flash Player 9.0.115.0) Приложение не обнаруживает поддерживаемых каналов (видео, аудио или данных) и не будет пытаться воспроизвести файл. Примечание. Не поддерживается в среде AIR 3.0 для iOS. |
"NetStream.Play.PublishNotify" | status | Исходная публикация потока отправляется всем подписчикам. |
"NetStream.Play.Reset" | status | Вызвано сбросом списка воспроизведения. Примечание. Не поддерживается в среде AIR 3.0 для iOS. |
"NetStream.Play.Start" | status | Началось воспроизведение. |
"NetStream.Play.Stop" | status | Воспроизведение остановлено. |
"NetStream.Play.StreamNotFound" | "error" | FLV-файл, переданный методу NetStream.play() , не найден. |
"NetStream.Play.Transition" | status | (Flash Media Server 3.5) Сервер получает команду перехода к другому потоку в результате переключения потока битовой передачи данных. Данный код означает состояние успешного выполнения вызова NetStream.play2() для инициации переключения потоков. Если переключение не выполнено, сервер отправляет событие NetStream.Play.Failed . При переключении потока выполняется отправка события onPlayStatus с кодом NetStream.Play.TransitionComplete. Для проигрывателя Flash Player версии 10 и более поздних версий. Примечание. Не поддерживается в среде AIR 3.0 для iOS. |
"NetStream.Play.UnpublishNotify" | status | Отмена публикации потока отправляется всем подписчикам. |
"NetStream.Publish.BadName" | "error" | Попытка опубликовать поток, уже публикуемый другим пользователем. |
"NetStream.Publish.Idle" | status | Сервер публикации потока свободен и не передает данных. |
"NetStream.Publish.Start" | status | Публикация выполнена успешно. |
"NetStream.Record.AlreadyExists" | status | Записываемый поток соответствует файлу, в который уже выполняется запись другим потоком. Такая ситуация может возникнуть при неправильной настройке виртуальных каталогов. |
NetStream.Record.Failed | "error" | Попытка записи потока не удалась. |
"NetStream.Record.NoAccess" | "error" | Попытка записать поток, который все еще воспроизводится или к которому у клиента нет права доступа. |
"NetStream.Record.Start" | status | Началась запись. |
"NetStream.Record.Stop" | status | Запись остановлена. |
"NetStream.SecondScreen.Start" | "status" | Отправляется при запуске сеанса PlayTo. Поле описания, прикрепленное к этому событию, будет содержать имя устройства, которое будет получать видеоданные. Применимо только к Windows 8.1, IE11, современный режим. |
"NetStream.SecondScreen.Stop" | "status" | Отправляется при окончании сеанса PlayTo. Применимо только к Windows 8.1, IE11, современный режим. |
"NetStream.Seek.Failed" | "error" | Невозможно выполнить поиск, если поток не поддерживает поиск. |
"NetStream.Seek.InvalidTime" | "error" | В ходе последовательной загрузки видео в пользователь попытался найти или воспроизвести еще не загруженные на данный момент видеоданные или данные, находящиеся за пределами полностью загруженного файла. Свойство info.details объекта события содержит временной код, указывающий последнюю действительную позицию, доступную для поиска. |
"NetStream.Seek.Notify" | status | Операция поиска выполнена. Отправляется, когда метод |
"NetStream.Step.Notify" | status | Операция шага выполнена. Примечание. Не поддерживается в среде AIR 3.0 для iOS. |
"NetStream.Unpause.Notify" | status | Поток возобновлен. |
"NetStream.Unpublish.Success" | status | Операция отмены публикации выполнена успешно. |
"SharedObject.BadPersistence" | "error" | Запрос на создание общего объекта с флагами постоянства отправлен, но не удовлетворен, так как объект уже создан с другими флагами. |
"SharedObject.Flush.Failed" | "error" | Состояние ожидания pending разрешено, но вызов SharedObject.flush() не удался. |
"SharedObject.Flush.Success" | status | Состояние ожидания pending разрешено, и вызов SharedObject.flush() выполнен успешно. |
"SharedObject.UriMismatch" | "error" | Предпринята попытка подключения к объекту NetConnection, URI (URL) которого не совпадает с общим объектом. |
"NetStream.Video.DimensionChange" | status | Размеры видео доступны или изменились. Используйте свойство videoWidth/videoHeight для Video или StageVideo, чтобы запросить новые размеры видео. Новые возможности Flash Player 11.4/AIR 3.4. |
Если постоянно появляются ошибки, связанные с буфером, попробуйте изменить его с помощью свойства NetStream.bufferTime
.
Реализация
public function get info():Object
public function set info(value:Object):void
Связанные элементы API
Пример ( Использование этого примера )
NetStream.Seek.InvalidTime
. Ошибка NetStream.Seek.InvalidTime
происходит, когда пользователь пытается выполнить поиск точки воспроизведения, которая находится за пределами загруженного потока. В этом примере проверяется значение свойства info.code
объекта события. Если возникает ошибка, свойству eventObj.info.details
назначается переменная, которая должна использоваться в качестве параметра для метода seek()
потока. Свойство eventObj.info.details
содержит последнее имеющееся допустимое положение для обработки ошибки. Таким образом, пользователь переходит к допустимому месту в конце загруженного потока.
function videoStatus(eventObj:NetStatusEvent):Void { switch(eventObj.info.code) { case "NetStream.Seek.InvalidTime": { var validSeekTime:Number = eventObj.info.details; nStream.seek(validSeekTime); break; } } }
NetStatusEvent | () | Конструктор |
public function NetStatusEvent(type:String, bubbles:Boolean = false, cancelable:Boolean = false, info:Object = null)
Язык версии: | ActionScript 3.0 |
Версии среды выполнения: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Создает объект 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 .
|
Связанные элементы API
clone | () | метод |
override public function clone():Event
Язык версии: | ActionScript 3.0 |
Версии среды выполнения: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Создает копию объекта NetStatusEvent и задает значение каждого свойства, совпадающее с оригиналом.
ВозвращаетEvent — Новый объект NetStatusEvent, значения свойств которого соответствуют значениям оригинала.
|
toString | () | метод |
override public function toString():String
Язык версии: | ActionScript 3.0 |
Версии среды выполнения: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Возвращает строку, содержащую все свойства объекта NetStatusEvent. Строка имеет следующий формат:
[NetStatusEvent type=value bubbles=value cancelable=value info=value]
String — Строка, содержащая все свойства объекта NetStatusEvent.
|
NET_STATUS | Константа |
public static const NET_STATUS:String = "netStatus"
Язык версии: | ActionScript 3.0 |
Версии среды выполнения: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Задает значение свойства type
для объекта события netStatus
.
Это событие имеет следующие свойства:
Свойство | Значение |
---|---|
bubbles | false |
cancelable | false ; поведение по умолчанию, подлежащее отмене, не определено. |
currentTarget | Объект, активно обрабатывающий объект Event с помощью прослушивателя событий. |
info | Объект со свойствами, описывающими состояние объекта или условие ошибки. |
target | Объект NetConnection или NetStream, сообщающий свое состояние. |
Связанные элементы API
Здесь метод 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. } } }
Tue Jun 12 2018, 11:34 AM Z