Paketflash.media
Klassepublic class Video
VererbungVideo Inheritance DisplayObject Inheritance EventDispatcher Inheritance Object
Unterklassen VideoPlayer

Sprachversion : ActionScript 3.0
Player-Version : Flash Player 9

Die Video-Klasse zeigt Live-Video oder aufgezeichnetes Video in einer Anwendung an, ohne dass das Video in die SWF-Datei eingebettet ist. Diese Klasse erstellt ein Video-Objekt in einer Adobe Flash- oder Adobe Flex-Schnittstelle, die folgende Arten von Video anzeigt: aufgezeichnete Flash Video-Dateien (FLV), die auf einem Server oder lokal gespeichert wurden, oder Live-Video, das vom Computer eines Benutzers erfasst wird. Ein Video-Objekt ist ein Anzeigeobjekt in der Anzeigeliste der Anwendung und stellt den visuellen Raum dar, in dem das Video in einer Benutzeroberfläche abgespielt wird.

Bei der Verwendung mit Flash Media Server ermöglicht Ihnen das Video-Objekt, Live-Video vom Computer eines Benutzers an den Server zu senden und dann vom Server an andere Benutzer zu übertragen. Mithilfe dieser Funktionen können Sie Medienanwendungen wie einfache Videoplayer, Videoplayer mit Multipoint-Veröffentlichung von einem Server zum anderen oder eine Anwendung für den Videoaustausch in einer Community erstellen.

Flash Player 9 unterstützt das Veröffentlichen und Wiedergeben von mit dem Sorenson Spark-Codec oder dem On2 VP6-Codec kodierten FLV-Dateien und zudem einen Alphakanal. Der Video-Codec On2 VP6 belegt eine geringere Bandbreite als ältere Technologien und enthält zusätzliche Deblocking- und Deringing-Filter.

Flash Player Update 3 und höher unterstützt Mip-Mapping, um die Qualität der Darstellung und die Leistung zur Laufzeit zu optimieren. Für die Videowiedergabe verwendet Flash Player Mip-Mapping-Optimierung, wenn Sie die Eigenschaft smoothing des Video-Objekts auf true einstellen.

Wie bei anderen Anzeigeobjekten in der Anzeigeliste können Sie die verschiedenen Eigenschaften von Video-Objekten steuern. Sie können das Video-Objekt beispielsweise mithilfe seiner x- und y-Eigenschaften auf der Bühne verschieben, seine Größe mit den Eigenschaften height und width ändern usw.

Um einen Videostream abzuspielen, verwenden Sie attachCamera() oder attachNetStream(), um das Video an das Video-Objekt anzuhängen. Fügen Sie das Video-Objekt dann mithilfe von addChild() der Anzeigeliste hinzu.

Wenn Sie die Flash-Authoring-Umgebung verwenden, können Sie das Video-Objekt auch auf der Bühne platzieren, anstatt es mit addChild() hinzuzufügen:

  1. Ist das Bedienfeld "Bibliothek" nicht sichtbar, wählen Sie "Fenster" > "Bibliothek".
  2. Fügen Sie der Bibliothek ein eingebettetes Video-Objekt hinzu, indem Sie auf der rechten Seite der Titelleiste im Bedienfeld "Bibliothek" auf das Optionsmenü klicken und die Option "Neues Video" auswählen.
  3. Benennen Sie das eingebettete Video-Objekt im Dialogfeld für die Videoeigenschaften für die Verwendung in der Bibliothek und klicken Sie auf "OK".
  4. Ziehen Sie das Video-Objekt auf die Bühne, und geben Sie ihm im Eigenschafteninspektor einen eindeutigen Namen, zum Beispiel my_video. (Verwenden Sie nicht den Namen "Video".)

Hinweis: Die Video-Klasse ist keine Unterklasse der InteractiveObject-Klasse, sodass keine Mausereignisse ausgelöst werden können. Sie können jedoch die addEventListener()-Methode für den Anzeigeobjekt-Container aufrufen, der das Video-Objekt enthält.

