NCManager

Paket	fl.video
Klasse	public class NCManager
Vererbung	NCManager Object
Implementiert	INCManager
Unterklassen	NCManagerNative

Sprachversion:

ActionScript 3.0

Produktversion:

Flash CS3

Laufzeitversionen:

Flash Player 9.0.28.0, AIR 1.0

Erstellt das Objekt NetConnection für die VideoPlayer-Klasse, eine Hilfsklasse für diese benutzerseitige Klasse.

Die NCManager-Klasse sucht eine URL und geht von Folgendem aus:

Wenn der Host des URL-Strings mit einem gültigen FMS-Streaming-Protokoll beginnt, z. B. rtmp://, rtmps:// oder rtmpt://, wird daraus geschlossen, dass die URL von einem FMS gestreamt wird.
Wenn nicht von einem FMS gestreamt wird und die URL ein Fragezeichen (?) enthält, wird daraus geschlossen, dass die URL auf eine SMIL-Datei verweist.
Wenn nicht von einem FMS gestreamt wird und die URL kein Fragezeichen (?) enthält, prüft die NCManager-Klasse, ob die URL mit „.flv“ endet. Wenn die URL mit „.flv“ endet, wird daraus geschlossen, dass sie für einen progressiven FLV-Download ist. Andernfalls ist es eine SMIL-Datei, die heruntergeladen und analysiert werden muss.

Beispiele anzeigen

Öffentliche Eigenschaften

Vererbte öffentliche Eigenschaften ausblenden

Vererbte öffentliche Eigenschaften anzeigen

	Eigenschaft		Definiert von
		bitrate : Number Beim Streaming vom Flash Media Server (FMS) gibt die bitrate-Eigenschaft den bei der automatischen Erkennung berechneten Wert und nicht den mit der bitrate()-Eigenschaft festgelegten Wert zurück.	NCManager
		constructor : Object Ein Verweis auf das Klassenobjekt oder die Konstruktorfunktion für eine angegebene Objektinstanz.	Object
		fallbackServerName : String Macht die fallbackServerName-Eigenschaft indirekt oder direkt sichtbar.	NCManager
		isRTMP : Boolean [schreibgeschützt] Gibt an, ob die URL für RTMP-Streaming von einem Flash Media Server (FMS) oder einen progressiven Download ist.	NCManager
		netConnection : NetConnection [schreibgeschützt] Eine Referenz auf das NetConnection-Objekt.	NCManager
		streamHeight : int [schreibgeschützt] Die Höhe des Streams in Pixel.	NCManager
		streamLength : Number [schreibgeschützt] Die Länge des Streams in Sekunden.	NCManager
		streamName : String [schreibgeschützt] Der Streamname, der in die Methode "NetStream.play()" übergeben wird.	NCManager
		streamWidth : int [schreibgeschützt] Die Breite des Streams in Pixel.	NCManager
		timeout : uint Die Zeit in Millisekunden, nach der Versuche eines Verbindungsaufbaus beendet werden.	NCManager
		videoPlayer : VideoPlayer Das VideoPlayer-Objekt, das dieses Objekt besitzt.	NCManager

Öffentliche Methoden

Vererbte öffentliche Methoden ausblenden

