Главная / Action Script 3
Пакетfl.video
Классpublic class NCManager
НаследованиеNCManager Inheritance Object
Реализует INCManager
Подклассы NCManagerNative

Язык версии : ActionScript 3.0
Версии среды выполнения:  1.0 9.0.28.0

Создает объект NetConnection для класса VideoPlayer — вспомогательного класса для этого интерфейсного класса.

Класс NCManager ищет URL-адрес и принимает следующее.

Посмотреть примеры



Общедоступные свойства
 СвойствоОпределено
  bitrate : Number
При потоковой загрузке с сервера Flash Media Server (FMS) свойство bitrate содержит значение, вычисленное в ходе автообнаружения, а не значение, установленное с помощью свойства bitrate().
NCManager
 Inheritedconstructor : Object
Ссылка на объект класса или функцию конструктора для данного экземпляра объекта.
Object
  fallbackServerName : String
Явно или косвенно делает доступным свойство fallbackServerName.
NCManager
  isRTMP : Boolean
[только для чтения] Является ли поток с данного адреса URL потоком RTMP c сервера Flash Media Server (FMS) или потоком последовательной загрузки.
NCManager
  netConnection : NetConnection
[только для чтения] Ссылка на объект NetConnection.
NCManager
 Inheritedprototype : Object
[статические] Ссылка на модель объекта класса или функции.
Object
  streamHeight : int
[только для чтения] Высота потока (пикселы).
NCManager
  streamLength : Number
[только для чтения] Длина потока (секунды).
NCManager
  streamName : String
[только для чтения] Имя потока, переданного в метод NetStream.play().
NCManager
  streamWidth : int
[только для чтения] Ширина потока (пикселы).
NCManager
  timeout : uint
Промежуток времени, по истечении которого прекращаются попытки соединения (мс).
NCManager
  videoPlayer : VideoPlayer
Объект VideoPlayer, которому принадлежит этот объект.
NCManager
Общедоступные методы
 МетодОпределено
  
Создает новый экземпляр класса NCManager.
NCManager
  
Закрывает объект NetConnection.
NCManager
  
Вызывается объектом VideoPlayer, если подключение успешно установлено, но поток не найден.
NCManager
  
Вызывается объектом VideoPlayer для запроса соединения с адресом URL.
NCManager
  
getProperty(propertyName:String):*
Позволяет возвращать свойства fallbackServerName, fpadZone, objectEncoding и proxyType.
NCManager
 Inherited
Показывает, определено ли заданное свойство для объекта.
Object
  
helperDone(helper:Object, success:Boolean):void
Вызывается любым вспомогательным объектом, выполняющим задачу для объекта NCManager, чтобы просигнализировать об успешном или неуспешном завершении задачи.
NCManager
 Inherited
Показывает, есть ли экземпляр класса Object в цепи прототипов объекта, заданного в качестве параметра.
Object
 Inherited
Показывает наличие заданного свойства и его перечисляемость.
Object
  
Вызывается объектом VideoPlayer, чтобы запросить повторное подключение после потери подключения.
NCManager
  
setProperty(propertyName:String, value:*):void
Позволяет задавать свойства fallbackServerName, fpadZone, objectEncoding и proxyType.
NCManager
 Inherited
Задает доступность динамического свойства для операций цикла.
Object
 Inherited
Возвращает строковое представление заданного объекта.
Object
 Inherited
Возвращает элементарное значение заданного объекта.
Object
Общедоступные константы
 Константа Определено
  DEFAULT_TIMEOUT : uint = 60000
Время ожидания по умолчанию, в миллисекундах.
NCManager
  SHORT_VERSION : String = "2.1"
[статические] Переменная состояния, указывающая сокращенный номер версии компонента.
NCManager
  VERSION : String = "2.1.0.19"
[статические] Переменная состояния, указывающая полный номер версии компонента.
NCManager
Сведения о свойстве
bitrateсвойство
bitrate:Number  [чтение и запись]

