Unterstützung für den Vollbildmodus

Die ActionScript 3.0-Version der FLVPlayback-Komponente unterstützt den Vollbildmodus, der Flash Player 9.0.28.0 oder höher erfordert. Außerdem muss der HTML-Code richtig für die Anzeige im Vollbildmodus eingerichtet sein. Einige vordefinierte Skins enthalten eine Schaltfläche, mit der der Vollbildmodus ein- und ausgeschaltet werden kann. In der folgenden Abbildung wird das FullScreenButton-Symbol rechts in der Steuerungsleiste angezeigt.

Symbol für den Vollbildmodus in der Steuerungsleiste

Der Vollbildmodus wird nur unterstützt, wenn die Eigenschaft fullScreenTakeOver den Standardwert true aufweist.

Die Unterstützung für den Vollbildmodus ist mit und ohne Unterstützung für die Hardwarebeschleunigung möglich. Informationen zur Unterstützung der Hardwarebeschleunigung finden Sie unter Hardwarebeschleunigung .

Implementieren der Vollbildmodus-Unterstützung für FLVPlayback:

  1. Fügen Sie die FLVPlayback-Komponente Ihrer Anwendung hinzu und weisen Sie ihr eine Videodatei zu.

  2. Wählen Sie für die FLVPlayback-Komponente eine Skin aus, die eine Schaltfläche für den Vollbildmodus aufweist (z. B. SkinUnderPlaySeekFullscreen.swf). Stattdessen können Sie auch den Bereich „Video“ im Bedienfeld „Komponenten“ verwenden, um der FLVPlayback-Komponente die FullScreenButton-UI-Komponente hinzuzufügen.

  3. Wählen Sie „Datei“ > „Einstellungen für Veröffentlichungen“.

  4. Klicken Sie im Dialogfeld „Einstellungen für Veröffentlichungen“ auf die Registerkarte „HTML“.

  5. Wählen Sie auf der Registerkarte „HTML“ im Dropdownmenü „Vorlage“ die Option für Flash mit Vollbildmodus-Unterstützung.

  6. Aktivieren Sie auf der Registerkarte „HTML“ das Kontrollkästchen „Flash-Version feststellen“ und geben Sie Version 9.0.28 oder höher an, je nach der von Ihnen verwendeten Flash Player-Version.

  7. Wählen Sie auf der Registerkarte „Formate“ die Optionen für Flash (.swf) und HTML (.html) aus. Sie können die Standarddateinamen ersetzen.

  8. Klicken Sie auf „Veröffentlichen“ und dann auf „OK“.

    Als Alternative zu Schritt 7 können Sie auch auf „OK“ klicken und dann „Datei“ > „Vorschau für Veröffentlichungen“ > „Standard – (HTML)“ auswählen, um die exportierte HTML-Datei automatisch in Ihrem Standardbrowser zu öffnen. Andernfalls öffnen Sie die exportierte HTML-Datei im Browser, um den Vollbildmodus zu testen.

    Um die FLVPlayback-Komponente mit Vollbildmodus-Unterstützung in Ihre Webseite einzufügen, öffnen Sie die exportierte HTML-Datei und kopieren Sie den Code, mit dem die SWF-Datei eingebettet wird, in die HTML-Datei für Ihre Webseite. Der Code sollte ungefähr folgendermaßen aussehen:

    //from the <head> section 
     
    <script language="javascript"> AC_FL_RunContent = 0; </script>  
    <script language="javascript"> DetectFlashVer = 0; </script>  
    <script src="AC_RunActiveContent.js" language="javascript"></script> 
    <script language="JavaScript" type="text/javascript">  
    <!--  
    // -----------------------------------------------------------------------------  
    // Globals  
    // Major version of Flash required  
    var requiredMajorVersion = 9;  
    // Minor version of Flash required  
    var requiredMinorVersion = 0;  
    // Revision of Flash required  
    var requiredRevision = 28;  
    // -----------------------------------------------------------------------------  
    // -->  
    </script>  
     
    //and from the <body> section 
     
    <script language="JavaScript" type="text/javascript">  
    <!--  
    if (AC_FL_RunContent == 0 || DetectFlashVer == 0) {  
        alert("This page requires AC_RunActiveContent.js.");  
    } else {  
        var hasRightVersion = DetectFlashVer(requiredMajorVersion, 
            requiredMinorVersion, requiredRevision);  
        if(hasRightVersion) { // if we&apos;ve detected an acceptable version  
            // embed the Flash movie  
            AC_FL_RunContent(  
                &apos;codebase&apos;, &apos;http://download.macromedia.com/pub/ 
                    shockwave/cabs/flash/swflash.cab#version=9,0,28,0&apos;,  
                &apos;width&apos;, &apos;550&apos;,  
                &apos;height&apos;, &apos;400&apos;, 
                &apos;src&apos;, &apos;fullscreen&apos;,  
                &apos;quality&apos;, &apos;high&apos;,  
                &apos;pluginspage&apos;, &apos;http://www.macromedia.com/go/ 
                    getflashplayer&apos;,  
                &apos;align&apos;, &apos;middle&apos;,  
                &apos;play&apos;, &apos;true&apos;,  
                &apos;loop&apos;, &apos;true&apos;,  
                &apos;scale&apos;, &apos;showall&apos;,  
                &apos;wmode&apos;, &apos;window&apos;,  
                &apos;devicefont&apos;, &apos;false&apos;,  
                &apos;id&apos;, &apos;fullscreen&apos;,  
                &apos;bgcolor&apos;, &apos;#ffffff&apos;,  
                &apos;name&apos;, &apos;fullscreen&apos;,  
                &apos;menu&apos;, &apos;true&apos;, 
                &apos;allowScriptAccess&apos;,&apos;sameDomain&apos;, 
                &apos;allowFullScreen&apos;,&apos;true&apos;,  
                &apos;movie&apos;, &apos;fullscreen&apos;,  
                &apos;salign&apos;, &apos;&apos; ); //end AC code  
        } else { // Flash is too old or we can&apos;t detect the plug-in.  
            var alternateContent = &apos;Alternative HTML content should be placed 
                    here.&apos;  
                + &apos;This content requires Adobe Flash Player.&apos;  
                + &apos;<a href=http://www.macromedia.com/go/getflash/>Get Flash</a> 
                        &apos;;  
            document.write(alternateContent); // Insert non-Flash content.  
        }  
    }  
    // -->  
    </script>  
    <noscript>  
        // Provide alternative content for browsers that do not support scripting  
        // or for those that have scripting disabled.  
        Alternative HTML content should be placed here. This content requires Adobe Flash Player.  
        <a href="http://www.macromedia.com/go/getflash/">Get Flash</a>  
    </noscript>

    Stattdessen können Sie auch die exportierte HTML-Datei als Vorlage für Ihre Webseite verwenden und ihr den weiteren Inhalt hinzufügen. In diesem Fall sollten Sie die HTML-Datei jedoch umbenennen, damit sie nicht versehentlich überschrieben wird, falls Sie die HTML-Datei mit der FLVPlayback-Komponente später erneut aus Flash exportieren.

    In jedem Fall müssen Sie auch die Datei „AC_RunActiveContent.js“, die in denselben Ordner wie die HTML-Datei exportiert wird, auf Ihren Webserver hochladen.

    Die ActionScript-Unterstützung für den Vollbildmodus umfasst die Eigenschaften fullScreenBackgroundColor , fullScreenSkinDelay und fullScreenTakeOver sowie die Methode enterFullScreenDisplayState() . Informationen zu diesen ActionScript-Elementen finden Sie im ActionScript 3.0 Referenzhandbuch für Flash Professional .

