NCManager

Pakiet	fl.video
Klasa	public class NCManager
Dziedziczenie	NCManager Object
Implementuje	INCManager
Podklasy	NCManagerNative

Wersja języka:

ActionScript 3.0

Wersja produktu:

Flash CS3

Wersje środowiska wykonawczego:

Flash Player 9.0.28.0, AIR 1.0

Tworzy obiekt NetConnection dla klasy VideoPlayer — klasę pomocniczą względem klasy przeznaczonej dla użytkownika.

Klasa NCManager poszukuje adresu URL i definiuje następujące założenia:

Jeśli ciąg znaków adresu URL hosta rozpoczyna się od poprawnego protokołu transmisji strumieniowej FMS (np. rtmp://, rtmps:// lub rtmpt://), klasa zakłada, że adres URL jest przesyłany strumieniowo z FMS.
Jeśli nie jest przesyłany strumieniowo z FMS oraz jeśli adres URL zawiera znak zapytania (?), klasa zakłada, że adres URL wskazuje na plik SMIL.
Jeśli nie jest przesyłany strumieniowo FMS oraz nie zawiera znaku zapytania (?), klasa NCManager sprawdza, czy adres kończy się znakami .flv. Jeśli adres kończy się znakami .flv, klasa zakłada, że adres służy do stopniowego pobierania FLV. W przeciwnym wypadku jest to plik SMIL przeznaczony do pobierania i analizowania.

Wyświetl przykłady

Właściwości publiczne

Ukryj dziedziczone właściwości publiczne

Pokaż dziedziczone właściwości publiczne

	Właściwość		Zdefiniowane przez
		bitrate : Number Jeśli dane są przesyłane strumieniowo z serwera FMS (Flash Media Server), właściwość bitrate zwraca wartość obliczoną przez funkcję automatycznego wykrywania, a nie wartość ustawioną przez właściwość bitrate().	NCManager
		constructor : Object Odwołanie do obiektu klasy lub funkcji konstruktora, dotyczące danej instancji obiektu.	Object
		fallbackServerName : String Uaktywnia właściwość fallbackServerName, pośrednio lub bezpośrednio.	NCManager
		isRTMP : Boolean [tylko do odczytu] Jeśli adres URL jest przeznaczony do strumieniowego przesyłania RTMP z serwera Flash Media Server (FMS) lub pobierania stopniowego.	NCManager
		netConnection : NetConnection [tylko do odczytu] Odwołanie do obiektu NetConnection.	NCManager
		streamHeight : int [tylko do odczytu] Wysokość strumienia w pikselach.	NCManager
		streamLength : Number [tylko do odczytu] Czas trwania strumienia w sekundach.	NCManager
		streamName : String [tylko do odczytu] Nazwa strumienia przekazana do metody NetStream.play().	NCManager
		streamWidth : int [tylko do odczytu] Szerokość strumienia w pikselach.	NCManager
		timeout : uint Czas w milisekundach, po jakim kończą się próby nawiązania połączenia.	NCManager
		videoPlayer : VideoPlayer Obiekt VideoPlayer, do którego należy ten obiekt.	NCManager

Metody publiczne

Ukryj dziedziczone metody publiczne

Pokaż dziedziczone metody publiczne

	Metoda		Zdefiniowane przez
		NCManager() Tworzy nową instancję NCManager.	NCManager
		close():void Zamyka połączenie NetConnection.	NCManager
		connectAgain():Boolean Wywoływana przez obiekt VideoPlayer, jeśli nawiązanie połączenia powiodło się, ale nie znaleziono strumienia.	NCManager
		connectToURL(url:String):Boolean Wywoływana przez obiekt VideoPlayer w celu ponownego uzyskania połączenia z adresem URL.	NCManager
		getProperty(propertyName:String):* Umożliwia pobieranie właściwości fallbackServerName, fpadZone, objectEncoding i proxyType.	NCManager
		hasOwnProperty(name:String):Boolean Wskazuje, czy dla obiektu zdefiniowano określoną właściwość.	Object
		helperDone(helper:Object, success:Boolean):void Wywoływana przez dowolny obiekt pomocniczy obiektu INCManager; informuje, czy operacja została wykonana i czy zakończyła się pomyślnie.	NCManager
		isPrototypeOf(theClass:Object):Boolean Wskazuje, czy instancja klasy Object należy do łańcucha prototypów obiektu określonego jako parametr.	Object
		propertyIsEnumerable(name:String):Boolean Wskazuje, czy określona właściwość istnieje i jest przeliczalna.	Object
		reconnect():void Wywoływana przez obiekt VideoPlayer w celu ponownego połączenia w przypadku utraty połączenia.	NCManager
		setProperty(propertyName:String, value:*):void Umożliwia ustawienie właściwości fallbackServerName, fpadZone, objectEncoding i proxyType.	NCManager
		setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void Ustawia dostępność właściwości dynamicznej używanej w pętlach.	Object
		toLocaleString():String Zwraca ciąg reprezentujący obiekt — sformatowany zgodnie z konwencjami właściwymi dla ustawień regionalnych.	Object
		toString():String Zwraca ciąg reprezentujący określony obiekt.	Object
		valueOf():Object Zwraca pierwotną wartość dla określonego obiektu.	Object

Stałe publiczne

	Stała		Zdefiniowane przez
		DEFAULT_TIMEOUT : uint = 60000 Domyślny limit czasu w milisekundach.	NCManager
		SHORT_VERSION : String = "2.1" [statyczny] Zmienna stanu wskazująca na krótki numer wersji składnika.	NCManager
		VERSION : String = "2.1.0.23" [statyczny] Zmienna stanu wskazująca na długi numer wersji składnika.	NCManager

Szczegół właściwości

bitrate

właściwość

bitrate:Number

Wersja języka:

ActionScript 3.0

Wersja produktu:

Flash CS3

Wersje środowiska wykonawczego:

Flash Player 9.0.28.0, AIR 1.0

Jeśli dane są przesyłane strumieniowo z serwera FMS (Flash Media Server), właściwość bitrate zwraca wartość obliczoną przez funkcję automatycznego wykrywania, a nie wartość ustawioną przez właściwość bitrate().

Implementacja
public function get bitrate():Number
public function set bitrate(value:Number):void

Powiązane elementy interfejsu API

INCManager.bitrate

fallbackServerName

właściwość

public var fallbackServerName:String

Wersja języka:

ActionScript 3.0

Wersja produktu:

Flash CS3

Wersje środowiska wykonawczego:

Flash Player 9.0.28.0, AIR 1.0

Uaktywnia właściwość fallbackServerName pośrednio lub bezpośrednio.

Pośrednio — poprzez wprowadzenie dodatkowej wartości <meta base> do SMIL. Właściwość fallbackServerName korzysta z tego atrybutu podstawowego. (Właściwość fallbackServerName korzysta tylko z nazwy serwera i niczego innego).
Bezpośrednio — poprzez uzyskanie dostępu do właściwości ncMgr w obiekcie FLVPlayback lub VideoPlayer, a następnie ustawienie właściwości fallbackServerName lub użycie metody setProperty().

Powiązane elementy interfejsu API

setProperty()

isRTMP

właściwość

isRTMP:Boolean [tylko do odczytu]

Wersja języka:

ActionScript 3.0

Wersja produktu:

Flash CS3

Wersje środowiska wykonawczego:

Flash Player 9.0.28.0, AIR 1.0

Jeśli adres URL jest przeznaczony do strumieniowego przesyłania RTMP z serwera Flash Media Server (FMS) lub pobierania stopniowego. Jeśli strumień jest strumieniem RTMP dla FMS, wówczas wartością jest true. Jeśli strumień dotyczy pliku pobieranego stopniowo za pośrednictwem HTTP, pobieranego lokalnie lub innego pliku, wówczas wartością jest false.

Implementacja
public function get isRTMP():Boolean

Powiązane elementy interfejsu API

INCManager.isRTMP

netConnection

właściwość

netConnection:NetConnection [tylko do odczytu]

Wersja języka:

ActionScript 3.0

Wersja produktu:

Flash CS3

Wersje środowiska wykonawczego:

Flash Player 9.0.28.0, AIR 1.0

Odniesienie do obiektu NetConnection.

Implementacja
public function get netConnection():NetConnection

Powiązane elementy interfejsu API

INCManager.netConnection

streamHeight

właściwość

streamHeight:int [tylko do odczytu]

Wersja języka:

ActionScript 3.0

Wersja produktu:

Flash CS3

Wersje środowiska wykonawczego:

Flash Player 9.0.28.0, AIR 1.0

Wysokość strumienia w pikselach. Jeśli po wywołaniu metody VideoPlayer.ncConnected() właściwość streamHeight ma wartość niższą niż 0, oznacza to dla obiektu VideoPlayer, że nie ma informacji o wysokości strumienia. Jeśli właściwość scaleMode obiektu VideoPlayer jest ustawiona na wartość VideoScaleMode.MAINTAIN_ASPECT_RATIO lub VideoScaleMode.NO_SCALE, wówczas ta wartość jest używana i zmiana wielkości następuje natychmiastowo bez opóźnienia.

Implementacja
public function get streamHeight():int

Powiązane elementy interfejsu API

INCManager.streamHeight

streamLength

właściwość

streamLength:Number [tylko do odczytu]

Wersja języka:

ActionScript 3.0

Wersja produktu:

Flash CS3

Wersje środowiska wykonawczego:

Flash Player 9.0.28.0, AIR 1.0

Czas trwania strumienia w sekundach. Jeśli po wywołaniu metoda VideoPlayer.ncConnected() zwróci wartość undefined, null lub mniejszą od 0, wówczas obiekt VideoPlayer będzie wiedział o tym, że nie ma informacji o czasie trwania strumienia. Jeśli zostaną zwrócone informacje o czasie trwania strumienia, zastąpią one wszelkie istniejące informacje o tym czasie, łącznie z informacjami ustawionymi przez parametr totalTime metody VideoPlayer.play(), metody VideoPlayer.load() lub informacje odebrane z metadanych pliku FLV.

Implementacja
public function get streamLength():Number

Powiązane elementy interfejsu API

INCManager.streamLength

streamName

właściwość

streamName:String [tylko do odczytu]

Wersja języka:

ActionScript 3.0

Wersja produktu:

Flash CS3

Wersje środowiska wykonawczego:

Flash Player 9.0.28.0, AIR 1.0

Nazwa strumienia przekazana do metody NetStream.play().

Implementacja
public function get streamName():String

Powiązane elementy interfejsu API

INCManager.streamName

streamWidth

właściwość

streamWidth:int [tylko do odczytu]

Wersja języka:

ActionScript 3.0

Wersja produktu:

Flash CS3

Wersje środowiska wykonawczego:

Flash Player 9.0.28.0, AIR 1.0

Szerokość strumienia w pikselach. Jeśli po wywołaniu metody VideoPlayer.ncConnected() właściwość streamWidth ma wartość niższą niż 0, oznacza to dla obiektu VideoPlayer, że nie ma informacji o szerokości strumienia. Jeśli właściwość scaleMode obiektu VideoPlayer jest ustawiona na wartość VideoScaleMode.MAINTAIN_ASPECT_RATIO lub VideoScaleMode.NO_SCALE, wówczas ta wartość jest używana i zmiana wielkości następuje natychmiastowo bez opóźnienia.

Implementacja
public function get streamWidth():int

Powiązane elementy interfejsu API

INCManager.streamWidth

timeout

właściwość

timeout:uint

Wersja języka:

ActionScript 3.0

Wersja produktu:

Flash CS3

Wersje środowiska wykonawczego:

Flash Player 9.0.28.0, AIR 1.0

Czas w milisekundach, po jakim kończą się próby nawiązania połączenia.

Implementacja
public function get timeout():uint
public function set timeout(value:uint):void

Powiązane elementy interfejsu API

INCManager.timeout

videoPlayer

właściwość

videoPlayer:VideoPlayer

Wersja języka:

ActionScript 3.0

Wersja produktu:

Flash CS3

Wersje środowiska wykonawczego:

Flash Player 9.0.28.0, AIR 1.0

Obiekt VideoPlayer, do którego należy ten obiekt.

Implementacja
public function get videoPlayer():VideoPlayer
public function set videoPlayer(value:VideoPlayer):void

Powiązane elementy interfejsu API

INCManager.videoPlayer

Konstruktor Szczegół

()

Konstruktor

public function NCManager()

Wersja języka:

ActionScript 3.0

Wersja produktu:

Flash CS3

Wersje środowiska wykonawczego:

Flash Player 9.0.28.0, AIR 1.0

Tworzy nowe wystąpienie klasy NCManager.

Szczegół metody

close

()

metoda

public function close():void

Wersja języka:

ActionScript 3.0

Wersja produktu:

Flash CS3

Wersje środowiska wykonawczego:

Flash Player 9.0.28.0, AIR 1.0

Zamyka połączenie NetConnection.

Powiązane elementy interfejsu API

INCManager.close()

connectAgain

()

metoda

public function connectAgain():Boolean

Wersja języka:

ActionScript 3.0

Wersja produktu:

Flash CS3

Wersje środowiska wykonawczego:

Flash Player 9.0.28.0, AIR 1.0

Wywoływana przez obiekt VideoPlayer, jeśli nawiązanie połączenia powiodło się, ale nie znaleziono strumienia. Jeśli możliwych jest wiele alternatywnych interpretacji RTMP URL, klasa podejmuje próbę nawiązania połączenia z serwerem pod innym adresem URL, a następnie przekazuje inną nazwę strumienia.

Może to być konieczne w przypadkach, gdy adres URL przypomina następujący adres: rtmp://servername/path1/path2/path3. W przypadku wprowadzania nazwy aplikacji i nazwy instancji należy otworzyć obiekt NetConnection, korzystając z adresu rtmp://servername/path1/path2 lub użyć domyślnej instancji w taki sposób, aby strumień został otwarty z adresu path2/path3. Zwykle jest to możliwe, gdy istnieją więcej niż dwie części ścieżki, ale nie jest to możliwe, gdy istnieją tylko dwie części (nigdy nie powinno być tylko jednej części).

Zwraca

Boolean — Jeśli wykonano próbę nawiązania innego połączenia, wartością jest true. Jeśli wykonano już próbę lub dodatkowe próby nie są pożądane, wówczas wartością jest false.

Powiązane elementy interfejsu API

INCManager.connectAgain()

connectToURL

()

metoda

public function connectToURL(url:String):Boolean

Wersja języka:

ActionScript 3.0

Wersja produktu:

Flash CS3

Wersje środowiska wykonawczego:

Flash Player 9.0.28.0, AIR 1.0

Wywoływana przez obiekt VideoPlayer w celu ponownego uzyskania połączenia z adresem URL. Po przerwaniu połączenia lub jego nawiązaniu należy wywołać metodę VideoPlayer.ncConnected(). Jeśli nawiązanie połączenia nie powiodło się, należy przed wywołaniem ustawić nc = null.

Parametry

url:String — Adres URL, z którym chce się połączyć obiekt VideoPlayer.

Zwraca

Boolean — Jeśli połączenie jest wykonywane synchronicznie, wartość true. Jeśli próba została wykonana asynchronicznie i strona wywołująca może oczekiwać zdarzenia "connected", wartością jest false.

Powiązane elementy interfejsu API

INCManager.connectToURL()

getProperty

()

metoda

public function getProperty(propertyName:String):*

Wersja języka:

ActionScript 3.0

Wersja produktu:

Flash CS3

Wersje środowiska wykonawczego:

Flash Player 9.0.28.0, AIR 1.0

Umożliwia pobieranie właściwości fallbackServerName, fpadZone, objectEncoding i proxyType. Opis tych właściwości zawiera sekcja setProperty().

Parametry

propertyName:String — Nazwa właściwości, którą wywołuje metoda getProperty.

Zwraca

* — Reprezentacja właściwości fallbackServerName, fpadZone, objectEncoding i proxyType w postaci łańcucha znaków.

Powiązane elementy interfejsu API

setProperty()
fallbackServerName

helperDone

()

metoda

public function helperDone(helper:Object, success:Boolean):void

Wersja języka:

ActionScript 3.0

Wersja produktu:

Flash CS3

Wersje środowiska wykonawczego:

Flash Player 9.0.28.0, AIR 1.0

Wywoływana przez dowolny obiekt pomocniczy obiektu INCManager; informuje, czy operacja została wykonana i czy zakończyła się sukcesem. Obiekt NCManager korzysta z tej metody z obiektem SMILManager.

Parametry

	`helper:Object` — Obiekt pomocniczy.

	`success:Boolean` — Ustawienie sygnału po zakończeniu zadania. Jeśli parametr `success` ma wartość `true`, oznacza to, że zadanie zostało zakończone pomyślnie; w przeciwnym wypadku jest to wartość `false`.

Powiązane elementy interfejsu API

INCManager.helperDone()

reconnect

()

metoda

public function reconnect():void

Wersja języka:

ActionScript 3.0

Wersja produktu:

Flash CS3

Wersje środowiska wykonawczego:

Flash Player 9.0.28.0, AIR 1.0

Wywoływana przez obiekt VideoPlayer w celu ponownego połączenia w przypadku utraty połączenia. Po przerwaniu połączenia lub jego nawiązaniu należy wywołać metodę VideoPlayer.ncReconnected(). Jeśli nawiązanie połączenia nie powiodło się, należy przed wywołaniem ustawić nc = null.

Powiązane elementy interfejsu API

INCManager.reconnect()

setProperty

()

metoda

public function setProperty(propertyName:String, value:*):void

Wersja języka:

ActionScript 3.0

Wersja produktu:

Flash CS3

Wersje środowiska wykonawczego:

Flash Player 9.0.28.0, AIR 1.0

Umożliwia ustawienie właściwości fallbackServerName, fpadZone, objectEncoding i proxyType.

Właściwość fallbackServerName określa adres Flash Media Server (FMS) URL, jaki powinien być używany wówczas, gdy nie jest możliwe nawiązanie połączenia z serwerem głównym, którego adres uzyskany na podstawie adresu URL przekazano do connectToURL(). Ta właściwość może zostać również ustawiona bezpośrednio za pomocą właściwości fallbackServerName.

Właściwość fpadZone określa właściwość fpadZone dla serwera Flash Media Server (FMS). Jeśli zwrócona wartość nie jest liczbą (NaN), wówczas nie jest ustawiana żadna strefa. Właściwość fpadZone musi być ustawiona przed rozpoczęciem przetwarzania połączenia — tylko wówczas będzie miała wpływ na połączenie. Jeśli użytkownik nie chce ustawiać strefy, należy ustawić dla właściwości fpadZone wartość NaN.

Wartością domyślną jest NaN.

Właściwość objectEncoding określa wartość, jaka ma być używana dla właściwości objectEncoding w instancjach NetConnection. Domyślnie: flash.net.ObjectEncoding.AMF0.

Właściwość proxyType określa wartość, jaka ma być używana dla właściwości proxyType w instancjach NetConnection. Domyślnie: „best”.

Parametry

	`propertyName:String` — Nazwa właściwości, którą wywołuje metoda `setProperty`.

	`value:*` — Wartość właściwości.

Powiązane elementy interfejsu API

getProperty()
fallbackServerName

Szczegół stałej

DEFAULT_TIMEOUT

Stała

public const DEFAULT_TIMEOUT:uint = 60000

Wersja języka:

ActionScript 3.0

Wersja produktu:

Flash CS3

Wersje środowiska wykonawczego:

Flash Player 9.0.28.0, AIR 1.0

Domyślny limit czasu w milisekundach.

Powiązane elementy interfejsu API

INCManager.timeout

SHORT_VERSION

Stała

public static const SHORT_VERSION:String = "2.1"

Wersja języka:

ActionScript 3.0

Wersja produktu:

Flash CS3

Wersje środowiska wykonawczego:

Flash Player 9.0.28.0, AIR 1.0

Zmienna stanu wskazująca na krótki numer wersji składnika. Numer wersji jest użyteczny, gdy istnieje plik FLA i wymagane jest określenie wersji składnika. W celu określenia wersji składnika należy wpisać następującą instrukcję trace do pliku FLA:

FLVPlayback.SHORT_VERSION

Zmienna SHORT_VERSION zawiera tylko główne i podrzędne numery wersji, na przykład: 2.0. Zmienna VERSION zawiera główne i podrzędne numery wersji, a także numery poprawek i kompilacji, na przykład: 2.0.0.11.

Powiązane elementy interfejsu API

Zmienna VERSION

VERSION

Stała

public static const VERSION:String = "2.1.0.23"

Wersja języka:

ActionScript 3.0

Wersja produktu:

Flash CS3

Wersje środowiska wykonawczego:

Flash Player 9.0.28.0, AIR 1.0

Zmienna stanu wskazująca na długi numer wersji składnika. Numer wersji jest użyteczny, gdy istnieje plik FLA i wymagane jest określenie wersji składnika. W celu określenia wersji składnika należy wpisać następującą instrukcję trace do pliku FLA:

FLVPlayback.VERSION

Zmienna VERSION zawiera główne i podrzędne numery wersji, a także numery poprawek i kompilacji, na przykład: 2.0.0.11. Zmienna SHORT_VERSION zawiera tylko główne i podrzędne numery wersji, na przykład: 2.0.

Powiązane elementy interfejsu API

Zmienna SHORT_VERSION

Przykłady Sposób korzystania z tego przykładu

NCManagerExample.as

Ten przykład demonstruje, w jaki sposób należy uzyskać dostęp do obiektu NCManager należącego do obiektu VideoPlayer w celu określenia, czy plik wideo jest przesyłany strumieniowo lub pobierany stopniowo.

W celu uruchomienia przykładu należy wykonać poniższe czynności:

Dodaj składnik FLVPlayback do biblioteki.
Zastąp testVideoPath ścieżką względną lub bezwzględną do pliku FLV.
Zapisz kod jako NCManagerExample.as w tym samym katalogu, w którym znajduje się plik FLA.
Ustaw dla klasy Document w pliku FLA wartość 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");
            }
        }
    }
}

Informacje prawne | Zasady prywatności online

NCManager - AS3 Flash

Klasy x

bitrate

fallbackServerName

isRTMP

netConnection

streamHeight

streamLength

streamName

streamWidth

timeout

videoPlayer

NCManager

close

connectAgain

connectToURL

getProperty

helperDone

reconnect

setProperty

DEFAULT_TIMEOUT

SHORT_VERSION

VERSION