Число секунд данных, в настоящий момент находящихся в буфере. Используя данное свойство вместе со свойством bufferTime, можно определить, насколько близок момент полного заполнения буфера (это необходимо, например, чтобы оповестить пользователя, ожидающего загрузки данных в буфер).

См. также

Определяет, как долго сообщения должны накапливаться в буфере до начала отображения потока. Например, для того чтобы первые 15 секунд потока воспроизводились без прерываний, следует установить для параметра bufferTime значение 15. Flash начнет воспроизведение потока только после того, как буферизацию пройдут 15 секунд данных.

Значение по умолчанию — 0,1 (одна десятая секунды). Определить количество секунд, которые в данный момент находятся в буфере, можно с помощью свойства bufferLength.

Примечание. Во избежание искажения при потоковой передаче предварительно записанного (не эфирного) содержимого, не задавайте для NetStream.bufferTime значение 0. По умолчанию проигрыватель Flash Player использует входящий буфер для предварительно записанного содержимого, который ставит данные в очередь и надлежащим образом их воспроизводит. Для предварительно записанного содержимого используйте параметр по умолчанию или увеличьте время буферизации.

Начиная с версии 9.0.115.0, проигрыватель Flash Player больше не очищает буфер при вызове метода NetStream.pause(). До версии 9.0.115.0, перед тем как продолжить воспроизведение, проигрыватель Flash Player находился в ожидании заполнения буфера, что часто вызывало задержку.

Для одиночной паузы свойство NetStream.bufferLength имеет ограничение в 60 секунд или удвоенное значение параметра NetStream.bufferTime (выбирается большее значение из двух). Например, если параметр bufferTime равен 20 секундам, то проигрыватель Flash Player заполняет буфер до тех пор, пока NetStream.bufferLength не примет верхнее значение 20*2 (40) или 60. В данном случае, буферизация проводится до того, как параметр bufferLength не будет иметь значение 60. Если параметр bufferTime равен 40 секундам, то проигрыватель Flash Player заполняет буфер до тех пор, пока NetStream.bufferLength не примет верхнее значение 40*2 (80) или 60. В этом случае буферизация проводится до того, как параметр bufferLength не будет иметь значение 80.

Свойство bufferLength также имеет абсолютный предел. Если любой вызов pause() приводит к тому, что значение параметра bufferLength увеличивается на 600 секунд или на значение bufferTime * 2 (выбирается наибольшее из двух), проигрыватель Flash Player очищает буфер и устанавливает для параметра bufferLength значение, равное 0. Например, если значение параметра bufferTime равно 120 секундам, проигрыватель Flash Player заполняет буфер до тех пор, пока параметр bufferLength не примет значение в 600 секунд. Если значение параметра bufferTime — 360 секунд, то Flash Player заполняет буфер до тех пор, пока bufferLength не станет равным 720 секундам.

Совет: Метод NetStream.pause() можно использовать в коде для буферизации данных в тот момент, например, когда зрители смотрят рекламу, и последующего воспроизведения потока в начале основной видеопрограммы.

Дополнительные сведения о новых возможностях механизма паузы см. по адресу http://www.adobe.com/go/learn_fms_smartpause_ru.

Flash Media Server. Поведение буфера зависит от того, в отношении какого потока установлено время буферизации: публикующего или подписывающего. Для публикующего потока параметр bufferTime указывает, как долго может расширяться исходящий буфер до тех пор, пока проигрыватель Flash не начнет пропускать кадры. При высокоскоростном подключении время буферизации не столь важно — данные будут отправляться настолько же быстро, насколько быстро проигрыватель сможет поместить их в буфер. Однако при медленном подключении может появиться существенная разница между тем, как быстро проигрыватель Flash помещает данные в буфер, и тем, с какой скоростью эти данные он может отправить клиенту.

Для подписывающего потока параметр bufferTime указывает, как долго может происходить буферизация входящих данных до того, как поток будет отображаться на экране. Например, для того чтобы первые 15 секунд потока воспроизводились без прерываний, следует установить для параметра bufferTime значение 15. Flash начнет воспроизведение потока только после того, как буферизацию пройдут 15 секунд данных.

Если при воспроизведении записанного потока параметр bufferTime равен нулю, то проигрыватель Flash устанавливает для него малое значение (приблизительно 10 миллисекунд). Если в дальнейшем воспроизводятся (например, из списка воспроизведения) потоки в реальном времени, данное значение времени буферизации не меняется. Другими словами, параметр bufferTime остается для потока ненулевым.

См. также

Число байт данных, загруженных в проигрыватель Flash Player. Используя данное свойство вместе со свойством bytesTotal, можно определить, насколько близок момент полного заполнения буфера (это необходимо, например, чтобы оповестить пользователя, ожидающего загрузки данных в буфер).

См. также

Общий размер файла, загружаемого в проигрыватель Flash Player (в байтах).

См. также

Указывает, будет ли проигрыватель Flash Player пытаться загрузить файл политик URL с сервера загружаемого видеофайла перед началом загрузки самого файла. Данное свойство применяется при использовании объекта NetStream для последовательной загрузки отдельных видефайлов или при загрузке файлов, размещенных за пределами собственного домена вызывающего SWF-файла. Данное свойство игнорируется, если для получения ресурса RTMP используется объект NetStream.

Установите для данного свойства значение true, если вы загружаете видеофайл, размещенный за пределами домена вызывающего SWF-файла. Для доступа с возможностью обработки этого видеоматериала вам следует использовать метод BitmapData.draw(). При вызове BitmapData.draw() без установки значения true для параметра checkPolicyFile во время загрузки можно получить исключение SecurityError, так как требуемый файл политик не был загружен.

Если вам не требуется доступ к загружаемому видео на уровне обработки изображения, не устанавливайте для параметра checkPolicyFile значение true. Проверка наличия файла политик снижает пропускную способность сети и может задержать начало загрузки.

Когда вызывается метод NetStream.play(), в котором параметр checkPolicyFile имеет значение true, проигрыватель Flash Player должен успешно загрузить соответствующий файл политик URL или определить, что такой файл не существует, и только потом перейти к загрузке объекта, указанного в вызове NetStream.play(). Чтобы убедиться в существовании файла политик, проигрыватель Flash Player выполняет следующие действия в указанном ниже порядке:

