Capabilities  - AS3

Anger om åtkomst till användarens kamera och mikrofon inte har tillåtits (true) eller har tillåtits (false) av administratören. Serversträngen är AVD.

När det gäller innehåll i Adobe AIR™ används den här egenskapen endast för innehåll i andra säkerhetssandlådor än säkerhetssandlådan application. Innehåll i säkerhetssandlådan application kan alltid komma åt användarens kamera och mikrofon.

Relaterade API-element

Anger den aktuella processorarkitekturen. Egenskapen cpuArchitecture kan returnera följande strängar: "PowerPC", "x86", "SPARC" och "ARM". Serversträngen är ARCH.

Anger huruvida systemet stöder (true) eller inte stöder (false) kommunikation med hjälpmedel. Serversträngen är ACC.

Relaterade API-element

Anger huruvida systemet har ljudfunktioner. Den här egenskapen är alltid true. Serversträngen är A.

Anger huruvida systemet kan (true) eller inte kan (false) koda ett ljudflöde, till exempel ett ljudflöde från en mikrofon. Serversträngen är AE.

Anger huruvida systemet stöder (true) eller inte stöder (false) inbäddad video. Serversträngen är EV.

Anger huruvida systemet har (true) eller inte har (false) en IME (Input Method Editor) installerad. Serversträngen är IME.

Relaterade API-element

Anger huruvida systemet har (true) eller inte har (false) en MP3-avkodare. Serversträngen är MP3.

Anger huruvida systemet stöder (true) eller inte stöder (false) utskrift. Serversträngen är PR.

Anger huruvida systemet stöder (true) eller inte stöder (false) utveckling av skärmsändningsprogram som körs via Flash Media Server. Serversträngen är SB.

Anger huruvida systemet stöder (true) eller inte stöder (false) uppspelning av skärmsändningsprogram som körs via Flash Media Server. Serversträngen är SP.

Anger huruvida systemet kan (true) eller inte kan (false) spela upp direktuppspelningsljud. Serversträngen är SA.

Anger huruvida systemet kan (true) eller inte kan (false) spela upp direktuppspelningsvideo. Serversträngen är SV.

Anger huruvida systemet stöder (true) eller inte stöder (false) interna SSL-socketar via NetConnection. Serversträngen är TLS.

Relaterade API-element

Anger huruvida systemet kan (true) eller inte kan (false) koda ett videoflöde, till exempel ett videoflöde från en webbkamera. Serversträngen är VE.

Anger huruvida systemet är en specialversion för felsökning (true) eller en officiell version (false). Serversträngen är DEB. Den här egenskapen anges till true vid körning i felsökningsversionen av Flash Player eller ADL (AIR Debug Launcher).

Anger om Flash-miljön är inbäddad i en PDF-fil som är öppen i Acrobat 9.0 eller senare (true) eller inte (false).

Anger språkkoden för systemet som innehållet körs på. Språket anges i form av en bokstavskod med två bokstäver enligt ISO 639-1. För kinesiska anger en ytterligare landskod med två bokstäver från ISO 3166 om det är förenklad eller traditionell kinesiska. Språkkoderna baseras på språkets engelska namn. hu anger ungerska (engelska Hungarian).

I engelska system returnerar den här egenskapen bara språkkoden (en), inte landskoden. I Microsoft Windows-system returnerar egenskapen användargränssnittets språk, vilket innebär det språk som används i alla menyer, dialogrutor, felmeddelanden och hjälpfiler. Giltiga värden visas i följande tabell:

Obs! Värdet på Capabilities.language-egenskapen begränsas till de möjliga värdena på denna lista. På grund av denna begränsning ska Adobe AIR-program använda det första elementet i Capabilities.languages-arrayen för att avgöra det primära gränssnittsspråket för systemet.

Serversträngen är L.

Relaterade API-element