Язык версии : ActionScript 3.0
Версии среды выполнения:  1.0 9.0.28.0

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



Реализация
    public function get bitrate():Number
    public function set bitrate(value:Number):void

См. также

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

Язык версии : ActionScript 3.0
Версии среды выполнения:  1.0 9.0.28.0

Делает явно или косвенно доступным свойство fallbackServerName.

См. также

isRTMPсвойство 
isRTMP:Boolean  [только для чтения]

Язык версии : ActionScript 3.0
Версии среды выполнения:  1.0 9.0.28.0

Является ли поток с данного адреса URL потоком RTMP c сервера Flash Media Server (FMS) или потоком последовательной загрузки. Если поток является потоком RTMP с сервера FMS, то свойство имеет значение true. Если поток является последовательной загрузкой с HTTP, локального или другого файла, то свойство имеет значение false.



Реализация
    public function get isRTMP():Boolean

См. также

netConnectionсвойство 
netConnection:NetConnection  [только для чтения]

Язык версии : ActionScript 3.0
Версии среды выполнения:  1.0 9.0.28.0

Ссылка на объект NetConnection.



Реализация
    public function get netConnection():NetConnection

См. также

streamHeightсвойство 
streamHeight:int  [только для чтения]

Язык версии : ActionScript 3.0
Версии среды выполнения:  1.0 9.0.28.0

Высота потока (пикселы). Если после вызова метода VideoPlayer.ncConnected() значение свойства streamHeight меньше 0, то это указывает объекту VideoPlayer, что информация о ширине потока отсутствует. Если для свойства scaleMode объекта VideoPlayer установлено значение VideoScaleMode.MAINTAIN_ASPECT_RATIO или VideoScaleMode.NO_SCALE, то будет использоваться данное значение и изменение размеров происходит немедленно без задержки.



Реализация
    public function get streamHeight():int

См. также

streamLengthсвойство 
streamLength:Number  [только для чтения]

Язык версии : ActionScript 3.0
Версии среды выполнения:  1.0 9.0.28.0

Длина потока (секунды). Если после вызова метода VideoPlayer.ncConnected() возвращаемое значение не определено, равно null или меньше 0, то объект VideoPlayer знает, что здесь нет информации о длине потока. Если возвращается информация о длине потока, то она замещает любую существующую информацию о длине потока, включая информацию, устанавливаемую параметромtotalTime метода VideoPlayer.play() или метода VideoPlayer.load(), или информацию, полученную из метаданных FLV-файла.



Реализация
    public function get streamLength():Number

См. также

streamNameсвойство 
streamName:String  [только для чтения]

Язык версии : ActionScript 3.0
Версии среды выполнения:  1.0 9.0.28.0

Имя потока, переданного в метод NetStream.play().



Реализация
    public function get streamName():String

См. также

streamWidthсвойство 
streamWidth:int  [только для чтения]

Язык версии : ActionScript 3.0
Версии среды выполнения:  1.0 9.0.28.0

Ширина потока (пикселы). Если после вызова метода VideoPlayer.ncConnected() значение свойства streamWidth меньше 0, то это указывает объекту VideoPlayer, что здесь нет информации о ширине потока. Если для свойства scaleMode объекта VideoPlayer установлено значение VideoScaleMode.MAINTAIN_ASPECT_RATIO или VideoScaleMode.NO_SCALE, то используется данное значение и изменение размеров происходит немедленно без задержки.



Реализация
    public function get streamWidth():int

См. также

timeoutсвойство 
timeout:uint  [чтение и запись]

Язык версии : ActionScript 3.0
Версии среды выполнения:  1.0 9.0.28.0

Промежуток времени, по истечении которого прекращаются попытки соединения (мс).



Реализация
    public function get timeout():uint
    public function set timeout(value:uint):void

См. также

videoPlayerсвойство 
videoPlayer:VideoPlayer  [чтение и запись]

