VideoPlayer  - AS3 Flash

Gibt an, wie das Video relativ zu den registrationX-, registrationY-, registrationWidth- und registrationHeight-Eigenschaften angezeigt wird. Die Eigenschaft align löst dieses automatische Layout aus, wenn die Eigenschaft scaleMode auf VideoScaleMode.MAINTAIN_ASPECT_RATIO oder VideoScaleMode.NO_SCALE gesetzt ist. Wird diese Eigenschaft geändert, nachdem eine FLV-Datei geladen wurde, wird sofort ein automatisches Layout erstellt. Die Werte werden aus der VideoAlign-Klasse abgerufen.

Der Standardwert ist VideoAlign.CENTER.

Verwandte API-Elemente

Ein boolescher Wert; bei der Einstellung true wird die FLV-Datei beim Beenden der Wiedergabe zu Bild 1 zurückgespult, weil entweder das Ende des Streams erreicht oder die Methode stop() aufgerufen wurde. Diese Eigenschaft hat für Live-Streams keine Bedeutung.

Der Standardwert ist false.

Eine Zahl, die angibt, wie viele Sekunden zwischengespeichert werden sollen, bevor ein Videostream abgespielt wird. Für FLV-Dateien, die über RTMP gestreamt und deshalb nicht heruntergeladen und nur im Arbeitsspeicher zwischengespeichert werden, ist es u. U. wichtig, für diese Einstellung einen höheren Wert als den Standardwert 0,1 zu verwenden. Für eine FLV-Datei, die über HTTP progressiv heruntergeladen wird, ist der Vorteil beim Erhöhen dieses Werts nur gering; allerdings kann die Anzeige eines Videos mit hoher Qualität auf einem älteren, langsameren Computer damit verbessert werden.

Legen Sie bei bereits aufgenommenen Videos (keine Live-Videos) für die Eigenschaft bufferTime nicht den Wert 0 fest. Verwenden Sie die Standardzwischenspeicherzeit oder erhöhen Sie die Zwischenspeicherzeit.

Diese Eigenschaft gibt nicht an, wie viel der FLV-Datei heruntergeladen werden muss, bevor die Wiedergabe beginnt.

Verwandte API-Elemente

Eine Zahl, die angibt, wie viele Byte bereits heruntergeladen wurden, falls es sich um einen HTTP-Download handelt. Gibt „0“ zurück, wenn kein Stream stattfindet, wenn der Stream vom Flash Media Server (FMS) erfolgt oder wenn die Informationen noch nicht verfügbar sind. Der Rückgabewert ist nur für HTTP-Downloads von Bedeutung.

Eine Zahl, die angibt, wie viele Byte insgesamt bei einem HTTP-Download heruntergeladen werden. Gibt „-1“ zurück, wenn kein Stream stattfindet, wenn der Stream vom Flash Media Server (FMS) erfolgt oder wenn die Informationen noch nicht verfügbar sind. Der Rückgabewert ist nur für HTTP-Downloads von Bedeutung.

Eine Zahl, die die Höhe der VideoPlayer-Instanz in Pixel angibt.

Hinweis: Verwechseln Sie diese Eigenschaft nicht mit der Eigenschaft flash.media.Video.height, die der Eigenschaft fl.video.VideoPlayer.videoHeight entspricht.

Verwandte API-Elemente

Die Dauer in Millisekunden, bevor Flash eine nicht aktive Verbindung zu einem Video-Server, wie z. B. Flash Media Server, trennt, weil das Abspielen angehalten oder beendet wurde. Diese Eigenschaft wirkt sich nicht auf FLV-Dateien aus, die über HTTP heruntergeladen werden.

Wenn diese Eigenschaft festgelegt wird, während ein Videostream bereits inaktiv ist, wird die Timeout-Zeit mit dem neuen Wert neu gestartet.

Damit alle VideoPlayer-Objekte Ihre benutzerdefinierte Klasse als die standardmäßige INCManager-Implementierung verwenden, legen Sie für die Eigenschaft iNCManagerClass das Klassenobjekt oder den Stringnamen Ihrer benutzerdefinierten Klasse fest. Die FLVPlayback-Klasse enthält die Definition der benutzerdefinierten Klasse, der Video-Player nicht.

Der Standardwert ist "fl.video.NCManager" als ein String.

Ein boolescher Wert; bei der Einstellung true wird angegeben, dass es sich um einen Video-Livestream handelt. Diese Eigenschaft wirkt sich nur beim Streaming von einem Video-Server, wie z. B. Flash Media Server oder einem anderen Flash Video Streaming Service, aus. Der Wert dieser Eigenschaft wird bei HTTP-Downloads ignoriert.

Legen Sie für die Eigenschaft isLive den Wert false fest, wenn Sie einen bereits aufgenommenen Videostream an den Video-Player senden. Legen Sie true fest, wenn Sie Echtzeitdaten, z. B. eine Live-Broadcastübertragung, senden. Sie verbessern die Leistung, wenn Sie für die Eigenschaft isLive den Wert false festlegen und für die Eigenschaft bufferTime nicht den Wert 0 festlegen.

Verwandte API-Elemente

Ein boolescher Wert; die Einstellung true bedeutet, dass die FLV-Datei vom Flash Media Server (FMS) mithilfe von RTMP gestreamt wird. Für jede andere FLV-Dateiquelle lautet der Wert false.