Beispiele anzeigen

Siehe auch

attachCamera()
attachNetStream()
flash.media.Camera.getCamera()
flash.net.NetConnection
flash.net.NetStream
flash.display.DisplayObjectContainer.addChild()
flash.display.Stage.addChild()
Hauptanzeigeklassen
Grundlagen der Verwendung von Videos


Öffentliche Eigenschaften
 EigenschaftDefiniert von
 InheritedaccessibilityProperties : AccessibilityProperties
Die aktuellen Eingabehilfenoptionen für dieses Anzeigeobjekt.
DisplayObject
 Inheritedalpha : Number
Gibt den Alphatransparenzwert des angegebenen Objekts an.
DisplayObject
 InheritedblendMode : String
Ein Wert aus der BlendMode-Klasse, mit dem angegeben wird, welcher Mischmodus verwendet werden soll.
DisplayObject
 InheritedcacheAsBitmap : Boolean
Wird diese Eigenschaft auf "true" gesetzt, speichert Flash Player eine interne Bitmap-Darstellung des Anzeigeobjekts im Cache.
DisplayObject
 Inheritedconstructor : 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 decodierte Videos angewendet wird.
Video
 Inheritedfilters : Array
Ein indiziertes Array, das alle dem Anzeigeobjekt derzeit zugeordneten filter-Objekte enthält.
DisplayObject
 Inheritedheight : Number
Gibt die Höhe des Anzeigeobjekts in Pixel an.
DisplayObject
 InheritedloaderInfo : LoaderInfo
[read-only] Gibt ein LoaderInfo-Objekt mit Informationen zum Laden der Datei zurück, zu der dieses Anzeigeobjekt gehört.
DisplayObject
 Inheritedmask : DisplayObject
Das aufrufende Anzeigeobjekt wird durch das angegebene mask-Objekt maskiert.
DisplayObject
 InheritedmouseX : Number
[read-only] Gibt die x-Koordinate der Mausposition in Pixel an.
DisplayObject
 InheritedmouseY : Number
[read-only] Gibt die y-Koordinate der Mausposition in Pixel an.
DisplayObject
 Inheritedname : String
Gibt den Instanznamen des Anzeigeobjekts an.
DisplayObject
 InheritedopaqueBackground : Object
Legt fest, ob das Anzeigeobjekt bei einer bestimmten Hintergrundfarbe undurchsichtig ist.
DisplayObject
 Inheritedparent : DisplayObjectContainer
[read-only] Gibt das DisplayObjectContainer-Objekt an, das dieses Anzeigeobjekt enthält.
DisplayObject
 Inheritedprototype : Object
[static] Ein Verweis auf das Prototypobjekt einer Klasse oder eines Funktionsobjekts.
Object
 Inheritedroot : DisplayObject
[read-only] 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
 Inheritedrotation : Number
Gibt die Drehung der DisplayObject-Instanz ausgehend von der ursprünglichen Ausrichtung in Grad an.
DisplayObject
 Inheritedscale9Grid : Rectangle
Das aktuell verwendete Skalierungsraster.
DisplayObject
 InheritedscaleX : Number
Gibt die horizontale Skalierung (percentage) des Objekts ausgehend vom Registrierungspunkt an.
DisplayObject
 InheritedscaleY : Number
Gibt die vertikale Skalierung (percentage) eines Objekts ausgehend vom Registrierungspunkt an.
DisplayObject
 InheritedscrollRect : 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
 Inheritedstage : Stage
[read-only] Die Bühne des Anzeigeobjekts.
DisplayObject
 Inheritedtransform : Transform
Ein Objekt mit Eigenschaften, die zur Matrix, Farbtransformation und Pixelbegrenzung eines Anzeigeobjekts gehören.
DisplayObject
  videoHeight : int
[read-only] Eine Ganzzahl, die die Höhe des Video-Streams in Pixel angibt.
Video
  videoWidth : int