Verwenden von enterFullScreenDisplayState()

Sie können den Vollbildmodus auch über die ActionScript-Methode enterFullScreenDisplayState() aufrufen, wie im folgenden Beispiel gezeigt.

function handleClick(e:MouseEvent):void { 
    myFLVPlybk.enterFullScreenDisplayState(); 
} 
myButton.addEventListener(MouseEvent.CLICK, handleClick);

In diesem Beispiel wird der Vollbildmodus nicht durch Klicken auf die Vollbildmodus-Schaltfläche einer FLVPlayback-Skin aufgerufen, sondern durch Klicken auf eine Schaltfläche (MyButton), die der Ersteller der Webseite zum Aufrufen des Vollbildmodus eingefügt hat. Beim Klicken auf die Schaltfläche wird die Ereignisprozedur handleClick ausgelöst, die wiederum die Methode enterFullScreen DisplayState() aufruft.

Die Methode enterFullScreenDisplayState() stellt die Eigenschaft Stage.displayState auf den Wert StageDisplayState.FULL_SCREEN ein und bewirkt daher dieselben Einschränkungen wie auch die Eigenschaft displayState . Weitere Informationen zur Methode enterFullScreenDisplayState() und zur Eigenschaft Stage . displayState finden Sie im ActionScript 3.0 Referenzhandbuch für Flash Professional .

Hardwarebeschleunigung

Flash Player 9.0.115.0 und neuere Versionen enthalten Code, der verfügbare Videohardware nutzt, um die Leistung und Genauigkeit beim Abspielen von FLV-Dateien zu erhöhen, die FLVPlayback im Vollbildmodus wiedergibt. Sofern die Voraussetzungen erfüllt sind und die Eigenschaft fullScreenTakeOver auf true eingestellt ist, skaliert Flash Player die Videodatei über die Hardwarebeschleunigung anstatt über die Software. Wenn die FLVPlayback-Komponente in einer früheren Flash Player-Version ausgeführt wird oder wenn die Voraussetzungen für die Hardwarebeschleunigung nicht erfüllt sind, erfolgt die Skalierung der Videodatei wie bisher durch Flash Player selbst.