Vererbte öffentliche Methoden anzeigen

	Methode		Definiert von
		NCManager() Erstellt eine neue NCManager-Instanz.	NCManager
		close():void Schließt die NetConnection.	NCManager
		connectAgain():Boolean Wird vom VideoPlayer-Objekt aufgerufen, wenn die Verbindung erfolgreich hergestellt, jedoch kein Stream gefunden wurde.	NCManager
		connectToURL(url:String):Boolean Wird vom VideoPlayer-Objekt aufgerufen, um eine Verbindung mit der URL anzufordern.	NCManager
		getProperty(propertyName:String):* Ermöglicht das Abrufen der Eigenschaften „fallbackServerName“, „fpadZone“, „objectEncoding“ und „proxyType“.	NCManager
		hasOwnProperty(name:String):Boolean Gibt an, ob für ein Objekt eine bestimmte Eigenschaft definiert wurde.	Object
		helperDone(helper:Object, success:Boolean):void Wird von einem helper-Objekt, das eine Aufgabe für das NCManager-Objekt ausführt, aufgerufen, um anzuzeigen, dass die Ausführung abgeschlossen wurde. Außerdem gibt es an, ob Fehler auftraten.	NCManager
		isPrototypeOf(theClass:Object):Boolean Gibt an, ob eine Instanz der Object-Klasse in der Prototypkette des Objekts vorhanden ist, das als Parameter angegeben wurde.	Object
		propertyIsEnumerable(name:String):Boolean Gibt an, ob die angegebene Eigenschaft vorhanden ist und durchlaufen werden kann.	Object
		reconnect():void Wird vom VideoPlayer-Objekt aufgerufen, um eine neue Verbindung anzufordern, nachdem die Verbindung unterbrochen wurde.	NCManager
		setProperty(propertyName:String, value:*):void Ermöglicht das Festlegen der Eigenschaften „fallbackServerName“, „fpadZone“, „objectEncoding“ und „proxyType“.	NCManager
		setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void Legt die Verfügbarkeit einer dynamischen Eigenschaft für Schleifenoperationen fest.	Object
		toLocaleString():String Gibt die Stringdarstellung dieses Objekts zurück, formatiert entsprechend den Konventionen des Gebietsschemas.	Object
		toString():String Gibt das angegebene Objekt als String zurück.	Object
		valueOf():Object Gibt den Grundwert des angegebenen Objekts zurück.	Object

Öffentliche Konstanten

	Konstante		Definiert von
		DEFAULT_TIMEOUT : uint = 60000 Der Standardwert für das Timeout in Millisekunden.	NCManager
		SHORT_VERSION : String = "2.1" [statisch] Statusvariable, die die kurze Versionsnummer der Komponente angibt.	NCManager
		VERSION : String = "2.1.0.23" [statisch] Statusvariable, die die lange Versionsnummer der Komponente angibt.	NCManager

Eigenschaftendetails

bitrate

Eigenschaft

bitrate:Number

Sprachversion:

ActionScript 3.0

Produktversion:

Flash CS3

Laufzeitversionen:

Flash Player 9.0.28.0, AIR 1.0

Beim Streaming vom Flash Media Server (FMS) gibt die bitrate-Eigenschaft den bei der automatischen Erfassung berechneten Wert und nicht den mit der bitrate()-Eigenschaft festgelegten Wert zurück.

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

Verwandte API-Elemente

INCManager.bitrate

fallbackServerName

Eigenschaft

public var fallbackServerName:String

Sprachversion:

ActionScript 3.0

Produktversion:

Flash CS3

Laufzeitversionen:

Flash Player 9.0.28.0, AIR 1.0

Macht die Eigenschaft fallbackServerName indirekt oder direkt sichtbar.

Indirekt: Geben Sie ein zweites <meta base> in SMIL an. Die Eigenschaft fallbackServerName verwendet dieses base-Attribut. (Die Eigenschaft fallbackServerName verwendet ausschließlich den Servernamen.)
Direkt: Greifen Sie in FLVPlayback oder VideoPlayer auf die ncMgr-Eigenschaft zu und legen Sie die fallbackServerName-Eigenschaft fest, oder verwenden Sie die setProperty()-Methode.

Verwandte API-Elemente

setProperty()

isRTMP

Eigenschaft

isRTMP:Boolean [schreibgeschützt]

Sprachversion:

ActionScript 3.0

Produktversion:

Flash CS3

Laufzeitversionen:

Flash Player 9.0.28.0, AIR 1.0