[read-only] Eine Ganzzahl, die die Breite des Video-Streams in Pixel angibt.
Video
 Inheritedvisible : Boolean
Gibt an, ob das Anzeigeobjekt sichtbar ist oder nicht.
DisplayObject
 Inheritedwidth : Number
Gibt die Breite des Anzeigeobjekts in Pixel an.
DisplayObject
 Inheritedx : Number
Gibt die x-Koordinate der DisplayObject-Instanz relativ zu den lokalen Koordinaten des übergeordneten DisplayObjectContainer-Objekts an.
DisplayObject
 Inheritedy : Number
Gibt die y-Koordinate der DisplayObject-Instanz relativ zu den lokalen Koordinaten des übergeordneten DisplayObjectContainer-Objekts an.
DisplayObject
Öffentliche Methoden
 MethodeDefiniert von
  
Video(width:int = 320, height:int = 240)
Erstellt eine neue Video-Instanz.
Video
 Inherited
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 Video-Stream von einer Kamera an, der innerhalb des Video-Objekts in der Anwendung angezeigt werden soll.
Video
  
Gibt einen Video-Stream an, der innerhalb des Video-Objekts in der Anwendung angezeigt werden soll.
Video
  
Löscht das aktuell im Video-Objekt angezeigte Bild.
Video
 Inherited
Sendet ein Ereignis in den Ereignisablauf.
EventDispatcher
 Inherited
getBounds(targetCoordinateSpace:DisplayObject):Rectangle
Gibt ein Rechteck zurück, das den Bereich des Anzeigeobjekts in Bezug auf das Koordinatensystem des targetCoordinateSpace-Objekts definiert.
DisplayObject
 Inherited
getRect(targetCoordinateSpace:DisplayObject):Rectangle
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
 Inherited
Konvertiert das point-Objekt von den (globalen) Bühnenkoordinaten in die (lokalen) Koordinaten des Anzeigeobjekts.
DisplayObject
 Inherited
Überprüft, ob das EventDispatcher-Objekt Listener für einen bestimmten Ereignistyp registriert hat.
EventDispatcher
 Inherited
Gibt an, ob für ein Objekt eine bestimmte Eigenschaft definiert wurde.
Object
 Inherited
Wertet das Anzeigeobjekt aus, um festzustellen, ob es das Anzeigeobjekt "obj" überdeckt oder schneidet.
DisplayObject
 Inherited
hitTestPoint(x:Number, y:Number, shapeFlag:Boolean = false):Boolean
Wertet das Anzeigeobjekt aus, um festzustellen, ob es den durch die Parameter "x" und "y" festgelegten Punkt überdeckt oder schneidet.
DisplayObject
 Inherited
Gibt an, ob eine Instanz der Object-Klasse in der Prototypkette des Objekts vorhanden ist, das als Parameter angegeben wurde.
Object
 Inherited
Konvertiert das point-Objekt von den (lokalen) Koordinaten des Anzeigeobjekts in die (globalen) Bühnenkoordinaten.
DisplayObject
 Inherited
Gibt an, ob die angegebene Eigenschaft vorhanden ist und durchlaufen werden kann.
Object
 Inherited
removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void
Entfernt einen Listener aus dem EventDispatcher-Objekt.
EventDispatcher
 Inherited
Legt die Verfügbarkeit einer dynamischen Eigenschaft für Schleifenoperationen fest.
Object
 Inherited
Gibt das angegebene Objekt als String zurück.
Object
 Inherited
Gibt den Grundwert des angegebenen Objekts zurück.
Object
 Inherited
