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

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

Тип прокси, используемый для успешного вызова NetConnection.connect() в отношении сервера Flash Media Server: none, HTTP, HTTPS или CONNECT. Значение none используется при подключении без туннелирования, HTTP — при подключении посредством туннелирования по протоколу HTTP, HTTPS — при подключении посредством туннелирования по протоколу HTTPS, CONNECT — при подключении посредством туннелирования с использованием метода HTTP CONNECT.

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

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

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

Более подробные сведения см. в описании свойства objectEncoding.

См. также

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

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

Общее количество входящих и исходящих одноранговых подключений, разрешенное данным экземпляром 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, подключающихся к данному экземпляру.

См. также

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

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

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

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

• Подключение к серверу, поддерживающему AMF3 (например, Flex Data Services 2 или Flash Media Server 3). Значение defaultObjectEncoding по умолчанию: ObjectEncoding.AMF3. Все экземпляры NetConnection, созданные в данном SWF-файле, используют сериализацию AMF3, поэтому нет необходимости указывать проигрывателю Flash Player требуемую кодировку AMF.
• Подключение к серверу, который не поддерживает 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 становится доступным только для чтения.

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

См. также

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

• "rtmp": RTMP
• "rtmpe": расширенный RTMP
• "rtmpt": RTMP с НТТР-туннелированием
• "rtmpte": расширенный RTMP с НТТР-туннелированием
• "rtmps": RTMP на базе HTTPS
• "rtmfp": RTMFP

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

Допустимые значения: none, HTTP, CONNECT и best.

В проигрывателе Flash Player 9 значением по умолчанию для данного свойства является none. Если это значение не будет изменено, Flash Player будет использовать для RTMPS туннелирование по протоколу HTTPS. Если свойство имеет значение best, клиент предпринимает попытку подключиться с помощью собственного протокола SSL. После неудачного подключения проводятся попытки применения других способов подключения. Если свойство имеет значение "HTTP" и прямое подключение приводит к сбою, используется туннелирование по протоколу HTTP. Если свойство имеет значение "CONNECT" и прямое подключение приводит к сбою, используется метод туннелирования CONNECT. Если и это приведет к сбою, подключение не будет возвращаться к туннелированию по протоколу HTTP.

Примечание. В проигрывателе Flash Player 9 данное свойство применяется только при использовании RTMP, RTMPS или RTMPT. Метод CONNECT применим только к тем пользователям, которые подключены к сети с помощью прокси-сервера.

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

См. также

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

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

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

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

См. также

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

Параметры

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

Нельзя подключаться к общепринятым зарезервированным портам. Полный список заблокированных портов см. в разделе "Ограничение сетевых API-интерфейсов" в главе "Безопасность" книги Программирование на ActionScript 3.0.

Параметры

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

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

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

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

См. также

Создает двунаправленное соединение между проигрывателем Flash Player и приложением Flash Media Server. Объект NetConnection представляет собой определенный канал (трубу) между клиентом и сервером. Используйте объекты NetStream для отправки потоков по каналу. Информацию о кодеках и форматах видеофайлов, поддерживаемых Flash Media Server, см. в документации по серверу Flash Media Server.

При отсутствии Flash Media Server метод NetConnection.connect() можно использовать для воспроизведения видео и MP3-файлов из локальной файловой системы или с веб-сервера. Информацию о поддерживаемых кодеках и форматах файлов см. по адресу http://www.adobe.com/go/hardware_scaling_ru.

Создает двунаправленное соединение между проигрывателем Flash Player и сервером приложений, на котором запущен компонент Flash Remoting. Используйте класс NetServices для вызова функций и получения результатов от серверов приложений посредством объекта NetConnection. Дополнительные сведения см. в документации по Flash Remoting.

При использовании данного метода необходимо продумать модель безопасности проигрывателя Flash Player и принять во внимание следующие соображения безопасности:

• По умолчанию проигрыватель Flash Player блокирует взаимодействие (доступ) между изолированными программными средами. Веб-сайт может обеспечить доступ к ресурсу с помощью файла политик для URL.
• Ваше приложение может запретить доступ к какому-либо ресурсу на сервере. Чтобы запретить доступ, в приложении Flash Media Server необходимо добавить код на стороне сервера. Подробные сведения см. в документации по Flash Media Server.
• Метод NetConnection.connect() нельзя использовать, если вызывающий SWF-файл размещен в изолированной программной среде "local-with-file-system".
• Нельзя подключаться к общепринятым зарезервированным портам. Полный список заблокированных портов см. в разделе "Ограничение сетевых API-интерфейсов" в главе "Безопасность" книги Программирование на ActionScript 3.0.
• Можно запретить использование SWF-файлом этого метода путем установки параметра allowNetworking для тегов object и embed на странице HTML, содержащей SWF-содержимое.

Дополнительные сведения см. в следующих источниках.

• Глава о безопасности в книге Программирование на ActionScript 3.0 и последние комментарии на странице LiveDocs.
• Раздел центра разработки Flash Player: Безопасность

Параметры

См. также

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

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

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

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

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

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

См. также

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

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

См. также

В данном примере код, создающий объекты 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 = "Video.flv";
        private var connection:NetConnection;
        private var stream:NetStream;

        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 {
            var stream:NetStream = new NetStream(connection);
            stream.addEventListener(NetStatusEvent.NET_STATUS, netStatusHandler);
            stream.client = new CustomClient();
            var video:Video = new Video();
            video.attachNetStream(stream);
            stream.play(videoURL);
            addChild(video);
        }
    }
}

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);
    }
}