Справочник по ActionScript® 3.0 для платформы Adobe® Flash®
Домашняя страница  |  Скрыть список пакетов и классов |  Пакеты  |  Классы  |  Что нового  |  Указатель  |  Приложения  |  Почему по-английски?
Фильтры: Получение данных с сервера...
Получение данных с сервера...
flash.net 

NetStreamPlayOptions  - AS3

Пакетflash.net
Классpublic dynamic class NetStreamPlayOptions
НаследованиеNetStreamPlayOptions Inheritance EventDispatcher Inheritance Object

Язык версии: ActionScript 3.0
Версии среды выполнения: Flash Player 10, AIR 1.5, Flash Lite 4

Класс NetStreamPlayOptions определяет различные параметры, которые могут быть переданы методу NetStream.play2(). Объект NetStreamPlayOptions передается методу play2(), а свойства класса задают разные варианты. Этот класс, в основном, используется для динамической реализации переходов между потоками для переключения между потоками с разными размерами и скоростями потока или для замены содержимого в списке воспроизведения.



Общедоступные свойства
 СвойствоОпределено
 Inheritedconstructor : Object
Ссылка на объект класса или функцию конструктора для данного экземпляра объекта.
Object
  len : Number
Продолжительность воспроизведения (в секундах) для потока, заданного в streamName.
NetStreamPlayOptions
  offset : Number
Абсолютное время потока, в которое сервер переключается между потоками с разной скоростью передачи данных для обеспечения динамического потокового воспроизведения Flash Media Server.
NetStreamPlayOptions
  oldStreamName : String
Имя старого потока или потока, с которого нужно перейти на другой.
NetStreamPlayOptions
  start : Number
Время начала для streamName (в секундах).
NetStreamPlayOptions
  streamName : String
Имя нового потока для перехода или воспроизведения.
NetStreamPlayOptions
  transition : String
Режим воспроизведения streamName или режим перехода к нему.
NetStreamPlayOptions
Общедоступные методы
 МетодОпределено
  
Создает объект NetStreamPlayOptions для определения вариантов, передаваемых методу NetStream.play2().
NetStreamPlayOptions
 Inherited
addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
Регистрирует объект прослушивателя события на объекте EventDispatcher для получения прослушивателем уведомления о событии.
EventDispatcher
 Inherited
Посылает событие в поток событий.
EventDispatcher
 Inherited
Проверяет, имеет ли объект EventDispatcher прослушиватели, зарегистрированные для определенного типа события.
EventDispatcher
 Inherited
Показывает, определено ли заданное свойство для объекта.
Object
 Inherited
Показывает, есть ли экземпляр класса Object в цепи прототипов объекта, заданного в качестве параметра.
Object
 Inherited
Показывает наличие заданного свойства и его перечисляемость.
Object
 Inherited
removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void
Удаляет прослушиватель из объекта EventDispatcher.
EventDispatcher
 Inherited
Задает доступность динамического свойства для операций цикла.
Object
 Inherited
Возвращает строковое представление этого объекта, отформатированного в соответствии со стандартами, принятыми для данной локали.
Object
 Inherited
Возвращает строковое представление заданного объекта.
Object
 Inherited
Возвращает элементарное значение заданного объекта.
Object
 Inherited
Проверяет, зарегистрирован ли прослушиватель события для указанного типа события с данным объектом EventDispatcher или любым его предшественником.
EventDispatcher
События
 Событие Сводка Определено
 Inherited[многоадресное событие] Отправляется, когда проигрыватель Flash Player или приложение AIR перемещается в фокус операционной системы и становится активным.EventDispatcher
 Inherited[многоадресное событие] Отправляется, когда проигрыватель Flash Player или приложение AIR теряет фокус системы и становится неактивным.EventDispatcher
Сведения о свойстве

len

свойство
public var len:Number

Язык версии: ActionScript 3.0
Версии среды выполнения: Flash Player 10, AIR 1.5, Flash Lite 4

Продолжительность воспроизведения (в секундах) для потока, заданного в streamName. Значение по умолчанию — -1, то есть Flash Player воспроизводит поток в реальном времени, пока он доступен, или записанный поток до его окончания. Если передать значение 0 для свойства len, Flash Player воспроизводит один кадр на секунде, заданной в start, от начала записанного потока, (при условии что значение start равно или больше 0).

Если передать положительное число для свойства len, Flash Player воспроизводит эфирный поток в течение заданного количества секунд len с того момента, как он станет доступным, или записанный поток в течение len секунд. (Если поток закончится раньше, чем задано в свойстве len, воспроизведение заканчивается вместе с потоком.)

Если передать в качестве значения для len отрицательное число, отличное от -1, Flash Player обрабатывает его как -1.

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

offset

свойство 
public var offset:Number

Язык версии: ActionScript 3.0
Версии среды выполнения: Flash Player 10.1, AIR 2, Flash Lite 4