Verwandte API-Elemente

Ein Objekt, bei dem es sich um ein Metadaten-Informationspaket handelt, das von einem Aufruf der Rückrufmethode NetStream.onMetaData() empfangen wird, falls verfügbar. Bereit, wenn das metadataReceived-Ereignis ausgelöst wird.

Wenn die FLV-Datei mit dem Flash 8-Encoder kodiert wurde, enthält die metadata-Eigenschaft die folgenden Informationen. Ältere FLV-Dateien enthalten nur die Werte für height, width und duration.

Verwandte API-Elemente

Ein INCManager-Objekt, das Zugriff auf eine Instanz der Klasse, die INCManager implementiert, bietet, wobei es sich um eine Schnittstelle zur NCManager-Klasse handelt.

Sie können diese Eigenschaft verwenden, um einen benutzerdefinierten INCManager, der eine benutzerdefinierte Initialisierung erfordert, zu implementieren

Verwandte API-Elemente

Gestattet direkten Zugriff auf die vom Video-Player erstellte NetConnection-Instanz.

Gestattet direkten Zugriff auf die vom Video-Player erstellte NetStream-Instanz.

Registriert eine benutzerdefinierte Klasse für die NetStream-Eigenschaft „client“. Standardmäßig wird fl.video.VideoPlayerClient verwendet; diese Klasse verarbeitet die Meldungen onMetaData() und onCuePoint(). Um die benutzerdefinierte Verarbeitung anderer Meldungen hinzuzufügen, zum Beispiel onImageData() und onTextData(), können Sie eine eigene Klasse erstellen und den Wert dieser Eigenschaft auf die Klasse setzen.

Der Konstruktor für die Klasse muss eine VideoPlayer-Instanz als einzigen Parameter annehmen, und er muss eine boolesche ready-Eigenschaft aufweisen. Diese Eigenschaft sollte auf false gesetzt werden, während der Client noch auf erwartete Datenmeldungen am Anfang der Datei wartet. Wenn der VideoPlayer automatisch zurückspult, bevor diese Meldungen erhalten werden, werden sie möglicherweise nie empfangen. Standardmäßig gibt fl.video.VideoPlayerClient den Wert true von der ready-Eigenschaft zurück, sobald onMetaData() aufgerufen wird.

Sie können die Eigenschaft auf das Klassenobjekt selbst (wie im folgenden Beispiel) oder auf den Stringnamen der Klasse setzen:

        import fl.video.
        VideoPlayer.netStreamClientClass = MyCustomClient;
        

Beachten Sie, dass es nicht genügt, den Stringnamen der Klasse zu verwenden, um die Kompilierung der Klasse in die SWF-Datei zu erzwingen. Der Standardwert ist das Klassenobjekt fl.video.VideoPlayerClient, nicht der Stringname.

Es wird dringend empfohlen, benutzerdefinierte Implementierungen als Unterklassen von fl.video.VideoPlayer zu konfigurieren. Andernfalls besteht das Risiko, dass Metadaten und Cue-Point-Verarbeitung, die in die VideoPlayer- und FLVPlayback-Komponente integriert sind, aufgeteilt werden.

Der Standardwert ist fl.video.VideoPlayerClient.

Eine Zahl, die die aktuelle Position (Zeit) des Abspielkopfs angibt. Diese Angabe erfolgt in Sekunden, wobei es sich auch um einen Bruchwert handeln kann. Das Festlegen dieser Eigenschaft löst eine Suche aus, bei der alle Einschränkungen einer Suche gelten.

Wenn sich die Zeit des Abspielkopfs ändert, was beim Abspielen der FLV-Datei jede Viertelsekunde passiert, löst die Komponente das Ereignis playheadUpdate aus.

Aus verschiedenen Gründen hat die Eigenschaft playheadTime möglicherweise nicht sofort nach dem Aufrufen einer der Suchmethoden oder dem Festlegen von playheadTime zum Auslösen eines Suchlaufs den erwarteten Wert. Erstens können Sie bei einem progressiven Download nur nach einem Schlüsselbild suchen, so dass ein Suchlauf Sie zu der Zeit des ersten Schlüsselbilds nach der angegebenen Zeit bringt. (Beim Streaming führt eine Suche immer zur exakt angegebenen Zeit, selbst wenn die FLV-Quelldatei an dieser Stelle über kein Schlüsselbild verfügt.) Zweitens ist die Suche asynchron, sodass beim Aufrufen einer Suchmethode oder beim Einstellen der playheadTime-Eigenschaft der Wert von playheadTime nicht sofort aktualisiert wird. Um die Zeit nach dem Abschluss der Suche abzurufen, warten Sie auf das Ereignis seek, welches erst ausgelöst wird, wenn die Eigenschaft playheadTime aktualisiert wurde.

Verwandte API-Elemente

Eine Zahl, die die Zeit (in Millisekunden) zwischen den einzelnen playheadUpdate-Ereignissen angibt. Wenn Sie diese Eigenschaft beim Abspielen der FLV-Datei festlegen, wird der Timer zurückgesetzt.

Da ActionScript-Cue-Points bei Aktualisierungen des Abspielkopfs starten, kann das Verringern des Werts für die Eigenschaft playheadUpdateInterval die Genauigkeit von ActionScript-Cue-Points erhöhen.