Gibt an, ob die URL für RTMP-Streaming von einem Flash Media Server (FMS) oder einen progressiven Download ist. Wenn der Stream ein RTMP-Stream von einem FMS ist, lautet der Wert true. Wenn der Stream ein progressiver Download einer HTTP-, lokalen oder anderen Datei ist, lautet der Wert false.

Implementierung
public function get isRTMP():Boolean

Verwandte API-Elemente

INCManager.isRTMP

netConnection

Eigenschaft

netConnection:NetConnection [schreibgeschützt]

Sprachversion:

ActionScript 3.0

Produktversion:

Flash CS3

Laufzeitversionen:

Flash Player 9.0.28.0, AIR 1.0

Eine Referenz auf das NetConnection-Objekt.

Implementierung
public function get netConnection():NetConnection

Verwandte API-Elemente

INCManager.netConnection

streamHeight

Eigenschaft

streamHeight:int [schreibgeschützt]

Sprachversion:

ActionScript 3.0

Produktversion:

Flash CS3

Laufzeitversionen:

Flash Player 9.0.28.0, AIR 1.0

Die Höhe des Streams in Pixel. Wenn nach dem Aufruf der Methode VideoPlayer.ncConnected() die Eigenschaft streamHeight "kleiner als 0" ist, wird dadurch dem VideoPlayer-Objekt mitgeteilt, dass keine Informationen zur Streamhöhe vorhanden sind. Wenn die Eigenschaft scaleMode des VideoPlayer-Objekts auf VideoScaleMode.MAINTAIN_ASPECT_RATIO oder VideoScaleMode.NO_SCALE gesetzt ist, wird dieser Wert verwendet und die Größe sofort geändert.

Implementierung
public function get streamHeight():int

Verwandte API-Elemente

INCManager.streamHeight

streamLength

Eigenschaft

streamLength:Number [schreibgeschützt]

Sprachversion:

ActionScript 3.0

Produktversion:

Flash CS3

Laufzeitversionen:

Flash Player 9.0.28.0, AIR 1.0

Die Länge des Streams in Sekunden. Wenn die Methode VideoPlayer.ncConnected() nach ihrem Aufruf "undefined", null oder "kleiner als 0" zurückgibt, dann weiß das VideoPlayer-Objekt, dass keine Informationen zur Streamlänge vorhanden sind. Werden Informationen zur Länge des Streams zurückgegeben, überschreiben diese alle vorhandenen Informationen zur Streamlänge, einschließlich Informationen, die mit dem Parameter totalTime der Methode VideoPlayer.play() oder VideoPlayer.load() festgelegt wurden oder Informationen, die aus den Metadaten der FLV-Datei stammen.

Implementierung
public function get streamLength():Number

Verwandte API-Elemente

INCManager.streamLength

streamName

Eigenschaft

streamName:String [schreibgeschützt]

Sprachversion:

ActionScript 3.0

Produktversion:

Flash CS3

Laufzeitversionen:

Flash Player 9.0.28.0, AIR 1.0

Der Streamname, der in die Methode NetStream.play() übergeben wird.

Implementierung
public function get streamName():String

Verwandte API-Elemente

INCManager.streamName

streamWidth

Eigenschaft

streamWidth:int [schreibgeschützt]

Sprachversion:

ActionScript 3.0

Produktversion:

Flash CS3

Laufzeitversionen:

Flash Player 9.0.28.0, AIR 1.0

Die Breite des Streams in Pixel. Wenn nach dem Aufruf der Methode VideoPlayer.ncConnected() die Eigenschaft streamWidth "kleiner als 0" ist, wird dadurch dem VideoPlayer-Objekt mitgeteilt, dass keine Informationen zur Streambreite vorhanden sind. Wenn die Eigenschaft scaleMode des VideoPlayer-Objekts auf VideoScaleMode.MAINTAIN_ASPECT_RATIO oder VideoScaleMode.NO_SCALE gesetzt ist, wird dieser Wert verwendet und die Größe sofort geändert.