1. Проигрыватель Flash Player анализирует ранее загруженные файлы политик.
2. Проигрыватель Flash Player пытается загрузить любые файлы действующих политик, указанные в вызовах метода Security.loadPolicyFile().
3. Проигрыватель Flash Player производит попытку загрузить файл политик из адреса по умолчанию, который соответствует URL-адресу, переданному NetStream.play() (файл /crossdomain.xml на том же сервере, где и находится данный URL-адрес).

Во всех случаях для работы проигрывателя Flash Player требуется, чтобы на сервере видеоданных существовал подходящий файл политики, чтобы он предоставлял доступ к объекту по URL-адресу, переданному методу play() на основе места размещения файла политики, а также, чтобы он обеспечивал домену вызывающего SWF-файла доступ к видео посредством одного или нескольких тегов <allow-access-from>.

Если установить для параметра checkPolicyFile значение true, то перед тем как загрузить видео, проигрыватель Flash Player будет находиться в ожидании до того, как будет проверен файл политики. Чтобы выполнять какие-либо операции по обработке видеоданных на уровне пикселов (например, вызов BitmapData.draw()), следует дождаться получения от своего объекта NetStream событий onMetaData или NetStatus.

Если вы укажете для параметра checkPolicyFile значение true, но при этом соответствующий файл политики не будет найден, сообщение об ошибке не будет получено до тех пор, пока вы не выполните операцию, требующую файл политики, после чего проигрыватель Flash создаст исключение SecurityError.

Будьте внимательны при установке параметра checkPolicyFile, если вы загружаете файл с URL-адреса, в котором используется HTTP-переадресация на стороне сервера. Flash Player производит попытку извлечь файлы политики, связанные с первоначальным URL-адресом, который указывается в NetStream.play(). Если из-за HTTP-переадресации конечный файл поступает с другого URL-адреса, первоначально загруженные файлы политик могут не применяться в отношении конечного URL-адреса файла. С точки зрения безопасности, именно этот URL-адрес представляет большую важность.

Дополнительные сведения о файлах политик см. в главе "Система безопасности проигрывателя Flash Player" руководства Программирование на ActionScript 3.0.

См. также

Задает объект, для которого вызываются методы обратного вызова для обработки потоковой передачи или данных FLV-файла. Объект по умолчанию: this (создаваемый объект NetStream). Если в свойстве client указать другой объект, методы обратного вызова будут вызываться на этом другом объекте. Объект NetStream.client может вызывать следующие функции и получать связанный объект данных: onCuePoint(), onImageData(), onMetaData(), onPlayStatus() onTextData() и onXMPData.

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

1. Создайте объект и назначьте его свойству client объекта NetStream:

        var customClient:Object = new Object();
        my_netstream.client = customClient;
        

2. Назначьте функцию обработчика для нужного события данных в качестве свойства объекта Client:

        customClient.onImageData = onImageDataHandler;           
        

3. Напишите функцию обработчика для получения объекта события данных, такого как:

         public function onImageDataHandler(imageData:Object):void {
                 trace("imageData length: " + imageData.data.length);
         }
        

Когда данные передаются через поток или при воспроизведении, объект события данных (в данном случае это объект imageData) заполняется данными. См. описание onImageData, содержащее полный пример объекта, назначенного свойству client.

Чтобы связать свойство client с подклассом, выполните следующие действия.

