Actionscript 3 Entwicklerhandbuch

ACTIONSCRIPT 3.0 ENTWICKLERHANDBUCH
Verwenden von Videos
Wenn kein Bühnenvideo verfügbar ist, enthält dieses Vector-Objekt keine Objekte. Um Laufzeitfehler zu vermeiden,
darf der Zugriff auf Mitglieder dieses Vektors nur erfolgen, wenn das neueste StageVideoAvailability-Ereignis
darauf hinweist, dass Bühnenvideo verfügbar ist.
StageVideo-Ereignisse
Die StageVideo-API bietet die folgenden Ereignisse:
StageVideoAvailabilityEvent.STAGE_VIDEO_AVAILABILITY (In AIR 2.5 für TV nicht unterstützt) Wird gesendet,
wenn die Stage.stageVideos-Eigenschaft sich ändert. Die StageVideoAvailabilityEvent.availability-
Eigenschaft hat den Wert AVAILABLE (VERFÜGBAR) oder UNAVAILABLE (NICHT VERFÜGBAR). Verwenden Sie
dieses Ereignis, um zu ermitteln, ob die stageVideos-Eigenschaft StageVideo-Objekte enthält, anstatt direkt die
Länge des Stage.stageVideos-Vektors zu überprüfen.
StageVideoEvent.RENDER_STATE Wird gesendet, wenn ein NetStream-Objekt einem StageVideo-Objekt zugeordnet
wurde und abgespielt wird. Gibt an, welches Dekodierverfahren gerade verwendet wird: Hardware, Software oder
nicht verfügbar (nichts wird angezeigt). Das Ereignisziel enthält die videoWidth- und videoHeight-Eigenschaften,
mit denen die Größe des Video-Viewports auf sichere Weise geändert werden kann.
Wichtig: Die vom StageVideo-Zielobjekt abgerufenen Koordinaten stützen sich auf Bühnenkoordinaten, da sie nicht zur
Standardanzeigeliste gehören.
VideoEvent.RENDER_STATE (In AIR 2.5 für TV nicht unterstützt) Wird gesendet, wenn ein Video-Objekt verwendet
wird. Das Ereignis gibt an, ob die Dekodierung über die Software oder über die Hardwarebeschleunigung
durchgeführt wird. Wenn dieses Ereignis auf eine hardwarebeschleunigte Dekodierung hinweist, sollten Sie nach
Möglichkeit zu einem StageVideo-Objekt wechseln. Das Video-Ereignisziel enthält die videoWidth- und
videoHeight-Eigenschaften, mit denen die Größe des Video-Viewports auf sichere Weise geändert werden kann.
Arbeitsablauf zum Implementieren der StageVideo-Funktion
Das Implementieren der StageVideo-Funktion besteht aus den folgenden Hauptschritten:
1 Verwenden Sie einen Listener für das StageVideoAvailabilityEvent.STAGE_VIDEO_AVAILABILITY-Ereignis,
um festzustellen, wann sich der Stage.stageVideos-Vektor geändert hat. Siehe „Verwenden des
StageVideoAvailabilityEvent.STAGE_VIDEO_AVAILABILITY-Ereignisses“ auf Seite 547. (In AIR 2.5 für TV
nicht unterstützt.)
2 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 auf Stage.stageVideos zu, nachdem das erste Bild der SWF-
Datei gerendert wurde.
3 Hängen Sie ein NetStream-Objekt an, indem Sie StageVideo.attachNetStream() verwenden.
4 Spielen Sie das Video mit NetStream.play() ab.
5 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. Siehe „Verwenden der
StageVideoEvent.RENDER_STATE- und VideoEvent.RENDER_STATE-Ereignisse“ auf Seite 549.
6 Verwenden Sie einen Listener für das VideoEvent.RENDER_STATE-Ereignis des Video-Objekts. Dieses Ereignis
stellt dieselben Statusangaben bereit wie StageVideoEvent.RENDER_STATE, sodass Sie damit auch feststellen
können, ob die 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. (In AIR 2.5 für TV
nicht unterstützt.) Siehe „Verwenden der StageVideoEvent.RENDER_STATE- und
VideoEvent.RENDER_STATE-Ereignisse“ auf Seite 549.
Letzte Aktualisierung 27.6.2012
546