Implementierung
public function get streamWidth():int

Verwandte API-Elemente

INCManager.streamWidth

timeout

Eigenschaft

timeout:uint

Sprachversion:

ActionScript 3.0

Produktversion:

Flash CS3

Laufzeitversionen:

Flash Player 9.0.28.0, AIR 1.0

Die Zeit in Millisekunden, nach der Versuche eines Verbindungsaufbaus beendet werden.

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

Verwandte API-Elemente

INCManager.timeout

videoPlayer

Eigenschaft

videoPlayer:VideoPlayer

Sprachversion:

ActionScript 3.0

Produktversion:

Flash CS3

Laufzeitversionen:

Flash Player 9.0.28.0, AIR 1.0

Das VideoPlayer-Objekt, das dieses Objekt besitzt.

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

Verwandte API-Elemente

INCManager.videoPlayer

Konstruktordetails

()

Konstruktor

public function NCManager()

Sprachversion:

ActionScript 3.0

Produktversion:

Flash CS3

Laufzeitversionen:

Flash Player 9.0.28.0, AIR 1.0

Erstellt eine neue NCManager-Instanz.

Methodendetails

close

()

Methode

public function close():void

Sprachversion:

ActionScript 3.0

Produktversion:

Flash CS3

Laufzeitversionen:

Flash Player 9.0.28.0, AIR 1.0

Schließt die NetConnection.

Verwandte API-Elemente

INCManager.close()

connectAgain

()

Methode

public function connectAgain():Boolean

Sprachversion:

ActionScript 3.0

Produktversion:

Flash CS3

Laufzeitversionen:

Flash Player 9.0.28.0, AIR 1.0

Wird vom VideoPlayer-Objekt aufgerufen, wenn die Verbindung erfolgreich hergestellt, aber der Stream nicht gefunden wurde. Wenn mehrere Interpretationen der RTMP-URL möglich sind, versucht die API mit einer anderen URL erneut eine Verbindung mit dem Server herzustellen und einen anderen Streamnamen zurückzugeben.

Dies kann notwendig sein, wenn die URL beispielsweise rtmp://Servername/Pfad1/Pfad2/Pfad3 ist. Öffnen Sie bei der Angabe eines Anwendungsnamen und eines Instanzennamens das NetConnection-Objekt mit rtmp://Servername/Pfad1/Pfad2 oder verwenden Sie die Standardinstanz, damit der Stream mit Pfad2/Pfad3 geöffnet wird. Im Allgemeinen ist dies möglich, wenn mehr als zwei Teile im Pfad vorhanden sind. Dies ist nicht möglich, wenn nur zwei Teile vorhanden sind (nur ein Teil ist nicht zulässig).

Rückgabewerte

Boolean — Wenn versucht wurde, eine andere Verbindung herzustellen, lautet der Wert true. Wenn bereits ein Verbindungsaufbau versucht wurde oder weitere Versuche zwecklos sind, lautet der Wert false.

Verwandte API-Elemente

INCManager.connectAgain()

connectToURL

()

Methode

public function connectToURL(url:String):Boolean

Sprachversion:

ActionScript 3.0

Produktversion:

Flash CS3

Laufzeitversionen:

Flash Player 9.0.28.0, AIR 1.0

Wird vom VideoPlayer-Objekt aufgerufen, um eine Verbindung zur URL anzufordern. Rufen Sie nach einem erfolgreichen oder fehlgeschlagenen Verbindungsaufbau die Methode VideoPlayer.ncConnected() auf. Wenn die Verbindung fehlgeschlagen ist, stellen Sie vor dem Aufruf nc = null ein.

Parameter

url:String — Die URL, mit der das VideoPlayer-Objekt eine Verbindung herstellen möchte.

Rückgabewerte

Boolean — Wenn eine synchrone Verbindung hergestellt wurde, lautet der Wert true. Wenn versucht wurde, eine asynchrone Verbindung herzustellen, der Aufrufer also ein connected-Ereignis erwarten sollte, false.