1. Создайте подкласс с функцией обработчика, чтобы получить объект события данных:

        class CustomClient {
           public function onMetaData(info:Object):void {
               trace("metadata: duration=" + info.duration + " framerate=" + info.framerate);
        }
        

2. Назначьте экземпляр подкласса свойству client объекта NetStream:

        my_netstream.client = new CustomClient();
        

Когда данные передаются через поток или при воспроизведении, объект события данных (в данном случае это объект info) заполняется данными. В конце описания класса NetStream приводится пример, демонстрирующий назначение экземпляра подкласса свойству client.

См. также

Число кадров, отображаемых за одну секунду. При экспорте видеофайлов для воспроизведения на нескольких системах можно проверить это значение в процессе тестирования, чтобы определить, какой уровень сжатия необходим при экспортировании файла.

Идентификатор удаленного узла, подключенного к данному экземпляру NetStream. Это свойство определяется только для подключений RTMFP.

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

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

См. также

Число секунд данных в буфере подписывающего потока в режиме реального времени (небуферизованном). Данное свойство указывает текущую задержку в сетевой передаче данных (время запаздывания).

Данное свойство используется преимущественно для работы с сервером Flash Media Server (более подробную информацию см. в описании класса).

С помощью значения этого свойства можно приблизительно измерить качество передачи потока и сообщить результат пользователю.

Задает время буферизации сообщений во время режима паузы. Его можно использовать для ограничения объема буферизации в режиме паузы путем определения максимально допустимого значения буфера. При достижении предельного значения NetStream.bufferLength буферизация прекращается. Если это значение не передается, по умолчанию используется значение в 60 секунд или удвоенное значение NetStream.bufferTime при каждой паузе, как описано выше.

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

Кодировка объекта (версия AMF) для данного объекта NetStream. Объект NetStream наследует значение objectEncoding от соответствующего объекта NetConnection. Необходимо хорошо понимать назначение этого свойства, если вашему SWF-файлу версии ActionScript 3.0 требуется обмен данными с серверами, программное обеспечение которых было выпущено до выхода Flash Player версии 9. Подробные сведения см. в описании свойства objectEncoding для класса NetConnection.

Значение этого свойства зависит от того, каким является данный поток — локальным или удаленным. Локальные потоки, в которых значение null было передано методу NetConnection.connect(), возвращают значение NetConnection.defaultObjectEncoding. Удаленные потоки возвращают кодировку объекта для подключения к серверу.

При вашей попытке прочитать это свойство при отсутствии подключения или при попытке его изменить проигрыватель Flash Player создаст исключение.

См. также

Объект, содержащий все подписывающие экземпляры NetStream, прослушивающие этот публикующий экземпляр NetStream.

Управляет звуком в данном объекте NetStream. Дополнительную информацию см. в описании класса SoundTransform.

См. также

Положение точки воспроизведения (в секундах).

Flash Media Server Для подписывающего потока — число секунд воспроизведения потока. Для публикующего потока — продолжительность публикации потока (в секундах). Это число используется с точностью до тысячных долей. Умножьте его на 1000, чтобы получить число миллисекунд воспроизведения потока.

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

Значение time продолжает расти, когда поток переключается с одного элемента списка воспроизведения на другой. Данное свойство получает значение 0, когда NetStream.play() вызывается с параметром reset, значение которого равно 1 или true, а также при вызове метода NetStream.close().

См. также

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

Информация о поддерживаемых кодеках и форматах файлов представлена по адресу http://www.adobe.com/go/hardware_scaling_ru и в документации по серверу Flash Media Server.

     new NetStream(nc:NetConnection);
     

См. также

            var my_nc:NetConnection = new NetConnection();
            my_nc.connect(null);
            var my_ns:NetStream = new NetStream(my_nc);
            my_ns.play(videoURL);
            var my_video:Video = new Video();
            my_video.attachNetStream(my_ns);
            addChild(my_video);

            var my_nc:NetConnection = new NetConnection();
            my_nc.connect("rtmfp://www.yourfmsserver.com/someappname");
            var my_ns:NetStream = new NetStream(my_nc, NetStream.CONNECT_TO_FMS);
            my_ns.play(videoURL);
            var my_video:Video = new Video();
            my_video.attachNetStream(my_ns);
            addChild(my_video);

Задает аудиопоток, отправляемый через объект NetStream из объекта Microphone, переданного в качестве источника. Данный метод доступен только издателю указанного потока.

Метод attachAudio используется при работе с сервером Flash Media Server. Данный метод часто вызывается пользователем, отправляющим аудио в реальном времени (или видео в реальном времени вместе с аудиоданными) с клиентского компьютера на сервер.

Данный метод можно вызвать до или после того, как будет вызван метод publish()и фактически начата передача. Для прослушивания аудио подписчики должны вызвать метод NetStream.play(). Звуковыми свойствами данного аудиопотока можно управлять с помощью свойства soundTransform указанного объекта Microphone.

Параметры

См. также

Начинает захват видео с видеокамеры, либо останавливает запись, если параметр theCamera имеет значение null. Данный метод доступен только издателю указанного потока.

Данный метод используется при работе с сервером Flash Media Server (более подробную информацию см. в описании класса).

Чтобы начать передачу, следует после прикрепления видеоисточника вызвать метод NetStream.publish(). Чтобы отобразить видео в рабочей области, подписчики, которым необходимо отобразить видеоданные, должны вызвать методы NetStream.play() и Video.attachCamera().

С помощью snapshotMilliseconds можно отправить отдельный снимок (необходимое значение — 0) или серию снимков (для создания эффектов замедленной киносъемки). Для этого нужно указать положительное число, которое добавляет в видеоданные концевой кадр на указанное число миллисекунд. Концевой кадр увеличивает время отображения видеосообщения. С помощью повторных вызовов метода attachCamera() с положительным значением для параметра snapshotMilliseconds последовательность сменяющих друг друга снимков и концевых кадров создает эффект замедленной киносъемки. Например, вы можете снимать по одному кадру в день и вставлять такой кадр в видеофайл. Когда подписчик воспроизводит файл, каждый кадр отображается на экране заданное количество миллисекунд, а затем сменяется на следующий кадр.

Функция параметра snapshotMilliseconds отличается от функции параметра fps, который можно установить для метода Camera.setMode(). Определение параметра snapshotMilliseconds позволяет установить промежуток времени между записываемыми кадрами. Контроль за тем, сколько времени проходит между записью и воспроизведением, осуществляется путем определения параметра fpsс помощью Camera.setMode().

Например, предположим, что вам необходимо сделать 100 снимков с периодичностью в 5 минут. Это можно выполнить двумя различными способами:

• Можно 100 раз, через каждые 5 минут, запустить команду NetStream.attachCamera(myCamera, 500). На эту запись потребуется 500 минут, но полученный файл будет воспроизводиться в течение 50 секунд (100 кадров с промежутком в 500 миллисекунд).
• Можно запустить команду Camera.setMode(), установив для параметра fps значение 1/300 (1 раз в 300 секунд или 1 раз каждые 5 минут), а затем запустить команду NetStream.attachCamera(source), позволяя камере непрерывно захватывать данные в течение 500 минут. Полученный файл будет воспроизводиться 500 минут (тот же отрезок времени, который потребовался для записи данных): каждый кадр будет отображаться на экране в течение 5 минут.

В обоих случаях захватываются одни и те же 500 кадров, и оба подхода имеют функциональное применение. Выбор нужного подхода в основном зависит от требований к воспроизведению снятого материала. Например, во втором случае аудио может записываться на протяжении всего времени. Вдобавок, оба файла будут приблизительно одного размера.

Параметры

Останавливает воспроизведение всех данных в потоке, присваивает свойству time значение 0 и делает поток доступным для использования. Данный метод также удаляет локальную копию видеофайла, загруженную по протоколу HTTP. Несмотря на то, что проигрыватель Flash Player удаляет локальную копию созданного им файла, она может сохраняться в кэш-каталоге обозревателя. Чтобы полностью предотвратить кэширование или локальное хранение видеофайла, используйте Flash Media Server.

При использовании Flash Media Server данный метод вызывается незаметно при вызове NetStream.play() из публикующего потока или при вызове NetStream.publish() из подписывающего потока. Обратите внимание:

• Если из публикующего потока вызывается close(), поток прекращает публикацию, после чего издатель может использовать этот поток по другому назначению. Подписчики больше не получают данные, публикуемые в потоке, так как публикация потока была остановлена.
• Если из подписывающего потока вызывается close(, то поток прекращает воспроизведение для подписчика, после чего подписчик может использовать данный поток для других целей. Это не касается остальных подписчиков.
• С помощью flash.net.NetStream.play(false) можно остановить воспроизведение подписывающего потока без закрытия самого потока или изменения его типа.

См. также

Вызывается, когда поток одноранговой публикации совпадает с потоком одноранговой подписки. Перед тем как подписчик будет подключен к издателю, вызовите этот метод, чтобы обеспечить четкое управление доступом к коду ActionScript для одноранговой публикации. Следующий код демонстрирует создание функции обратного вызова для этого метода

     var c:Object = new Object;
     c.onPeerConnect = function(subscriber:NetStream):Boolean {
      if (accept)
          return true;
      else
          return false;
      };
      m_netStream.client = c;
     

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

Параметры

Приостанавливает воспроизведение видеопотока. Вызов данного метода ни к чему не приводит, если видеопоток уже был приостановлен. Чтобы продолжить воспроизведение видео после временной остановки, вызовите resume(). Переключение между паузой и воспроизведением (сначала пауза, затем возобновление воспроизведения) выполняется с помощью togglePause().

Начиная с версии 9.0.115.0, проигрыватель Flash Player больше не очищает буфер при вызове метода NetStream.pause(). До версии 9.0.115.0, перед тем как продолжить воспроизведение, проигрыватель Flash Player находился в ожидании заполнения буфера, что часто вызывало задержку.

Для одиночной паузы свойство NetStream.bufferLength имеет ограничение в 60 секунд или удвоенное значение параметра NetStream.bufferTime (выбирается большее значение из двух). Например, если параметр bufferTime равен 20 секундам, то проигрыватель Flash Player заполняет буфер до тех пор, пока NetStream.bufferLength не примет верхнее значение 20*2 (40) или 60. В данном случае, буферизация проводится до того, как параметр bufferLength не будет иметь значение 60. Если параметр bufferTime равен 40 секундам, то проигрыватель Flash Player заполняет буфер до тех пор, пока NetStream.bufferLength не примет верхнее значение 40*2 (80) или 60. В этом случае буферизация проводится до того, как параметр bufferLength не будет иметь значение 80.

Свойство bufferLength также имеет абсолютный предел. Если любой вызов pause() приводит к тому, что значение параметра bufferLength увеличивается на 600 секунд или на значение bufferTime * 2 (выбирается наибольшее из двух), проигрыватель Flash Player очищает буфер и устанавливает для параметра bufferLength значение, равное 0. Например, если значение параметра bufferTime равно 120 секундам, проигрыватель Flash Player заполняет буфер до тех пор, пока параметр bufferLength не примет значение в 600 секунд. Если значение параметра bufferTime — 360 секунд, то Flash Player заполняет буфер до тех пор, пока bufferLength не станет равным 720 секундам.

Совет: Метод NetStream.pause() можно использовать в коде для буферизации данных в тот момент, например, когда зрители смотрят рекламу, и последующего воспроизведения потока в начале основной видеопрограммы.

См. также

Начинает воспроизведение видеофайлов.

Информация о поддерживаемых кодеках и форматах файлов представлена по адресу http://www.adobe.com/go/hardware_scaling_ru и в документации по серверу Flash Media Server.

Для просмотра видеоданных необходимо создать объект Video и вызвать метод Video.attachNetStream(). При этом будет автоматически воспроизводиться аудио, передаваемое в потоке с видеосигналом, или файл, содержащий только аудиоданные. Для потоковой передачи аудио с микрофона используйте метод NetStream.attachAudio() и управляйте некоторыми аспектами звука через объект Microphone.

Чтобы контролировать аудио, связанное с видеофайлом, можно использовать метод DisplayObjectContainer.addChild(), позволяющий направить аудиоданные на объект в списке отображения. Позднее можно создать объект Sound, чтобы управлять определенными характеристиками этих аудиоданных. Дополнительную информацию см. в описании метода DisplayObjectContainer.addChild().

Если не удается найти видеофайл, отправляется событие netStatus. Для остановки воспроизводимого в данный момент потока используйте метод close().

При использовании данного метода без Flash Media Server необходимо продумать модель безопасности проигрывателя Flash Player. SWF-файл в локальной доверенной изолированной среде или среде, локальной для сети, может загружать и воспроизводить видеофайл из удаленной изолированной программной среды, но при этом он не имеет доступа к данным этого удаленного файла без четкого разрешения в форме файла политик для URL. Вдобавок, чтобы SWF-файл не использовал этот метод, настройте параметр allowNetworking тегов object и embed HTML-страницы с SWF-содержимым.

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

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

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

Параметры

См. также

     ns.play("record1", 0, 100, true);
     

     ns.play("stephen");
     

Начинает воспроизведение мультимедийных файлов с использованием одного из нескольких вариантов.

Этот метод представляет собой расширенную версию NetStream.play(). Как и play(), метод play2() начинает воспроизведение мультимедийного файла или отправляет мультимедийные файлы в очередь для создания списка воспроизведения. При использовании с Flash Media Server он может также запрашивать у сервера переключение на другой мультимедийный файл. Переход происходит незаметно для клиентского приложения.

Используйте метод play2() для переключения на потоки с одинаковым содержимым, закодированным с разной скоростью потока или для замены потоков в списке воспроизведения. Этот метод позволяет приложению адаптироваться к меняющимся сетевым условиям или к клиентам с разными возможностями. Дополнительные сведения о доступных вариантах перехода см. в разделах NetStreamPlayOptions и NetStreamPlayTransitions.

Параметры

См. также

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

Не используйте этот метод, чтобы разрешить клиенту воспроизвести поток, который был предварительно опубликован и записан. Вместо этого создайте для данного клиента экземпляр NetStream и вызовите метод play():

     var subscribeNS:NetStream = new NetStream(myNetConnection);
     subscribeNS.play("streamToPlay");
     

При записи потока с помощью Flash Media Server сервер создает файл и сохраняет его в подкаталоге, который размещен в каталоге приложения на сервере. Каждый поток сохраняется в каталоге, имя которого совпадает с именем экземпляра приложения, переданным методу NetConnection.connect(). Сервер создает эти каталоги автоматически, пользователю не требуется создавать каталог для каждого экземпляра приложения. Например, в следующем коде показано, как подключиться к определенному экземпляру приложения, хранящегося в каталоге lectureSeries внутри каталога вашего приложения. Файл lecture.flv размещен в подкаталоге /yourAppsFolder/lectureSeries/streams/Monday:

     var myNC:NetConnection = new NetConnection();
     myNC.connect("rtmp://server.domain.com/lectureSeries/Monday");
     var myNS:NetStream = new NetStream(myNC);
     myNS.publish("lecture", "record");
     

В следующем примере показано, как подключиться к другому экземпляру того же приложения, при этом запустив идентичную команду публикации. Файл lecture.flv размещен в подкаталоге /yourAppsFolder/lectureSeries/streams/Tuesday:

     var myNC:NetConnection = new NetConnection();
     myNC.connect("rtmp://server.domain.com/lectureSeries/Tuesday");
     var myNS:NetStream = new NetStream(my_nc);
     myNS.publish("lecture", "record");
     

Если вы не укажете значение для имени экземпляра, совпадающее со значением, переданным свойству name, сохраняется в подкаталоге /yourAppsFolder/appName/streams/_definst_ . Более подробные сведения об использовании имен экземпляров см. в описании метода NetConnection.connect(). Информацию о воспроизведении видеофайлов см. в описании метода NetStream.play().

Когда клиент приложения Flash Media Server вызывает метод publish(), приложение получает событие onPublish. Приложение должно обрабатывать событие в сценарии на стороне сервера. Когда клиент прекращает публикацию, приложение получает событие onUnpublish. Дополнительную информацию см. в Справочник по языку Flash Media Server Server-Side ActionScript.

Данный метод может отправить событие netStatus с несколькими различными информационными объектами. Например, если кто-либо уже ведет публикацию на потоке с указанным именем, событие netStatus отправляется со свойством кода NetStream.Publish.BadName. Дополнительную информацию см. в описании события netStatus.

Параметры

См. также

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

Данный метод используется преимущественно для работы с сервером Flash Media Server (более подробную информацию см. в описании класса).

Данный метод можно вызвать до или после того, как будет вызван метод NetStream.play()и фактически начат прием потока. Например, эти методы можно присвоить той кнопке, которую пользователь нажимает, чтобы включить или выключить звук на входящем аудиопотоке.

Если указанный поток содержит только аудиоданные, то передача значения false данному методу останавливает приращение NetStream.time.

Параметры

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

Данный метод используется преимущественно для работы с сервером Flash Media Server (более подробную информацию см. в описании класса).

Данный метод можно вызвать до или после того, как будет вызван метод NetStream.play()и фактически начат прием потока. Например, эти методы можно присвоить той кнопке, которую пользователь нажимает, чтобы отобразить или скрыть входящий видеопоток.

Если указанный поток содержит только видеоданные, то передача значения false данному методу останавливает приращение NetStream.time.

Параметры

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

Данный метод используется преимущественно для работы с сервером Flash Media Server (более подробную информацию см. в описании класса).

Данный метод можно вызвать до или после того, как будет вызван метод NetStream.play()и фактически начат прием потока. Например, можно присоединить эти методы к текстовому полю, где пользователь может задать частоту кадров входящего видео.

Чтобы остановить получение видеоданных, передайте для параметра FPS значение 0. Чтобы определить текущую частоту кадров, используйте NetStream.currentFPS.

Если в целях уменьшения частоты видеокадров передать определенное значение параметру FPS, проигрыватель Flash Media Server предпримет попытку снизить частоту кадров, при этом сохраняя целостность видеоизображения. Через каждые два ключевых кадра сервер посылает минимальное количество кадров, необходимое для обеспечения заданной частоты кадров. Тем не менее, следует помнить, что промежуточные кадры должны отправляться рядом с ключевыми. В противном случае, видеоизображение будет испорченным. Таким образом, необходимое число кадров отправляется немедленно в сопровождении ключевого кадра. Так как кадры распределены неравномерно, движение выглядит смягченным в тех сегментах, прерываемых остановками.

Параметры

Возобновляет воспроизведение приостановленного видеопотока. Если видео уже воспроизводится, вызов данного метода ни к чему не приведет.

См. также

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

Видеопотоки обычно кодируются с двумя типами кадров: ключевые кадры (или I-кадры) и P-кадры. Ключевой кадр содержит все изображение, в то время как P-кадр является промежуточным кадром, предоставляющим дополнительную видеоинформацию между ключевыми кадрами. Как правило, в видеопотоке ключевой кадр ставится через каждые 10-50 кадров.

На сервере Flash Media Server поведение seek() контролируется с помощью значения элемента EnhancedSeek в файле конфигурации Application.xml.

Если параметр EnhancedSeek имеет значение false, сервер использует обычный режим поиска. В обычном режиме поиска сервер начинает потоковое воспроизведение с ближайшего ключевого кадра. Например, если в видео ключевые кадры размещены на 0 секунд и 10 секундах, то в результате поиска на 4 секунды воспроизведение начнется с 4 секунды с использованием ключевого кадра, установленного на 0 секунде. Видеокартинка не меняется до тех пор, пока на 10 секундах не будет достигнут следующий ключевой кадр. Для того чтобы оптимизировать операцию поиска, необходимо сократить интервал между ключевыми кадрами. В нормальном режиме поиска нельзя запустить видео в точке между ключевыми кадрами.

Если параметр EnhancedSeek имеет значение true (значение по умолчанию), то сервер генерирует новый ключевой кадр в точке смещения offset на основе предыдущего ключевого кадра и любых промежуточных P-кадров. Тем не менее, это создает большую нагрузку на вычислительные ресурсы сервера, что может привести к искажению сгенерированного ключевого кадра. Если в качестве видеокодека применяется On2, то клиенту отправляются ключевой кадр перед точкой поиска и любые P-кадры между ключевым кадром и точкой поиска.

Параметры

См. также

Отправляет сообщение по опубликованному потоку всем подписавшимся клиентам. Этот метод доступен только издателю указанного потока и предназначен для работы с сервером Flash Media Server. Чтобы обработать данное сообщение и отреагировать на него, создайте обработчик на объекте NetStream, например ns.HandlerName.

Проигрыватель Flash Player не проводит сериализацию методов или их данных, переменных для прототипов объектов или несчетных переменных. Для отображаемых объектов проигрыватель Flash Player сериализует не данные, а только сам путь.

Чтобы добавить ключевые кадры данных в прямой поток, отправляемый на сервер Flash Media Server, можно вызвать метод send(). Ключевой кадр данных — это сообщение, добавляемое сервером публикаций в прямой поток. Ключевые кадры данных обычно используются для добавления метаданных в прямой поток до того, как будет происходить захват данных (для этого потока) с камеры и микрофона. Издатель может добавлять ключевой кадр данных в любой момент в процессе публикации прямого потока. Ключевой кадр данных хранится в памяти сервера, пока издатель подключен к данному серверу.

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

Чтобы добавить ключевой кадр метаданных в прямой поток, отправляемый на сервер Flash Media Server, используйте @setDataFrame в качестве имени обработчика, а затем добавьте два дополнительных аргумента, например:

     var ns:NetStream = new NetStream(nc);
     ns.send("@setDataFrame", "onMetaData", metaData);
     

Аргумент @setDataFrame ссылается на специальный обработчик, встроенный в сервер Flash Media Server. Аргумент onMetaData — это имя функции обратного вызова в клиентском приложении, которая прослушивает событие onMetaData и извлекает метаданные. Третий элемент, metaData, представляет собой экземпляр Object или Array со свойствами, определяющими значения метаданных. Издатели должны устанавливать имена свойств, понятные для подписчиков. Список предлагаемых имен свойств представлен в документации по серверу Flash Media Server.

Чтобы удалить ключевой кадр метаданных, который был предварительно определен в потоке, используйте @clearDataFrame:

     ns.send("@clearDataFrame", "onMetaData");
     

Параметры

См. также

     package {
       import flash.display.Sprite;
       import flash.net.NetConnection;
       import flash.net.NetStream;
       import flash.events.NetStatusEvent;
       import flash.media.Video;
       import flash.utils.setTimeout;
          
       public class TestExample extends Sprite
       {
         var nc:NetConnection = new NetConnection();
         var ns1:NetStream;
         var ns2:NetStream;
         var vid:Video = new Video(300,300);
         var obj:Object = new Object();
     
         public function TestExample() {
            nc.objectEncoding = 0;
            nc.addEventListener("netStatus", onNCStatus);
            nc.connect("rtmp://localhost/FlashVideoApp");
            addChild(vid); 
         }
      
         function onNCStatus(event:NetStatusEvent):void {
           switch (event.info.code) {
               case "NetConnection.Connect.Success":
                   trace("You've connected successfully");
                   ns1 = new NetStream(nc);
                   ns2 = new NetStream(nc);
                   
                   ns1.client = new CustomClient();
                   ns1.publish("dummy", "live");
        
                   ns2.play("dummy");
                   ns2.client = new CustomClient();
                   vid.attachNetStream(ns2);
                   setTimeout(sendHello, 3000);
                   break;
                  
               case "NetStream.Publish.BadName":
                   trace("Please check the name of the publishing stream" );
                   break;
            }   
         }
              function sendHello():void {
             ns1.send("myFunction", "hello");
         }       
       }
     }
     
     class CustomClient {
        public function myFunction(event:String):void {
           trace(event);
        }
     }
     

     private function netStatusHandler(event:NetStatusEvent):void {
         switch (event.info.code) {  
            case "NetStream.Publish.Start":
                var metaData:Object = new Object();
                metaData.title = "myStream";
                metaData.width = 400;
                metaData.height = 200;
                ns.send("@setDataFrame", "onMetaData", metaData);
                ns.attachCamera( Camera.getCamera() );
                ns.attachAudio( Microphone.getMicrophone() );     
            }
         }
     

     public function onMetaData(info:Object):void {
        trace("width: " + info.width);
        trace("height: " + info.height);
     }
     

     // Create a NetStream for playing
     var my_ns:NetStream = new NetStream(my_nc);
     my_video.attachNetStream(my_ns);
     
     // Play the stream record1
     my_ns.play("record1", 0, -1, true);
     
     // Switch to the stream live1 and play for 5 seconds.  
     // Since reset is false, live1 will start to play after record1 is done.
     my_ns.play("live1", -1 , 5, false);
     

     //To play at normal speed
     var my_ns:NetStream = new NetStream(my_nc);
     my_ns.play("log", 0, -1);
     
     //To get the data messages all at once
     my_ns.play("log", 0, -1, 3);
     

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

См. также

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

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

См. также

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

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

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

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

См. также

Добавляет прослушиватель, реагирующий на достижение встроенной ключевой точки во время воспроизведения видеофайла. Данный прослушиватель можно использовать для запуска действий в коде, когда воспроизведение видео достигает определенной ключевой точки. Это позволяет синхронизировать другие действия в приложении с событиями воспроизведения видео. Информацию о форматах видеофайлов, поддерживаемых Flash Media Server, см. в документации по серверу Flash Media Server.

onCuePoint на самом деле является свойством объекта NetStream.client. Это не событие, однако его можно найти в разделе "События", так как он реагирует на событие данных при потоковой передаче мультимедийногосодержимого с помощью Flash Media Server или при воспроизведении FLV-файла. Дополнительные сведения см. в описании класса NetStream. Для прослушивания или обработки onImageData в качестве события нельзя использовать ни метод addEventListener(), ни любые другие методы EventDispatcher. В данном случае необходимо определить отдельную функцию обратного вызова и прикрепить ее непосредственно к одному из следующих объектов:

• Объект, на который ссылается свойство client экземпляра NetStream.
• Экземпляр подкласса NetStream. NetStream представляет собой защищенный класс. Это означает, что при выполнении кода объекту NetStream не могут быть добавлены какие-либо свойства или методы. Тем не менее, можно создать подкласс NetStream и определить свой обработчик событий в этом подклассе. Также можно создать динамический подкласс и добавить функцию обработчика событий отдельному экземпляру подкласса.

Связанный прослушиватель событий запускается после вызова метода NetStream.play(), но перед продвижением точки воспроизведения.

В видеофайл можно встроить следующие типы ключевых точек:

• Ключевая точка навигации указывает внутри видеофайла ключевой кадр, которому соответствует свойство time данной точки. Ключевые точки навигации часто используются как закладки или точки входа, облегчающие пользователям перемещение по видеофайлу.
• Ключевая точка события указывается по времени независимо от того, соотносится или не соотносится данное время с определенным ключевым кадром. Ключевая точка события обычно представляет собой определенный момент видео, в котором происходит что-то, что можно использовать для вызова других событий.

Объект события onCuePoint имеет следующие свойства:

Ключевые точки в видеофайле можно определить при первом кодировании файла или при импортировании фрагмента ролика в инструменте разработки Flash с помощью мастера импорта видео.

Событие onMetaData также извлекает информацию о ключевых точках в видеофайле. Тем не менее, событие onMetaData получает информацию обо всех ключевых точках до начала воспроизведения видеоданных. Событие onCuePoint получает сведения об отдельной ключевой точке в момент времени, указанной для данной точки во время воспроизведения.

Как правило, для того чтобы ваш код отреагировал на определенную ключевую точку в момент ее возникновения, следует применить в коде событие onCuePoint, позволяющее инициировать какое-либо действие.

С помощью списка ключевых точек, предоставленных событию onMetaData, пользователь может начинать воспроизведение видео в предварительно определенных точках внутри видеопотока. Чтобы воспроизвести видео с определенной ключевой точки, передайте значение свойства time данной точки методу NetStream.seek().

См. также

Добавляет прослушиватель событий, реагирующий на получение проигрывателем Flash Player графических данных в виде массива байт, встроенного в воспроизводимый мультимедийный файл. Данные изображения могут быть преобразованы в содержимое формата JPEG, PNG или GIF. Используйте метод flash.display.Loader.loadBytes() для загрузки байтового массива в экранный объект.

onImageData на самом деле является свойством объекта NetStream.client. Это не событие, однако его можно найти в разделе "События", так как он реагирует на событие данных при потоковой передаче мультимедийногосодержимого с помощью Flash Media Server или при воспроизведении FLV-файла. Дополнительные сведения см. в описании класса NetStream. Для прослушивания или обработки onImageData в качестве события нельзя использовать ни метод addEventListener(), ни любые другие методы EventDispatcher. В данном случае необходимо определить отдельную функцию обратного вызова и прикрепить ее непосредственно к одному из следующих объектов:

• Объект, на который ссылается свойство client экземпляра NetStream.
• Экземпляр подкласса NetStream. NetStream представляет собой защищенный класс. Это означает, что при выполнении кода объекту NetStream не могут быть добавлены какие-либо свойства или методы. Тем не менее, можно создать подкласс NetStream и определить свой обработчик событий в этом подклассе. Также можно создать динамический подкласс и добавить функцию обработчика событий отдельному экземпляру подкласса.

Связанный прослушиватель событий запускается после вызова метода NetStream.play(), но перед продвижением точки воспроизведения.

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

package {
    import flash.display.*;
    import flash.net.*;
    import flash.media.*;
    import flash.system.*;
    import flash.events.*;

        public class OnTextDataExample extends Sprite {
                                              
            public function OnTextDataExample():void {

                var customClient:Object = new Object();
                customClient.onImageData = onImageDataHandler;           
                customClient.onTextData = onTextDataHandler;               

                var my_nc:NetConnection = new NetConnection();
                my_nc.connect(null);
                var my_ns:NetStream = new NetStream(my_nc);
                my_ns.play("yourURL");
                my_ns.client = customClient;

                var my_video:Video = new Video();
                my_video.attachNetStream(my_ns);
                addChild(my_video);

            }

            public function onImageDataHandler(imageData:Object):void {

                trace("imageData length: " + imageData.data.length);
                var imageloader:Loader = new Loader();           
                imageloader.loadBytes(imageData.data); // imageData.data is a ByteArray object.
                addChild(imageloader);
            }

    
            public function onTextDataHandler(textData:Object):void {

                trace("--- textData properties ----");
                var key:String;

                for (key in textData) {
                    trace(key + ": " + textData[key]);
                }
            }

        }

}

См. также

Добавляет прослушиватель, реагирующий на получение проигрывателем Flash Player описательной информации, встроенной в воспроизводимое видео. Информацию о форматах видеофайлов, поддерживаемых Flash Media Server, см. в документации по серверу Flash Media Server.

onMetaData на самом деле является свойством объекта NetStream.client. Это не событие, однако его можно найти в разделе "События", так как он реагирует на событие данных при потоковой передаче мультимедийногосодержимого с помощью Flash Media Server или при воспроизведении FLV-файла. Дополнительные сведения см. в описании класса NetStream и свойства NetStream.client. Для прослушивания или обработки onImageData в качестве события нельзя использовать ни метод addEventListener(), ни любые другие методы EventDispatcher. В данном случае необходимо определить отдельную функцию обратного вызова и прикрепить ее непосредственно к одному из следующих объектов:

• Объект, на который ссылается свойство client экземпляра NetStream.
• Экземпляр подкласса NetStream. NetStream представляет собой защищенный класс. Это означает, что при выполнении кода объекту NetStream не могут быть добавлены какие-либо свойства или методы. Тем не менее, можно создать подкласс NetStream и определить свой обработчик событий в этом подклассе. Также можно создать динамический подкласс и добавить функцию обработчика событий отдельному экземпляру подкласса.

Служебная программа Flash Video Exporter (версии 1.1 или более поздней версии) встраивает различные данные (продолжительность видео, дата создания, скорости передачи данных и т.п.) в сам видеофайл. Разные видеокодеры вставляют разные наборы метаданных.

Связанный прослушиватель событий запускается после вызова метода NetStream.play(), но перед продвижением точки воспроизведения.

В большинстве случаев, значение продолжительности, встроенное в метаданные потока, является не точным, а лишь приблизительным показателем фактической продолжительности. Другими словами, оно не всегда совпадает со значением свойства NetStream.time, когда точка воспроизведения находится в конце видеопотока.

Объект события, передаваемый обработчику событий onMetaData, содержит одно свойство для каждого элемента данных.

См. также

Добавляет прослушиватель, которые реагирует на завершение воспроизведения потока объектом NetStream. Связанный объект событий передает информацию в дополнение к сведениям, возвращенным событием netStatus. С помощью этого свойства можно запускать действия в коде, когда объект NetStream переключится с одного потока на другой поток в списке воспроизведения (на что указывает информационный объект NetStream.Play.Switch) или когда объект NetStream завершит воспроизведение (на что указывает информационный объект NetStream.Play.Complete).

Объект onPlayStaus на самом деле является свойством объекта NetStream.client. Это не событие, однако его можно найти в разделе "События", так как он реагирует на событие данных при потоковой передаче мультимедийногосодержимого с помощью Flash Media Server или при воспроизведении FLV-файла. Дополнительные сведения см. в описании класса NetStream. Для прослушивания или обработки onImageData в качестве события нельзя использовать ни метод addEventListener(), ни любые другие методы EventDispatcher. В данном случае необходимо определить отдельную функцию обратного вызова и прикрепить ее непосредственно к одному из следующих объектов:

• Объект, на который ссылается свойство client экземпляра NetStream.
• Экземпляр подкласса NetStream. NetStream представляет собой защищенный класс. Это означает, что при выполнении кода объекту NetStream не могут быть добавлены какие-либо свойства или методы. Тем не менее, можно создать подкласс NetStream и определить свой обработчик событий в этом подклассе. Также можно создать динамический подкласс и добавить функцию обработчика событий отдельному экземпляру подкласса.

Данное событие возвращает информационный объект со следующими свойствами:

См. также

Добавляет прослушиватель событий, реагирующий на получение проигрывателем Flash Player текстовых данных, встроенных в воспроизводимый мультимедийный файл. Текстовые данные представлены в формате UTF-8 и могут содержать информацию о форматировании на основе спецификации 3GP Timed Text.

onTextDataна самом деле является свойством объекта NetStream.client. Это не событие, однако его можно найти в разделе "События", так как он реагирует на событие данных при потоковой передаче мультимедийногосодержимого с помощью Flash Media Server или при воспроизведении FLV-файла. Дополнительные сведения см. в описании класса NetStream. Для прослушивания или обработки onImageData в качестве события нельзя использовать ни метод addEventListener(), ни любые другие методы EventDispatcher. В данном случае необходимо определить отдельную функцию обратного вызова и прикрепить ее непосредственно к одному из следующих объектов:

• Объект, на который ссылается свойство client экземпляра NetStream.
• Экземпляр подкласса NetStream. NetStream представляет собой защищенный класс. Это означает, что при выполнении кода объекту NetStream не могут быть добавлены какие-либо свойства или методы. Тем не менее, можно создать подкласс NetStream и определить свой обработчик событий в этом подклассе. Также можно создать динамический подкласс и добавить функцию обработчика событий отдельному экземпляру подкласса.

Связанный прослушиватель событий запускается после вызова метода NetStream.play(), но перед продвижением точки воспроизведения.

Объект события onTextData содержит по одному свойству для каждого отрывка текстовых данных.

package {
    import flash.display.*;
    import flash.net.*;
    import flash.media.*;
    import flash.system.*;
    import flash.events.*;

        public class OnTextDataExample extends Sprite {
                                              
            public function OnTextDataExample():void {

                var customClient:Object = new Object();
                customClient.onImageData = onImageDataHandler;           
                customClient.onTextData = onTextDataHandler;               

                var my_nc:NetConnection = new NetConnection();
                my_nc.connect(null);
                var my_ns:NetStream = new NetStream(my_nc);
                my_ns.play("yourURL");
                my_ns.client = customClient;

                var my_video:Video = new Video();
                my_video.attachNetStream(my_ns);
                addChild(my_video);

            }

            public function onImageDataHandler(imageData:Object):void {

                trace("imageData length: " + imageData.data.length);
                var imageloader:Loader = new Loader();           
                imageloader.loadBytes(imageData.data); // imageData.data is a ByteArray object.
                addChild(imageloader);
            }

    
            public function onTextDataHandler(textData:Object):void {

                trace("--- textData properties ----");
                var key:String;

                for (key in textData) {
                    trace(key + ": " + textData[key]);
                }
            }

        }

}

См. также

Устанавливает прослушиватель, реагирующий на получение проигрывателем Flash Player информации о платформе Adobe Extensible Metadata Platform (XMP), встроенной в воспроизводимое видео. Информацию о форматах видеофайлов, поддерживаемых Flash Media Server, см. в документации по серверу Flash Media Server.

onXMPData на самом деле является свойством объекта NetStream.client. Это не событие, однако его можно найти в разделе "События", так как он реагирует на событие данных при потоковой передаче мультимедийногосодержимого с помощью Flash Media Server или при воспроизведении FLV-файла. Дополнительные сведения см. в описании класса NetStream и свойства NetStream.client. Для прослушивания или обработки onImageData в качестве события нельзя использовать ни метод addEventListener(), ни любые другие методы EventDispatcher. В данном случае необходимо определить отдельную функцию обратного вызова и прикрепить ее непосредственно к одному из следующих объектов:

• Объект, на который ссылается свойство client экземпляра NetStream.
• Экземпляр подкласса NetStream. NetStream представляет собой защищенный класс. Это означает, что при выполнении кода объекту NetStream не могут быть добавлены какие-либо свойства или методы. Тем не менее, можно создать подкласс NetStream и определить свой обработчик событий в этом подклассе. Также можно создать динамический подкласс и добавить функцию обработчика событий отдельному экземпляру подкласса.

Связанный прослушиватель событий запускается после вызова метода NetStream.play(), но перед продвижением точки воспроизведения.

Объект, передаваемый функции обработчика событияonXMPData(), имеет одно свойство data, содержащее строковое значение. Эта строка генерируется из поля UUID верхнего уровня. (Для поля верхнего уровня 128-разрядный UUID имеет значение BE7ACFCB-97A9-42E8-9C71-999491E3AFAC.) Это поле UUID верхнего уровня содержит только один документ XML, представленный в виде строки UTF-8, заканчивающейся на 0.

См. также

Статический объект, передаваемый в качестве параметра конструктору для экземпляра NetStream. Это значение по умолчанию для второго параметра в конструкторе NetStream. Оно не используется приложением для последовательного воспроизведения содержимого. Когда этот параметр используется, конструктор создает подключение к экземпляру Flash Media Server.

Создает подключение между одноранговыми издателями Передайте эту строку в качестве второго (необязательного) параметра конструктору для экземпляра NetStream. С помощью этой строки приложение может создать подключение NetStream с целью публикации аудио и видео для клиентов.

В данном примере код, создающий объекты 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);
    }
}