Weil das Intervall für die Aktualisierung des Abspielkopfs durch einen Aufruf der globalen Methode setInterval() festgelegt wird, kann die Aktualisierung nicht häufiger ausgelöst werden, als es die Bildrate der SWF-Datei zulässt. Dies gilt für alle Intervalle, die auf diese Weise festgelegt werden. Beispiel: Bei der Standardbildrate von 12 Bildern pro Sekunde ist das niedrigste effektive Intervall, das Sie erstellen können, ungefähr 83 Millisekunden oder 1 Sekunde (1000 Millisekunden) geteilt durch 12.

Der Standardwert ist 250.

Verwandte API-Elemente

Eine Zahl, die die Zeit (in Millisekunden) zwischen den einzelnen progress-Ereignissen angibt. Wenn Sie diese Eigenschaft beim Abspielen des Videostreams festlegen, wird der Timer neu gestartet.

Die Höhe, die bei der automatischen Größenänderung zum Ausrichten des Videoinhalts verwendet wird. Verwechseln Sie die Eigenschaft registrationHeight nicht mit der Eigenschaft height. Die Eigenschaft height gibt die tatsächliche Höhe des Videoinhalts wieder.

Beispiel 1: Laden Sie eine FLV-Datei mit 80 x 80 mit den folgenden Einstellungen:

• registrationX = 100
• registrationY = 100
• registrationWidth = 60
• registrationHeight = 40
• align = VideoAlign.CENTER
• scaleMode = VideoScaleMode.NO_SCALE

• x = 90
• y = 80
• width = 80
• height = 80

Beispiel 2: Laden Sie das gleiche Szenario wie in Beispiel 1, aber mit den folgenden Einstellungen:

• scaleMode = VideoScaleMode.MAINTAIN_ASPECT_RATIO

• x = 110
• y = 100
• width = 40
• height = 80

Beispiel 3: Laden Sie das gleiche Szenario wie in Beispiel 2, aber mit den folgenden Einstellungen:

• scaleMode = VideoScaleMode.EXACT_FIT

• x = 100
• y = 100
• width = 60
• height = 40

Das Festlegen der Eigenschaft registrationHeight entspricht dem Festlegen der Eigenschaft height (und umgekehrt). Wenn Sie eine andere Eigenschaft festlegen oder irgendeine Methode aufrufen, die die Höhe ändert, wie z. B. scaleX, setSize und setScale, bleiben auch height und registrationHeight synchronisiert.

Verwandte API-Elemente

Die Breite, die bei der automatischen Größenänderung zum Ausrichten des Videoinhalts verwendet wird. Verwechseln Sie die Eigenschaft registrationWidth nicht mit der Eigenschaft width. Die Eigenschaft width gibt die tatsächliche Breite des Videoinhalts wieder.

Beispiel 1: Laden Sie eine FLV-Datei mit 80 x 80 mit den folgenden Einstellungen:

• registrationX = 100
• registrationY = 100
• registrationWidth = 60
• registrationHeight = 40
• align = VideoAlign.CENTER
• scaleMode = VideoScaleMode.NO_SCALE

• x = 90
• y = 80
• width = 80
• height = 80

Beispiel 2: Laden Sie das gleiche Szenario wie in Beispiel 1, aber mit den folgenden Einstellungen:

• scaleMode = VideoScaleMode.MAINTAIN_ASPECT_RATIO

• x = 110
• y = 100
• width = 40
• height = 80

Beispiel 3: Laden Sie das gleiche Szenario wie in Beispiel 2, aber mit den folgenden Einstellungen:

• scaleMode = VideoScaleMode.EXACT_FIT

• x = 100
• y = 100
• width = 60
• height = 40

Das Festlegen der registrationWidth-Eigenschaft entspricht dem Festlegen der width-Eigenschaft (und umgekehrt). Wenn Sie eine andere Eigenschaft festlegen oder irgendeine Methode aufrufen, die die Breite ändert, wie z. B. scaleX, setSize und setScale, bleiben auch width und registrationWidth synchronisiert.

Verwandte API-Elemente

Die x-Koordinate, die bei der automatischen Größenänderung zum Ausrichten des Videoinhalts verwendet wird. Verwechseln Sie dies nicht mit der Eigenschaft x, die die tatsächliche Position des Videoinhalts wiedergibt.

Beispiel 1: Laden Sie eine FLV-Datei mit 80 x 80 mit den folgenden Einstellungen:

• registrationX = 100
• registrationY = 100
• registrationWidth = 60
• registrationHeight = 40
• align = VideoAlign.CENTER
• scaleMode = VideoScaleMode.NO_SCALE

• x = 90
• y = 80
• width = 80
• height = 80

Beispiel 2: Laden Sie das gleiche Szenario wie in Beispiel 1, aber mit den folgenden Einstellungen:

• scaleMode = VideoScaleMode.MAINTAIN_ASPECT_RATIO

• x = 110
• y = 100
• width = 40
• height = 80

Beispiel 3: Laden Sie das gleiche Szenario wie in Beispiel 2, aber mit den folgenden Einstellungen:

• scaleMode = VideoScaleMode.EXACT_FIT

• x = 100
• y = 100
• width = 60
• height = 40