Überprüft, ob bei diesem EventDispatcher-Objekt oder bei einem seiner vorangegangenen Elementen ein Ereignis-Listener für einen bestimmten Ereignistyp registriert ist.
EventDispatcher
Ereignisse
 EreignisÜbersicht Definiert von
 Inherited Wird ausgelöst, wenn Flash Player den Betriebssystemfokus erhält und aktiv wird.EventDispatcher
 Inherited Wird ausgelöst, wenn ein Objekt der Anzeigeliste hinzugefügt wird.DisplayObject
 Inherited 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
 Inherited Wird ausgelöst, wenn Flash Player den Betriebssystemfokus verliert und inaktiv wird.EventDispatcher
 Inherited Wird ausgelöst, wenn der Abspielkopf ein neues Bild erreicht.DisplayObject
 Inherited Wird ausgelöst, wenn ein Objekt aus der Anzeigeliste entfernt werden soll.DisplayObject
 Inherited 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
 Inherited Wird ausgelöst, wenn die Anzeigeliste aktualisiert und neu gezeichnet werden soll.DisplayObject
Eigenschaftsdetail
deblockingEigenschaft
deblocking:int  [read-write]

Sprachversion : ActionScript 3.0
Player-Version : Flash Player 9

Gibt den Typ des Filters an, der bei der Nachbearbeitung auf decodierte Videos angewendet wird. Mit dem Standardwert 0 kann bei der Videokomprimierung gegebenenfalls ein Deblocking-Filter angewendet werden.

Die Komprimierung von Videos kann zu unerwünschten Artefakten führen. Mithilfe der deblocking-Eigenschaft können Sie Filter setzen, mit denen Blocking-Artefakte und (bei Videokomprimierungen mit dem On2 VP6-Codec) auch Ringing-Artefakte reduziert werden.

Blocking bezieht sich auf sichtbare Fehler zwischen den Begrenzungen der einzelnen Blocks, aus denen sich jedes Videobild zusammensetzt. Ringing bezieht sich auf verzerrte Kanten der Elemente in einem Videobild.

Es stehen zwei Deblocking-Filter zur Verfügung: einer im Sorenson-Codec und ein weiterer im On2 VP6-Codec. Bei Verwendung des On2 VP6-Codecs ist zudem ein Deringing-Filter verfügbar. Verwenden Sie zum Festlegen eines Filters einen der folgenden Werte:

Wenn bei Verwendung des Sorenson-Codecs ein Wert größer als 2 angegeben wurde, wird der Sorenson-Decoder automatisch auf 2 gesetzt.

Die Verwendung eines Deblocking-Filters hat Auswirkungen auf die Gesamtleistung bei der Wiedergabe und ist bei Videos mit hoher Bandbreite normalerweise nicht erforderlich. Wenn das System eines Benutzers nicht leistungsfähig genug ist, treten bei einem aktivierten Deblocking-Filter bei der Wiedergabe von Videos möglicherweise Probleme auf.


Implementierung
    public function get deblocking():int
    public function set deblocking(value:int):void
smoothingEigenschaft 
smoothing:Boolean  [read-write]

Sprachversion : ActionScript 3.0
Player-Version : Flash Player 9

Gibt an, ob das Video beim Skalieren geglättet (interpoliert) werden soll. Die Funktion zum Glätten funktioniert nur, wenn sich der Player im Modus für hohe Qualität befindet. Der Standardwert lautet false (ohne Glättung).

Setzen Sie diese Eigenschaft auf true, wenn Sie Video mit Flash Player Update 3 oder höher abspielen, um die Bildoptimierung mit Mip-Mapping zu nutzen.


Implementierung
    public function get smoothing():Boolean
    public function set smoothing(value:Boolean):void
videoHeightEigenschaft 
videoHeight:int  [read-only]

Sprachversion : ActionScript 3.0
Player-Version : Flash Player 9

Eine Ganzzahl, die die Höhe des Video-Streams in Pixel angibt. Im Falle von Live-Streams ist der Wert mit dem der Eigenschaft Camera.height des Kamera-Objekts identisch, das den Video-Stream aufzeichnet. Bei FLV-Dateien entspricht dieser Wert der Höhe der Datei, die im FLV-Format exportiert wurde.

Sie können diese Eigenschaft beispielsweise verwenden, um sicherzustellen, dass der Benutzer das Video in der Größe sieht, in der es aufgenommen wurde (unabhängig von der eigentlichen Größe des Video-Objekts auf der Bühne).