Verwandte API-Elemente

INCManager.connectToURL()

getProperty

()

Methode

public function getProperty(propertyName:String):*

Sprachversion:

ActionScript 3.0

Produktversion:

Flash CS3

Laufzeitversionen:

Flash Player 9.0.28.0, AIR 1.0

Ermöglicht das Abrufen der Eigenschaften fallbackServerName, fpadZone, objectEncoding und proxyType. Eine Beschreibung dieser Eigenschaften finden Sie unter setProperty().

Parameter

propertyName:String — Der Name der Eigenschaft, die die getProperty-Methode aufruft.

Rückgabewerte

* — Darstellung der Eigenschaften „fallbackServerName“, „fpadZone“, „objectEncoding“ und „proxyType“ als String.

Verwandte API-Elemente

setProperty()
fallbackServerName

helperDone

()

Methode

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

Sprachversion:

ActionScript 3.0

Produktversion:

Flash CS3

Laufzeitversionen:

Flash Player 9.0.28.0, AIR 1.0

Wird von einem helper-Objekt, das eine Aufgabe für das NCManager-Objekt ausführt, aufgerufen, um anzuzeigen, dass die Ausführung abgeschlossen wurde. Außerdem gibt es an, ob Fehler auftraten. Das NCManager-Objekt verwendet dies mit SMILManager.

Parameter

	`helper:Object` — Das helper-Objekt.

	`success:Boolean` — Eine Einstellung zur Angabe, wenn eine Aufgabe abgeschlossen ist. Wenn der Wert für `success` `true` ist, wurde die Aufgabe erfolgreich abgeschlossen. Andernfalls lautet der Wert `false`.

Verwandte API-Elemente

INCManager.helperDone()

reconnect

()

Methode

public function reconnect():void

Sprachversion:

ActionScript 3.0

Produktversion:

Flash CS3

Laufzeitversionen:

Flash Player 9.0.28.0, AIR 1.0

Wird vom VideoPlayer-Objekt aufgerufen, um eine neue Verbindung anzufordern, nachdem die Verbindung unterbrochen wurde. Rufen Sie nach einem erfolgreichen oder fehlgeschlagenen Verbindungsaufbau die Methode VideoPlayer.ncReconnected() auf. Wenn die Verbindung fehlgeschlagen ist, stellen Sie vor dem Aufruf nc = null ein.

Verwandte API-Elemente

INCManager.reconnect()

setProperty

()

Methode

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

Sprachversion:

ActionScript 3.0

Produktversion:

Flash CS3

Laufzeitversionen:

Flash Player 9.0.28.0, AIR 1.0

Ermöglicht das Festlegen der Eigenschaften fallbackServerName, fpadZone, objectEncoding und proxyType.

Die Eigenschaft fallbackServerName legt eine URL für den Flash Media Server (FMS) fest. Diese URL wird verwendet, wenn die primäre Serveradresse, die von der nach connectToURL() übergebenen URL abgeleitet wurde, nicht erreicht werden kann. Diese Eigenschaft kann auch direkt mit der Eigenschaft fallbackServerName festgelegt werden.

Die Eigenschaft fpadZone legt die Eigenschaft fpadZone für Flash Media Server (FMS) fest. Wenn der zurückgegebene Wert keine Zahl ist (NaN), dann wird keine Zone festgelegt. Die Eigenschaft fpadZone muss festgelegt werden, bevor der Verbindungsvorgang wirksam wird. Wenn Sie keine Zone festlegen möchten, legen Sie für die Eigenschaft fpadZone den Wert NaN fest.

Der Standardwert ist NaN.

Die Eigenschaft objectEncoding legt den Wert fest, der für die Eigenschaft objectEncoding bei NetConnection-Instanzen verwendet wird. Der Standardwert ist flash.net.ObjectEncoding.AMF0.