Wenn entweder die Eigenschaft x oder registrationX festgelegt ist, wird die zweite Eigenschaft geändert, um ihren Offset von der ersten beizubehalten. Beispiel: Wenn x = 10 und registrationX = 20 ist, wird durch Festlegen von x = 110 auch registrationX = 120 festgelegt.

Verwandte API-Elemente

Die y-Koordinate, die bei der automatischen Größenänderung zum Ausrichten des Videoinhalts verwendet wird. Verwechseln Sie dies nicht mit der Eigenschaft y, die die tatsächliche Position des Videoinhalts wiedergibt.

Beispiel 1: Laden Sie eine FLV-Datei mit 80 x 80 mit den folgenden Einstellungen:

• registrationX = 100
• registrationY = 100
• registrationWidth = 60
• registrationHeight = 40
• align = VideoAlign.CENTER
• scaleMode = VideoScaleMode.NO_SCALE

• x = 90
• y = 80
• width = 80
• height = 80

Beispiel 2: Laden Sie das gleiche Szenario wie in Beispiel 1, aber mit den folgenden Einstellungen:

• scaleMode = VideoScaleMode.MAINTAIN_ASPECT_RATIO

• x = 110
• y = 100
• width = 40
• height = 80

Beispiel 3: Laden Sie das gleiche Szenario wie in Beispiel 2, aber mit den folgenden Einstellungen:

• scaleMode = VideoScaleMode.EXACT_FIT

• x = 100
• y = 100
• width = 60
• height = 40

Wenn entweder die Eigenschaft y oder registrationY festgelegt ist, wird die zweite Eigenschaft geändert, um ihren Offset von der ersten beizubehalten. Beispiel: Wenn y = 10 und registrationY = 20 ist, wird durch Festlegen von y = 110 auch registrationY = 120 festgelegt.

Verwandte API-Elemente

Gibt die Größenänderung des Videos nach dem Ladevorgang an. Bei der Einstellung VideoScaleMode.MAINTAIN_ASPECT_RATIO wird das Seitenverhältnis des Videos innerhalb des durch registrationX, registrationY, registrationWidth und registrationHeight definierten Rechtecks beibehalten. Bei der Einstellung VideoScaleMode.NO_SCALE wird die Größe des Videos automatisch auf die Abmessungen der FLV-Quelldatei eingestellt. Bei der Einstellung VideoScaleMode.EXACT_FIT werden die Abmessungen der FLV-Quelldatei ignoriert und das Video gedehnt, um in das durch registrationX, registrationY, registrationWidth und registrationHeight definierte Rechteck zu passen. Wenn diese Einstellung vorgenommen wird, nachdem eine FLV-Datei geladen wurde, wird sofort ein automatisches Layout erstellt. Die Werte werden aus der VideoScaleMode-Klasse abgerufen.

Der Standardwert ist VideoScaleMode.MAINTAIN_ASPECT_RATIO.

Verwandte API-Elemente

Eine Zahl, die die horizontale Skalierung darstellt.

Der Standardwert ist 1.

Verwandte API-Elemente

Eine Zahl, die die vertikale Skalierung darstellt.

Der Standardwert ist 1.

Verwandte API-Elemente

Bietet direkten Zugriff auf die Eigenschaft NetStream.soundTransform, um die Lautstärke besser regeln zu können. Legen Sie die Eigenschaft fest, um die Einstellungen zu ändern. Verwenden Sie die Get-Accessor-Methode der Eigenschaft, um die aktuellen Einstellungen abzurufen.

Verwandte API-Elemente

Ein String, der die URL der zu streamenden FLV-Datei und die Art des Streamings angibt. Bei der URL kann es sich um eine HTTP-URL zu einer FLV-Datei, eine RTMP-URL zu einem Stream oder eine HTTP-URL zu einer XML-Datei handeln.

Wenn Sie diese Eigenschaft im Komponenteninspektor oder im Eigenschafteninspektor festlegen, wird die FLV-Datei beim Eintreten des Ereignisses enterFrame geladen und abgespielt. Die Verzögerung bietet Zeit, um die Eigenschaften isLive, autoPlay und cuePoints zu setzen, die den Ladevorgang betreffen. Damit kann auch ActionScript-Code, der im ersten Bild eingefügt wurde, vor dem Beginn der Wiedergabe auf die FLVPlayback-Komponente angewendet werden.

Wenn Sie diese Eigenschaft mit ActionScript festlegen, wird sofort die Methode VideoPlayer.load() aufgerufen, wenn für die Eigenschaft autoPlay der Wert false festgelegt ist. Alternativ wird die Methode VideoPlayer.play() aufgerufen, wenn für die Eigenschaft autoPlay der Wert true festgelegt ist. Die Eigenschaften autoPlay, totalTime und isLive beeinflussen, wie die neue FLV-Datei geladen wird. Wenn Sie diese Eigenschaften festlegen, müssen Sie dies deshalb vor dem Festlegen der Eigenschaft source tun.

Stellen Sie für die Eigenschaft autoPlay den Wert false ein, um das automatische Abspielen der neuen FLV-Datei zu verhindern.

Verwandte API-Elemente

Ein String, der den Status der Komponente angibt. Diese Eigenschaft wird mit den Methoden load(), play(), stop(), pause() und seek() festgelegt.