Implementierung
    public function get videoHeight():int

Siehe auch

videoWidthEigenschaft 
videoWidth:int  [read-only]

Sprachversion : ActionScript 3.0
Player-Version : Flash Player 9

Eine Ganzzahl, die die Breite des Video-Streams in Pixel angibt. Im Falle von Live-Streams ist der Wert mit dem der Eigenschaft Camera.width des Camera-Objekts identisch, das den Video-Stream aufzeichnet. Bei FLV-Dateien entspricht dieser Wert der Breite der Datei, die als FLV-Datei exportiert wurde.

Sie können diese Eigenschaft beispielsweise verwenden, um sicherzustellen, dass der Benutzer das Video in der Größe sieht, in der es aufgenommen wurde (unabhängig von der eigentlichen Größe des Video-Objekts auf der Bühne).


Implementierung
    public function get videoWidth():int

Siehe auch

Konstruktordetail
Video()Konstruktor
public function Video(width:int = 320, height:int = 240)

Sprachversion : ActionScript 3.0
Player-Version : Flash Player 9

Erstellt eine neue Video-Instanz. Wenn für die Parameter width und height keine Werte angegeben sind, werden die Standardwerte verwendet. Mithilfe von Video.width und Video.height können Sie die width- und height-Eigenschaften des Video-Objekts auch nach der Erstellung des Objekts festlegen. Beim Erstellen eines neuen Video-Objekts ist der Wert 0 für die Höhe und Breite nicht zulässig. Wenn Sie den Wert 0 übergeben, werden die Standardwerte verwendet.

Rufen Sie nach dem Erstellen des Videos die Methode DisplayObjectContainer.addChild() oder DisplayObjectContainer.addChildAt() auf, um das Video-Objekt einem übergeordneten DisplayObjectContainer-Objekt hinzuzufügen.

Parameter
width:int (default = 320) — Die Breite des Videos in Pixel.
 
height:int (default = 240) — Die Höhe des Videos in Pixel.
Methodendetail
attachCamera()Methode
public function attachCamera(camera:Camera):void

Sprachversion : ActionScript 3.0
Player-Version : Flash Player 9

Gibt einen Video-Stream von einer Kamera an, der innerhalb des Video-Objekts in der Anwendung angezeigt werden soll.

Verwenden Sie diese Methode, um Live-Video vom Computer eines Benutzers an das Video-Objekt anzuhängen. Sie können das Live-Video lokal auf demselben Computer, auf dem es aufgezeichnet wurde, abspielen, oder es an Flash Media Server senden und es mithilfe des Servers an andere Benutzer streamen.

Parameter

camera:Camera — Ein Camera-Objekt, das Videodaten erfasst. Wenn Sie die Verbindung mit dem Video-Objekt beenden möchten, übergeben Sie den Wert null.

Siehe auch


Beispiel
Verwendung von Beispielen
Die Verwendung dieser Methode wird im Beispiel für die Camera.getCamera()-Methode veranschaulicht.
attachNetStream()Methode 
public function attachNetStream(netStream:NetStream):void

Sprachversion : ActionScript 3.0
Player-Version : Flash Player 9

Gibt einen Video-Stream an, der innerhalb des Video-Objekts in der Anwendung angezeigt werden soll. Der Videostream ist entweder eine FLV-Datei, die mit NetStream.play() abgespielt wird, ein Camera-Objekt oder null. Wenn Sie eine FLV-Datei verwenden, kann sie im lokalen Dateisystem oder auf Flash Media Server gespeichert werden. Wenn der Wert des netStream-Arguments auf null gesetzt ist, wird das Video nicht mehr im Video-Objekt wiedergegeben.