Язык версии : ActionScript 3.0
Версии среды выполнения:  1.0 9.0.28.0

Объект VideoPlayer, которому принадлежит этот объект.



Реализация
    public function get videoPlayer():VideoPlayer
    public function set videoPlayer(value:VideoPlayer):void

См. также

Сведения о конструкторе
NCManager()Конструктор
public function NCManager()

Язык версии : ActionScript 3.0
Версии среды выполнения:  1.0 9.0.28.0

Создает новый экземпляр класса NCManager.

Сведения о методе
close()метод
public function close():void

Язык версии : ActionScript 3.0
Версии среды выполнения:  1.0 9.0.28.0

Закрывает объект NetConnection.

См. также

connectAgain()метод 
public function connectAgain():Boolean

Язык версии : ActionScript 3.0
Версии среды выполнения:  1.0 9.0.28.0

Вызывается объектом VideoPlayer, если подключение успешно установлено, но поток не найден. Если возможны несколько альтернативных вариантов URL-адреса RTMP, то производится попытка подключения к другим URL-адресам, и возвращаются различные имена потоков.

Это необходимо в случае, если URL-адрес выглядит как rtmp://servername/path1/path2/path3. При передаче имени приложения или имени экземпляра откройте объект NetConnection с адресом rtmp://servername/path1/path2 или используйте стандартный экземпляр, то есть поток откроется с адресом path2/path3. В общем, это возможно когда имеется более двух частей для адреса и невозможно, если их всего две (не должно быть одной части).

Возвращает
Boolean — Если выполняется попытка установить другое соединение, то значение параметра — true. Если попытка уже выполнена или дополнительные попытки не требуются, то значение параметра — false.

См. также

connectToURL()метод 
public function connectToURL(url:String):Boolean

Язык версии : ActionScript 3.0
Версии среды выполнения:  1.0 9.0.28.0

Вызывается объектом VideoPlayer для запроса соединения с адресом URL. После успешного или неудачного соединения вызывается метод VideoPlayer.ncConnected(). При неудачном соединении перед вызовом установите свойство nc = null.

Параметры

url:String — URL-адрес запроса соединения объекта VideoPlayer.

Возвращает
Boolean — Если соединение устанавливается синхронно, то параметр имеет значение true. Если попытка соединения выполняетя асинхронно, то есть вызывающий должен ожидать событие "соединен", параметр имеет значечение false.

См. также

getProperty()метод 
public function getProperty(propertyName:String):*

Язык версии : ActionScript 3.0
Версии среды выполнения:  1.0 9.0.28.0

Позволяет возвращать свойства fallbackServerName, fpadZone, objectEncoding и proxyType. Более подробную информации об этих свойствах смотрите в setProperty().

Параметры

propertyName:String — Имя свойства, вызываемого методом getProperty.

Возвращает
* — Строковое представление свойств fallbackServerName, fpadZone, objectEncoding и proxyType.

См. также

helperDone()метод 
public function helperDone(helper:Object, success:Boolean):void

Язык версии : ActionScript 3.0
Версии среды выполнения:  1.0 9.0.28.0

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

Параметры

helper:Object — Вспомогательный объект.
 
success:Boolean — Параметр вывода сигнала, если задача завершена. Если свойствоsuccess имеет значение true, то задача завершена успешно, иначе — значение false.

См. также

reconnect()метод 
public function reconnect():void

Язык версии : ActionScript 3.0
Версии среды выполнения:  1.0 9.0.28.0

Вызывается объектом VideoPlayer, чтобы запросить повторное подключение после потери подключения. После успешного или неуспешного подключения вызывается метод VideoPlayer.ncReconnected(). После неуспешного соединения перед вызовом установите параметр nc = null.

См. также

setProperty()метод 
public function setProperty(propertyName:String, value:*):void

Язык версии : ActionScript 3.0
Версии среды выполнения:  1.0 9.0.28.0

