NetConnection  - AS3

Указывает объект, для которого вызываются методы ответного вызова. По умолчанию используется данный экземпляр NetConnection. Если в свойстве client указать другой объект, методы обратного вызова будут вызываться на этом другом объекте.

Указывает, подключено приложение к серверу через постоянное подключение RTMP (true) или нет (false). При подключении по протоколу HTTP данное свойство имеет значение false, за исключением случаев подключения к службам Flash Remoting на сервере приложений (значение true).

Прокси-сервер, используемый для успешного подключения к Flash Media Server. Возможные значения: "none", "HTTP", "HTTPS" или "CONNECT".

Значение "none" задается, если подключение выполняется без туннелирования или если используется собственное подключение через SSL.

Значение "HTTP" задается, если подключение туннелируется через HTTP.

Значение "HTTPS" задается, если подключение туннелируется через HTTPS.

Значение "CONNECT" задается, если подключение туннелируется с использованием метода CONNECT через прокси-сервер.

Кодировка объекта, используемая по умолчанию для объектов NetConnection. Когда объект записывается или считывается из двоичных данных, свойство defaultObjectEncoding указывает используемую для сериализации версию формата AMF: формат ActionScript 3.0 (ObjectEncoding.AMF3) или формат ActionScript 1.0 и ActionScript 2.0 (ObjectEncoding.AMF0).

Значение по умолчанию: ObjectEncoding.AMF3. Изменение NetConnection.defaultObjectEncoding не влияет на существующие экземпляры NetConnection, а влияет только на экземпляры, которые будут созданы позднее.

Чтобы установить кодировку для отдельного объекта (не для всего приложения), задайте свойство objectEncoding соответствующего объекта NetConnection.

Дополнительные сведения см. в описании свойства objectEncoding.

Связанные элементы API

Идентификатор экземпляра Flash Media Server, к которому подключен данных экземпляр Flash Player или Adobe AIR. Это свойство имеет значение только для подключений RTMFP. Значение этого свойства доступно только после установки подключения RTMFP.

Связанные элементы API

Значение, выбираемое преимущественно этим сервером Flash Media Server (уникально для данного подключения). Это значение представляется серверу в качестве его значения client.nearNonce. Это свойство определяется только для подключений RTMFP, RTMPE и RTMPTE.

Время ожидания ответа HTTP в миллисекундах. По умолчанию установлено значение 0.

• httpIdleTimeout значение - a Число.
• При использовании HTTP-подключения положительное значение обозначает число миллисекунд, неактивное подключение должно остаться открытым.
• Нулевое значение обозначает, что стандартное сетевое значение перерыва ожидания для платформы должно использоваться.
• Отрицательная величина приведет к ошибке RangeError.
• Если httpIdleTimeout значение превышено, a netStatus событие отправлено.
• Эти свойства будут только влиять NetConnection объекты созданы с HTTP-подключениями. NetConnection объекты, созданные с RTMP, RTMFP, или другими каналами HTTP, остаются незатронутыми этими свойствами.

    //Set the timeout to 5 seconds
    connection = new NetConnection();
    connection.addEventListener(NetStatusEvent.NET_STATUS, netStatusHandler);
    connection.addEventListener(SecurityErrorEvent.SECURITY_ERROR, securityErrorHandler);
    connection.httpIdleTimeout = 5000;
    

Общее количество входящих и исходящих одноранговых подключений, разрешенное данным экземпляром Flash Player или Adobe AIR. Значением по умолчанию является 8.

Это значение не различает подключения издателей и подписчиков. Если это значение уменьшить в момент, когда уже существуют одноранговые подключения, новое значение затрагивает только новые входящие подключения. Существующие подключения не прерываются.

Идентификатор данного экземпляра Flash Player или Adobe AIR для данного экземпляра NetConnection. Это свойство имеет значение только для подключений RTMFP.

Каждый экземпляр NetConnection имеет уникальное свойство nearID. Все экземпляры Flash Player, Adobe AIR и NetConnection имеют разные идентификаторы.

Другие экземпляры Flash Player или Adobe AIR используют этот идентификатор в качестве peerID для новых подключений NetStream к этому клиенту. Впоследствии этот идентификатор становится farID в одноранговых NetStream, подключающихся к данному экземпляру.