Die möglichen Werte für die state-Eigenschaft lauten: buffering, connectionError, disconnected, loading, paused, playing, rewinding, seeking und stopped. Sie können die FLVPlayback-Klasseneigenschaften verwenden, um diese Statuszustände zu überprüfen.

Verwandte API-Elemente

Ein boolescher Wert; die Einstellung true bedeutet, dass der Status interaktiv ist. Wenn der Status nicht interaktiv ist, werden die Aufrufe der Methoden play(), load(), stop(), pause() und seek() in eine Warteschlange gestellt und später ausgeführt, wenn der Status wieder interaktiv ist. Da diese Aufrufe in eine Warteschlange gestellt und später ausgeführt werden, ist es normalerweise nicht nötig, den Wert der Eigenschaft stateResponsive nachzuverfolgen. Die interaktiven Statuszustände sind: stopped, playing, paused und buffering.

Verwandte API-Elemente

Eine Zahl, die die Gesamtspielzeit des Videos in Sekunden angibt.

Beim Streaming vom Flash Media Server (FMS) mit dem Standard-NCManager wird dieser Wert automatisch von serverseitigen APIs (Anwendungsprogrammierschnittstellen) bestimmt. Dieser Wert überschreibt alles, was durch diese Eigenschaft festgelegt oder von Metadaten abgerufen wird. Die Eigenschaft kann gelesen werden, wenn der Status stopped oder playing erreicht wird, nachdem die Eigenschaft source festgelegt wurde. Diese Eigenschaft hat für Live-Streams von einem FMS keine Bedeutung.

Bei einem HTTP-Download wird dieser Wert automatisch bestimmt, wenn die FLV-Datei über eingebettete Metadaten verfügt; andernfalls legen Sie den Wert explizit fest. Falls Sie den Wert nicht festlegen, ist er „NaN“ (keine Zahl). Wenn Sie den Wert festlegen, wird der Metadatenwert im Stream ignoriert.

Wenn Sie diese Eigenschaft festlegen, tritt der Wert für die nächste FLV-Datei, die durch das Festlegen von source geladen wird, in Kraft. Die Eigenschaft hat keine Auswirkungen auf eine FLV-Datei, die bereits geladen wurde. Außerdem übergibt diese Eigenschaft den neuen Wert erst dann, wenn eine FLV-Datei geladen wird.

Die FLV-Datei kann immer noch abgespielt werden, wenn die Eigenschaft nie gesetzt wird (weder ausdrücklich noch automatisch); es kann aber zu Problemen bei Suchläufen (Vorlauf/Rücklauf) kommen.

Wenn Sie die Eigenschaft nicht festlegen, ist der Wert solange „NaN“, bis ein gültiger Wert aus den Metadaten festgelegt wird.

Verwandte API-Elemente

Die ursprüngliche Breite der geladenen FLV-Datei. Diese Eigenschaft gibt „-1" zurück, wenn noch keine Informationen verfügbar sind.

Verwandte API-Elemente

Die ursprüngliche Breite der geladenen FLV-Datei. Diese Eigenschaft gibt „-1" zurück, wenn noch keine Informationen verfügbar sind.

Verwandte API-Elemente

Ein boolescher Wert; bei der Einstellung true ist die VideoPlayer-Instanz sichtbar. Bei der Einstellung false ist die Instanz nicht sichtbar.

Der Standardwert ist true.

Eine Zahl im Bereich 0 bis 1, die die Lautstärkeeinstellung angibt.

Der Standardwert ist 1.

Verwandte API-Elemente

Eine Zahl, die die Breite der VideoPlayer-Instanz auf der Bühne festlegt.

Hinweis: Die Eigenschaft flash.media.Video.width entspricht der Eigenschaft fl.video.VideoPlayer.videoWidth.

Verwandte API-Elemente

Eine Zahl, die die horizontale Position des Video-Players in Pixel angibt.

Das Festlegen der Eigenschaft x betrifft auch die Eigenschaft registrationX. Wenn entweder die Eigenschaft x oder registrationX festgelegt ist, wird die zweite Eigenschaft geändert, um ihren Offset von der ersten beizubehalten. Beispiel: Wenn x = 10 und registrationX = 20 ist, wird durch Festlegen von x = 110 auch registrationX = 120 festgelegt.

Verwandte API-Elemente

Eine Zahl, die die vertikale Position des Video-Players in Pixel angibt.

Das Festlegen der Eigenschaft y betrifft auch die Eigenschaft registrationY. Wenn entweder die Eigenschaft y oder registrationY festgelegt ist, wird die zweite Eigenschaft geändert, um ihren Offset von der ersten beizubehalten. Beispiel: Wenn y = 10 und registrationY = 20 ist, wird durch Festlegen von y = 110 auch registrationY = 120 festgelegt.

Verwandte API-Elemente

Erstellt ein neues VideoPlayer-Objekt mit der angegebenen Breite und Höhe.

Verwandte API-Elemente

Erzwingt das Schließen des Video-Streams und der Flash Media Server-Verbindung. Diese Methode löst das Ereignis close aus. Normalerweise brauchen Sie diese Methode nicht direkt aufzurufen, weil die idleTimeout-Funktionalität den Stream schließt.

Verwandte API-Elemente