package {
    import flash.display.Sprite;
    import flash.text.TextField;
    import flash.text.TextFieldAutoSize;
    import flash.system.Capabilities;

    public class Capabilities_languageExample extends Sprite {

        public function Capabilities_languageExample()  {
            var myTextField:TextField = new TextField();         
            myTextField.x = 10;
            myTextField.y = 10;
            myTextField.background = true;
            myTextField.autoSize = TextFieldAutoSize.LEFT;
            
            var greetingEnglish:String = "Hello World";
            var greetingGerman:String = "Hallo Welt";
            var greetingFrench:String = "Bonjour Monde";
            var greetingSpanish:String = "Hola Mundo";

            var lang:String = Capabilities.language;
                         
            switch (lang) {
                case "en":
                    myTextField.text = greetingEnglish;
                    break;
                case "de":
                    myTextField.text = greetingGerman;
                    break;
                case "fr":
                    myTextField.text = greetingFrench;
                    break;
                case "es":
                    myTextField.text = greetingSpanish;
                    break;
                default:
                    myTextField.text = "Sorry your system's language is not supported at this time.";               
            }
             
            this.addChild(myTextField);
        }
    }
}

En array med strängar som innehåller information om användarens föredragna gränssnittsspråk, som de har ställts in i operativsystemet. Strängarna innehåller språktaggar (samt i förekommande fall skript- och regioninformation) som definieras av RFC4646 (http://www.ietf.org/rfc/rfc4646.txt) och använder bindestreck som avgränsare (till exempel "en-US" eller "ja-JP"). Språken listas i arrayen i den ordning de föredras, vilket anges av operativsysteminställningarna.

Vilken områdesinformation som returneras i språksträngarna skiljer sig mellan olika operativsystem. Ett operativsystem kanske returnerar "se-sv", medan andra kanske returnerar "se".

Den första posten i den returnerade arrayen har i allmänhet samma primära språk-ID som egenskapen Capabilities.language. Om till exempel Capabilities.languages[0] är inställt på "en-US" ställs egenskapen language in på "en". Men om egenskapen Capabilities.language ställs in på "xu" (ett okänt språk) blir det första elementet i denna array annorlunda. Därför kan Capabilities.languages[0] vara mer exakt än Capabilities.language.

Serversträngen är LS.

Anger om läsåtkomst till användarens hårddisk inte har tillåtits (true) eller tillåtits (false) av administratören. När det gäller innehåll i Adobe AIR används den här egenskapen endast för innehåll i andra säkerhetssandlådor än säkerhetssandlådan application. (Innehåll i säkerhetssandlådan application kan alltid läsa från filsystemet.) Om den här egenskapen har värdet true kan Flash Player inte läsa filer (inklusive den första filen som Flash Player startas med) från användarens hårddisk. Om den här egenskapen har värdet true kan AIR-innehåll utanför säkerhetssandlådan application inte läsa filer från användarens hårddisk. Försök att läsa en fil på användarens hårddisk med inläsningsmetoder kommer till exempel att misslyckas om egenskapen är inställd på true.

Det går heller inte att läsa bibliotek som delas vid körning om egenskapen är inställd på true, med det går att läsa lokala delade objekt, oavsett den här egenskapens värde.

Serversträngen är LFD.

Relaterade API-element

Anger tillverkaren av den version av Flash Player eller AIR-körningen som körs, i formatet "Adobe OSName". Värdet för OSName kan vara "Windows", "Macintosh", "Linux" eller namnet på ett annat operativsystem. Serversträngen är M.

Använd inte Capabilities.manufacturer för att fastställa en funktion baserat på operativsystemet om det finns en mer specifik funktionsegenskap. Det är ingen bra idé att grunda en funktion på operativsystemet, eftersom det kan skapa problem om ett program inte beaktar alla möjliga måloperativsystem. Använd i stället den egenskap som motsvarar den funktion du testar. Mer information finns i beskrivningen av klassen Capabilities.

Hämtar högsta H.264 Level IDC som klientmaskinvaran stöder. Media som körs på den här nivån körs garanterat. Det kan dock vara så att media som körs på den högsta nivån kanske inte körs med den högsta kvaliteten. Den här egenskapen är användbar för servrar som försöker anpassa sig till klientens förmågor. Med den här användaren kan det avgöras vilken videonivå som servern ska skicka till klienten.

Serversträngen är ML.

Anger det nuvarande operativsystemet. Egenskapen os kan returnera följande strängar:

Serversträngen är OS.

Använd inte Capabilities.os för att fastställa en funktion baserat på operativsystemet om det finns en mer specifik funktionsegenskap. Det är ingen bra idé att grunda en funktion på operativsystemet, eftersom det kan skapa problem om ett program inte beaktar alla möjliga måloperativsystem. Använd i stället den egenskap som motsvarar den funktion du testar. Mer information finns i beskrivningen av klassen Capabilities.

Anger skärmens bildformat i pixlar. Serversträngen är AR.

Anger typen av körningsmiljö. Egenskapen kan ha något av följande värden:

• "ActiveX" för Flash Player ActiveX-kontrollen som används av Microsoft Internet Explorer
• "Desktop" för Adobe AIR-körningen (förutom för SWF-innehåll som har lästs in av en HTML-sida, för vilket Capabilities.playerType anges till "PlugIn")
• "External" för en extern Flash Player eller i testläge
• "PlugIn" för Flash Player-webbläsarpluginen (och för SWF-innehåll som har lästs in av en HTML-sida i ett AIR-program)
• "StandAlone" för en fristående Flash Player

Serversträngen är PT.

Anger skärmfärgen. Egenskapen kan ha värdet "color", "gray" (för gråskala) eller "bw" (för svartvitt). Serversträngen är COL.

Anger skärmens upplösning (dpi) i pixlar. Serversträngen är DP.

Anger skärmens maximala vågräta upplösning. Serversträngen är R (vilket returnerar både skärmens bredd och höjd). Den här egenskapen uppdateras inte med användarens skärmupplösning, utan anger endast upplösningen vid det tillfälle då Flash Player eller ett Adobe AIR-program startades. Värdet anger dessutom endast den primära bildskärmen.

Anger skärmens maximala lodräta upplösning. Serversträngen är R (vilket returnerar både skärmens bredd och höjd). Den här egenskapen uppdateras inte med användarens skärmupplösning, utan anger endast upplösningen vid det tillfälle då Flash Player eller ett Adobe AIR-program startades. Värdet anger dessutom endast den primära bildskärmen.

import flash.events.*;
import flash.display.*;
import flash.system.Capabilities;
import flash.text.TextField;

var screenInfoTxt:TextField = new TextField();
screenInfoTxt.x = 30;
screenInfoTxt.y = 50;
screenInfoTxt.width = 300;
screenInfoTxt.height = 100;
screenInfoTxt.border = true;

addChild(screenInfoTxt);

addEventListener(MouseEvent.CLICK, getScreenNVersion);

function getScreenNVersion(e:MouseEvent):void{
    screenInfoTxt.text= "flash.system.Capabilities.screenResolutionX is : " + String(flash.system.Capabilities.screenResolutionX) + "\n" +
    "flash.system.Capabilities.screenResolutionY is : " + String(flash.system.Capabilities.screenResolutionY) + "\n" +
    "flash.system.Capabilities.version is : " + flash.system.Capabilities.version;
}

En URL-kodad sträng som anger värden för varje Capabilities-egenskap.

I följande exempel visas en URL-kodad sträng:

A=t&SA=t&SV=t&EV=t&MP3=t&AE=t&VE=t&ACC=f&PR=t&SP=t&
	 SB=f&DEB=t&V=WIN%208%2C5%2C0%2C208&M=Adobe%20Windows&
	 R=1600x1200&DP=72&COL=color&AR=1.0&OS=Windows%20XP&
	 L=en&PT=External&AVD=f&LFD=f&WD=f

Anger om systemet har stöd för att köra 32-bitars processer. Serversträngen är PR32.

Anger om systemet har stöd för att köra 64-bitars processer. Serversträngen är PR64.

Anger den typ av pekskärm som stöds, om en sådan stöds. Värdena definieras i klassen flash.system.TouchscreenType.

Relaterade API-element

import flash.events.*;
import flash.display.*;
import flash.system.Capabilities;
import flash.text.TextField;

var capabilitiesTouchScreenTypeTxt:TextField = new TextField();
capabilitiesTouchScreenTypeTxt.width = 300;
capabilitiesTouchScreenTypeTxt.border = true;

addChild(capabilitiesTouchScreenTypeTxt);

addEventListener(MouseEvent.CLICK, getScreenKeyboardType);

function getScreenKeyboardType(e:MouseEvent):void{
    capabilitiesTouchScreenTypeTxt.text= "flash.system.Capabilities.touchscreenType is : " + flash.system.Capabilities.touchscreenType;
}

Anger plattforms- och versionsinformation för Flash Player eller Adobe^® AIR^®. Versionsnumrets format är: plattform större version, mindre version, build-nummer, internt build-nummer. Giltiga värden för platform är "WIN", "MAC", "LNX" och "AND". Här är några exempel på versionsinformation:

	 WIN 9,0,0,0  // Flash Player 9 for Windows
	 MAC 7,0,25,0   // Flash Player 7 for Macintosh
	 LNX 9,0,115,0  // Flash Player 9 for Linux
	 AND 10,2,150,0 // Flash Player 10 for Android
	 

Använd inte Capabilities.version för att fastställa en funktion baserat på operativsystemet om det finns en mer specifik funktionsegenskap. Det är ingen bra idé att grunda en funktion på operativsystemet, eftersom det kan skapa problem om ett program inte beaktar alla möjliga måloperativsystem. Använd i stället den egenskap som motsvarar den funktion du testar. Mer information finns i beskrivningen av klassen Capabilities.

Serversträngen är V.

import flash.events.*;
import flash.display.*;
import flash.system.Capabilities;
import flash.text.TextField;

var screenInfoTxt:TextField = new TextField();
screenInfoTxt.x = 30;
screenInfoTxt.y = 50;
screenInfoTxt.width = 300;
screenInfoTxt.height = 100;
screenInfoTxt.border = true;

addChild(screenInfoTxt);

addEventListener(MouseEvent.CLICK, getScreenNVersion);

function getScreenNVersion(e:MouseEvent):void{
    screenInfoTxt.text= "flash.system.Capabilities.screenResolutionX is : " + String(flash.system.Capabilities.screenResolutionX) + "\n" +
    "flash.system.Capabilities.screenResolutionY is : " + String(flash.system.Capabilities.screenResolutionY) + "\n" +
    "flash.system.Capabilities.version is : " + flash.system.Capabilities.version;
}

Anger om systemet har stöd för flerkanalsljud av en speciell typ. Klassen flash.media.AudioDecoder räknar upp tänkbara typer.

Stöd för AIR-profiler: Flerkanalsljud stöds bara på enheter med AIR for TV. På alla andra enheter returnerar den här metoden alltid false. På sidan om stöd för AIR-profiler hittar du mer information om API-stöd för flera profiler.

Obs! När en av DTS-ljudkodekarna används finns scenarier där hasMultiChannelAudio() returnerar true trots att DTS-ljudet inte spelas upp. Tänk dig till exempel att du har en Blu-ray-spelare, med en S/PDIF-utgång, ansluten till en gammal förstärkare. Den gamla förstärkaren saknar DTS-stöd, men för S/PDIF finns inget protokoll för att meddela Blu-ray-spelaren. Om Blu-ray-spelaren skickar DTS-strömmen till den gamla förstärkaren kommer användaren inte att höra något. Det är därför bäst när DTS användas att tillhandhålla ett gränssnitt så att användaren kan upptäcka om inget ljud spelas upp. Därefter kan programmet återställas till en annan kodek.

I följande tabell visas serversträngen för varje flerkanalsljudtyp:

Parametrar

Relaterade API-element

    trace(Capabilities.hasMultiChannelAudio(flash.media.AudioDecoder.DOLBY_DIGITAL);