Связанные элементы API

Значение, выбираемое преимущественно этим экземпляром Flash Player или Adobe AIR (уникально для данного подключения). Это значение представляется серверу в качестве его значения client.farNonce. Это свойство определяется только для подключений RTMFP, RTMPE и RTMPTE.

Кодировка объекта для данного экземпляра NetConnection.

Когда объект записывается или считывается из двоичных данных, свойство defaultObjectEncoding указывает используемую для сериализации версию формата AMF: формат ActionScript 3.0 (ObjectEncoding.AMF3) или формат ActionScript 1.0 и ActionScript 2.0 (ObjectEncoding.AMF0). Чтобы установить версию AMF для экземпляра NetConnection, укажите значение для свойства objectEncoding.

Необходимо хорошо понимать назначение этого свойства, если приложению требуется обмен данными с серверами, выпущенными до выхода Flash Player версии 9. Возможны три следующих сценария действий:

• Подключение к серверу, поддерживающему AMF3 (например, Flex Data Services 2 или Flash Media Server 3). Значение defaultObjectEncoding по умолчанию: ObjectEncoding.AMF3. Ко всем экземплярам NetConnection, созданным в данном файле, применяется сериализация формата AMF3, поэтому свойство objectEncoding задавать не требуется.
• Подключение к серверу, который не поддерживает AMF3 (например, Flash Media Server 2). В этом случае необходимо установить для статического свойства NetConnection.defaultObjectEncoding значение ObjectEncoding.AMF0. Все экземпляры NetConnection, созданные в данном SWF-файле, используют сериализацию AMF0. Нет необходимости устанавливать значение свойства objectEncoding.
• Подключение к нескольким серверам, на которых используются разные версии кодировки. Вместо того чтобы использовать defaultObjectEncoding, установите кодировку объекта для каждого подключения с помощью свойства objectEncoding. Установите значение ObjectEncoding.AMF0, чтобы подключаться к серверам, использующим кодировку AMF0 (например, Flash Media Server 2). Аналогично, установите значение ObjectEncoding.AMF3 для подключения к серверам, которые используют кодировку AMF3 (например, Flex Data Services 2).

Как только происходит подключение экземпляра NetConnection, его свойство objectEncoding становится доступным только для чтения.

Если при подключении к серверу используется неправильная кодировка, объект NetConnection отправляет событие netStatus. Свойство NetStatusEvent.info содержит информационный объект, в котором свойство code имеет значение NetConnection.Connect.Failed, и описание, объясняющее, что выбрана неправильная кодировка.

Связанные элементы API

Протокол, используемый для установки подключения. Это свойство релевантно при использовании Flash Media Server. Возможны следующие значения:

• rtmp: протокол передачи сообщений в реальном времени (RTMP)
• rtmpe: зашифрованный RTMP
• rtmpt: RTMP с НТТР-туннелированием
• rtmpte: зашифрованный RTMP с НТТР-туннелированием
• "rtmps": RTMP на базе HTTPS
• rtmfp: протокол потоковой передачи медиаданных в реальном времени (RTMFP)

Определяет, какие резервные методы подключения используются в случае сбоя при первоначальной попытке подключения к серверу Flash Media Server. Свойство proxyType необходимо задать до того, как будет вызываться метод NetConnection.connect().

Допустимыми являются значения "none", "HTTP", "CONNECTOnly", "CONNECT" и "best". По умолчанию используется значение "none".

Чтобы использовать собственное подключение через SSL, задайте свойству значение "best". Если проигрывателю не удается установить прямое подключение к серверу (через стандартный порт 443 или другой указанный порт) и развернут прокси-сервер, проигрыватель пытается использовать метод CONNECT. Если эта попытка не дает результатов, то выполняется туннелирование через HTTPS.

Если свойство имеет значение "CONNECTOnly", проигрыватель вначале пытается использовать метод CONNECT. Если использовать метод не удалось, резервного варианта не предусмотрено.

Если свойство имеет значение HTTP и прямое подключение выполняется с ошибкой, используется туннелирование по протоколу HTTP. Если свойство имеет значение CONNECT и прямое подключение выполняется с ошибкой, используется метод туннелирования CONNECT. Если и эта попытка не удастся, для подключения не используется туннелирование через HTTP.