Ähnelt der Methode play(); die FLV-Datei wird zwar geladen, aber nicht abgespielt. Die Größe wird automatisch geändert, falls zutreffend, und das erste Bild der FLV-Datei wird angezeigt. Nach dem anfänglichen Laden und automatischen Layout ist der Status VideoState.PAUSED.

Diese Methode verwendet dieselben Parameter wie die play()-Methode, Sie können die load()-Methode jedoch nicht ohne eine URL aufrufen. Falls Sie es tun, wird ein Fehler ausgegeben. Wenn sich der Video-Player in einem nicht interaktiven Status befindet, wird die Anforderung von der Methode load() in eine Warteschlange gestellt.

Parameter

Verwandte API-Elemente

Wird von INCManager aufgerufen, nachdem die Verbindung hergestellt wurde oder nachdem die Verbindung nach einem Aufruf der Methode INCManager.connectToURL() fehlgeschlagen ist. Wenn die Verbindung fehlgeschlagen ist, legen Sie vor dem Aufrufen für die Eigenschaft INCManager.netConnection den Wert null oder "undefined" fest.

Verwandte API-Elemente

Wird von INCManager aufgerufen, nachdem die neue Verbindung hergestellt wurde oder nachdem die Verbindung nach einem Aufruf der Methode INCManager.reconnect() fehlgeschlagen ist. Wenn die Verbindung fehlgeschlagen ist, legen Sie vor dem Aufrufen für die Eigenschaft INCManager.netconnection den Wert null fest.

Verwandte API-Elemente

Hält die Videowiedergabe an. Wenn das Video angehalten oder beendet ist, hat dies keine Auswirkungen. Um die Wiedergabe erneut zu starten, rufen Sie play() auf. Akzeptiert keine Parameter.

Wenn der Player in einem nicht interaktiven Status ist, stellt die pause()-Methode die Anforderung in eine Warteschlange.

Löst eine Ausnahme aus, wenn sie aufgerufen wird und kein Stream vorhanden ist. Bestimmen Sie mit dem Ereignis stateChange und der Eigenschaft connected den Zeitpunkt, wann es sicher ist, diese Methode aufzurufen.

Wenn der Player beendet wurde, hat ein Aufruf der pause()-Methode keine Auswirkungen und der Status des Players bleibt "stopped".

Verwandte API-Elemente

Löst das Abspielen des Videos aus. Kann aufgerufen werden, während das Video angehalten oder beendet wurde oder abgespielt wird. Rufen Sie diese Methode ohne Argumente auf, um ein bereits geladenes Video abzuspielen oder eine URL zu übergeben, um einen neuen Stream zu laden.

Wenn der Player in einem nicht interaktiven Status ist, wird die Anforderung in eine Warteschlange gestellt.

Löst eine Ausnahme aus, wenn es ohne Argumente aufgerufen wird und kein Stream vorhanden ist. Bestimmen Sie mit dem Ereignis stateChange und der Eigenschaft connected den Zeitpunkt, wann es sicher ist, diese Methode aufzurufen.

Parameter

Verwandte API-Elemente

Gibt die FLV-Datei wieder, wenn genügend Daten davon heruntergeladen wurden. Wenn die FLV-Datei heruntergeladen wurde oder Sie vom Flash Media Server (FMS) streamen, dann entspricht das Aufrufen der playWhenEnoughDownloaded()-Methode dem Aufrufen der play()-Methode ohne Parameter. Durch das Aufrufen dieser Methode wird die Wiedergabe nicht angehalten. In vielen Fällen sollten Sie also die Methode pause() vor dieser Methode aufrufen.

Sucht einen bestimmten Zeitpunkt in der Datei, der in Sekunden angegeben und bis auf drei Dezimalstellen (Millisekunden) genau ist. Wird ein Video abgespielt, wird es von diesem Zeitpunkt ab weiter abgespielt. Ist ein Video angehalten, wird dieser Zeitpunkt gesucht. Das Video bleibt angehalten. Ist das Video beendet, wird dieser Zeitpunkt gesucht. Das Video wechselt in den Status "paused". Hat keine Auswirkungen bei Live-Streams.

Die Eigenschaft playheadTime hat u. U. nicht sofort nach dem Aufrufen einer der Suchmethoden oder dem Festlegen von playheadTime zum Auslösen eines Suchlaufs den erwarteten Wert. Bei einem progressiven Download können Sie nur nach einem Schlüsselbild suchen; deshalb bringt ein Suchlauf Sie zu der Zeit des ersten Schlüsselbilds nach der angegebenen Zeit.

Hinweis: Beim Streaming führt eine Suche immer zu der exakt angegebenen Zeit, selbst wenn die FLV-Quelldatei an dieser Stelle über kein Schlüsselbild verfügt.

Die Suche ist asynchron, sodass beim Aufrufen einer Suchmethode oder beim Festlegen der Eigenschaft playheadTime der Wert von playheadTime nicht sofort aktualisiert wird. Um die Zeit nach dem Abschluss der Suche abzurufen, warten Sie auf das Ereignis seek, welches erst ausgelöst wird, wenn die Eigenschaft playheadTime aktualisiert wurde.

Löst eine Ausnahme aus, wenn sie aufgerufen wird und kein Stream vorhanden ist. Bestimmen Sie mit dem Ereignis stateChange und der Eigenschaft connected den Zeitpunkt, wann es sicher ist, diese Methode aufzurufen.

Parameter