Sie müssen diese Methode nicht verwenden, wenn die FLV-Datei nur Audiodaten enthält. Die Audiodaten von FLV-Dateien werden automatisch wiedergegeben, wenn Sie die NetStream.play()-Methode aufrufen. Um die mit einer FLV-Datei verknüpften Audiodaten zu steuern, verwenden Sie die soundTransform-Eigenschaft des NetStream-Objekts, das die FLV-Datei wiedergibt.

Parameter

netStream:NetStream — Ein NetStream-Objekt. Wenn Sie die Verbindung mit dem Video-Objekt beenden möchten, übergeben Sie den Wert null.

Siehe auch


Beispiel
Verwendung von Beispielen
Am Ende des Abschnitts über diese Klasse finden Sie in Beispiel, in dem die Verwendung dieser Methode veranschaulicht wird.
clear()Methode 
public function clear():void

Sprachversion : ActionScript 3.0
Player-Version : Flash Player 9

Löscht das aktuell im Video-Objekt angezeigte Bild. Hiermit können Sie Standby-Informationen anzeigen, ohne das Video-Objekt ausblenden zu müssen.

Siehe auch

Beispiele Verwendung von Beispielen
VideoExample.as

Im folgenden Beispiel wird ein Video-Objekt mit den Klassen NetConnection und NetStream verwendet, um eine FLV-Datei zu laden und abzuspielen. Zur Ausführung dieses Beispiels benötigen Sie eine FLV-Datei, deren Name und Speicherort mit der an videoURL übergebenen Variablen übereinstimmt. In diesem Fall ist das eine FLV-Datei mit dem Namen "Video.flv", die in dem Verzeichnis abgelegt ist, in dem sich die SWF-Datei befindet.

In diesem Fall wird der Code zur Erstellung des Video- und NetStream-Objekts und zum Aufrufen der Methoden Video.attachNetStream() und NetStream.play() in eine Prozedur-Funktion eingefügt. Die Prozedur wird nur aufgerufen, wenn die Verbindung mit dem NetConnection-Objekt erfolgreich hergestellt werden kann, d. h. wenn das Ereignis netStatus ein info-Objekt mit einer code-Eigenschaft zurückgibt, die Erfolg angibt. Es wird empfohlen, die erfolgreiche Verbindungsherstellung abzuwarten, bevor Sie NetStream.play() aufrufen.


 package {
    import flash.display.Sprite;
    import flash.events.*;
    import flash.media.Video;
    import flash.net.NetConnection;
    import flash.net.NetStream;

    public class VideoExample extends Sprite {
        private var videoURL:String = "Video.flv";
        private var connection:NetConnection;
        private var stream:NetStream;

        public function VideoExample() {
            connection = new NetConnection();
            connection.addEventListener(NetStatusEvent.NET_STATUS, netStatusHandler);
            connection.addEventListener(SecurityErrorEvent.SECURITY_ERROR, securityErrorHandler);
            connection.connect(null);
        }

        private function netStatusHandler(event:NetStatusEvent):void {
            switch (event.info.code) {
                case "NetConnection.Connect.Success":
                    connectStream();
                    break;
                case "NetStream.Play.StreamNotFound":
                    trace("Unable to locate video: " + videoURL);
                    break;
            }
        }

        private function connectStream():void {
            var stream:NetStream = new NetStream(connection);
            stream.addEventListener(NetStatusEvent.NET_STATUS, netStatusHandler);
            stream.addEventListener(AsyncErrorEvent.ASYNC_ERROR, asyncErrorHandler);
            var video:Video = new Video();
            video.attachNetStream(stream);
            stream.play(videoURL);
            addChild(video);
        }

        private function securityErrorHandler(event:SecurityErrorEvent):void {
            trace("securityErrorHandler: " + event);
        }
        
        private function asyncErrorHandler(event:AsyncErrorEvent):void {
            // ignore AsyncErrorEvent events.
        }
    }
 }




 

Eine E-Mail an mich senden, wenn dieser Seite Kommentare hinzugefügt werden | Kommentarbericht

Aktuelle Seite: http://livedocs.adobe.com/flash/9.0_de/ActionScriptLangRefV3/flash/media/Video.html