Это свойство применяется только при использовании RTMP, RTMPS или RTMPT. Методы CONNECT и CONNECTOnly подходят только для тех пользователей, которые подключены к сети через прокси-сервер.

Объект, содержащий все объекты NetStream одноранговых подписчиков, не связанные с публикующими объектами NetStream. Объекты-подписчики NetStream, связанные с публикующими объектами NetStream, перечислены в массиве NetStream.peerStreams.

Связанные элементы API

URI-адрес, передаваемый методу NetConnection.connect(). Если метод NetConnection.connect() не был вызван или не был передан какой-либо URI-адрес, данное свойство имеет значение undefined.

Определяет, создавалось ли защищенное подключение с применением собственного протокола Transport Layer Security (TLS) вместо HTTPS. Это свойство действительно только тогда, когда подключен объект NetConnection.

Создает объект NetConnection. Чтобы установить подключение, вызовите метод connect().

Если приложению требуется связь с серверами, выпущенными до выхода Flash Player 9, необходимо задать свойство objectEncoding объекта NetConnection.

Следующий код создает объект NetConnection.

     var nc:NetConnection = new NetConnection();
     

Связанные элементы API

Добавляет заголовок контекста в структуру пакета Action Message Format (AMF). Этот заголовок отправляется с каждым последующим пакетом AMF. При вызове NetConnection.addHeader() с использованием того же самого имени новый заголовок заменяет существующий заголовок, при этом новый заголовок остается на всем протяжении существования объекта NetConnection. Для удаления заголовка, вызовите NetConnection.addHeader() с указанием имени заголовка для удаления объекта со значением undefined.

Параметры

Вызывает команду или метод на сервере Flash Media Server или на сервере приложений, на котором запущен компонент Flash Remoting. Перед тем как вызвать NetConnection.call(), необходимо подключиться к серверу путем вызова метода NetConnection.connect(). Для передачи данному методу необходимо создать функцию на стороне сервера.

Нельзя подключаться к общепринятым зарезервированным портам. Полный список заблокированных портов см. в разделе «Ограничение API-интерфейсов сетевого подключения» в руководстве ActionScript 3.0 Developer's Guide (руководстве разработчика по ActionScript 3.0).

Параметры

Связанные элементы API

Закрывает открытое локальное подключение или подключение на сервере и отправляет событие netStatus со значением NetConnection.Connect.Closed для свойства code.

Данный метод отсоединяет все объекты NetStream, функционирующие через это подключение. Любые неотправленные данные, помещенные в очередь, игнорируются. (Чтобы завершить локальные или серверные потоки, не закрывая при этом подключения, используйте NetStream.close().) Если после закрытия подключения требуется создать новое подключение, следует сначала создать новый объект NetConnection, а затем снова вызвать метод connect().

Метод close() также отсоединяет все удаленные общие объекты, функционирующие через это подключение. Тем не менее, для повторного подключения не требуется вновь создавать общий объект. Вместо этого следует просто вызвать метод SharedObject.connect(), чтобы восстановить подключение к общему объекту. Кроме того, любые данные в общем объекте, которые были поставлены в очередь при вызове NetConnection.close(), отправляются после того, как будет восстановлено подключение к общему объекту.

При работе с сервером Flash Media Server наиболее оптимальным вариантом является вызов close() в тот момент, когда клиенту больше не требуется подключение к серверу. Вызов close() является самым быстрым способом очистки неиспользуемых подключений. Можно настроить сервер на автоматическое закрытие неиспользуемых подключений. Дополнительные сведения см. в Руководстве по настройке и администрированию Flash Media Server.

Связанные элементы API

Создает двухстороннее подключение к приложению на сервере Flash Media Server или к службе Flash Remoting, или создает двухстороннюю сетевую конечную точку для связи в пределах одноранговой группы RTMFP. Чтобы сообщить о его состоянии или ошибке, вызов метода NetConnection.connect() отправляет событие netStatus.

Метод NetConnection.connect() позволяет выполнить следующие действия.