Verwandte API-Elemente

Legt die Eigenschaften scaleX und scaleY gleichzeitig fest. Wenn Sie die Werte für scaleX oder scaleY individuell festlegen, werden zwei autolayout-Ereignisse ausgelöst, während durch Aufrufen der Methode setScale() nur ein autolayout-Ereignis ausgelöst wird.

Wenn für die Eigenschaft scaleMode der Wert VideoScaleMode.MAINTAIN_ASPECT_RATIO oder VideoScaleMode.NO_SCALE festgelegt ist, verursacht das Aufrufen dieser Methode sofort ein autolayout-Ereignis.

Parameter

Verwandte API-Elemente

Legt die Eigenschaften width und height gleichzeitig fest. Wenn Sie die Werte für width oder height individuell festlegen, werden zwei autolayout-Ereignisse ausgelöst, während durch Aufrufen der Methode setSize() nur ein autolayout-Ereignis ausgelöst wird.

Wenn für die Eigenschaft scaleMode der Wert VideoScaleMode.MAINTAIN_ASPECT_RATIO oder VideoScaleMode.NO_SCALE festgelegt ist, dann verursacht der Aufruf dieser Methode sofort ein autolayout-Ereignis.

Parameter

Verwandte API-Elemente

Beendet die Videowiedergabe. Wenn autoRewind auf true eingestellt ist, wird zum ersten Bild zurückgespult. Wenn das Video bereits beendet ist, hat dies keine Auswirkungen. Um die Wiedergabe erneut zu starten, rufen Sie play() auf. Akzeptiert keine Parameter.

Wenn der Player in einem nicht interaktiven Status ist, wird die Anforderung in eine Warteschlange gestellt.

Löst eine Ausnahme aus, wenn sie aufgerufen wird und kein Stream vorhanden ist. Bestimmen Sie mit dem Ereignis stateChange und der Eigenschaft connected den Zeitpunkt, wann es sicher ist, diese Methode aufzurufen.

Verwandte API-Elemente

Wird ausgelöst, wenn der Abspielkopf zum Anfang des Video-Players bewegt wird, weil für die Eigenschaft autoRewind der Wert true festgelegt ist.

Das Ereignis autoRewound ist vom Typ "VideoEvent" und verfügt über die Konstante VideoEvent.AUTO_REWOUND.

Dieses Ereignis verfügt über die folgenden Eigenschaften:

Verwandte API-Elemente

Wird durch die VideoPlayer-Instanz ausgelöst, wenn diese die NetConnection aufgrund einer Zeitüberschreitung oder nach dem Aufrufen der Methode close() schließt, wenn Sie die Methode load() oder play() aufrufen oder wenn Sie die Eigenschaft source festlegen und die RTMP-Verbindung deshalb getrennt wird. Die FLVPlayback-Instanz löst dieses Ereignis nur beim Streaming vom Flash Media Server (FMS) oder einem anderen Flash Video Streaming Service (FVSS) aus.

Das Ereignis close ist vom Typ „VideoEvent“ und verfügt über die Konstante VideoEvent.CLOSE.

Dieses Ereignis verfügt über die folgenden Eigenschaften:

Verwandte API-Elemente

Wird ausgelöst, wenn der Abspielvorgang abgeschlossen ist, weil der Player das Ende der FLV-Datei erreicht hat. Die Komponente löst dieses Ereignis nicht aus, wenn Sie die Methode stop() oder pause() aufrufen oder auf das entsprechende Steuerelement klicken.

Verwendet die Anwendung progressiven Download, legt die Komponente die Eigenschaft totalTime nicht explizit fest. Die Komponente lädt eine FLV-Datei herunter, bei der die Dauer nicht in den Metadaten festgelegt ist. Der Video-Player legt vor dem Auslösen dieses Ereignisses für die Eigenschaft totalTime einen ungefähren Gesamtwert fest.

Der Video-Player löst auch die Ereignisse stateChange und stopped aus.

Das Ereignis complete ist vom Typ „VideoEvent“ und verfügt über die Konstante VideoEvent.COMPLETE.

Dieses Ereignis verfügt über die folgenden Eigenschaften:

Verwandte API-Elemente

Wird ausgelöst, wenn ein Cue-Point erreicht wird. Das Ereignisobjekt verfügt über die Eigenschaft info, die das info-Objekt enthält, das vom Rückruf des Ereignisses NetStream.onCuePoint für FLV-Datei-Cue-Points empfangen wurde. Bei ActionScript-Cue-Points enthält es das Objekt, das an die ActionScript-Cue-Point-Methoden oder Eigenschaften übergeben wurde.

Das Ereignis cuePoint ist vom Typ „MetadataEvent“ und verfügt über die Konstante MetadataEvent.CUE_POINT.

Dieses Ereignis verfügt über die folgenden Eigenschaften:

Verwandte API-Elemente

drmAuthenticate-Ereignis

drmError-Ereignis

drmError-Ereignis

Wird ausgelöst, wenn der Video Player angeordnet oder seine Größe geändert wird. Es folgen zwei Szenarios für eine Anordnung:

• Wenn der Video-Player entweder mit dem Ereignis autoLayout, durch Aufrufen der Methode setScale() oder setSize() oder durch Ändern der Eigenschaften width, height, scaleX und scaleY angeordnet wird.
• Wenn zwei Video-Player unterschiedlicher Größe vorhanden sind und die Eigenschaft visibleVideoPlayerIndex von einem Video-Player auf den anderen umgeschaltet wird.

