Capabilities  - AS3

Określa, czy dostęp do kamery lub mikrofonu użytkownika został zabroniony administracyjnie (true), czy nie (false). Ciąg znaków serwera: AVD.

W przypadku treści w środowisku Adobe AIR™ ta właściwość ma zastosowanie wyłącznie do treści w izolowanych obszarach zabezpieczeń innych niż obszar izolowany aplikacji. Treść w obszarze izolowanym aplikacji ma zawsze dostęp do kamery i mikrofonu użytkownika.

Powiązane elementy interfejsu API

Określa bieżącą architekturę procesora głównego (CPU). Właściwość cpuArchitecture może zwracać następujące ciągi znaków: "PowerPC", "x86", "SPARC" i "ARM". Ciąg znaków serwera to ARCH.

Określa, czy system obsługuje (true) komunikację z ułatwieniami dostępu, czy nie obsługuje takiej komunikacji (false). Ciąg znaków serwera: ACC.

Powiązane elementy interfejsu API

Określa, czy system ma możliwości obsługi dźwięku. Właściwość zawsze ma wartość true. Ciąg znaków serwera: A.

Określa, czy system może (true), czy nie może (false) kodować strumieni audio uzyskiwanych na przykład z mikrofonu. Ciąg znaków serwera: AE.

Określa, czy system obsługuje osadzone wideo (true), czy go nie obsługuje (false). Ciąg znaków serwera: EV.

Określa, czy system jest, (true), czy nie jest (false) wyposażony w edytor IME (ang. input method editor). Ciąg znaków serwera: IME.

Powiązane elementy interfejsu API

Określa, czy system jest (true), czy nie jest (false) wyposażony w dekoder MP3. Ciąg znaków serwera: MP3.

Określa, czy system obsługuje drukowanie (true), czy nie (false). Ciąg znaków serwera: PR.

Określa, czy system obsługuje rozbudowę aplikacji graficznych uruchamianych za pośrednictwem oprogramowania Flash Media Server (true), czy nie obsługuje (false). Ciąg znaków serwera: SB.

Określa, czy system obsługuje odtwarzanie przy użyciu aplikacji graficznych uruchamianych za pośrednictwem oprogramowania Flash Media Server (true), czy nie obsługuje (false). Ciąg znaków serwera: SP.

Określa, czy system może odtwarzać strumieniowe dane audio (true), czy nie może (false). Ciąg znaków serwera: SA.

Określa, czy system może odtwarzać strumieniowe dane wideo (true), czy nie może (false). Ciąg znaków serwera: SV.

Określa, czy system obsługuje natywne gniazda SSL za pośrednictwem obiektu NetConnection (true), czy nie (false). Ciąg znaków serwera: TLS.

Powiązane elementy interfejsu API

Określa, czy system może kodować strumienie wideo, uzyskiwane na przykład z kamery internetowej (true), czy nie może (false). Ciąg znaków serwera: VE.

Określa, czy zainstalowano system w wersji próbnej (wartość true), czy w wersji oficjalnie zatwierdzonej (wartość false). Ciąg znaków serwera: DEB. Ta właściwość jest ustawiana na true w przypadku pracy w wersji programu Flash Player przeznaczonej do debugowania lub w środowisku AIR Debug Launcher (ADL).

Określa, czy środowisko wykonawcze Flash jest osadzone w pliku PDF otwartym w programie Acrobat 9.0 lub nowszej wersji (true), czy nie (false).

Określa kod języka systemu, w którym działa treść. Język jest określony w postaci dwuznakowego (małe litery) kodu języka zgodnego z ISO 639-1. W przypadku języka chińskiego dwuznakowy kod (wielkie litery) zgodny z ISO 3166 odróżnia język chiński uproszczony od tradycyjnego. Kody języków są oparte na angielskich nazwach języków, na przykład: hu określa język węgierski (ang. Hungarian).

W systemach anglojęzycznych ta właściwość zwraca tylko kod języka (en), a nie kod kraju. W systemach Microsoft Windows ta właściwość zwraca język interfejsu użytkownika, który jest językiem używanym we wszystkich menu, oknach dialogowych, komunikatach o błędach i plikach pomocy. W poniższej tabeli przedstawiono możliwe wartości:

Uwaga: Właściwość Capabilities.language może przyjmować tylko wartości z tej listy. Z powodu tego ograniczenia aplikacje Adobe AIR powinny określać podstawowy język interfejsu użytkownika na podstawie pierwszego elementu tablicy Capabilities.languages.

Ciąg znaków serwera: L.

Powiązane elementy interfejsu API

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);
        }
    }
}