• Передайте значение null, чтобы воспроизвести видеосодержимое и файлы MP3 из локальной файловой системы или с веб-сервера.
• Передайте URL для http, чтобы подключиться к серверу приложений со службой Flash Remoting. Используйте класс NetServices для вызова функций и получения результатов от серверов приложений посредством объекта NetConnection. Дополнительные сведения см. в документации по Flash Remoting.
• Передайте URL-адрес для rtmp/e/s, чтобы подключиться к приложению на сервере Flash Media Server.
• Передайте в URL-адрес для rtmfp, чтобы создать двухстороннюю сетевую конечную точку между для связи RTMFP между клиентом и сервером, между одноранговыми узлами или для групповой адресации IP.
• Передайте строку «rtmfp:», чтобы создать бессерверную двухстороннюю сетевую конечную точку для связи RTMFP с групповой адресацией IP.

Рассмотрим следующую модель безопасности.

• По умолчанию проигрыватель Flash Player или AIR блокирует взаимодействие (доступ) между изолированными программными средами. Web-сайт может обеспечить доступ к ресурсу с помощью файла политики для URL.
• Ваше приложение может запретить доступ к какому-либо ресурсу на сервере. В приложении на сервере Flash Media Server, используйте серверный код ActionScript, чтобы запретить доступ. Сведения см. в документации по Flash Media Server.
• Метод NetConnection.connect() нельзя использовать, если вызывающий файл размещен в локальной для файловой системы изолированной программной среде.
• Нельзя подключаться к общепринятым зарезервированным портам. Полный список заблокированных портов см. в разделе «Ограничение API-интерфейсов сетевого подключения» в руководстве ActionScript 3.0 Developer's Guide (руководстве разработчика по ActionScript 3.0).
• Чтобы запретить использование этого метода SWF-файлом, установите параметр allowNetworking для тегов object и embed на странице HTML, содержащей SWF-содержимое.

Однако в Adobe AIR эти ограничения по безопасности не распространяются на содержимое в изолированной программной среде безопасности application (содержимое, установленное с приложением AIR).

Дополнительные сведения о безопасности см. в разделе центра разработчиков Adobe Flash Player Безопасность.

Параметры

Связанные элементы API

Отправляется, когда исключение создается асинхронным образом, то есть в коде, изначально имеющем асинхронную природу.

Это событие имеет следующие свойства:

Отправляется, когда происходит ошибка ввода-вывода, приводящая к сбою сетевой операции.

Это событие имеет следующие свойства:

Отправляется, когда объект NetConnection сообщает о своем состоянии или о случившейся ошибке. Событие netStatus содержит свойство info, представляющее собой информационный объект, который содержит определенные сведения о событии (например, количество успешных и неудачных попыток подключения).

Это событие имеет следующие свойства:

Связанные элементы API

Отправляется, если путем вызова метода NetConnection.call() предпринимается попытка подключения к серверу, расположенному за пределами изолированной среды вызывающего объекта.

Это событие имеет следующие свойства:

Связанные элементы API

В данном примере код, создающий объекты Video и NetStream, а также вызывающий методы Video.attachNetStream() и NetStream.play(), размещен в функции обработчика. Обработчик вызывается только при успешном подключении к объекту NetConnection (другими словами, когда событие netStatus возвращает объект info со свойством code, что свидетельствует об успешном выполнении задачи). Рекомендуется перед вызовом NetStream.play() дождаться успешного подключения.

package {
    import flash.display.Sprite;
    import flash.events.NetStatusEvent;
    import flash.events.SecurityErrorEvent;
    import flash.media.Video;
    import flash.net.NetConnection;
    import flash.net.NetStream;
    import flash.events.Event;

    public class NetConnectionExample extends Sprite {
        private var videoURL:String = "http://www.helpexamples.com/flash/video/cuepoints.flv";
        private var connection:NetConnection;
        private var stream:NetStream;
        private var video:Video = new Video();        

        public function NetConnectionExample() {
            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("Stream not found: " + videoURL);
                    break;
            }
        }

        private function securityErrorHandler(event:SecurityErrorEvent):void {
            trace("securityErrorHandler: " + event);
        }

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

class CustomClient {
    public function onMetaData(info:Object):void {
        trace("metadata: duration=" + info.duration + " width=" + info.width + " height=" + info.height + " framerate=" + info.framerate);
    }
    public function onCuePoint(info:Object):void {
        trace("cuepoint: time=" + info.time + " name=" + info.name + " type=" + info.type);
    }
}