Das Ereignis layout ist vom Typ „LayoutEvent“ und verfügt über die Konstante LayoutEvent.LAYOUT.

Dieses Ereignis verfügt über die folgenden Eigenschaften:

Verwandte API-Elemente

Wird ausgelöst, wenn die Metadaten der FLV-Datei zum ersten Mal erreicht werden. Das Ereignisobjekt verfügt über die Eigenschaft info, die das info-Objekt enthält, das vom Rückruf des Ereignisses NetStream.onMetaData empfangen wurde.

Das Ereignis metadataReceived ist vom Typ „MetadataEvent“ und verfügt über die Konstante MetadataEvent.METADATA_RECEIVED.

Dieses Ereignis verfügt über die folgenden Eigenschaften:

Verwandte API-Elemente

Wird beim Abspielen der FLV-Datei mit der Häufigkeit, die in der Eigenschaft playheadUpdateInterval festgelegt wurde, oder durch den Beginn des Zurückspulens ausgelöst. Die Komponente löst dieses Ereignis nicht aus, wenn der Video-Player angehalten oder beendet wurde, es sei denn, es wird eine Suche ausgeführt.

DasEreignis playheadUpdate ist vom Typ „VideoEvent“ und verfügt über die Konstante VideoEvent.PLAYHEAD_UPDATE.

Dieses Ereignis verfügt über die folgenden Eigenschaften:

Verwandte API-Elemente

Gibt den Fortschritt als Anzahl der heruntergeladenen Byte an. Wird mit der Häufigkeit ausgelöst, die in der Eigenschaft progressInterval angegeben wurde, beginnend am Anfang des Ladevorgangs bis zu dem Zeitpunkt, wenn alle Byte geladen wurden oder es einen Netzwerkfehler gibt. Wird standardmäßig jede Viertelsekunde ausgelöst, beginnend beim Aufruf von „load“ und bis zu dem Zeitpunkt, wenn alle Byte geladen wurden oder ein Netzwerkfehler aufgetreten ist. Verwenden Sie dieses Ereignis, um die Anzahl der geladenen Byte oder der Byte im Puffer zu überprüfen.

Das Ereignis wird nur für progressive Downloads über HTTP ausgelöst. Es zeigt den Fortschritt als Anzahl der heruntergeladenen Byte an. Das event-Objekt verfügt über die Eigenschaften bytesLoaded und bytesTotal., die identisch mit den FLVPlayback-Eigenschaften desselben Namens sind.

Das Ereignis progress ist vom Typ „VideoProgressEvent“ und verfügt über die Konstante VideoProgressEvent.PROGRESS.

Dieses Ereignis verfügt über die folgenden Eigenschaften:

Verwandte API-Elemente

Dieses Ereignis wird ausgelöst, wenn eine FLV-Datei geladen wurde und angezeigt werden kann. Es tritt ein, wenn zum ersten Mal der interaktive Status erreicht wird, nachdem Sie mit der Methode play() oder load() eine neue FLV-Datei geladen haben. Das Ereignis wird für jede geladene FLV-Datei nur einmal gestartet.

Das Ereignis ready ist vom Typ „VideoEvent“ und verfügt über die Konstante VideoEvent.READY.

Dieses Ereignis verfügt über die folgenden Eigenschaften:

Verwandte API-Elemente

Wird ausgelöst, wenn sich der Abspielstatus ändert. Wenn ein autoRewind-Aufruf beendet ist, wird das Ereignis stateChange mit dem Zurückspulstatus ausgelöst. Das Ereignis stateChange startet erst, nachdem das Zurückspulen abgeschlossen ist.

Mit diesem Ereignis können Sie nachverfolgen, wann die Wiedergabe in einen nicht interaktiven Status wechselt bzw. diesen verlässt, z. B. beim Herstellen der Verbindung, bei Größenänderungen oder beim Zurückspulen. Die Methoden play(), pause(), stop() und seek() stellen die auszuführenden Anfragen in eine Warteschlange, wenn der Player in den interaktiven Status wechselt.

Das Ereignis stateChange ist vom Typ "VideoEvent" und verfügt über die Konstante VideoEvent.STATE_CHANGE.

Dieses Ereignis verfügt über die folgenden Eigenschaften:

Verwandte API-Elemente

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

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

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

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

package
{
    import fl.video.VideoPlayer;
    import flash.display.Sprite;
    import flash.filters.BlurFilter;

    public class VideoPlayerExample extends Sprite 
    {
        private var videoPath:String = "http://www.helpexamples.com/flash/video/sheep.flv"
        private var player:VideoPlayer;
        private var blurryPlayer:VideoPlayer;
        
        public function VideoPlayerExample() {
            player = new VideoPlayer();
            player.play(videoPath);
            player.setScale(0.75, 0.75);
            addChild(player);
            
            blurryPlayer = new VideoPlayer();
            blurryPlayer.play(videoPath);
            blurryPlayer.setScale(0.75,0.75);
            blurryPlayer.filters = [ new BlurFilter(8, 8, 1) ];
            blurryPlayer.x = 250;
            addChild(blurryPlayer);            
        }
    }
}