Um die Hardwarebeschleunigung für die Vollbildmodus-Unterstützung nutzen zu können, muss Ihr Computer mit einer DirectX 7-kompatiblen Grafikkarte mit mindestens 4 MB VRAM (Video RAM) ausgestattet sein. Diese Hardware-Unterstützung ist in Windows 2000 oder Mac OS X 10.2 sowie höheren Versionen dieser Betriebssysteme verfügbar. Direct X® enthält APIs, die eine Schnittstelle zwischen der Software und der Videohardware bilden und unter anderem zwei- und dreidimensionale Grafiken beschleunigen.

Zur Nutzung der Hardwarebeschleunigung müssen Sie zudem den Vollbildmodus mit einer der folgenden Methoden aufrufen:

  • Vollbildmodus-Schaltfläche in einer FLVPlayback-Skin

  • FullScreenButton-Videosteuerung

  • ActionScript-Methode enterFullScreenDisplayState() Weitere Informationen finden Sie unter Verwenden von enterFullScreenDisplayState() .

    Wenn Sie den Vollbildmodus aufrufen, indem Sie die Eigenschaft Stage.displayState auf den Wert StageDisplayState.FULLSCREEN einstellen, verwendet FLVPlayback keine Hardwarebeschleunigung, selbst wenn Videohardware und VRAM verfügbar sind.

    Die Verwendung der Hardwarebeschleunigung für die Vollbildmodus-Unterstützung bewirkt unter anderem, dass die FLVPlayback-Skins zusammen mit dem Video-Player und der Videodatei skaliert werden. Die folgende Abbildung zeigt die Auswirkungen des Vollbildmodus mit Hardwarebeschleunigung auf die FLVPlayback-Skin. Ein Detail ist in voller Auflösung hervorgehoben.

    Vollbildmodus auf einem Bildschirm mit 1600 x 1200 für ein Video mit 320 x 240 Pixel
    Vollbildmodus auf einem Bildschirm mit 1600 x 1200 für ein Video mit 320 x 240 Pixel

    Diese Abbildung zeigt das Resultat bei Verwendung des Vollbildmodus auf einem Bildschirm mit 1600 x 1200 für eine Videodatei mit einer Breite von 320 und einer Höhe von 240 (dies sind die FLVPlayback-Standardabmessungen). Die Verzerrung der Skin fällt bei FLV-Dateien mit geringeren Abmessungen oder auf einem größeren Bildschirm stärker aus. Umgekehrt tritt bei größeren FLV-Dateien oder auf kleineren Bildschirmen eine geringere Verzerrung auf. Wenn Sie beispielsweise statt 640 x 480 einen Bildschirm mit 1600 x 1200 verwenden, wird die Skin größer, sieht aber weniger verzerrt aus.

    Über die Eigenschaft skinScaleMaximum können Sie die Skalierung der FLVPlayback-Skin einschränken. Der Standardwert lautet 4,0 (400 %). Das Einschränken der Skin-Skalierung erfordert jedoch eine Kombination aus Hardware und Software zum Skalieren der FLV-Datei. Dies kann sich negativ auf die Leistung von großen FLV-Dateien auswirken, die mit einer hohen Bitrate kodiert sind. Wenn das Video groß ist (zum Beispiel 640 Pixel breit oder breiter, 480 Pixel hoch oder höher), sollten Sie die Eigenschaft skinScaleMaximum nicht auf einen niedrigen Wert setzen, da es sonst auf großen Bildschirmen zu deutlichen Leistungsproblemen kommen kann. Mithilfe der Eigenschaft skinScaleMaximum können Sie ein angemessenes Verhältnis zwischen Leistung und Qualität sowie der Darstellung einer großen Skin erzielen.

Beenden des Vollbildmodus

Zum Beenden des Vollbildmodus klicken Sie noch einmal auf die Vollbild-Schaltfläche oder drücken Sie die Esc-Taste.

Beim Festlegen der folgenden Eigenschaften und Aufrufen der folgenden Methoden können Änderungen am Layout auftreten, die dazu führen, dass die FLVPlayback-Komponente den Vollbildmodus beendet: height , registrationHeight , registrationWidth , registrationX , registrationY , scaleX , scaleY , width , x , y , setScale() oder setSize() .

Wenn Sie die Eigenschaften align oder scaleMode festlegen, setzt FLVPlayback sie auf die Werte center bzw. maintainAspectRatio , bis der Vollbildmodus beendet wird.

Außerdem beendet Flash den Vollbildmodus, wenn Sie den Wert der Eigenschaft fullScreenTakeOver von true in false ändern, während der Vollbildmodus mit Hardwarebeschleunigung verwendet wird.