Paket | fl.video |
Klasse | public class VideoPlayer |
Vererbung | VideoPlayer Video DisplayObject EventDispatcher Object |
Sprachversion: | ActionScript 3.0 |
Produktversion: | Flash CS3 |
Laufzeitversionen: | Flash Player 9.0.28.0, AIR 1.0 |
cuePoint
-Ereignisse auf. Die FLVPlayback-Klasse enthält die VideoPlayer-Klasse.
Verwenden Sie die FLVPlayback-Klasse in fast allen Fällen, weil die VideoPlayer-Klasse keine Funktionalität enthält, auf die nicht auch mit der FLVPlayback-Klasse zugegriffen werden kann.
Darüber hinaus stellt die FLVPlayback-Klasse automatisch eine Schnittstelle zur NCManager-Klasse zur Verfügung, um auf Streaming-FLV-Dateien auf einem Video-Server, wie z. B. Flash Media Server, zuzugreifen. Sie interagieren mit der NCManager-Klasse, wenn Sie die Eigenschaft contentPath
festlegen und wenn Sie eine URL an die Methoden play()
und load()
übergeben. Wenn Sie die VideoPlayer-Klasse verwenden, müssen Sie Ihrem ActionScript-Code die folgende Anweisung hinzufügen, um sicherzustellen, dass die NCManager-Klasse eingeschlossen wird:
var _forceNCManager:fl.video.NCManager;
Die NCManager-Klasse implementiert die INCManager-Schnittstelle. Sie kann durch eine benutzerdefinierte Klasse, die diese Schnittstelle implementiert, zum Verwalten der Netzwerkkommunikation ersetzt werden. In diesem Fall müssen Sie auch die folgende Anweisung hinzufügen, wobei Sie NCManager durch den Namen der zur Verfügung gestellten Klasse ersetzen:
fl.video.VideoPlayer.iNCManagerClass = fl.video.NCManager;
Wenn Sie die Standard-NCManager-Klasse verwenden, brauchen Sie diese Anweisung nicht hinzuzufügen.
Hinweis: Sie können auch iNCManagerClass
festlegen, um den Standard-fl.video.NCManager durch die FLVPlayback-Komponente zu ersetzen.
Zur Verarbeitung mehrerer Streams für unterschiedliche Bandbreiten unterstützt NCManager einen Teilsatz von SMIL.
Verwandte API-Elemente
Eigenschaft | Definiert von | ||
---|---|---|---|
accessibilityProperties : AccessibilityProperties
Die aktuellen Optionen für Eingabehilfen zur Barrierefreiheit dieses Anzeigeobjekts. | DisplayObject | ||
align : String
Gibt an, wie das Video relativ zu den registrationX-, registrationY-, registrationWidth- und registrationHeight-Eigenschaften angezeigt wird. | VideoPlayer | ||
alpha : Number
Gibt den Alphatransparenzwert des angegebenen Objekts an. | DisplayObject | ||
autoRewind : Boolean
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. | VideoPlayer | ||
blendMode : String
Ein Wert aus der BlendMode-Klasse, mit dem angegeben wird, welcher Mischmodus verwendet werden soll. | DisplayObject | ||
blendShader : Shader [Nur Schreiben]
Legt einen Shader fest, der für das Mischen von Vordergrund und Hintergrund verwendet wird. | DisplayObject | ||
bufferTime : Number
Eine Zahl, die angibt, wie viele Sekunden zwischengespeichert werden sollen, bevor ein Videostream abgespielt wird. | VideoPlayer | ||
bytesLoaded : uint [schreibgeschützt]
Eine Zahl, die angibt, wie viele Byte bereits heruntergeladen wurden, falls es sich um einen HTTP-Download handelt. | VideoPlayer | ||
bytesTotal : uint [schreibgeschützt]
Eine Zahl, die angibt, wie viele Byte insgesamt bei einem HTTP-Download heruntergeladen werden. | VideoPlayer | ||
cacheAsBitmap : Boolean
Wird diese Eigenschaft auf „true“ gesetzt, speichern Flash-Laufzeitumgebungen eine interne Bitmap-Darstellung des Anzeigeobjekts im Cache. | DisplayObject | ||
cacheAsBitmapMatrix : Matrix
Bei einem Nicht-Null-Wert definiert dieses Matrix-Objekt, wie ein Anzeigeobjekt dargestellt wird, wenn cacheAsBitmap auf „true“ gesetzt ist. | DisplayObject | ||
constructor : Object
Ein Verweis auf das Klassenobjekt oder die Konstruktorfunktion für eine angegebene Objektinstanz. | Object | ||
deblocking : int
Gibt den Typ des Filters an, der bei der Nachbearbeitung auf dekodierte Videos angewendet wird. | Video | ||
filters : Array
Ein indiziertes Array, das alle dem Anzeigeobjekt derzeit zugeordneten filter-Objekte enthält. | DisplayObject | ||
height : Number [override]
Eine Zahl, die die Höhe der VideoPlayer-Instanz in Pixel angibt. | VideoPlayer | ||
idleTimeout : Number
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. | VideoPlayer | ||
iNCManagerClass : Object = fl.video.NCManager [statisch]
Damit alle VideoPlayer-Objekte Ihre benutzerdefinierte Klasse als die standardmäßige INCManager-Implementierung verwenden, legen Sie für die iNCManagerClass-Eigenschaft das Klassenobjekt oder den Stringnamen Ihrer benutzerdefinierten Klasse fest. | VideoPlayer | ||
isLive : Boolean [schreibgeschützt]
Ein boolescher Wert; bei der Einstellung „true“ wird angegeben, dass es sich um einen Video-Livestream handelt. | VideoPlayer | ||
isRTMP : Boolean [schreibgeschützt]
Ein boolescher Wert; die Einstellung „true“ bedeutet, dass die FLV-Datei vom Flash Media Server (FMS) mithilfe von RTMP gestreamt wird. | VideoPlayer | ||
loaderInfo : LoaderInfo [schreibgeschützt]
Gibt ein LoaderInfo-Objekt mit Informationen zum Laden der Datei zurück, zu der dieses Anzeigeobjekt gehört. | DisplayObject | ||
mask : DisplayObject
Das aufrufende Anzeigeobjekt wird durch das angegebene mask-Objekt maskiert. | DisplayObject | ||
metadata : Object [schreibgeschützt]
Ein Objekt, bei dem es sich um ein Metadaten-Informationspaket handelt, das von einem Aufruf der NetStream.onMetaData()-Rückrufmethode empfangen wird, falls verfügbar. | VideoPlayer | ||
metaData : Object
Bezieht das Metadatenobjekt der DisplayObject-Instanz, wenn Metadaten neben der Instanz dieses DisplayObject in der SWF-Datei durch ein PlaceObject4-Tag gespeichert wurden. | DisplayObject | ||
mouseX : Number [schreibgeschützt]
Gibt die x-Koordinate der Position der Maus oder des Benutzereingabegeräts in Pixeln an. | DisplayObject | ||
mouseY : Number [schreibgeschützt]
Gibt die y-Koordinate der Position der Maus oder des Benutzereingabegeräts in Pixeln an. | DisplayObject | ||
name : String
Gibt den Instanznamen des Anzeigeobjekts an. | DisplayObject | ||
ncMgr : INCManager [schreibgeschützt]
Ein INCManager-Objekt, das Zugriff auf eine Instanz der Klasse, die INCManager implementiert, bietet, wobei es sich um eine Schnittstelle zur NCManager-Klasse handelt. | VideoPlayer | ||
netConnection : NetConnection [schreibgeschützt]
Gestattet direkten Zugriff auf die vom Video-Player erstellte NetConnection-Instanz. | VideoPlayer | ||
netStream : NetStream [schreibgeschützt]
Gestattet direkten Zugriff auf die vom Video-Player erstellte NetStream-Instanz. | VideoPlayer | ||
netStreamClientClass : Object [statisch]
Registriert eine benutzerdefinierte Klasse für die NetStream-Eigenschaft „client“. | VideoPlayer | ||
opaqueBackground : Object
Legt fest, ob das Anzeigeobjekt bei einer bestimmten Hintergrundfarbe undurchsichtig ist. | DisplayObject | ||
parent : DisplayObjectContainer [schreibgeschützt]
Gibt das DisplayObjectContainer-Objekt an, das dieses Anzeigeobjekt enthält. | DisplayObject | ||
playheadTime : Number
Eine Zahl, die die aktuelle Position (Zeit) des Abspielkopfs angibt. Diese Angabe erfolgt in Sekunden, wobei es sich auch um einen Bruchwert handeln kann. | VideoPlayer | ||
playheadUpdateInterval : Number
Eine Zahl, die die Zeit (in Millisekunden) zwischen den einzelnen playheadUpdate-Ereignissen angibt. | VideoPlayer | ||
progressInterval : Number
Eine Zahl, die die Zeit (in Millisekunden) zwischen den einzelnen progress-Ereignissen angibt. | VideoPlayer | ||
registrationHeight : Number
Die Höhe, die bei der automatischen Größenänderung zum Ausrichten des Videoinhalts verwendet wird. | VideoPlayer | ||
registrationWidth : Number
Die Breite, die bei der automatischen Größenänderung zum Ausrichten des Videoinhalts verwendet wird. | VideoPlayer | ||
registrationX : Number
Die x-Koordinate, die bei der automatischen Größenänderung zum Ausrichten des Videoinhalts verwendet wird. | VideoPlayer | ||
registrationY : Number
Die y-Koordinate, die bei der automatischen Größenänderung zum Ausrichten des Videoinhalts verwendet wird. | VideoPlayer | ||
root : DisplayObject [schreibgeschützt]
Bei einem Anzeigeobjekt in einer geladenen SWF-Datei ist die root-Eigenschaft das oberste Anzeigeobjekt in dem Teil der Baumstruktur der Anzeigeliste, der diese SWF-Datei repräsentiert. | DisplayObject | ||
rotation : Number
Gibt die Drehung der DisplayObject-Instanz ausgehend von der ursprünglichen Ausrichtung in Grad an. | DisplayObject | ||
rotationX : Number
Gibt die x-Achsendrehung der DisplayObject-Instanz in Grad an, und zwar bezogen auf die ursprüngliche Ausrichtung zum übergeordneten 3D-Container. | DisplayObject | ||
rotationY : Number
Gibt die y-Achsendrehung der DisplayObject-Instanz in Grad an, und zwar bezogen auf die ursprüngliche Ausrichtung zum übergeordneten 3D-Container. | DisplayObject | ||
rotationZ : Number
Gibt die Drehung der z-Achse der DisplayObject-Instanz in Grad an, ausgehend von ihrer ursprünglichen Ausrichtung relativ zum übergeordneten 3D-Container. | DisplayObject | ||
scale9Grid : Rectangle
Das aktuell verwendete Skalierungsraster. | DisplayObject | ||
scaleMode : String
Gibt die Größenänderung des Videos nach dem Ladevorgang an. | VideoPlayer | ||
scaleX : Number [override]
Eine Zahl, die die horizontale Skalierung darstellt. | VideoPlayer | ||
scaleY : Number [override]
Eine Zahl, die die vertikale Skalierung darstellt. | VideoPlayer | ||
scaleZ : Number
Gibt die Tiefenskalierung (Prozentwert) eines Objekts ausgehend vom Registrierungspunkt an. | DisplayObject | ||
scrollRect : Rectangle
Die Begrenzungen des Bildlaufrechtecks für das Anzeigeobjekt. | DisplayObject | ||
smoothing : Boolean
Gibt an, ob das Video beim Skalieren geglättet (interpoliert) werden soll. | Video | ||
soundTransform : flash.media:SoundTransform
Bietet direkten Zugriff auf die NetStream.soundTransform-Eigenschaft, um die Lautstärke besser regeln zu können. | VideoPlayer | ||
source : String [schreibgeschützt]
Ein String, der die URL der zu streamenden FLV-Datei und die Art des Streamings angibt. | VideoPlayer | ||
stage : Stage [schreibgeschützt]
Die Bühne des Anzeigeobjekts. | DisplayObject | ||
state : String [schreibgeschützt]
Ein String, der den Status der Komponente angibt. | VideoPlayer | ||
stateResponsive : Boolean [schreibgeschützt]
Ein boolescher Wert; die Einstellung „true“ bedeutet, dass der Status interaktiv ist. | VideoPlayer | ||
totalTime : Number [schreibgeschützt]
Eine Zahl, die die Gesamtspielzeit des Videos in Sekunden angibt. | VideoPlayer | ||
transform : flash.geom:Transform
Ein Objekt mit Eigenschaften, die zur Matrix, Farbtransformation und Pixelbegrenzung eines Anzeigeobjekts gehören. | DisplayObject | ||
videoHeight : int [override] [schreibgeschützt]
Die ursprüngliche Breite der geladenen FLV-Datei. | VideoPlayer | ||
videoWidth : int [override] [schreibgeschützt]
Die ursprüngliche Breite der geladenen FLV-Datei. | VideoPlayer | ||
visible : Boolean [override]
Ein boolescher Wert; bei der Einstellung „true“ ist die VideoPlayer-Instanz sichtbar. | VideoPlayer | ||
volume : Number
Eine Zahl im Bereich 0 bis 1, die die Lautstärkeeinstellung angibt. | VideoPlayer | ||
width : Number [override]
Eine Zahl, die die Breite der VideoPlayer-Instanz auf der Bühne festlegt. | VideoPlayer | ||
x : Number [override]
Eine Zahl, die die horizontale Position des Video-Players in Pixel angibt. | VideoPlayer | ||
y : Number [override]
Eine Zahl, die die vertikale Position des Video-Players in Pixel angibt. | VideoPlayer | ||
z : Number
Gibt die z-Koordinatenposition an der z-Achse der DisplayObject-Instanz relativ zum übergeordneten 3D-Container an. | DisplayObject |
Methode | Definiert von | ||
---|---|---|---|
Erstellt ein neues VideoPlayer-Objekt mit der angegebenen Breite und Höhe. | VideoPlayer | ||
addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
Registriert ein Ereignis-Listener-Objekt bei einem EventDispatcher-Objekt, sodass der Listener über ein Ereignis benachrichtigt wird. | EventDispatcher | ||
Gibt einen Videostream von einer Kamera an, der innerhalb des Videoobjekts in der Anwendung angezeigt werden soll. | Video | ||
Gibt einen Videostream an, der innerhalb des Videoobjekts in der Anwendung angezeigt werden soll. | Video | ||
Löscht das Bild, das aktuell im Videoobjekt angezeigt wird (nicht im Videostream). | Video | ||
Erzwingt das Schließen des Video-Streams und der Flash Media Server-Verbindung. | VideoPlayer | ||
Sendet ein Ereignis in den Ereignisablauf. | EventDispatcher | ||
Gibt ein Rechteck zurück, das den Bereich des Anzeigeobjekts in Bezug auf das Koordinatensystem des targetCoordinateSpace-Objekts definiert. | DisplayObject | ||
Gibt ein Rechteck zurück, das die Begrenzung des Anzeigeobjekts (ohne etwaige Striche oder Formen) definiert, und zwar aufgrund des vom Parameter „targetCoordinateSpace“ definierten Koordinatensystems. | DisplayObject | ||
Konvertiert das point-Objekt von den (globalen) Bühnenkoordinaten in die (lokalen) Koordinaten des Anzeigeobjekts. | DisplayObject | ||
Konvertiert einen zweidimensionale Punkt von den (globalen) Bühnenkoordinaten in die dreidimensionalen (lokalen) Koordinaten des Anzeigeobjekts. | DisplayObject | ||
Überprüft, ob das EventDispatcher-Objekt Listener für einen bestimmten Ereignistyp registriert hat. | EventDispatcher | ||
Gibt an, ob für ein Objekt eine bestimmte Eigenschaft definiert wurde. | Object | ||
Untersucht den Begrenzungsrahmen des Anzeigeobjekts, um festzustellen, ob er sich mit dem Begrenzungsrahmen des obj-Anzeigeobjekts überschneidet. | DisplayObject | ||
Wertet das Anzeigeobjekt aus, um festzustellen, ob es den durch die Parameter „x“ und „y“ festgelegten Punkt überdeckt oder schneidet. | DisplayObject | ||
Gibt an, ob eine Instanz der Object-Klasse in der Prototypkette des Objekts vorhanden ist, das als Parameter angegeben wurde. | Object | ||
load(url:String, totalTime:Number = NaN, isLive:Boolean = false, startTime:Number = NaN, duration:Number = NaN):void
Ähnelt der Methode play()-Methode; die FLV-Datei wird zwar geladen, aber nicht abgespielt. | VideoPlayer | ||
Konvertiert einen dreidimensionalen Punkt der dreidimensionalen (lokalen) Koordinaten des Anzeigeobjekts in einen zweidimensionalen Punkt der (globalen) Bühnenkoordinaten. | DisplayObject | ||
Konvertiert das point-Objekt von den (lokalen) Koordinaten des Anzeigeobjekts in die (globalen) Bühnenkoordinaten. | DisplayObject | ||
Wird von INCManager aufgerufen, nachdem die Verbindung hergestellt wurde oder nachdem die Verbindung nach einem Aufruf der INCManager.connectToURL()-Methode fehlgeschlagen ist. | VideoPlayer | ||
Wird von INCManager aufgerufen, nachdem die neue Verbindung hergestellt wurde oder nachdem die Verbindung nach einem Aufruf der INCManager.reconnect()-Methode fehlgeschlagen ist. | VideoPlayer | ||
Hält die Videowiedergabe an. | VideoPlayer | ||
play(url:String = null, totalTime:Number = NaN, isLive:Boolean = false, startTime:Number = NaN, duration:Number = NaN):void
Löst das Abspielen des Videos aus. | VideoPlayer | ||
Gibt die FLV-Datei wieder, wenn genügend Daten davon heruntergeladen wurden. | VideoPlayer | ||
Gibt an, ob die angegebene Eigenschaft vorhanden ist und durchlaufen werden kann. | Object | ||
Entfernt einen Listener aus dem EventDispatcher-Objekt. | EventDispatcher | ||
Sucht einen bestimmten Zeitpunkt in der Datei, der in Sekunden angegeben und bis auf drei Dezimalstellen (Millisekunden) genau ist. | VideoPlayer | ||
Legt die Verfügbarkeit einer dynamischen Eigenschaft für Schleifenoperationen fest. | Object | ||
Legt die scaleX-Eigenschaft und die scaleY-Eigenschaft gleichzeitig fest. | VideoPlayer | ||
Legt die Eigenschaften „width“ und „height“ gleichzeitig fest. | VideoPlayer | ||
Beendet die Videowiedergabe. | VideoPlayer | ||
Gibt die Stringdarstellung dieses Objekts zurück, formatiert entsprechend den Konventionen des Gebietsschemas. | Object | ||
Gibt das angegebene Objekt als String zurück. | Object | ||
Gibt den Grundwert des angegebenen Objekts zurück. | Object | ||
Überprüft, ob bei diesem EventDispatcher-Objekt oder bei einem seiner Vorgänger ein Ereignis-Listener für einen bestimmten Ereignistyp registriert ist. | EventDispatcher |
Ereignis | Übersicht | Definiert von | ||
---|---|---|---|---|
[broadcast event] Wird ausgelöst, wenn Flash Player oder eine AIR-Anwendung den Betriebssystemfokus erhält und aktiv wird. | EventDispatcher | |||
Wird ausgelöst, wenn ein Objekt der Anzeigeliste hinzugefügt wird. | DisplayObject | |||
Wird ausgelöst, wenn ein Anzeigeobjekt der Anzeigeliste für die Bühne hinzugefügt wird. Dies erfolgt entweder direkt oder über das Hinzufügen einer Unterstruktur, die das Anzeigeobjekt enthält. | DisplayObject | |||
Wird ausgelöst, wenn der Abspielkopf zum Anfang des Video-Players bewegt wird, weil für die Eigenschaft "autoRewind" der Wert „true“ festgelegt ist. | VideoPlayer | |||
Wird durch die VideoPlayer-Instanz ausgelöst, wenn diese die NetConnection aufgrund einer Zeitüberschreitung oder nach dem Aufrufen der close()-Methode schließt, wenn Sie die load()- oder play()-Methode aufrufen, oder wenn Sie die source-Eigenschaft festlegen und die RTMP-Verbindung deshalb getrennt wird. | VideoPlayer | |||
Wird ausgelöst, wenn der Abspielvorgang abgeschlossen ist, weil der Player das Ende der FLV-Datei erreicht hat. | VideoPlayer | |||
Wird ausgelöst, wenn ein Cue-Point erreicht wird. | VideoPlayer | |||
[broadcast event] Wird ausgelöst, wenn Flash Player- oder die AIR-Anwendung den Fokus verliert und inaktiv wird. | EventDispatcher | |||
drmAuthenticate-Ereignis | VideoPlayer | |||
drmError-Ereignis | VideoPlayer | |||
drmError-Ereignis | VideoPlayer | |||
[broadcast event] Wird ausgelöst, wenn der Abspielkopf ein neues Bild erreicht. | DisplayObject | |||
[broadcast event] Wird ausgelöst, wenn der Abspielkopf das aktuelle Bild verlässt. | DisplayObject | |||
[broadcast event] Wird ausgelöst, nachdem die Konstruktoren von Bildanzeigeobjekten ausgeführt wurden, bevor Bildskripten ausgeführt wurden. | DisplayObject | |||
Wird ausgelöst, wenn der Video Player angeordnet oder seine Größe geändert wird. | VideoPlayer | |||
Wird ausgelöst, wenn die Metadaten der FLV-Datei zum ersten Mal erreicht werden. | VideoPlayer | |||
Wird beim Abspielen der FLV-Datei mit der Häufigkeit, die in der playheadUpdateInterval-Eigenschaft festgelegt wurde, oder durch den Beginn des Zurückspulens ausgelöst. | VideoPlayer | |||
Gibt den Fortschritt als Anzahl der heruntergeladenen Byte an. | VideoPlayer | |||
Dieses Ereignis wird ausgelöst, wenn eine FLV-Datei geladen wurde und angezeigt werden kann. | VideoPlayer | |||
Wird ausgelöst, wenn ein Objekt aus der Anzeigeliste entfernt werden soll. | DisplayObject | |||
Wird ausgelöst, wenn ein Anzeigeobjekt aus der Anzeigeliste entfernt werden soll. Dies erfolgt entweder direkt oder über das Entfernen einer Unterstruktur, die das Anzeigeobjekt enthält. | DisplayObject | |||
[broadcast event] Wird ausgelöst, wenn die Anzeigeliste kurz davor steht, aktualisiert und neu gezeichnet zu werden. | DisplayObject | |||
Wird ausgelöst, wenn sich der Abspielstatus ändert. | VideoPlayer |
Konstante | Definiert von | ||
---|---|---|---|
SHORT_VERSION : String = "2.1" [statisch]
Statusvariable, die die kurze Versionsnummer der Komponente angibt. | VideoPlayer | ||
VERSION : String = "2.1.0.23" [statisch]
Statusvariable, die die lange Versionsnummer der Komponente angibt. | VideoPlayer |
align | Eigenschaft |
align:String
Sprachversion: | ActionScript 3.0 |
Produktversion: | Flash CS3 |
Laufzeitversionen: | Flash Player 9.0.28.0, AIR 1.0 |
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.
Implementierung
public function get align():String
public function set align(value:String):void
Verwandte API-Elemente
autoRewind | Eigenschaft |
autoRewind:Boolean
Sprachversion: | ActionScript 3.0 |
Produktversion: | Flash CS3 |
Laufzeitversionen: | Flash Player 9.0.28.0, AIR 1.0 |
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.
Implementierung
public function get autoRewind():Boolean
public function set autoRewind(value:Boolean):void
bufferTime | Eigenschaft |
bufferTime:Number
Sprachversion: | ActionScript 3.0 |
Produktversion: | Flash CS3 |
Laufzeitversionen: | Flash Player 9.0.28.0, AIR 1.0 |
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.
Implementierung
public function get bufferTime():Number
public function set bufferTime(value:Number):void
Verwandte API-Elemente
bytesLoaded | Eigenschaft |
bytesLoaded:uint
[schreibgeschützt] Sprachversion: | ActionScript 3.0 |
Produktversion: | Flash CS3 |
Laufzeitversionen: | Flash Player 9.0.28.0, AIR 1.0 |
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.
Implementierung
public function get bytesLoaded():uint
bytesTotal | Eigenschaft |
bytesTotal:uint
[schreibgeschützt] Sprachversion: | ActionScript 3.0 |
Produktversion: | Flash CS3 |
Laufzeitversionen: | Flash Player 9.0.28.0, AIR 1.0 |
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.
Implementierung
public function get bytesTotal():uint
height | Eigenschaft |
height:Number
[override] Sprachversion: | ActionScript 3.0 |
Produktversion: | Flash CS3 |
Laufzeitversionen: | Flash Player 9.0.28.0, AIR 1.0 |
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.
Implementierung
override public function get height():Number
override public function set height(value:Number):void
Verwandte API-Elemente
idleTimeout | Eigenschaft |
idleTimeout:Number
Sprachversion: | ActionScript 3.0 |
Produktversion: | Flash CS3 |
Laufzeitversionen: | Flash Player 9.0.28.0, AIR 1.0 |
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.
Implementierung
public function get idleTimeout():Number
public function set idleTimeout(value:Number):void
iNCManagerClass | Eigenschaft |
public static var iNCManagerClass:Object = fl.video.NCManager
Sprachversion: | ActionScript 3.0 |
Produktversion: | Flash CS3 |
Laufzeitversionen: | Flash Player 9.0.28.0, AIR 1.0 |
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.
isLive | Eigenschaft |
isLive:Boolean
[schreibgeschützt] Sprachversion: | ActionScript 3.0 |
Produktversion: | Flash CS3 |
Laufzeitversionen: | Flash Player 9.0.28.0, AIR 1.0 |
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.
Implementierung
public function get isLive():Boolean
Verwandte API-Elemente
isRTMP | Eigenschaft |
isRTMP:Boolean
[schreibgeschützt] Sprachversion: | ActionScript 3.0 |
Produktversion: | Flash CS3 |
Laufzeitversionen: | Flash Player 9.0.28.0, AIR 1.0 |
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
.
Implementierung
public function get isRTMP():Boolean
Verwandte API-Elemente
metadata | Eigenschaft |
metadata:Object
[schreibgeschützt] Sprachversion: | ActionScript 3.0 |
Produktversion: | Flash CS3 |
Laufzeitversionen: | Flash Player 9.0.28.0, AIR 1.0 |
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
.
Parameter | Beschreibung |
---|---|
canSeekToEnd | Ein boolescher Wert; die Einstellung true bedeutet, dass die FLV-Datei mit einem Schlüsselbild im letzten Bild kodiert wurde, das den Suchlauf bis zum Ende eines progressiv heruntergeladenen Movieclips ermöglicht. Der Wert lautet false , wenn die FLV-Datei nicht mit einem Schlüsselbild im letzten Bild kodiert wurde. |
cuePoints | Ein Array von Objekten, eines für jeden in die FLV-Datei eingebetteten Cue-Point. Der Wert ist nicht definiert, wenn die FLV-Datei keine Cue-Points enthält. Jedes Objekt hat die folgenden Eigenschaften:
|
audiocodecid | Eine Zahl, die den verwendeten Audio-Codec (Kodier-/Dekodiertechnik) angibt. |
audiodelay | Eine Zahl, die für die Zeit 0 in der Quelldatei steht, von der die FLV-Datei codiert wurde.
Der Videoinhalt wird um eine kurze Zeitspanne verzögert, die für die Synchronisierung mit dem Audio erforderlich ist. Wenn der Beachten Sie, dass die FLVPlayback- und VideoPlayer-Klassen diese Verzögerung in ihren Zeiteinstellungen kompensieren. Das bedeutet, dass Sie weiterhin die Zeiteinstellungen verwenden können, die Sie in der Quelldatei verwendet haben. |
audiodatarate | Eine Zahl, die die Datenrate des Audios in Kilobyte pro Sekunde angibt. |
videocodecid | Eine Zahl, die die Codec-Version, mit der das Video kodiert wurde, angibt. |
framerate | Eine Zahl, die die Bildrate der FLV-Datei angibt. |
videodatarate | Eine Zahl, die die Video-Datenrate der FLV-Datei angibt. |
height | Eine Zahl, die die Höhe der FLV-Datei angibt. |
width | Eine Zahl, die die Breite der FLV-Datei angibt. |
duration | Eine Zahl, die die Dauer der FLV-Datei in Sekunden angibt. |
Implementierung
public function get metadata():Object
Verwandte API-Elemente
ncMgr | Eigenschaft |
ncMgr:INCManager
[schreibgeschützt] Sprachversion: | ActionScript 3.0 |
Produktversion: | Flash CS3 |
Laufzeitversionen: | Flash Player 9.0.28.0, AIR 1.0 |
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
Implementierung
public function get ncMgr():INCManager
Verwandte API-Elemente
netConnection | Eigenschaft |
netConnection:NetConnection
[schreibgeschützt] Sprachversion: | ActionScript 3.0 |
Produktversion: | Flash CS3 |
Laufzeitversionen: | Flash Player 9.0.28.0, AIR 1.0 |
Gestattet direkten Zugriff auf die vom Video-Player erstellte NetConnection-Instanz.
Implementierung
public function get netConnection():NetConnection
netStream | Eigenschaft |
netStreamClientClass | Eigenschaft |
public static var netStreamClientClass:Object
Sprachversion: | ActionScript 3.0 |
Produktversion: | Flash CS3 |
Laufzeitversionen: | Flash Player 9.0.115.0, AIR 1.0 |
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.
Auslöser
VideoError — Wenn diese Eigenschaft auf einen ungültigen Wert gesetzt wird, wird VideoError.NETSTREAM_CLIENT_CLASS_UNSET ausgegeben.
|
playheadTime | Eigenschaft |
playheadTime:Number
Sprachversion: | ActionScript 3.0 |
Produktversion: | Flash CS3 |
Laufzeitversionen: | Flash Player 9.0.28.0, AIR 1.0 |
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.
Implementierung
public function get playheadTime():Number
public function set playheadTime(value:Number):void
Verwandte API-Elemente
playheadUpdateInterval | Eigenschaft |
playheadUpdateInterval:Number
Sprachversion: | ActionScript 3.0 |
Produktversion: | Flash CS3 |
Laufzeitversionen: | Flash Player 9.0.28.0, AIR 1.0 |
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.
Implementierung
public function get playheadUpdateInterval():Number
public function set playheadUpdateInterval(value:Number):void
Verwandte API-Elemente
progressInterval | Eigenschaft |
progressInterval:Number
Sprachversion: | ActionScript 3.0 |
Produktversion: | Flash CS3 |
Laufzeitversionen: | Flash Player 9.0.28.0, AIR 1.0 |
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.
Implementierung
public function get progressInterval():Number
public function set progressInterval(value:Number):void
registrationHeight | Eigenschaft |
registrationHeight:Number
Sprachversion: | ActionScript 3.0 |
Produktversion: | Flash CS3 |
Laufzeitversionen: | Flash Player 9.0.28.0, AIR 1.0 |
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
= 100registrationY
= 100registrationWidth
= 60registrationHeight
= 40align
=VideoAlign.CENTER
scaleMode
=VideoScaleMode.NO_SCALE
x
= 90y
= 80width
= 80height
= 80
Beispiel 2: Laden Sie das gleiche Szenario wie in Beispiel 1, aber mit den folgenden Einstellungen:
scaleMode
=VideoScaleMode.MAINTAIN_ASPECT_RATIO
x
= 110y
= 100width
= 40height
= 80
Beispiel 3: Laden Sie das gleiche Szenario wie in Beispiel 2, aber mit den folgenden Einstellungen:
scaleMode
=VideoScaleMode.EXACT_FIT
x
= 100y
= 100width
= 60height
= 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.
Implementierung
public function get registrationHeight():Number
public function set registrationHeight(value:Number):void
Verwandte API-Elemente
registrationWidth | Eigenschaft |
registrationWidth:Number
Sprachversion: | ActionScript 3.0 |
Produktversion: | Flash CS3 |
Laufzeitversionen: | Flash Player 9.0.28.0, AIR 1.0 |
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
= 100registrationY
= 100registrationWidth
= 60registrationHeight
= 40align
=VideoAlign.CENTER
scaleMode
=VideoScaleMode.NO_SCALE
x
= 90y
= 80width
= 80height
= 80
Beispiel 2: Laden Sie das gleiche Szenario wie in Beispiel 1, aber mit den folgenden Einstellungen:
scaleMode
=VideoScaleMode.MAINTAIN_ASPECT_RATIO
x
= 110y
= 100width
= 40height
= 80
Beispiel 3: Laden Sie das gleiche Szenario wie in Beispiel 2, aber mit den folgenden Einstellungen:
scaleMode
=VideoScaleMode.EXACT_FIT
x
= 100y
= 100width
= 60height
= 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.
Implementierung
public function get registrationWidth():Number
public function set registrationWidth(value:Number):void
Verwandte API-Elemente
registrationX | Eigenschaft |
registrationX:Number
Sprachversion: | ActionScript 3.0 |
Produktversion: | Flash CS3 |
Laufzeitversionen: | Flash Player 9.0.28.0, AIR 1.0 |
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
= 100registrationY
= 100registrationWidth
= 60registrationHeight
= 40align
=VideoAlign.CENTER
scaleMode
=VideoScaleMode.NO_SCALE
x
= 90y
= 80width
= 80height
= 80
Beispiel 2: Laden Sie das gleiche Szenario wie in Beispiel 1, aber mit den folgenden Einstellungen:
scaleMode
=VideoScaleMode.MAINTAIN_ASPECT_RATIO
x
= 110y
= 100width
= 40height
= 80
Beispiel 3: Laden Sie das gleiche Szenario wie in Beispiel 2, aber mit den folgenden Einstellungen:
scaleMode
=VideoScaleMode.EXACT_FIT
x
= 100y
= 100width
= 60height
= 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.
Implementierung
public function get registrationX():Number
public function set registrationX(value:Number):void
Verwandte API-Elemente
registrationY | Eigenschaft |
registrationY:Number
Sprachversion: | ActionScript 3.0 |
Produktversion: | Flash CS3 |
Laufzeitversionen: | Flash Player 9.0.28.0, AIR 1.0 |
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
= 100registrationY
= 100registrationWidth
= 60registrationHeight
= 40align
=VideoAlign.CENTER
scaleMode
=VideoScaleMode.NO_SCALE
x
= 90y
= 80width
= 80height
= 80
Beispiel 2: Laden Sie das gleiche Szenario wie in Beispiel 1, aber mit den folgenden Einstellungen:
scaleMode
=VideoScaleMode.MAINTAIN_ASPECT_RATIO
x
= 110y
= 100width
= 40height
= 80
Beispiel 3: Laden Sie das gleiche Szenario wie in Beispiel 2, aber mit den folgenden Einstellungen:
scaleMode
=VideoScaleMode.EXACT_FIT
x
= 100y
= 100width
= 60height
= 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.
Implementierung
public function get registrationY():Number
public function set registrationY(value:Number):void
Verwandte API-Elemente
scaleMode | Eigenschaft |
scaleMode:String
Sprachversion: | ActionScript 3.0 |
Produktversion: | Flash CS3 |
Laufzeitversionen: | Flash Player 9.0.28.0, AIR 1.0 |
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.
Implementierung
public function get scaleMode():String
public function set scaleMode(value:String):void
Verwandte API-Elemente
scaleX | Eigenschaft |
scaleX:Number
[override] Sprachversion: | ActionScript 3.0 |
Produktversion: | Flash CS3 |
Laufzeitversionen: | Flash Player 9.0.28.0, AIR 1.0 |
Eine Zahl, die die horizontale Skalierung darstellt.
Der Standardwert ist 1.
Implementierung
override public function get scaleX():Number
override public function set scaleX(value:Number):void
Verwandte API-Elemente
scaleY | Eigenschaft |
scaleY:Number
[override] Sprachversion: | ActionScript 3.0 |
Produktversion: | Flash CS3 |
Laufzeitversionen: | Flash Player 9.0.28.0, AIR 1.0 |
Eine Zahl, die die vertikale Skalierung darstellt.
Der Standardwert ist 1.
Implementierung
override public function get scaleY():Number
override public function set scaleY(value:Number):void
Verwandte API-Elemente
soundTransform | Eigenschaft |
soundTransform:flash.media:SoundTransform
Sprachversion: | ActionScript 3.0 |
Produktversion: | Flash CS3 |
Laufzeitversionen: | Flash Player 9.0.28.0, AIR 1.0 |
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.
Implementierung
public function get soundTransform():flash.media:SoundTransform
public function set soundTransform(value:flash.media:SoundTransform):void
Verwandte API-Elemente
source | Eigenschaft |
source:String
[schreibgeschützt] Sprachversion: | ActionScript 3.0 |
Produktversion: | Flash CS3 |
Laufzeitversionen: | Flash Player 9.0.28.0, AIR 1.0 |
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.
Implementierung
public function get source():String
Verwandte API-Elemente
state | Eigenschaft |
state:String
[schreibgeschützt] Sprachversion: | ActionScript 3.0 |
Produktversion: | Flash CS3 |
Laufzeitversionen: | Flash Player 9.0.28.0, AIR 1.0 |
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.
Implementierung
public function get state():String
Verwandte API-Elemente
stateResponsive | Eigenschaft |
stateResponsive:Boolean
[schreibgeschützt] Sprachversion: | ActionScript 3.0 |
Produktversion: | Flash CS3 |
Laufzeitversionen: | Flash Player 9.0.28.0, AIR 1.0 |
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
.
Implementierung
public function get stateResponsive():Boolean
Verwandte API-Elemente
totalTime | Eigenschaft |
totalTime:Number
[schreibgeschützt] Sprachversion: | ActionScript 3.0 |
Produktversion: | Flash CS3 |
Laufzeitversionen: | Flash Player 9.0.28.0, AIR 1.0 |
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.
Implementierung
public function get totalTime():Number
Verwandte API-Elemente
videoHeight | Eigenschaft |
videoHeight:int
[schreibgeschützt] [override] Sprachversion: | ActionScript 3.0 |
Produktversion: | Flash CS3 |
Laufzeitversionen: | Flash Player 9.0.28.0, AIR 1.0 |
Die ursprüngliche Breite der geladenen FLV-Datei. Diese Eigenschaft gibt „-1" zurück, wenn noch keine Informationen verfügbar sind.
Implementierung
override public function get videoHeight():int
Verwandte API-Elemente
videoWidth | Eigenschaft |
videoWidth:int
[schreibgeschützt] [override] Sprachversion: | ActionScript 3.0 |
Produktversion: | Flash CS3 |
Laufzeitversionen: | Flash Player 9.0.28.0, AIR 1.0 |
Die ursprüngliche Breite der geladenen FLV-Datei. Diese Eigenschaft gibt „-1" zurück, wenn noch keine Informationen verfügbar sind.
Implementierung
override public function get videoWidth():int
Verwandte API-Elemente
visible | Eigenschaft |
visible:Boolean
[override] Sprachversion: | ActionScript 3.0 |
Produktversion: | Flash CS3 |
Laufzeitversionen: | Flash Player 9.0.28.0, AIR 1.0 |
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.
Implementierung
override public function get visible():Boolean
override public function set visible(value:Boolean):void
volume | Eigenschaft |
volume:Number
Sprachversion: | ActionScript 3.0 |
Produktversion: | Flash CS3 |
Laufzeitversionen: | Flash Player 9.0.28.0, AIR 1.0 |
Eine Zahl im Bereich 0 bis 1, die die Lautstärkeeinstellung angibt.
Der Standardwert ist 1.
Implementierung
public function get volume():Number
public function set volume(value:Number):void
Verwandte API-Elemente
width | Eigenschaft |
width:Number
[override] Sprachversion: | ActionScript 3.0 |
Produktversion: | Flash CS3 |
Laufzeitversionen: | Flash Player 9.0.28.0, AIR 1.0 |
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
.
Implementierung
override public function get width():Number
override public function set width(value:Number):void
Verwandte API-Elemente
x | Eigenschaft |
x:Number
[override] Sprachversion: | ActionScript 3.0 |
Produktversion: | Flash CS3 |
Laufzeitversionen: | Flash Player 9.0.28.0, AIR 1.0 |
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.
Implementierung
override public function get x():Number
override public function set x(value:Number):void
Verwandte API-Elemente
y | Eigenschaft |
y:Number
[override] Sprachversion: | ActionScript 3.0 |
Produktversion: | Flash CS3 |
Laufzeitversionen: | Flash Player 9.0.28.0, AIR 1.0 |
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.
Implementierung
override public function get y():Number
override public function set y(value:Number):void
Verwandte API-Elemente
VideoPlayer | () | Konstruktor |
public function VideoPlayer(width:int = 320, height:int = 240)
Sprachversion: | ActionScript 3.0 |
Produktversion: | Flash CS3 |
Laufzeitversionen: | Flash Player 9.0.28.0, AIR 1.0 |
Erstellt ein neues VideoPlayer-Objekt mit der angegebenen Breite und Höhe.
Parameterwidth:int (default = 320 ) — Die Breite des Video-Players in Pixel.
| |
height:int (default = 240 ) — Die Höhe des Video-Players in Pixel.
|
Verwandte API-Elemente
close | () | Methode |
public function close():void
Sprachversion: | ActionScript 3.0 |
Produktversion: | Flash CS3 |
Laufzeitversionen: | Flash Player 9.0.28.0, AIR 1.0 |
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
load | () | Methode |
public function load(url:String, totalTime:Number = NaN, isLive:Boolean = false, startTime:Number = NaN, duration:Number = NaN):void
Sprachversion: | ActionScript 3.0 |
Produktversion: | Flash CS3 |
Laufzeitversionen: | Flash Player 9.0.28.0, AIR 1.0 |
Ä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
url:String — Ein URL-String für die FLV-Datei, die Sie laden möchten. Wurde kein Wert für URL übergeben, wird ein Fehler mit der Meldung null URL sent to VideoPlayer.load (URL mit dem Wert "null" an VideoPlayer.load übergeben) ausgelöst.
| |
totalTime:Number (default = NaN ) — Die Länge einer FLV-Datei. Übergeben Sie 0, null oder "undefined", um die Länge aus den Metadaten, vom Server oder aus der XML automatisch zu erkennen.
| |
isLive:Boolean (default = false ) — Der Wert ist true , wenn Sie einen Live-Feed vom Flash Media Server (FMS) streamen.
| |
startTime:Number (default = NaN ) — Die Zeit in Sekunden, die als Zeitpunkt 0 im gegebenen Medium betrachtet werden soll. Die Wiedergabe beginnt bei diesem Punkt, playheadTime betrachtet startTime als Zeitpunkt 0 und es ist nicht möglich, einen Suchlauf vor diesem Zeitpunkt auszuführen (ein Suchlauf bis 0 sucht bis zum angegebenen startTime-Wert). Dieser Parameter wird ignoriert, wenn isLive den Wert „true“ hat.
| |
duration:Number (default = NaN ) — Die Zeit in Sekunden, die als Dauer des Mediums verwendet wird. Wird nur verwendet, wenn startTime <= 0. Zusammen mit startTime definiert dieser Parameter ein Segment des Mediums, das vom VideoPlayer als das gesamte Medium betrachtet wird. Wenn das Video die mit „duration“ angegebene Anzahl von Sekunden abgespielt wurde, wird die Wiedergabe beendet und ein complete-Ereignis abgesetzt. Versuche, über die Mediendauer hinaus zu suchen, schlagen fehl. Wenn die totalTime-Eigenschaft abgerufen wird, gibt sie die angegebene Mediendauer zurück. Darin unterscheidet sich diese Methode vom totalTime-Parameter, da mit diesem Parameter die tatsächliche Dauer des Mediums angegeben wird, was hilfreich ist, wenn das Medium keine Metadaten enthält. Wenn totalTime kleiner als die tatsächliche Dauer des Mediums ist, wird die Wiedergabe damit nicht beendet. Mit dem duration-Parameter WIRD die Wiedergabe dagegen beendet. Dieser Parameter wird ignoriert, wenn isLive den Wert „true“ hat.
|
Verwandte API-Elemente
ncConnected | () | Methode |
public function ncConnected():void
Sprachversion: | ActionScript 3.0 |
Produktversion: | Flash CS3 |
Laufzeitversionen: | Flash Player 9.0.28.0, AIR 1.0 |
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
ncReconnected | () | Methode |
public function ncReconnected():void
Sprachversion: | ActionScript 3.0 |
Produktversion: | Flash CS3 |
Laufzeitversionen: | Flash Player 9.0.28.0, AIR 1.0 |
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
pause | () | Methode |
public function pause():void
Sprachversion: | ActionScript 3.0 |
Produktversion: | Flash CS3 |
Laufzeitversionen: | Flash Player 9.0.28.0, AIR 1.0 |
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
play | () | Methode |
public function play(url:String = null, totalTime:Number = NaN, isLive:Boolean = false, startTime:Number = NaN, duration:Number = NaN):void
Sprachversion: | ActionScript 3.0 |
Produktversion: | Flash CS3 |
Laufzeitversionen: | Flash Player 9.0.28.0, AIR 1.0 |
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
url:String (default = null ) — Übergeben Sie einen URL-String, wenn Sie eine neue FLV-Datei laden und abspielen möchten. Wenn Sie bereits eine FLV-Datei geladen haben und sie weiterhin abspielen möchten, übergeben Sie den Wert null .
| |
totalTime:Number (default = NaN ) — Übergeben Sie die Länge der FLV-Datei. Übergeben Sie 0 oder NaN , um die Länge aus den Metadaten, vom Server oder aus der XML automatisch zu erkennen. Wenn die Eigenschaft INCManager.streamLength nicht 0 , null oder "undefined" ist, wenn die Eigenschaft ncConnected aufgerufen wird, hat dieser Wert Vorrang vor dem anderen Wert.
| |
isLive:Boolean (default = false ) — Übergeben Sie true , wenn Sie einen Live-Feed vom Flash Media Server (FMS) streamen.
| |
startTime:Number (default = NaN ) — Die Zeit in Sekunden, die als Zeitpunkt 0 im gegebenen Medium betrachtet werden soll. Die Wiedergabe beginnt bei diesem Punkt, playheadTime betrachtet startTime als Zeitpunkt 0 und es ist nicht möglich, einen Suchlauf vor diesem Zeitpunkt auszuführen (ein Suchlauf bis 0 sucht bis zum angegebenen startTime-Wert). Dieser Parameter wird ignoriert, wenn isLive den Wert „true“ hat.
| |
duration:Number (default = NaN ) — Die Zeit in Sekunden, die als Dauer des Mediums verwendet wird. Wird nur verwendet, wenn startTime <= 0. Zusammen mit startTime definiert dieser Parameter ein Segment des Mediums, das vom VideoPlayer als das gesamte Medium betrachtet wird. Wenn das Video die mit „duration“ angegebene Anzahl von Sekunden abgespielt wurde, wird die Wiedergabe beendet und ein complete-Ereignis abgesetzt. Versuche, über die Mediendauer hinaus zu suchen, schlagen fehl. Wenn die totalTime-Eigenschaft abgerufen wird, gibt sie die angegebene Mediendauer zurück. Darin unterscheidet sich diese Methode vom totalTime-Parameter, da mit diesem Parameter die tatsächliche Dauer des Mediums angegeben wird, was hilfreich ist, wenn das Medium keine Metadaten enthält. Wenn totalTime kleiner als die tatsächliche Dauer des Mediums ist, wird die Wiedergabe damit nicht beendet. Mit dem duration-Parameter WIRD die Wiedergabe dagegen beendet. Dieser Parameter wird ignoriert, wenn isLive den Wert „true“ hat.
|
Verwandte API-Elemente
playWhenEnoughDownloaded | () | Methode |
public function playWhenEnoughDownloaded():void
Sprachversion: | ActionScript 3.0 |
Produktversion: | Flash CS3 |
Laufzeitversionen: | Flash Player 9.0.28.0, AIR 1.0 |
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.
seek | () | Methode |
public function seek(time:Number):void
Sprachversion: | ActionScript 3.0 |
Produktversion: | Flash CS3 |
Laufzeitversionen: | Flash Player 9.0.28.0, AIR 1.0 |
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
time:Number — Eine Zahl, die in Sekunden angibt, wo der Abspielkopf platziert werden soll.
|
Auslöser
VideoError — Wenn Zeit < 0 oder NaN ist.
|
Verwandte API-Elemente
setScale | () | Methode |
public function setScale(scaleX:Number, scaleY:Number):void
Sprachversion: | ActionScript 3.0 |
Produktversion: | Flash CS3 |
Laufzeitversionen: | Flash Player 9.0.28.0, AIR 1.0 |
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
scaleX:Number — Eine Zahl, die die horizontale Skalierung darstellt.
| |
scaleY:Number — Eine Zahl, die die vertikale Skalierung darstellt.
|
Verwandte API-Elemente
setSize | () | Methode |
public function setSize(width:Number, height:Number):void
Sprachversion: | ActionScript 3.0 |
Produktversion: | Flash CS3 |
Laufzeitversionen: | Flash Player 9.0.28.0, AIR 1.0 |
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
width:Number — Die Breite des Video-Players.
| |
height:Number — Die Höhe des Video-Players.
|
Verwandte API-Elemente
stop | () | Methode |
public function stop():void
Sprachversion: | ActionScript 3.0 |
Produktversion: | Flash CS3 |
Laufzeitversionen: | Flash Player 9.0.28.0, AIR 1.0 |
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
autoRewound | Ereignis |
fl.video.VideoEvent
Eigenschaft VideoEvent.type =
fl.video.VideoEvent.AUTO_REWOUND
Sprachversion: | ActionScript 3.0 |
Produktversion: | Flash CS3 |
Laufzeitversionen: | Flash Player 9.0.28.0, AIR 1.0 |
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
.
type
eines autoRewound
-Ereignisobjekts.
Dieses Ereignis verfügt über die folgenden Eigenschaften:
Eigenschaft | Wert |
---|---|
bubbles | false |
cancelable | false . Es gibt kein Standardverhalten, das abgebrochen werden kann. |
state | Ein String, der die Konstante aus der VideoState-Klasse kennzeichnet, die den Abspielstatus der Komponente beschreibt. |
playheadTime | Eine Zahl, die der aktuellen Zeit oder Position des Abspielkopfs entspricht. |
vp | Die Indexposition des VideoPlayer-Objekts. |
Verwandte API-Elemente
close | Ereignis |
fl.video.VideoEvent
Eigenschaft VideoEvent.type =
fl.video.VideoEvent.CLOSE
Sprachversion: | ActionScript 3.0 |
Produktversion: | Flash CS3 |
Laufzeitversionen: | Flash Player 9.0.28.0, AIR 1.0 |
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
.
type
eines close
-Ereignisobjekts.
Dieses Ereignis verfügt über die folgenden Eigenschaften:
Eigenschaft | Wert |
---|---|
bubbles | false |
cancelable | false . Es gibt kein Standardverhalten, das abgebrochen werden kann. |
state | Ein String, der die Konstante aus der VideoState-Klasse kennzeichnet, die den Abspielstatus der Komponente beschreibt. |
playheadTime | Eine Zahl, die der aktuellen Zeit oder Position des Abspielkopfs entspricht. |
vp | Die Indexposition des VideoPlayer-Objekts. |
Verwandte API-Elemente
complete | Ereignis |
fl.video.VideoEvent
Eigenschaft VideoEvent.type =
fl.video.VideoEvent.COMPLETE
Sprachversion: | ActionScript 3.0 |
Produktversion: | Flash CS3 |
Laufzeitversionen: | Flash Player 9.0.28.0, AIR 1.0 |
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
.
type
eines complete
-Ereignisobjekts.
Dieses Ereignis verfügt über die folgenden Eigenschaften:
Eigenschaft | Wert |
---|---|
bubbles | false |
cancelable | false . Es gibt kein Standardverhalten, das abgebrochen werden kann. |
state | Ein String, der die Konstante aus der VideoState-Klasse kennzeichnet, die den Abspielstatus der Komponente beschreibt. |
playheadTime | Eine Zahl, die der aktuellen Zeit oder Position des Abspielkopfs entspricht. |
vp | Die Indexposition des VideoPlayer-Objekts. |
Verwandte API-Elemente
cuePoint | Ereignis |
fl.video.MetadataEvent
Eigenschaft MetadataEvent.type =
fl.video.MetadataEvent.CUE_POINT
Sprachversion: | ActionScript 3.0 |
Produktversion: | Flash CS3 |
Laufzeitversionen: | Flash Player 9.0.28.0, AIR 1.0 |
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
.
type
eines cuePoint
-Ereignisobjekts.
Dieses Ereignis verfügt über die folgenden Eigenschaften:
Eigenschaft | Wert |
---|---|
bubbles | false |
cancelable | false . Es gibt kein Standardverhalten, das abgebrochen werden kann. |
info | Das Objekt mit Eigenschaften, die den Cue-Point beschreiben. |
vp | Die Indexposition des VideoPlayer-Objekts. |
Verwandte API-Elemente
drmAuthenticate | Ereignis |
flash.events.DRMAuthenticateEvent
Produktversion: | Flash CS3 |
Laufzeitversionen: | AIR 1.0 |
drmAuthenticate-Ereignis
drmError | Ereignis |
flash.events.DRMErrorEvent
Produktversion: | Flash CS3 |
Laufzeitversionen: | AIR 1.0 |
drmError-Ereignis
drmStatus | Ereignis |
flash.events.DRMStatusEvent
Produktversion: | Flash CS3 |
Laufzeitversionen: | AIR 1.0 |
drmError-Ereignis
layout | Ereignis |
fl.video.LayoutEvent
Eigenschaft LayoutEvent.type =
fl.video.LayoutEvent.LAYOUT
Sprachversion: | ActionScript 3.0 |
Produktversion: | Flash CS3 |
Laufzeitversionen: | Flash Player 9.0.28.0, AIR 1.0 |
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 MethodesetScale()
odersetSize()
oder durch Ändern der Eigenschaftenwidth
,height
,scaleX
undscaleY
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
.
type
eines layout
-Ereignisobjekts.
Dieses Ereignis verfügt über die folgenden Eigenschaften:
Eigenschaft | Wert |
---|---|
bubbles | false |
cancelable | false . Es gibt kein Standardverhalten, das abgebrochen werden kann. |
oldBounds | Die Werte der Eigenschaften x , y , width und height des Ziels vor dem Eintreten des Ereignisses layout . |
oldRegistrationBounds | Die Werte der Eigenschaften registrationX , registrationY , registrationWidth und registrationHeight des Ziels vor dem Eintreten des Ereignisses layout . |
Verwandte API-Elemente
metadataReceived | Ereignis |
fl.video.MetadataEvent
Eigenschaft MetadataEvent.type =
fl.video.MetadataEvent.METADATA_RECEIVED
Sprachversion: | ActionScript 3.0 |
Produktversion: | Flash CS3 |
Laufzeitversionen: | Flash Player 9.0.28.0, AIR 1.0 |
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
.
type
eines metadataReceived
-Ereignisobjekts.
Dieses Ereignis verfügt über die folgenden Eigenschaften:
Eigenschaft | Wert |
---|---|
bubbles | false |
cancelable | false . Es gibt kein Standardverhalten, das abgebrochen werden kann. |
info | Das Objekt mit Eigenschaften, die die FLV-Datei beschreiben. |
vp | Die Indexposition des VideoPlayer-Objekts. |
Verwandte API-Elemente
playheadUpdate | Ereignis |
fl.video.VideoEvent
Eigenschaft VideoEvent.type =
fl.video.VideoEvent.PLAYHEAD_UPDATE
Sprachversion: | ActionScript 3.0 |
Produktversion: | Flash CS3 |
Laufzeitversionen: | Flash Player 9.0.28.0, AIR 1.0 |
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
.
type
eines playheadUpdate
-Ereignisobjekts.
Dieses Ereignis verfügt über die folgenden Eigenschaften:
Eigenschaft | Wert |
---|---|
bubbles | false |
cancelable | false . Es gibt kein Standardverhalten, das abgebrochen werden kann. |
state | Ein String, der die Konstante aus der VideoState-Klasse kennzeichnet, die den Abspielstatus der Komponente beschreibt. |
playheadTime | Eine Zahl, die der aktuellen Zeit oder Position des Abspielkopfs entspricht. |
vp | Die Indexposition des VideoPlayer-Objekts. |
Verwandte API-Elemente
progress | Ereignis |
fl.video.VideoProgressEvent
Eigenschaft VideoProgressEvent.type =
fl.video.VideoProgressEvent.PROGRESS
Sprachversion: | ActionScript 3.0 |
Produktversion: | Flash CS3 |
Laufzeitversionen: | Flash Player 9.0.28.0, AIR 1.0 |
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
.
type
eines progress
-Ereignisobjekts.
Dieses Ereignis verfügt über die folgenden Eigenschaften:
Eigenschaft | Wert |
---|---|
bubbles | false |
cancelable | false . Es gibt kein Standardverhalten, das abgebrochen werden kann. |
bytesLoaded | Die Anzahl der geladenen Elemente oder Byte zu dem Zeitpunkt, zu dem der Listener das Ereignis verarbeitet. |
bytesTotal | Die Gesamtanzahl der Elemente oder Byte, die bei einem erfolgreichen Ladevorgang geladen werden. |
vp | Die Indexposition des VideoPlayer-Objekts. |
Verwandte API-Elemente
ready | Ereignis |
fl.video.VideoEvent
Eigenschaft VideoEvent.type =
fl.video.VideoEvent.READY
Sprachversion: | ActionScript 3.0 |
Produktversion: | Flash CS3 |
Laufzeitversionen: | Flash Player 9.0.28.0, AIR 1.0 |
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
.
type
eines ready
-Ereignisobjekts.
Dieses Ereignis verfügt über die folgenden Eigenschaften:
Eigenschaft | Wert |
---|---|
bubbles | false |
cancelable | false . Es gibt kein Standardverhalten, das abgebrochen werden kann. |
state | Ein String, der die Konstante aus der VideoState-Klasse kennzeichnet, die den Abspielstatus der Komponente beschreibt. |
playheadTime | Eine Zahl, die der aktuellen Zeit oder Position des Abspielkopfs entspricht. |
vp | Die Indexposition des VideoPlayer-Objekts. |
Verwandte API-Elemente
stateChange | Ereignis |
fl.video.VideoEvent
Eigenschaft VideoEvent.type =
fl.video.VideoEvent.STATE_CHANGE
Sprachversion: | ActionScript 3.0 |
Produktversion: | Flash CS3 |
Laufzeitversionen: | Flash Player 9.0.28.0, AIR 1.0 |
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
.
type
eines stateChange
-Ereignisobjekts.
Dieses Ereignis verfügt über die folgenden Eigenschaften:
Eigenschaft | Wert |
---|---|
bubbles | false |
cancelable | false . Es gibt kein Standardverhalten, das abgebrochen werden kann. |
state | Ein String, der die Konstante aus der VideoState-Klasse kennzeichnet, die den Abspielstatus der Komponente beschreibt. |
playheadTime | Eine Zahl, die der aktuellen Zeit oder Position des Abspielkopfs entspricht. |
vp | Die Indexposition des VideoPlayer-Objekts. |
Verwandte API-Elemente
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 | 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
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 VideoPlayerExample.as im gleichen Verzeichnis wie die FLA-Datei.
- 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); } } }
Tue Jun 12 2018, 10:04 AM Z