Helskärmsstöd

Använda enterFullScreenDisplayState()
Maskivaruacceleration
Avsluta helskärmsläge

ActionScript 3.0-versionen av FLVPlayback-komponenten stöder helskärmsläge, vilket kräver Flash Player 9.0.28.0 eller senare och att även HTML har ställts in korrekt för helskärmsvisning. Vissa redan utformade skal har en alternativknapp som används för att växla mellan helskärm på och helskärm av. Ikonen FullScreenButton visas på höger sida om kontrollfältet på följande bild.

Helskärmsikon i kontrollfältet

Stöd för helskärm fungerar bara om egenskapen fullScreenTakeOver är inställd på true (vilket den är som standard).

Helskärmsstöd kan förekomma med eller utan stöd för maskinvaruacceleration. Information om stöd för maskinvaruacceleration finns i Maskivaruacceleration .

Så här implementerar du helskärmsstöd för FLVPlayback:

Lägg till FLVPlayback-komponenten i ditt program och tilldela den en videofil.
Välj ett skal för den FLVPlayback-komponent som innehåller helskärmsknappen (exempelvis SkinUnderPlaySeekFullscreen.swf) eller lägg till användargränssnittskomponenten FullScreenButton till FLVPlayback-komponenten från avsnittet Video i panelen Komponenter.
Välj Arkiv > Publiceringsinställningar.
I dialogrutan Publiceringsinställningar klickar du på fliken HTML.
På fliken HTML väljer du Flash med helskärmsstöd från popup-menyn Mall.
På fliken HTML markerar du även kryssrutan Identifiera Flash-version och anger version 9.0.28 eller senare, beroende på vilken version av Flash Player som du använder.
Välj fliken Format och se till att både alternativet Flash (.swf) och alternativet HTML (.html) är markerade. Du kan ersätta standardfilnamnen.

Klicka på Publicera och sedan på OK.

Som ett alternativ till steg 7 kan du klicka på OK och sedan välja Arkiv > Publicera förhandsgranskning > Standard- (HTML) för att automatiskt öppna den exporterade HTML-filen i din standardwebbläsare. Annars öppnar du den exporterade HTML-filen i din webbläare för att testa helskärmsalternativet.

Om du vill lägga till FLVPlayback-komponenten med helskärmsstöd på din webbsida öppnar du den exporterade HTML-filen och kopierar den kod som bäddar in SWF-filen i HTML-filen på din webbsida. Koden bör nu se ut ungefär så här:

//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>

Du kan också använda den exporterade HTML-filen som mall för din webbsida och lägga till resterande innehåll på den. Om du gör det bör du dock ändra namnet på HTML-filen så att du inte av misstag skriver över den om du senare skulle exportera HTML-filen från Flash.

Du måste i alla fall överföra filen AC_RunActiveContent.js, som exporteras till samma mapp som HTML-filen, till din webbserver.

ActionScript-stöd för helskärmsläge inkluderar egenskaperna fullScreenBackgroundColor , fullScreenSkinDelay och fullScreenTakeOver och metoden enterFullScreenDisplayState() . Information om de här ActionScript-elementen finns i Referenshandbok för ActionScript 3.0 i Adobe Flash Professional .

Använda enterFullScreenDisplayState()

Du kan även aktivera helskärmsläge genom att anropa metoden enterFullScreenDisplayState() , enligt exemplet nedan.

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

I det här exemplet aktiveras inte helskärmsläget när du klickar på alternativknappen för helskärmsläge i ett FLVPlayback-skal, utan läget aktiveras när du klickar på en knapp (MyButton) som den som har skapat webbsidan har inkluderat för att aktivera helskärmsläget. När du klickar på knappen aktiveras händelsehanteraren handleClick som anropar metoden enterFullScreen DisplayState() .

Metoden enterFullScreenDisplayState() ställer in egenskapen Stage.displayState property till StageDisplayState.FULL_SCREEN och får därmed samma begränsningar som egenskapen displayState . Mer information om metoden enterFullScreenDisplayState() och egenskapen Stage .Egenskapen displayState , se Referenshandbok för ActionScript 3.0 i Adobe Flash Professional .

Maskivaruacceleration