Tablica ciągów znaków zawierająca informacje o preferowanych językach interfejsu użytkownika określonych w systemie operacyjnym. Ciągi będą zawierały znaczniki języków (oraz informacje o skrypcie i regionie, tam gdzie ma to zastosowanie) zdefiniowane w dokumencie RFC4646 (http://www.ietf.org/rfc/rfc4646.txt), w charakterze znaku rozdzielającego będzie używany minus (na przykład "en-US" lub "ja-JP"). Języki są wymienione w tablicy w kolejności wynikającej z preferencji użytkownika określonych w systemie operacyjnym.

Systemy operacyjne różnią się pod względem informacji zwracanych w ciągach znaków ustawień regionalnych. Jeden system operacyjny może zwrócić wartość "en-us", a inny może zwrócić wartość "en".

Zazwyczaj pierwszy wpis w zwróconej tablicy zawiera ten sam identyfikator języka podstawowego, co właściwość Capabilities.language. Na przykład, jeśli wpis Capabilities.languages[0] ma wartość "en-US", właściwość language będzie miała wartość "en". Jeśli jednak właściwość Capabilities.language będzie równa "xu" (co oznacza nieznany język), pierwszy element w tablicy będzie miał inną wartość. Z tego względu wpis Capabilities.languages[0] może być dokładniejszy niż Capabilities.language.

Ciąg znaków serwera: LS.

Określa, czy dostęp (w trybie odczytu) do twardego dysku użytkownika został zabroniony (true), czy nie (false). W przypadku treści w środowisku Adobe AIR ta właściwość ma zastosowan ie wyłącznie do treści w izolowanych obszarach zabezpieczeń innych niż obszar izolowany aplikacji. (Treść w obszarze izolowanym aplikacji może zawsze odczytywać dane z systemu plików). Jeśli ta właściwość ma wartość true, program Flash Player nie może odczytać plików z dysku twardego użytkownika (łącznie z pierwszym plikiem, z którym uruchamiany jest program Flash Player). Jeśli ta właściwość ma wartość true, treść działająca w środowisku AIR poza obszarem izolowanym aplikacji nie może odczytywać plików z dysku twardego użytkownika. Przykład: próby odczytania pliku z dysku twardego użytkownika za pomocą metod load zakończą się niepowodzeniem, jeśli dla tej właściwości ustawiona jest wartość true.

Jeśli dla tej właściwości ustawiona jest wartość true, zablokowany jest również odczyt wspólnych bibliotek środowiska wykonawczego, ale odczytywanie lokalnych obiektów udostępnionych jest możliwe bez względu na wartość właściwości.

Ciąg znaków serwera: LFD.

Powiązane elementy interfejsu API

Określa producenta uruchomionej wersji odtwarzacza Flash Player lub środowiska AIR w formacie "Adobe OSName". Wartość OSName może być równa "Windows", "Macintosh", "Linux" lub nazwie innego systemu operacyjnego. Ciąg znaków serwera: M.

Nie należy używać właściwości Capabilities.manufacturer do określania możliwości w sposób pośredni na podstawie typu systemu operacyjnego, jeśli istnieje właściwość skojarzona z konkretną możliwością. Określanie możliwości na podstawie typu systemu operacyjnego nie jest wskazane, ponieważ może prowadzić do problemów, jeśli w aplikacji nie zostaną uwzględnione wszystkie możliwe systemy operacyjne. Właściwym sposobem postępowania jest wykorzystanie właściwości odpowiadającej testowanej możliwości. Aby uzyskać więcej informacji na ten temat, należy zapoznać się z opisem klasy Capabilities.

Pobiera najwyższy poziom IDC kodeka H.264, jaki może obsłużyć sprzęt klienta. Uruchomienie plików multimedialnych na tym poziomie jest gwarantowane; jednak pliki multimedialne uruchomione na najwyższym poziomie mogą nie działać w najwyższej jakości. Ta właściwość jest użyteczna dla serwerów, które próbują dopasować swoje działanie do możliwości klienta. Korzystając z tej właściwości, serwer może dobrać poziom kodowania wideo wysyłanego do klienta.

Ciąg serwera to ML.

Określa bieżący system operacyjny. Właściwość os może zwrócić następujące ciągi znaków:

Ciąg znaków serwera: OS.

Nie należy używać właściwości Capabilities.os do określania możliwości w sposób pośredni na podstawie typu systemu operacyjnego, jeśli istnieje właściwość skojarzona z konkretną możliwością. Określanie możliwości na podstawie typu systemu operacyjnego nie jest wskazane, ponieważ może prowadzić do problemów, jeśli w aplikacji nie zostaną uwzględnione wszystkie możliwe systemy operacyjne. Właściwym sposobem postępowania jest wykorzystanie właściwości odpowiadającej testowanej możliwości. Aby uzyskać więcej informacji na ten temat, należy zapoznać się z opisem klasy Capabilities.

Określa proporcje ekranu (w pikselach). Ciąg znaków serwera: AR.

Określa typ środowiska wykonawczego. Ta właściwość może mieć jedną z następujących wartości:

• "ActiveX" dla elementu sterującego Flash Player ActiveX używanego przez przeglądarkę Microsoft Internet Explorer
• "Desktop" dla środowiska wykonawczego Adobe AIR (z wyjątkiem treści SWF załadowanej przez stronę HTML, kiedy to właściwość Capabilities.playerType ma wartość "PlugIn")
• "External" dla zewnętrznego programu Flash Player lub programu działającego w trybie testowym
• "PlugIn" dla wtyczki Flash Player działającej w przeglądarce (i treści SWF załadowanej przez stronę HTML w aplikacji AIR)
• "StandAlone" dla autonomicznego programu Flash Player

Ciąg znaków serwera: PT.

Określa kolor ekranu. Ta właściwość może mieć wartość "color", "gray" (dla skali szarości) lub "bw" (dla czerni i bieli). Ciąg znaków serwera: COL.

Określa rozdzielczość ekranu w jednostkach dpi (dots-per-inch). Ciąg znaków serwera: DP.

Określa maksymalną poziomą rozdzielczość ekranu. Ciąg znaków serwera: R (zwraca szerokość i wysokość ekranu). Ta właściwość nie jest aktualizowana wraz ze zmianami rozdzielczości ekranu użytkownika i wskazuje rozdzielczość wybraną w momencie uruchamiania programu Flash Player lub aplikacji Adobe AIR. Ponadto wartość określa tylko ekran podstawowy.

Określa maksymalną pionową rozdzielczość ekranu. Ciąg znaków serwera: R (zwraca szerokość i wysokość ekranu). Ta właściwość nie jest aktualizowana wraz ze zmianami rozdzielczości ekranu użytkownika i wskazuje rozdzielczość wybraną w momencie uruchamiania programu Flash Player lub aplikacji Adobe AIR. Ponadto wartość określa tylko ekran podstawowy.

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;
}