Абсолютное время потока, в которое сервер переключается между потоками с разной скоростью передачи данных для обеспечения динамического потокового воспроизведения Flash Media Server. Свойство offset используется при вызове метода NetStream.play2() с режимом перехода NetStreamPlayTransitions.SWITCH. Предусмотрено два режима переключения: быстрое переключение и стандартное переключение. По умолчанию offset имеет значение -1, которое представляет режим быстрого переключения. Напишите код ActionScript, чтобы определить, когда должно использоваться быстрое переключение, а когда стандартное.

Быстрое переключение

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

По умолчанию offset имеет значение -1, которое представляет режим быстрого переключения. Когда offset имеет значение -1, переключение происходит в первом доступном ключевом кадре после netstream.time + 3, что составляет примерно 3 секунды после точки воспроизведения. Для свойства offset также можно задать любое значение, которое больше значения netstream.time. Например, чтобы выполнить быстрое переключение через 5 секунд после точки воспроизведения, задайте свойству offset значение netstream.time + 5. Если значение offset меньше netstream.time, отправляется событие состояния NetStream.Play.Failed.

Примечание. Свойство offset указывает абсолютное время потока, а не сдвиг относительно точки воспроизведения. Например, чтобы выполнить переключение через 5 секунд после точки воспроизведения, задайте свойству offset значение netstream.time + 5, а не 5.

Стандартное переключение

Чтобы использовать стандартное переключение вместо быстрого, задайте свойству offset значение, которое больше значения netstream.time + netstream.bufferLength.

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

Дополнительные сведения см. в разделе «Быстрое переключение потоков» в Руководстве разработчика Adobe Flash Media Server.

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

oldStreamName

свойство 
public var oldStreamName:String

Язык версии: ActionScript 3.0
Версии среды выполнения: Flash Player 10, AIR 1.5, Flash Lite 4

Имя старого потока или потока, с которого нужно перейти на другой. Когда метод NetStream.play2() используется просто для воспроизведения потока (не для перехода), это свойство должно быть неопределенным или иметь значение null или undefined. В противном случае следует указать поток, с которого будет выполняться переход.

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

start

свойство 
public var start:Number

Язык версии: ActionScript 3.0
Версии среды выполнения: Flash Player 10, AIR 1.5, Flash Lite 4

Время начала для streamName (в секундах). Допустимыми являются значения -2, -1 и 0.

По умолчанию start имеет значение -2, то есть, Flash Player сначала пытается в реальном времени воспроизвести поток, определенный свойством streamName. Если не удается найти поток в реальном времени с таким именем, Flash Player воспроизводит поток, заданный в streamName. Если поток в реальном времени или записанный потока не найдены, Flash Player открывает поток в реальном времени с именем streamName, даже если в нем не публикуется содержимое. Когда кто-то начинает публикацию в этом потоке, Flash Player начинает его воспроизводить.

Если передать значение -1 для start, Flash Player воспроизводит только канал в реальном вреени, заданный в streamName. Если найти канал в реальном времени не удается, Flash Player ждет его бесконечно долго, если len имеет значение -1; если же len имеет другое значение, Flash Player ждет в течение указанного в len количества секунд, прежде чем начинать воспроизведение следующего элемента в списке.

Если передать значение 0 или положительное число для свойства start, Flash Player воспроизводит только записанный поток с именемstreamName с секунды, указанной в start от начала потока. Если не удается найти записанный поток, Flash Player немедленно начинает воспроизведение следующего элемента в списке.

Если передать отрицательное число, не являющееся -1 или -2, в качестве значения для start, Flash Player обрабатывает его как -2.

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

streamName

свойство 
public var streamName:String

Язык версии: ActionScript 3.0
Версии среды выполнения: Flash Player 10, AIR 1.5, Flash Lite 4

Имя нового потока для перехода или воспроизведения. Когда oldStreamName имеет значение 0 или не определено, вызов NetStream.play2() просто начинает воспроизведение streamName. Если задано свойство oldStreamName, при вызове NetStream.play2() выполняется переход с oldStreamName на streamName с использованием режима перехода, определенного свойством transition.

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

transition

свойство 
public var transition:String

Язык версии: ActionScript 3.0
Версии среды выполнения: Flash Player 10, AIR 1.5, Flash Lite 4

Режим воспроизведения streamName или режим перехода к нему. Возможными значениями являются константы класса NetStreamPlayTransitions. В зависимости от того, вызывается метод Netstream.play2() для воспроизведения потока или для перехода между потоками, режим перехода вызывает разное поведение. Дополнительные сведения о режимах перехода см. в описании класса NetStreamPlayTransitions.

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

Сведения о конструкторе

NetStreamPlayOptions

()Конструктор
public function NetStreamPlayOptions()

Язык версии: ActionScript 3.0
Версии среды выполнения: Flash Player 10, AIR 1.5, Flash Lite 4

Создает объект NetStreamPlayOptions для определения вариантов, передаваемых методу NetStream.play2().

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





[ X ]Почему по-английски?
Содержимое Справочника ActionScript 3.0 отображается на английском языке

Не все части Справочника ActionScript 3.0 переводятся на все языки. Если какой-то текстовый элемент не переведен, он отображается на английском языке. Например, компонент ga.controls.HelpBox не переведен ни на один из языков. Это значит, что в русской версии справки компонент ga.controls.HelpBox будет отображаться на английском языке.