Flash Player 9.0.115.0 och senare versioner innehåller kod som drar nytta av tillgänglig videomaskinvara för att förbättra prestanda och återgivningen av de FLV-filer som FLVPlayback spelar upp i helskärmsläge. Om förutsättningarna är uppfyllda och egenskapen fullScreenTakeOver är inställd till true använder Flash Player maskinvaruacceleration för att ändra skala på videofilen, i stället för att göra det via programvaran. Om FLVPlayback-komponenten körs i en tidigare version av Flash Player, eller om förutsättningarna för maskinvaruacceleration inte finns, ändrar Flash Player skalan på videofilen, som förut.

För att utnyttja maskinvaruacceleration för helskärmsstöd måste datorn ha ett DirectX 7-kompatibelt videokort med 4 MB eller mer i VRAM-minne (videominne). Det här maskinvarustödet finns i Windows 2000 och Mac OS X 10.2 samt senare versioner av dessa operativsystem. Direct X® innehåller API:er som utgör ett gränssnitt mellan programvara och videomaskinvara för att till exempel accelerera tre- och tvådimensionella bilder.

För att kunna använda accelerationsläget för maskinvara måste du aktivera helskärmsläget på något av följande sätt:

Använda alternativknappen för helskärmsläge på ett FLVPlayback-skal
Använda videokontrollen FullScreenButton
Använda ActionScript-metoden enterFullScreenDisplayState() . Mer information finns i Använda enterFullScreenDisplayState() .

Om du aktiverar helskärmsläget genom att ställa in egenskapen Stage.displayState till StageDisplayState.FULLSCREEN använder inte FLVPlayback maskinvaruacceleration, även om videomaskinvaran och minnet är tillgängligt.

En följd av att använda maskinvaruacceleration för helskärmsstöd är att FLVPlayback-skalen anpassas efter videospelaren och videofilen. Bilden nedan visar hur helskärmsläget ser ut med maskinvaruacceleration på FLVPlayback-skalet (en detalj visas i fullständig upplösning).

Helskärmsläge på en 1600x1200-skärm med en 320x240-pixelvideo

Den här bilden visar resultatet när helskärmsläge används på en bildskärm med upplösningen 1600 x 1200 tillsammans med en videofil som har bredden 320 och höjden 240, vilka är FLVPlayback-komponentens standarddimensioner. Förvrängningseffekten på skalet är tydligare på FLV-filer med mindre dimensioner och på större bildskärmar. Förvrängningen syns därför mindre på större FLV-filer och på mindre bildskärmar. Om du till exempel ändrar från 640 x 480 till 1600 x 1200 ökar storleken på skalet, men det ser mindre förvrängt ut.

Du kan ställa in egenskapen skinScaleMaximum för att begränsa anpassningen av FLVPlayback-skalet. Standardvärdet är 4,0 eller 400 %. För att begränsa anpassningen av skalet krävs dock en viss kombination av maskinvara och programvara för att ändra skalan på FLV-filen och det kan påverka prestanda negativt för FLV-filer med stora dimensioner som är kodade med en hög bithastighet. Om videofilen är stor (till exempel minst 640 pixlar bred och 480 pixlar hög) bör inte skinScaleMaximum ställas in på ett lågt värde eftersom det kan orsaka märkbara prestandaproblem på stora bildskärmar. Med egenskapen skinScaleMaximum kan du balansera prestanda och kvalitet samt utseendet på ett stort skal.

Avsluta helskärmsläge

Om du vill avsluta helskärmsläget klickar du på knappen för helskärmsläge eller på Esc-tangenten.

Om du ställer in följande egenskaper och anropar följande metoder kan det leda till layoutförändringar som kan göra att FLVPlayback-komponenten avslutar helskärmsläget: height , registrationHeight , registrationWidth , registrationX , registrationY , scaleX , scaleY , width , x , y , setScale() eller setSize() .

Om du ställer in egenskaperna align eller scaleMode ställer FLVPlayback in dem till center och maintainAspectRatio tills helskärmsläget är avslutat.

Om du ändrar värdet för fullScreenTakeOver från true till false när du använder helskärmsläget orsakar maskinvaruaccelerationsläget att Flash avslutar helskärmsläget.