Позволяет задавать свойства fallbackServerName , fpadZone, objectEncoding и proxyType.

Свойство fallbackServerName определяет URL-адрес Flash Media Server (FMS). Этот адрес используется, если недоступен адрес основного сервера, полученный с URL-адреса, переданного в connectToURL. Данное свойство также можно установить непосредственно через свойство fallbackServerName.

Свойство fpadZone определяет свойство fpadZone для Flash Media Server (FMS). Если возвращаемое значение не является номером (NaN), то присваивается значение "нет зоны". Свойство fpadZone должно быть установлено перед началом соединения. Если не требуется установка зоны, то установите для свойства fpadZone значение NaN.

По умолчанию используется NaN.

Свойство objectEncodingопределяет значение, используемое для свойства objectEncoding в экземплярах NetConnection. По умолчанию используется flash.net.ObjectEncoding.AMF0.

Свойство proxyType определяет значение, используемое для свойства proxyType в экземплярах NetConnection. По умолчанию используется значение best.

Параметры

propertyName:String — Имя свойства, вызываемого методом setProperty.
 
value:* — Значение свойства.

См. также

Сведения о константе
DEFAULT_TIMEOUTКонстанта
public const DEFAULT_TIMEOUT:uint = 60000

Язык версии : ActionScript 3.0
Версии среды выполнения:  1.0 9.0.28.0

Время ожидания по умолчанию, в миллисекундах.

См. также

SHORT_VERSIONКонстанта  
public static const SHORT_VERSION:String = "2.1"

Язык версии : ActionScript 3.0
Версии среды выполнения:  1.0 9.0.28.0

Переменная состояния, указывающая сокращенный номер версии компонента. Номер версии полезен, если есть FLA-файл и нужно узнать версию компонента. Для определения версии компонента вставьте следующий код трассировки в FLA-файл:

FLVPlayback.SHORT_VERSION

Переменная SHORT_VERSION включает только старший и младший номер версии, например 2.0. Переменная VERSION включает старший и младший номер версии, редакцию и номер сборки, например 2.0.0.11.

См. также

VERSIONКонстанта  
public static const VERSION:String = "2.1.0.19"

Язык версии : ActionScript 3.0
Версии среды выполнения:  1.0 9.0.28.0

Переменная состояния, указывающая полный номер версии компонента. Номер версии полезен, если есть FLA-файл и нужно узнать версию компонента. Для определения версии компонента вставьте следующий код трассировки в FLA-файл:

FLVPlayback.VERSION

Переменная VERSION включает старший и младший номер версии, редакцию и номер сборки, например 2.0.0.11. Переменная SHORT_VERSION включает только старший и младший номер версии, например 2.0.

См. также

Примеры Как пользоваться примерами
NCManagerExample.as

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

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

  1. Добавьте в библиотеку компонент FLVPlayback.
  2. Введите вместо testVideoPath абсолютный или относительный путь к FLV-файлу.
  3. Сохраните этот код под именем NCManagerExample.as в том же каталоге, где хранится FLV-файл.
  4. Присвойте классу Document в FLA-файле значение NCManagerExample.
package
{
    import fl.video.VideoEvent;
    import fl.video.VideoPlayer;
    import flash.display.Sprite;    

    public class NCManagerExample extends Sprite 
    {
        private var videoPath:String = "http://www.helpexamples.com/flash/video/sheep.flv"
        private var player:VideoPlayer;
        
        public function NCManagerExample() {
            player = new VideoPlayer();
            player.play(videoPath);
            player.addEventListener(VideoEvent.READY,announceRTMS);
            addChild(player);
        }
        private function announceRTMS(e:VideoEvent):void {
            var player:VideoPlayer = e.target as VideoPlayer;
            if(player.ncMgr.isRTMP) {
                trace("Video is streaming");
            }
            else {
                trace("Video is progressively downloading");
            }
        }
    }
}