Zakodowany ciąg znaków z wartościami poszczególnych właściwości Capabilities.

W poniższym przykładzie przedstawiono ciąg znaków (kodowanie URL):

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

Określa, czy system obsługuje uruchamianie procesów 32-bitowych. Ciąg znaków serwera to PR32.

Określa, czy system obsługuje uruchamianie procesów 64-bitowych. Ciąg znaków serwera to PR64.

Określa typ obsługiwanego ekranu dotykowego, o ile taki ekran jest obsługiwany. Wartości zdefiniowano w klasie flash.system.TouchscreenType.

Powiązane elementy interfejsu API

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;
}

Zawiera informacje o wersji i platformie Flash Player lub Adobe^® AIR^®. Format numeru wersji: platform majorVersion,minorVersion,buildNumber,internalBuildNumber. Możliwe wartości właściwości platform: "WIN", "MAC", "LNX" i "AND". Poniżej przedstawiono przykłady informacji o wersji:

	 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
	 

Nie należy używać właściwości Capabilities.version do określania możliwości w sposób pośredni na podstawie typu systemu operacyjnego, jeśli istnieje właściwość skojarzona z konkretną możliwością. Określanie możliwości na podstawie typu systemu operacyjnego nie jest wskazane, ponieważ może prowadzić do problemów, jeśli w aplikacji nie zostaną uwzględnione wszystkie możliwe systemy operacyjne. Właściwym sposobem postępowania jest wykorzystanie właściwości odpowiadającej testowanej możliwości. Aby uzyskać więcej informacji na ten temat, należy zapoznać się z opisem klasy Capabilities.

Ciąg znaków serwera: 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;
}

Określa, czy system obsługuje dźwięk wielokanałowy danego typu. Dopuszczalne typy zawiera klasa flash.media.AudioDecoder.

Obsługa profilów AIR: Funkcja dźwięku wielokanałowego jest obsługiwana tylko na urządzeniach telewizyjnych ze środowiskiem AIR. Na wszystkich innych urządzeniach ta metoda zawsze zwraca wartość false. Więcej informacji o obsłudze elementów interfejsu API w różnych profilach można znaleźć w sekcji Obsługa profilów aplikacji AIR.

Uwaga: Podczas używania jednego z kodeków dźwięku DTS istnieje możliwość, że metoda hasMultiChannelAudio() zwróci wartość true, chociaż dźwięk w formacie DTS nie będzie odtwarzany. Za przykład może posłużyć odtwarzacz Blu-ray z wyjściem S/PDIF podłączony do starego wzmacniacza. Stary wzmacniacz może nie obsługiwać obsługuje formatu DTS, ale wyjście S/PDIF nie oferuje protokołu do powiadamiania o tym odtwarzacza Blu-ray. Jeżeli odtwarzacz Blu-ray będzie wysyłać strumień dźwięku DTS do starego wzmacniacza, użytkownik nic nie usłyszy. Dlatego w przypadku dźwięku DTS najlepiej jest zapewnić interfejs użytkownika, za pomocą którego użytkownik może wskazać, że dźwięk nie jest odtwarzany. Pozwoli to aplikacji zmienić kodek na inny.

Poniższa tabela zawiera ciągi znaków serwera dla poszczególnych typów dźwięku wielokanałowego.

Parametry

Powiązane elementy interfejsu API

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