Paket | flash.media |
Klasse | public class StageVideo |
Vererbung | StageVideo EventDispatcher Object |
Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | AIR 2.5, Flash Player 10.2 |
Unterstützung von AIR-Profilen: In AIR 3 unterstützen alle AIR-für-TV-Geräte und einige mobile Geräte diese Funktion. AIR 3 for iOS verwendet das StageVideo-Objekt für H.264-Video mit Hardwaredekodierung mit eingeschränkter Unterstützung für die NetStream-Funktionalität. AIR 3 for iOS unterstützt auch die Codecs On2 und Sorenson über das StageVideo-Objekt. Diese Unterstützung verwendet keine Hardwaredekodierung und schränkt die NetStream-Funktionalität nicht ein. In AIR 2.5 unterstützen nur Geräte mit AIR für TV diese Funktion. Außerdem ist der ActionScript-Code für diese Funktion in AIR 2.5 für TV anders als der ActionScript-Code für AIR 3 oder Flash Player 10.2. Die Unterschiede sind in den ActionScript-Beschreibungen aufgeführt. Weitere Informationen zum API-Support über mehrere Profile finden Sie unter Unterstützung von AIR-Profilen. Die StageVideo-Klasse wird in den AIR-Profilen „desktop“ oder „extendedDesktop“ nicht unterstützt.
Das vom StageVideo-Objekt angezeigte Video erscheint immer in einem rechteckigen Bereich auf der Bühne hinter allen Flash-Anzeigelistenobjekten. Deshalb nutzt das StageVideo-Objekt die Hardwarebeschleunigung, während der häufigste Fall bei Videoanzeigen unterstützt wird: ein rechteckiger Anzeigebereich, auf dem Videosteuerungen eingeblendet sind.
Die Vorteile der Verwendung eines StageVideo-Objekts anstelle des Video-Objekts sind:
- Verbesserte Videoanzeigeleistung aufgrund der Verwendung der Hardwarebeschleunigung.
- Geringere CPU-Auslastung.
- Flexibilität und Kreativität bei der Entwicklung von Inhalten, zum Beispiel Videosteuerungen, die vor dem StageVideo-Objekt angezeigt werden.
Da das Video mit der Hardware des Geräts angezeigt wird, gelten für ein StageVideo-Objekt die folgenden Einschränkungen im Vergleich mit einem Video-Objekt:
- Für jede SWF-Datei beschränkt Flash Player die Anzahl der StageVideo-Objekte, die gleichzeitig angezeigt werden können, auf vier. Die tatsächliche Höchstzahl kann jedoch darunter liegen; dies ist von den Hardwareressourcen des Geräts abhängig. Bei Geräten mit AIR für TV kann jeweils nur ein StageVideo-Objekt ein Video anzeigen.
- Die Videozeitgebung ist nicht mit der Zeitgebung von Flash-Inhalten, die die Laufzeitumgebung anzeigt, synchronisiert.
- Der Videoanzeigebereich kann nur ein Rechteck sein. Kompliziertere Anzeigebereiche, zum Beispiel Ellipsen oder unregelmäßige Formen, können nicht verwendet werden.
- Sie können das Video nicht drehen.
- Sie können das Video nicht als Bitmap zwischenspeichern oder BitmapData verwenden, um darauf zuzugreifen.
- Sie können keine Filter auf das Video anwenden.
- Sie können keine Farbtransformierungen auf das Video anwenden.
- Sie können keinen Alpha-Wert auf das Video anwenden.
- Mischmodi, die Sie auf Anzeigeobjekte anwenden, die sich vor dem Video befinden, werden nicht auf das Video angewendet.
- Sie können das Video nur auf vollen Pixelgrenzen platzieren.
- Obwohl das Rendering das jeweils beste für ein gegebenes Gerät verfügbare ist, ist es nicht 100% „pixel-identisch“ auf allen Geräten. Aufgrund von Treiber- und Plattformunterschieden kommt es zu leichten Abweichungen.
- Einige Geräte unterstützen nicht alle erforderlichen Farbräume. So unterstützen bestimmte Geräte zum Beispiel nicht BT.709, den H.264-Standard. In diesen Fällen können Sie für die schnelle Anzeige BT.601 verwenden.
- Sie können kein Bühnenvideo mit WMODE-Einstellungen wie
normal
,opaque
odertransparent
verwenden. Bühnenvideo unterstützt nurWMODE=direct
, wenn nicht der Vollbildmodus verwendet wird. WMODE hat in Safari 4 oder höher, IE 9 oder höher und in AIR für TV keine Auswirkungen. - Wenn Sie StageVideo in einer AIR for Android-Anwendung verwenden, stellen Sie
colorDepth
im Anwendungsdeskriptor auf 32bit ein. Die Verwendung von StageVideo mit einer 16-Bit-Farbtiefe wird nicht unterstützt. - Unter Android wird StageVideo nur bei Geräten unterstützt, auf denen Android 3 (Honeycomb) und höher ausgeführt wird. Damit Ihre App auf möglichst vielen Android-Geräten ausgeführt werden kann, stellen Sie immer eine Logik bereit, um Video mithilfe des Video-Objekts anzuzeigen, wenn StageVideo nicht verfügbar ist.
In den folgenden Schritte ist das Abspielen eines Videos mit einem StageVideo-Objekt zusammengefasst:
- Verwenden Sie einen Listener für das StageVideoAvailabilityEvent.STAGE_VIDEO_AVAILABILITY-Ereignis, um festzustellen, wenn sich der Stage.stageVideos-Vektor geändert hat. (Nicht unterstützt für AIR 2.5 für TV.)
- Wenn das StageVideoAvailabilityEvent.STAGE_VIDEO_AVAILABILITY-Ereignis meldet, dass Bühnenvideo verfügbar ist, greifen Sie mit dem
Stage.stageVideos
-Vektorobjekt in dieser Ereignisprozedur auf ein StageVideo-Objekt zu. In AIR 2.5 für TV greifen Sie aufStage.stageVideos
zu, nachdem das erste Bild der SWF-Datei gerendert wurde. Hinweis Sie können kein StageVideo-Objekt erstellen. - Hängen Sie ein NetStream-Objekt an, indem Sie
StageVideo.attachNetStream()
verwenden. - Spielen Sie das Video mit
NetStream.play()
ab. - Verwenden Sie einen Listener für das
StageVideoEvent.RENDER_STATE
-Ereignis des StageVideo-Objekts, um den Wiedergabestatus des Videos festzustellen. Der Empfang dieses Ereignisses gibt auch an, dass die width- und height-Eigenschaften (Breite und Höhe) des Videos initialisiert oder geändert wurden. - Verwenden Sie einen Listener für das
VideoEvent.RENDER_STATE
-Ereignis des Video-Objekts. Dieses Ereignis stellt dieselben Status bereit wie StageVideoEvent.RENDER_STATE, sodass Sie damit ebenfalls feststellen können, ob GPU-Beschleunigung verfügbar ist. Der Empfang dieses Ereignisses gibt auch an, dass die width- und height-Eigenschaften (Breite und Höhe) des Videos initialisiert oder geändert wurden. (Nicht unterstützt für AIR 2.5 für TV.)
Wenn ein StageVideoEvent.RENDER_STATE
-Ereignis angibt, dass das Video nicht abgespielt werden kann, können Sie wieder ein Video-Objekt anstelle eines StageVideo-Objekts verwenden. Dieses Ereignis wird abgesetzt, nachdem das Video an ein NetStream-Objekt angehängt wurde und abgespielt wird. Je nach Plattform können außerdem Änderungen am Wiedergabestatus zum Absetzen des Ereignisses führen. Verarbeiten Sie das StageVideoEvent.RENDER_STATE
-Ereignis, um sicherzustellen, dass die Anwendung das Video abspielt oder geregelt nicht abspielt.
Wenn ein laufendes Video aus einem WMODE, der kein Bühnenvideo unterstützt, in den Vollbildmodus wechselt, kann Bühnenvideo verfügbar werden. Umgekehrt kann Bühnenvideo nicht länger verfügbar sein, wenn der Benutzer den Vollbildmodus beendet. In diesen Fällen ändert sich der Stage.stageVideos-Vektor. Um über diese Änderung informiert zu werden, verwenden Sie einen Listener für das StageVideoAvailabilityEvent.STAGE_VIDEO_AVAILABITY-Ereignis. HINWEIS: Diese Benachrichtigung ist in AIR 2.5 für TV nicht verfügbar.
Weitere Informationen
Verwandte API-Elemente
flash.events.StageVideoAvailabilityEvent
flash.events.VideoEvent
flash.display.Stage.stageVideos
flash.media.Video
flash.net.NetStream
Eigenschaft | Definiert von | ||
---|---|---|---|
colorSpaces : Vector.<String> [schreibgeschützt]
Gibt die Namen der verfügbaren Farbräume für diese Videooberfläche zurück. | StageVideo | ||
constructor : Object
Ein Verweis auf das Klassenobjekt oder die Konstruktorfunktion für eine angegebene Objektinstanz. | Object | ||
depth : int
Die Tiefenebene eines StageVideo-Objekts in Relation zu anderen StageVideo-Objekten. | StageVideo | ||
pan : Point
Die Ausschnitteinstellung für die Anzeige des Videos, als Point-Objekt angegeben. | StageVideo | ||
videoHeight : int [schreibgeschützt]
Eine Ganzzahl, die die Höhe des Videostreams in Pixeln angibt. | StageVideo | ||
videoWidth : int [schreibgeschützt]
Eine Ganzzahl, die die Breite des Videostreams in Pixeln angibt. | StageVideo | ||
viewPort : Rectangle
Die absolute Position und Größe der Videooberfläche in Pixel. | StageVideo | ||
zoom : Point
Die Zoom-Einstellung für das Video, als Point-Objekt angegeben. | StageVideo |
Methode | Definiert von | ||
---|---|---|---|
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 unter Nutzung der GPU für das Rendering innerhalb des StageVideo-Objekts in der Anwendung angezeigt werden soll. | StageVideo | ||
Definiert einen Video-Stream, der innerhalb des StageVideo-Objekts im Anwendungsfenster angezeigt werden soll. | StageVideo | ||
Sendet ein Ereignis in den Ereignisablauf. | EventDispatcher | ||
Ü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 | ||
Gibt an, ob eine Instanz der Object-Klasse in der Prototypkette des Objekts vorhanden ist, das als Parameter angegeben wurde. | Object | ||
Gibt an, ob die angegebene Eigenschaft vorhanden ist und durchlaufen werden kann. | Object | ||
Entfernt einen Listener aus dem EventDispatcher-Objekt. | EventDispatcher | ||
Legt die Verfügbarkeit einer dynamischen Eigenschaft für Schleifenoperationen fest. | Object | ||
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 | |||
[broadcast event] Wird ausgelöst, wenn Flash Player- oder die AIR-Anwendung den Fokus verliert und inaktiv wird. | EventDispatcher | |||
Wird vom StageVideo-Objekt abgesetzt, wenn sich der Renderstatus des StageVideo-Objekts ändert. | StageVideo |
colorSpaces | Eigenschaft |
colorSpaces:Vector.<String>
[schreibgeschützt] Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | AIR 2.5, Flash Player 10.2 |
Gibt die Namen der verfügbaren Farbräume für diese Videooberfläche zurück. Normalerweise enthält diese Liste „BT.601“ und „BT.709“. Bei einigen Konfigurationen wird nur „BT.601“ unterstützt, was bedeutet, dass ein Video möglicherweise nicht im richtigen Farbraum dargestellt wird.
Hinweis: Bei Geräten mit AIR für TV gibt der Wert „BT.601“ die Softwarewiedergabe an, während der Wert „BT.709“ die Hardwarewiedergabe anzeigt.
Implementierung
public function get colorSpaces():Vector.<String>
depth | Eigenschaft |
depth:int
Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | AIR 2.5, Flash Player 10.2 |
Die Tiefenebene eines StageVideo-Objekts in Relation zu anderen StageVideo-Objekten.
StageVideo-Objekte werden immer hinter anderen Objekten auf der Bühne angezeigt. Wenn eine Plattform mehrere StageVideo-Objekte unterstützt, zeigt die depth
-Eigenschaft die Tiefenebene eines StageVideo-Objekts an. Die depth
-Eigenschaft des untersten StageVideo-Objekts hat den kleinsten Wert. Wenn mehrere StageVideo-Objekte dieselbe Tiefeneinstellung haben, bestimmt die Reihenfolge, in der sie im stage,stageVideos
-Vektor auftauchen, ihre relative Tiefe.
Hinweis: Geräte mit AIR für TV unterstützen nur ein StageVideo-Objekt. Deshalb gilt diese Eigenschaft für diese Geräte nicht.
Implementierung
public function get depth():int
public function set depth(value:int):void
Verwandte API-Elemente
pan | Eigenschaft |
pan:Point
Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | AIR 2.5, Flash Player 10.2 |
Die Ausschnitteinstellung für die Anzeige des Videos, als Point-Objekt angegeben.
Standardmäßig hat pan
den Wert (0,0)
. Mit diesem Standardwert wird das Video in dem Rechteck zentriert, das von StageVideo.viewPort
spezifiziert wird.
Der pan
-Wert ist nur dann von Bedeutung, wenn die zoom
-Eigenschaft nicht den Standardwert (1.0, 1.0)
hat. Wenn ein Video im StageVideo.viewPort
-Rechteck mit dem zoom
-Standardwert angezeigt wird, passt die Plattform das Video genau in das Rechteck ein. Somit ist das gesamte Video sichtbar. Wenn jedoch ein Zoomfaktor angegeben wurde, ist nicht das gesamte Video sichtbar. In diesem Fall können Sie den pan
-Wert festlegen, um anzugeben, welches Teilrechteck des Videos im StageVideo.viewPort
-Rechteck angezeigt werden soll.
Die gültigen Werte der pan
-Eigenschaft liegen im Bereich (-1.0, -1.0)
bis (1.0, 1.0)
. Insbesondere:
-
Der
pan
-Wert(-1.0, -1.0)
platziert das obere linke Pixel des Videos in der oberen linken Ecke desStageVideo.viewPort
-Rechtecks. -
Der
pan
-Wert(1.0, 1.0)
platziert das untere rechte Pixel des Videos in der unteren rechten Ecke desStageVideo.viewPort
-Rechtecks. -
Der
pan
-Wert(1.0, -1.0)
platziert das obere rechte Pixel des Videos in der oberen rechten Ecke desStageVideo.viewPort
-Rechtecks. -
Der
pan
-Wert(-1.0, 1.0)
platziert das untere linke Pixel des Videos in der unteren linken Ecke desStageVideo.viewPort
-Rechtecks.
Werte zwischen -1.0 und 1.0 ergeben entsprechende Ausschnitte.
Wenn Sie die pan
-Eigenschaft auf einen Wert außerhalb des gültigen Bereichs RangeError
setzen, wird eine Ausnahme ausgegeben. Die Laufzeitumgebung setzt den Wert auf den letzten gültigen Wert zurück.
Ziehen Sie auch in Erwägung, zur Verwendung eines StageVideo-Objekts ein Element des Stage.stageVideos
-Vector-Objekts einer StageVideo-Variablen zuzuweisen. Wenn Sie die pan
-Eigenschaft der StageVideo-Variablen festlegen, ändert sich auch das zugrunde liegende Stage.stageVideos
-Vector-Element. Wenn Sie dieses Element später einer anderen StageVideo-Variablen zuweisen, setzen Sie die pan
-Eigenschaft zurück.
Implementierung
public function get pan():Point
public function set pan(value:Point):void
Auslöser
RangeError — Der Point-Wert ist nicht gültig.
|
Verwandte API-Elemente
videoHeight | Eigenschaft |
videoHeight:int
[schreibgeschützt] Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | AIR 2.5, Flash Player 10.2 |
Eine Ganzzahl, die die Höhe des Videostreams in Pixeln angibt.
Diese Eigenschaft können Sie zum Beispiel verwenden, um sicherzustellen, dass der Benutzer das Video in derselben Höhe sieht, mit der es erfasst wurde, unabhängig von der Größe des StageVideo.viewPort
-Rechtecks.
Implementierung
public function get videoHeight():int
videoWidth | Eigenschaft |
videoWidth:int
[schreibgeschützt] Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | AIR 2.5, Flash Player 10.2 |
Eine Ganzzahl, die die Breite des Videostreams in Pixeln angibt.
Diese Eigenschaft können Sie zum Beispiel verwenden, um sicherzustellen, dass der Benutzer das Video in derselben Breite sieht, mit der es erfasst wurde, unabhängig von der Größe des StageVideo.viewPort
-Rechtecks.
Implementierung
public function get videoWidth():int
viewPort | Eigenschaft |
viewPort:Rectangle
Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | AIR 2.5, Flash Player 10.2 |
Die absolute Position und Größe der Videooberfläche in Pixel.
Die Position des Videos ist relativ zur oberen linken Ecke der Bühne.
Der gültige Bereich der x
- und y
-Eigenschaften des viewPort
-Rectangle-Objekts ist -8192 bis 8191. Deshalb können Sie das Video vollständig oder teilweise außerhalb der Bühne positionieren. Sie können das Video auch größer als die Bühne machen, wenn Sie die width
- und height
-Eigenschaften der viewPort
-Eigenschaft größer als die Bühne einstellen.
Implementierung
public function get viewPort():Rectangle
public function set viewPort(value:Rectangle):void
Auslöser
RangeError — Der Rectangle-Wert ist nicht gültig.
|
zoom | Eigenschaft |
zoom:Point
Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | AIR 2.5, Flash Player 10.2 |
Die Zoom-Einstellung für das Video, als Point-Objekt angegeben.
Der Zoom-Punkt ist ein Skalierungsfaktor. Standardmäßig hat zoom
den Wert (1.0, 1.0)
. Mit diesem Standardwert wird das gesamte Video imStageVideo.viewPort
-Rechteck angezeigt.
Die gültigen Werte der zoom
-Eigenschaft liegen im Bereich (1.0, 1.0)
bis (8.0, 8.0)
. Die x
-Eigenschaft des zoom-Point-Objekts gibt den Zoomwert für die horizontalen Pixel an und die y-Eigenschaft gibt den Zoom-Wert für die vertikalen Pixel an.
Ein zoom
-Wert von (2.0, 2.0)
zeigt zum Beispiel nur die Hälfte der horizontalen und die Hälfte der vertikalen Pixel im StageVideo.viewPort
-Rechteck an. Das bedeutet, dass das Video zwar immer noch das StageVideo.viewPort
-Rechteck ausfüllt, es ist jedoch nur die Hälfte des Videos sichtbar, sodass ein 2-facher Vergrößerungseffekt entsteh. Dementsprechend wird bei einem zoom
-Wert von (8.0, 8.0)
nur 1/8 der horizontalen Pixel und ein 1/8 der vertikalen Pixel im StageVideo.viewPort
-Rechteck angezeigt, sodass ein 8-facher Vergrößerungseffekt entsteht.
Wenn Sie die zoom
-Eigenschaft festlegen, stellen Sie die pan
-Eigenschaft so ein, dass das StageVideo.viewPort
-Rechteck das gewünschte Teilrechteck des Videos anzeigt.
Betrachten Sie die folgende Situation, bei der es hilfreich ist, einen anderen Wert für die x
- und y
-Eigenschaften des zoom
-Point-Objekts festzulegen. Beachten Sie zunächst, dass wenn ein Video im StageVideo.viewPort
-Rechteck mit dem zoom
-Standardwert angezeigt wird, die Plattform das Video genau in das Rechteck einpasst. Wenn das Rechteck des Videos nicht gleichmäßig in das StageVideo.viewPort
-Rechteck skaliert wird, kann die Videoanzeige verzerrt sein. Das heißt, dass die Seitenverhältnisse des Videos und des StageVideo.viewPort
-Rechteck nicht gleich sind. Dieser Fall kann zum Beispiel eintreten, wenn das Video eine andere Breite als Höhe hat, die StageVideo.viewPort
-Eigenschaft jedoch ein Quadrat spezifiziert. Um die Verzerrung zu beheben, stellen Sie unterschiedliche Werte für die x
- und y
-Eigenschaften des zoom
-Point-Objekts ein. Stellen Sie dann die pan
-Eigenschaft ein, um sicherzustellen, dass das StageVideo.viewPort
-Rechteck das richtige Teilrechteck des Videos zeigt.
Wenn Sie die zoom
-Eigenschaft auf einen Wert außerhalb des gültigen Bereichs RangeError
setzen, wird eine Ausnahme ausgegeben. Die Laufzeitumgebung setzt den Wert auf den letzten gültigen Wert zurück.
Ziehen Sie auch in Erwägung, zur Verwendung eines StageVideo-Objekts ein Element des Stage.stageVideos
-Vector-Objekts einer StageVideo-Variablen zuzuweisen. Wenn Sie die zoom
-Eigenschaft der StageVideo-Variablen festlegen, ändert sich auch das zugrunde liegende Stage.stageVideos
-Vector-Element. Wenn Sie dieses Element später einer anderen StageVideo-Variablen zuweisen, setzen Sie die zoom
-Eigenschaft zurück.
Implementierung
public function get zoom():Point
public function set zoom(value:Point):void
Auslöser
RangeError — Der Point-Wert ist nicht gültig.
|
Verwandte API-Elemente
attachCamera | () | Methode |
public function attachCamera(theCamera:Camera):void
Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | Flash Player 11.4, AIR 3.4 |
Gibt einen Videostream von einer Kamera an, der unter Nutzung der GPU für das Rendering innerhalb des StageVideo-Objekts in der Anwendung angezeigt werden soll.
Hinweis: StageVideo für Kamera wird nicht auf Android unterstützt.
Verwenden Sie diese Methode, um vom Benutzer erfasstes Live-Video an das StageVideo-Objekt anzuhängen. Wenn Sie die Verbindung mit dem StageVideo-Objekt beenden möchten, übergeben Sie den Wert null
.
Parameter
theCamera:Camera — Ein Camera-Objekt, das Videodaten erfasst.
|
Verwandte API-Elemente
attachNetStream | () | Methode |
public function attachNetStream(netStream:NetStream):void
Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | AIR 2.5, Flash Player 10.2 |
Definiert einen Video-Stream, der innerhalb des StageVideo-Objekts im Anwendungsfenster angezeigt werden soll. Der Videostream ist entweder eine Videodatei, die mit NetStream.play() abgespielt wird, oder null
. Eine Videodatei kann 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 StageVideo-Objekt wiedergegeben.
Bevor Sie attachNetStream()
ein zweites Mal aufrufen, rufen Sie die close()
-Methode des zurzeit angehängten NetStream-Objekts an. Mit dem Aufruf von close()
werden alle Ressourcen freigegeben, die zum Abspielen des Videos benötigt werden, einschließlich des Hardwaredecoders. Sie können dann attachNetStream()
mit einem anderen NetStream-Objekt oder null
aufrufen.
Sie müssen diese Methode nicht verwenden, wenn eine Videodatei nur Audiodaten enthält. Die Audiodaten von Videodateien werden automatisch wiedergegeben, wenn Sie NetStream.play()
aufrufen. Um die mit einer Videodatei verknüpften Audiodaten zu steuern, verwenden Sie die soundTransform
-Eigenschaft des NetStream-Objekts, das die Videodatei wiedergibt.
Parameter
netStream:NetStream — Ein NetStream-Objekt. Wenn Sie die Verbindung mit dem StageVideo-Objekt beenden möchten, übergeben Sie den Wert null .
|
renderState | Ereignis |
flash.events.StageVideoEvent
Eigenschaft StageVideoEvent.type =
flash.events.StageVideoEvent.RENDER_STATE
Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | AIR 2.5, Flash Player 10.2 |
Wird vom StageVideo-Objekt abgesetzt, wenn sich der Renderstatus des StageVideo-Objekts ändert.
DieStageVideoEvent.RENDER_STATE
-Konstante definiert den Wert der type
-Eigenschaft eines renderState
-Ereignisobjekts.
Dieses Ereignis verfügt über die folgenden Eigenschaften:
Eigenschaft | Wert |
---|---|
bubbles | false |
cancelable | false . Es gibt kein Standardverhalten, das abgebrochen werden kann. |
colorSpace | Die verfügbaren Farbräume für die Wiedergabe des Videos. |
currentTarget | Das Objekt, welches das StageVideoEvent-Objekt aktiv mit einem Ereignis-Listener verarbeitet. |
status | Gibt an, ob das Video von der Hardware gerendert (dekodiert und angezeigt) wird, von der Software, oder gar nicht. |
target | Das StageVideo-Objekt, dessen Zustand sich geändert hat. |
Tue Jun 12 2018, 10:04 AM Z