Die Eigenschaft proxyType legt den Wert fest, der für die Eigenschaft proxyType bei NetConnection-Instanzen verwendet wird. Die Standardeinstellung ist "best".

Parameter

	`propertyName:String` — Der Name der Eigenschaft, die die `setProperty`-Methode aufruft.

	`value:*` — Der Wert der Eigenschaft.

Verwandte API-Elemente

getProperty()
fallbackServerName

Konstantendetails

DEFAULT_TIMEOUT

Konstante

public const DEFAULT_TIMEOUT:uint = 60000

Sprachversion:

ActionScript 3.0

Produktversion:

Flash CS3

Laufzeitversionen:

Flash Player 9.0.28.0, AIR 1.0

Der Standardwert für das Timeout in Millisekunden.

Verwandte API-Elemente

INCManager.timeout

SHORT_VERSION

Konstante

public static const SHORT_VERSION:String = "2.1"

Sprachversion:

ActionScript 3.0

Produktversion:

Flash CS3

Laufzeitversionen:

Flash Player 9.0.28.0, AIR 1.0

Statusvariable, die die kurze Versionsnummer der Komponente angibt. Die Versionsnummer ist nützlich, wenn Sie eine FLA-Datei haben und wissen müssen, um welche Version der Komponente es sich handelt. Geben Sie zur Bestimmung der Komponentenversion die folgende Codeablaufverfolgung in die FLA-Datei ein:

FLVPlayback.SHORT_VERSION

Die Variable SHORT_VERSION umfasst nur die Haupt- und Unterversionen, z. B. 2.0. Die Variable VERSION umfasst die Haupt- und Unterversionen sowie die Änderungs- und Buildnummern, z. B. 2.2.2.11.

Verwandte API-Elemente

VERSION-Variable

VERSION

Konstante

public static const VERSION:String = "2.1.0.23"

Sprachversion:

ActionScript 3.0

Produktversion:

Flash CS3

Laufzeitversionen:

Flash Player 9.0.28.0, AIR 1.0

Statusvariable, die die lange Versionsnummer der Komponente angibt. Die Versionsnummer ist nützlich, wenn Sie eine FLA-Datei haben und wissen müssen, um welche Version der Komponente es sich handelt. Geben Sie zur Bestimmung der Komponentenversion die folgende Codeablaufverfolgung in die FLA-Datei ein:

FLVPlayback.VERSION

Die Variable VERSION umfasst die Haupt- und Unterversionen sowie die Änderungs- und Buildnummern, z. B. 2.2.2.11. Die Variable SHORT_VERSION umfasst nur die Haupt- und Unterversionen, z. B. 2.0.

Verwandte API-Elemente

SHORT_VERSION-Variable

Beispiele Verwendung dieses Beispiels

NCManagerExample.as

Im folgenden Beispiel wird veranschaulicht, wie auf das NCManager-Objekt eines VideoPlayer-Objekts zugegriffen wird, um zu bestimmen, ob ein Video gestreamt oder progressiv heruntergeladen wird.

Gehen Sie wie folgt vor, um das Beispiel auszuführen:

Fügen Sie die FLVPlayback-Komponente zur Bibliothek hinzu.
Ersetzen Sie testVideoPath durch einen absoluten oder relativen Pfad zu einer FLV-Datei.
Speichern Sie diesen Code unter NCManagerExample.as im gleichen Verzeichnis wie die FLA-Datei.
Legen Sie in der FLA-Datei die NCManagerExample-Dokumentklasse fest.

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

Rechtliche Hinweise | Onlinedatenschutzerklärung

NCManager - AS3 Flash

Klassen x

bitrate

fallbackServerName

isRTMP

netConnection

streamHeight

streamLength

streamName

streamWidth

timeout

videoPlayer

NCManager

close

connectAgain

connectToURL

getProperty

helperDone

reconnect

setProperty

DEFAULT_TIMEOUT

SHORT_VERSION

VERSION