| Pakiet | flash.system |
| Klasa | public final class Capabilities |
| Dziedziczenie | Capabilities  Object |
| Wersja języka: | ActionScript 3.0 |
| Wersje środowiska wykonawczego: | Flash Player 9, AIR 1.0, Flash Lite 4 |
Jednak niektóre możliwości środowiska Adobe AIR nie są wymienione jako właściwości w klasie Capabilities. Są one skojarzone z właściwościami innych klas:
| Właściwość | Opis |
|---|---|
NativeApplication.supportsDockIcon
| Określa, czy system operacyjny obsługuje ikony aplikacji w Docku. |
NativeApplication.supportsMenu
| Określa, czy system operacyjny obsługuje globalny pasek menu aplikacji. |
NativeApplication.supportsSystemTrayIcon
| Określa, czy system operacyjny obsługuje ikony aplikacji w zasobniku systemowym. |
NativeWindow.supportsMenu
| Określa, czy system operacyjny obsługuje menu okien. |
NativeWindow.supportsTransparency
| Określa, czy system operacyjny obsługuje przezroczyste okna. |
Nie należy używać właściwości Capabilities.os ani Capabilities.manufacturer do określania możliwości pośrednio na podstawie typu systemu operacyjnego. 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.
Informacje dotyczące możliwości zapisane we właściwości Capabilities.serverString można wysłać jako ciąg znaków (kodowanie URL) przy pomocy metody GET lub POST HTTP. Poniższy przykład przedstawia ciąg znaków serwera dla komputera, który obsługuje format MP3 i rozdzielczość 1600 x 1200 pikseli w systemie Windows XP, na którym jest zainstalowany edytor IME i nie jest obsługiwany dźwięk wielokanałowy.
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%209%2C0%2C0%2C0&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&IME=t&DD=f&
DDP=f&DTS=f&DTE=f&DTH=f&DTM=f
W poniższej tabeli wymieniono właściwości klasy Capabilities i odpowiadające im ciągi znaków serwera. Podano również ciągi znaków serwera dla poszczególnych typów dźwięku wielokanałowego.
| Właściwość klasy Capabilities | Ciąg znaków serwera |
|---|---|
avHardwareDisable
|
AVD
|
hasAccessibility
|
ACC
|
hasAudio
|
A
|
hasAudioEncoder
|
AE
|
hasEmbeddedVideo
|
EV
|
hasIME
|
IME
|
hasMP3
|
MP3
|
hasPrinting
|
PR
|
hasScreenBroadcast
|
SB
|
hasScreenPlayback
|
SP
|
hasStreamingAudio
|
SA
|
hasStreamingVideo
|
SV
|
hasTLS
|
TLS
|
hasVideoEncoder
|
VE
|
isDebugger
|
DEB
|
language
|
L
|
localFileReadDisable
|
LFD
|
manufacturer
|
M
|
maxLevelIDC
|
ML
|
os
|
OS
|
pixelAspectRatio
|
AR
|
playerType
|
PT
|
screenColor
|
COL
|
screenDPI
|
DP
|
screenResolutionX
|
R
|
screenResolutionY
|
R
|
version
|
V
|
Obsluga dzwieku Dolby Digital
|
DD
|
Obsluga dzwieku Dolby Digital Plus
|
DDP
|
Obsluga dzwieku DTS
|
DTS
|
Obsluga dzwieku DTS Express
|
DTE
|
Obsluga dzwieku DTS-HD High Resolution
|
DTH
|
Obsluga dzwieku DTS-HD Master Audio
|
DTM
|
Istnieje również ciąg znaków serwera WD, który określa, czy tryb pracy bez okien jest wyłączony. Tryb pracy bez okien może być wyłączony w programie Flash Player z powodu niezgodności z przeglądarką sieci Web lub z powodu określenia przez użytkownika odpowiedniego ustawienia w pliku mms.cfg. Nie istnieje odpowiednia właściwość Capabilities.
Wszystkie właściwości klasy Capabilities są tylko do odczytu.
Ukryj dziedziczone właściwości publiczne
Pokaż dziedziczone właściwości publiczne| Właściwość | Zdefiniowane przez | ||
|---|---|---|---|
| avHardwareDisable : Boolean [statyczny] [tylko do odczytu]
Określa, czy dostęp do kamery lub mikrofonu użytkownika został zabroniony administracyjnie (true), czy nie (false). | Capabilities | ||
 | constructor : Object
Odwołanie do obiektu klasy lub funkcji konstruktora, dotyczące danej instancji obiektu. | Object | |
| cpuArchitecture : String [statyczny] [tylko do odczytu]
Określa bieżącą architekturę procesora głównego (CPU). | Capabilities | ||
| hasAccessibility : Boolean [statyczny] [tylko do odczytu]
Określa, czy system obsługuje (true) komunikację z ułatwieniami dostępu, czy nie obsługuje takiej komunikacji (false). | Capabilities | ||
| hasAudio : Boolean [statyczny] [tylko do odczytu]
Określa, czy system ma możliwości obsługi dźwięku. | Capabilities | ||
| hasAudioEncoder : Boolean [statyczny] [tylko do odczytu]
Określa, czy system może kodować strumienie audio, uzyskiwane na przykład z mikrofonu (true), czy nie może (false). | Capabilities | ||
| hasEmbeddedVideo : Boolean [statyczny] [tylko do odczytu]
Określa, czy system obsługuje osadzone wideo (true), czy go nie obsługuje (false). | Capabilities | ||
| hasIME : Boolean [statyczny] [tylko do odczytu]
Określa, czy system jest IME (true), czy nie jest (false) wyposażony w edytor IME (ang. input method editor). | Capabilities | ||
| hasMP3 : Boolean [statyczny] [tylko do odczytu]
Określa, czy system jest (true), czy nie jest (false) wyposażony w dekoder MP3. | Capabilities | ||
| hasPrinting : Boolean [statyczny] [tylko do odczytu]
Określa, czy system obsługuje drukowanie (true), czy nie (false). | Capabilities | ||
| hasScreenBroadcast : Boolean [statyczny] [tylko do odczytu]
Określa, czy system obsługuje rozbudowę aplikacji graficznych uruchamianych za pośrednictwem oprogramowania Flash Media Server (true), czy nie obsługuje (false). | Capabilities | ||
| hasScreenPlayback : Boolean [statyczny] [tylko do odczytu]
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). | Capabilities | ||
| hasStreamingAudio : Boolean [statyczny] [tylko do odczytu]
Określa, czy system może odtwarzać strumieniowe dane audio (true), czy nie może (false). | Capabilities | ||
| hasStreamingVideo : Boolean [statyczny] [tylko do odczytu]
Określa, czy system może odtwarzać strumieniowe dane wideo (true), czy nie może (false). | Capabilities | ||
| hasTLS : Boolean [statyczny] [tylko do odczytu]
Określa, czy system obsługuje natywne gniazda SSL za pośrednictwem obiektu NetConnection (true), czy nie (false). | Capabilities | ||
| hasVideoEncoder : Boolean [statyczny] [tylko do odczytu]
Określa, czy system może kodować strumienie wideo, uzyskiwane na przykład z kamery internetowej (prawda), czy nie może (fałsz). | Capabilities | ||
| isDebugger : Boolean [statyczny] [tylko do odczytu]
Określa, czy zainstalowano system w wersji próbnej (wartość true), czy w wersji oficjalnie zatwierdzonej (wartość false). | Capabilities | ||
| isEmbeddedInAcrobat : Boolean [statyczny] [tylko do odczytu]
Określa, czy środowisko wykonawcze Flash jest osadzone w pliku PDF otwartym w programie Acrobat 9.0 lub nowszej wersji (true), czy nie (false). | Capabilities | ||
| language : String [statyczny] [tylko do odczytu]
Określa kod języka systemu, w którym działa treść. | Capabilities | ||
| languages : Array [statyczny] [tylko do odczytu]
Tablica ciągów znaków zawierająca informacje o preferowanych językach interfejsu użytkownika określonych w systemie operacyjnym. | Capabilities | ||
| localFileReadDisable : Boolean [statyczny] [tylko do odczytu]
Określa, czy dostęp (w trybie odczytu) do twardego dysku użytkownika został zabroniony (true), czy nie (false). | Capabilities | ||
| manufacturer : String [statyczny] [tylko do odczytu]
Określa producenta uruchomionej wersji odtwarzacza Flash Player lub środowiska wykonawczego AIR w formacie "Adobe OSName". | Capabilities | ||
| maxLevelIDC : String [statyczny] [tylko do odczytu]
Pobiera najwyższy poziom IDC kodeka H.264, jaki może obsłużyć sprzęt klienta. | Capabilities | ||
| os : String [statyczny] [tylko do odczytu]
Określa bieżący system operacyjny. | Capabilities | ||
| pixelAspectRatio : Number [statyczny] [tylko do odczytu]
Określa proporcje ekranu (w pikselach). | Capabilities | ||
| playerType : String [statyczny] [tylko do odczytu]
Określa typ środowiska wykonawczego. | Capabilities | ||
| screenColor : String [statyczny] [tylko do odczytu]
Określa kolor ekranu. | Capabilities | ||
| screenDPI : Number [statyczny] [tylko do odczytu]
Określa rozdzielczość ekranu w jednostkach dpi (dots-per-inch). | Capabilities | ||
| screenResolutionX : Number [statyczny] [tylko do odczytu]
Określa maksymalną poziomą rozdzielczość ekranu. | Capabilities | ||
| screenResolutionY : Number [statyczny] [tylko do odczytu]
Określa maksymalną pionową rozdzielczość ekranu. | Capabilities | ||
| serverString : String [statyczny] [tylko do odczytu]
Zakodowany ciąg z wartościami poszczególnych właściwości Capabilities. | Capabilities | ||
| supports32BitProcesses : Boolean [statyczny] [tylko do odczytu]
Określa, czy system obsługuje uruchamianie procesów 32-bitowych. | Capabilities | ||
| supports64BitProcesses : Boolean [statyczny] [tylko do odczytu]
Określa, czy system obsługuje uruchamianie procesów 64-bitowych. | Capabilities | ||
| touchscreenType : String [statyczny] [tylko do odczytu]
Określa typ obsługiwanego ekranu dotykowego, o ile taki ekran jest obsługiwany. | Capabilities | ||
| version : String [statyczny] [tylko do odczytu]
Zawiera informacje o wersji i platformie Flash Player lub Adobe® AIR®. | Capabilities | ||
| Metoda | Zdefiniowane przez | ||
|---|---|---|---|
[statyczny]
Określa, czy system obsługuje dźwięk wielokanałowy danego typu. | Capabilities | ||
|
Wskazuje, czy dla obiektu zdefiniowano określoną właściwość. | Object | |
|
Wskazuje, czy instancja klasy Object należy do łańcucha prototypów obiektu określonego jako parametr. | Object | |
|
Wskazuje, czy określona właściwość istnieje i jest przeliczalna. | Object | |
|
Ustawia dostępność właściwości dynamicznej używanej w pętlach. | Object | |
|
Zwraca ciąg reprezentujący obiekt — sformatowany zgodnie z konwencjami właściwymi dla ustawień regionalnych. | Object | |
|
Zwraca ciąg reprezentujący określony obiekt. | Object | |
|
Zwraca pierwotną wartość dla określonego obiektu. | Object | |
avHardwareDisable | właściwość |
avHardwareDisable:Boolean [tylko do odczytu] | Wersja języka: | ActionScript 3.0 |
| Wersje środowiska wykonawczego: | Flash Player 9, AIR 1.0, Flash Lite 4 |
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.
Implementacja
public static function get avHardwareDisable():BooleanPowiązane elementy interfejsu API
cpuArchitecture | właściwość |
cpuArchitecture:String [tylko do odczytu] | Wersja języka: | ActionScript 3.0 |
| Wersje środowiska wykonawczego: | Flash Player 10.0.32, AIR 1.5.1 |
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.
Implementacja
public static function get cpuArchitecture():StringhasAccessibility | właściwość |
hasAccessibility:Boolean [tylko do odczytu] | Wersja języka: | ActionScript 3.0 |
| Wersje środowiska wykonawczego: | Flash Player 9, AIR 1.0, Flash Lite 4 |
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.
Implementacja
public static function get hasAccessibility():BooleanPowiązane elementy interfejsu API
hasAudio | właściwość |
hasAudio:Boolean [tylko do odczytu] | Wersja języka: | ActionScript 3.0 |
| Wersje środowiska wykonawczego: | Flash Player 9, AIR 1.0, Flash Lite 4 |
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.
Implementacja
public static function get hasAudio():BooleanhasAudioEncoder | właściwość |
hasAudioEncoder:Boolean [tylko do odczytu] | Wersja języka: | ActionScript 3.0 |
| Wersje środowiska wykonawczego: | Flash Player 9, AIR 1.0, Flash Lite 4 |
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.
Implementacja
public static function get hasAudioEncoder():BooleanhasEmbeddedVideo | właściwość |
hasEmbeddedVideo:Boolean [tylko do odczytu] | Wersja języka: | ActionScript 3.0 |
| Wersje środowiska wykonawczego: | Flash Player 9, AIR 1.0, Flash Lite 4 |
Określa, czy system obsługuje osadzone wideo (true), czy go nie obsługuje (false). Ciąg znaków serwera: EV.
Implementacja
public static function get hasEmbeddedVideo():BooleanhasIME | właściwość |
hasIME:Boolean [tylko do odczytu] | Wersja języka: | ActionScript 3.0 |
| Wersje środowiska wykonawczego: | Flash Player 9, AIR 1.0, Flash Lite 4 |
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.
Implementacja
public static function get hasIME():BooleanPowiązane elementy interfejsu API
hasMP3 | właściwość |
hasPrinting | właściwość |
hasScreenBroadcast | właściwość |
hasScreenBroadcast:Boolean [tylko do odczytu] | Wersja języka: | ActionScript 3.0 |
| Wersje środowiska wykonawczego: | Flash Player 9, AIR 1.0, Flash Lite 4 |
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.
Implementacja
public static function get hasScreenBroadcast():BooleanhasScreenPlayback | właściwość |
hasScreenPlayback:Boolean [tylko do odczytu] | Wersja języka: | ActionScript 3.0 |
| Wersje środowiska wykonawczego: | Flash Player 9, AIR 1.0, Flash Lite 4 |
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.
Implementacja
public static function get hasScreenPlayback():BooleanhasStreamingAudio | właściwość |
hasStreamingAudio:Boolean [tylko do odczytu] | Wersja języka: | ActionScript 3.0 |
| Wersje środowiska wykonawczego: | Flash Player 9, AIR 1.0, Flash Lite 4 |
Określa, czy system może odtwarzać strumieniowe dane audio (true), czy nie może (false). Ciąg znaków serwera: SA.
Implementacja
public static function get hasStreamingAudio():BooleanhasStreamingVideo | właściwość |
hasStreamingVideo:Boolean [tylko do odczytu] | Wersja języka: | ActionScript 3.0 |
| Wersje środowiska wykonawczego: | Flash Player 9, AIR 1.0, Flash Lite 4 |
Określa, czy system może odtwarzać strumieniowe dane wideo (true), czy nie może (false). Ciąg znaków serwera: SV.
Implementacja
public static function get hasStreamingVideo():BooleanhasTLS | właściwość |
hasTLS:Boolean [tylko do odczytu] | Wersja języka: | ActionScript 3.0 |
| Wersje środowiska wykonawczego: | Flash Player 9, AIR 1.0, Flash Lite 4 |
Określa, czy system obsługuje natywne gniazda SSL za pośrednictwem obiektu NetConnection (true), czy nie (false). Ciąg znaków serwera: TLS.
Implementacja
public static function get hasTLS():BooleanPowiązane elementy interfejsu API
hasVideoEncoder | właściwość |
hasVideoEncoder:Boolean [tylko do odczytu] | Wersja języka: | ActionScript 3.0 |
| Wersje środowiska wykonawczego: | Flash Player 9, AIR 1.0, Flash Lite 4 |
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.
Implementacja
public static function get hasVideoEncoder():BooleanisDebugger | właściwość |
isDebugger:Boolean [tylko do odczytu] | Wersja języka: | ActionScript 3.0 |
| Wersje środowiska wykonawczego: | Flash Player 9, AIR 1.0, Flash Lite 4 |
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).
Implementacja
public static function get isDebugger():BooleanisEmbeddedInAcrobat | właściwość |
isEmbeddedInAcrobat:Boolean [tylko do odczytu] | Wersja języka: | ActionScript 3.0 |
| Wersje środowiska wykonawczego: | Flash Player 9.0.127.0, AIR 1.1, Flash Lite 4 |
Określa, czy środowisko wykonawcze Flash jest osadzone w pliku PDF otwartym w programie Acrobat 9.0 lub nowszej wersji (true), czy nie (false).
Implementacja
public static function get isEmbeddedInAcrobat():Booleanlanguage | właściwość |
language:String [tylko do odczytu] | Wersja języka: | ActionScript 3.0 |
| Wersje środowiska wykonawczego: | Flash Player 9, AIR 1.0, Flash Lite 4 |
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:
| Język | Wartość |
|---|---|
| Czeski | cs |
| Duński | da |
| Holenderski | nl |
| Angielski | en |
| Fiński | fi |
| Francuski | fr |
| Niemiecki | de |
| Węgierski | hu |
| Włoski | it |
| Japoński | ja |
| Koreański | ko |
| Norweski | nb |
| Inne/nieznane | xu |
| Polski | pl |
| Portugalski | pt |
| Rosyjski | ru |
| Chiński uproszczony | zh-CN |
| Hiszpański | es |
| Szwedzki | sv |
| Chiński tradycyjny | zh-TW |
| Turecki | tr |
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.
Implementacja
public static function get language():StringPowiązane elementy interfejsu API
Przykład ( Sposób korzystania z tego przykładu )
Właściwość Capabilities.language zwraca kod języka ISO 639-1 (na przykład „en” dla języka angielskiego). Instrukcja switch sprawdza kod języka i ustawia w polu tekstowym myTextField powitanie właściwe dla danego języka. Jeśli określony kod języka nie jest obsługiwany, zwracany jest domyślny ciąg znaków błędu.
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);
}
}
}
languages | właściwość |
languages:Array [tylko do odczytu] | Wersja języka: | ActionScript 3.0 |
| Wersje środowiska wykonawczego: | AIR 1.1 |
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.
Implementacja
public static function get languages():ArraylocalFileReadDisable | właściwość |
localFileReadDisable:Boolean [tylko do odczytu] | Wersja języka: | ActionScript 3.0 |
| Wersje środowiska wykonawczego: | Flash Player 9, AIR 1.0, Flash Lite 4 |
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.
Implementacja
public static function get localFileReadDisable():BooleanPowiązane elementy interfejsu API
manufacturer | właściwość |
manufacturer:String [tylko do odczytu] | Wersja języka: | ActionScript 3.0 |
| Wersje środowiska wykonawczego: | Flash Player 9, AIR 1.0, Flash Lite 4 |
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.
Implementacja
public static function get manufacturer():StringmaxLevelIDC | właściwość |
maxLevelIDC:String [tylko do odczytu] | Wersja języka: | ActionScript 3.0 |
| Wersje środowiska wykonawczego: | Flash Player 10, AIR 1.5, Flash Lite 4 |
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.
Implementacja
public static function get maxLevelIDC():Stringos | właściwość |
os:String [tylko do odczytu] | Wersja języka: | ActionScript 3.0 |
| Wersje środowiska wykonawczego: | Flash Player 9, AIR 1.0, Flash Lite 4 |
Określa bieżący system operacyjny. Właściwość os może zwrócić następujące ciągi znaków:
| System operacyjny | Wartość |
|---|---|
| Windows 10 | "Windows 10" |
| Windows 8 | "Windows 8" |
| Windows 7 | "Windows 7" |
| Windows Vista | "Windows Vista" |
| Windows Server 2012 | "Windows Server 2012" |
| Windows Server 2008 R2 | "Windows Server 2008 R2" |
| Windows Server 2008 | "Windows Server 2008" |
| Windows Home Server | "Windows Home Server" |
| Windows Server 2003 R2 | "Windows Server 2003 R2" |
| Windows Server 2003 | "Windows Server 2003" |
| Windows XP 64 | "Windows Server XP 64" |
| Windows XP | "Windows XP" |
| Windows 98 | "Windows 98" |
| Windows 95 | "Windows 95" |
| Windows NT | "Windows NT" |
| Windows 2000 | "Windows 2000" |
| Windows ME | "Windows ME" |
| Windows CE | "Windows CE" |
| Windows SmartPhone | "Windows SmartPhone" |
| Windows PocketPC | "Windows PocketPC" |
| Windows CEPC | "Windows CEPC" |
| Windows Mobile | "Windows Mobile" |
| Mac OS | "Mac OS X.Y.Z" (gdzie X.Y.Z to numer wersji, np. "Mac OS 10.5.2") |
| Linux | Linux (Program Flash Player dołącza wersję systemu Linux, tworząc na przykład wartośćLinux 2.6.15-1.2054_FC5smp). |
| iOS 4.1 | "iPhone3,1" |
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.
Implementacja
public static function get os():StringpixelAspectRatio | właściwość |
playerType | właściwość |
playerType:String [tylko do odczytu] | Wersja języka: | ActionScript 3.0 |
| Wersje środowiska wykonawczego: | Flash Player 9, AIR 1.0, Flash Lite 4 |
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.playerTypema 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.
Implementacja
public static function get playerType():StringscreenColor | właściwość |
screenColor:String [tylko do odczytu] | Wersja języka: | ActionScript 3.0 |
| Wersje środowiska wykonawczego: | Flash Player 9, AIR 1.0, Flash Lite 4 |
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.
Implementacja
public static function get screenColor():StringscreenDPI | właściwość |
screenResolutionX | właściwość |
screenResolutionX:Number [tylko do odczytu] | Wersja języka: | ActionScript 3.0 |
| Wersje środowiska wykonawczego: | Flash Player 9, AIR 1.0, Flash Lite 4 |
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.
Implementacja
public static function get screenResolutionX():NumberscreenResolutionY | właściwość |
screenResolutionY:Number [tylko do odczytu] | Wersja języka: | ActionScript 3.0 |
| Wersje środowiska wykonawczego: | Flash Player 9, AIR 1.0, Flash Lite 4 |
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.
Implementacja
public static function get screenResolutionY():NumberPrzykład ( Sposób korzystania z tego przykładu )
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;
}
serverString | właściwość |
serverString:String [tylko do odczytu] | Wersja języka: | ActionScript 3.0 |
| Wersje środowiska wykonawczego: | Flash Player 9, AIR 1.0, Flash Lite 4 |
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
Implementacja
public static function get serverString():Stringsupports32BitProcesses | właściwość |
supports32BitProcesses:Boolean [tylko do odczytu] | Wersja języka: | ActionScript 3.0 |
| Wersje środowiska wykonawczego: | Flash Player 10.0.32, AIR 1.5.2 |
Określa, czy system obsługuje uruchamianie procesów 32-bitowych. Ciąg znaków serwera to PR32.
Implementacja
public static function get supports32BitProcesses():Booleansupports64BitProcesses | właściwość |
supports64BitProcesses:Boolean [tylko do odczytu] | Wersja języka: | ActionScript 3.0 |
| Wersje środowiska wykonawczego: | Flash Player 10.0.32, AIR 1.5.2 |
Określa, czy system obsługuje uruchamianie procesów 64-bitowych. Ciąg znaków serwera to PR64.
Implementacja
public static function get supports64BitProcesses():BooleantouchscreenType | właściwość |
touchscreenType:String [tylko do odczytu] | Wersja języka: | ActionScript 3.0 |
| Wersje środowiska wykonawczego: | Flash Player 10.1, AIR 2 |
Określa typ obsługiwanego ekranu dotykowego, o ile taki ekran jest obsługiwany. Wartości zdefiniowano w klasie flash.system.TouchscreenType.
Implementacja
public static function get touchscreenType():StringPowiązane elementy interfejsu API
Przykład ( Sposób korzystania z tego przykładu )
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;
}
version | właściwość |
version:String [tylko do odczytu] | Wersja języka: | ActionScript 3.0 |
| Wersje środowiska wykonawczego: | Flash Player 9, AIR 1.0, Flash Lite 4 |
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.
Implementacja
public static function get version():StringPrzykład ( Sposób korzystania z tego przykładu )
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;
}
hasMultiChannelAudio | () | metoda |
public static function hasMultiChannelAudio(type:String):Boolean| Wersja języka: | ActionScript 3.0 |
| Wersje środowiska wykonawczego: | Flash Player 11, AIR 3 |
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.
| Typ dźwięku wielokanałowego | Ciąg znaków serwera |
|---|---|
AudioDecoder.DOLBY_DIGITAL | DD |
AudioDecoder.DOLBY_DIGITAL_PLUS | DDP |
AudioDecoder.DTS | DTS |
AudioDecoder.DTS_EXPRESS | DTE |
AudioDecoder.DTS_HD_HIGH_RESOLUTION_AUDIO | DTH |
AudioDecoder.DTS_HD_MASTER_AUDIO | DTM |
Parametry
type:String — Ciąg znaków reprezentujący typ dźwięku wielokanałowego. Prawidłowymi wartościami są stałe zdefiniowane w klasie flash.media.AudioDecoder.
|
Boolean — Wartość typu Boolean true, jeśli system obsługuje typ dźwięku wielokanałowego przekazany w parametrze type. W przeciwnym razie jest zwracana wartość false.
|
Powiązane elementy interfejsu API
Przykład ( Sposób korzystania z tego przykładu )
hasMultiChannelAudio(). Zwracana wartość wskazuje, czy system obsługuje dźwięk wielokanałowy Dolby Digital.
trace(Capabilities.hasMultiChannelAudio(flash.media.AudioDecoder.DOLBY_DIGITAL);
trace().
package {
import flash.display.Sprite;
import flash.system.Capabilities;
import flash.text.TextField;
import flash.text.TextFieldAutoSize;
public class CapabilitiesExample extends Sprite {
public function CapabilitiesExample() {
showCapabilities();
}
private function showCapabilities():void {
var tf:TextField = new TextField();
tf.height = 600;
tf.width = 400;
tf.autoSize = TextFieldAutoSize.LEFT;
tf.wordWrap = true;
tf.text = "avHardwareDisable: " + Capabilities.avHardwareDisable +
"\nhasAccessibility: " + Capabilities.hasAccessibility +
"\nhasAudio: " + Capabilities.hasAudio +
"\nhasAudioEncoder: " + Capabilities.hasAudioEncoder +
"\nhasEmbeddedVideo: " + Capabilities.hasEmbeddedVideo +
"\nhasIME: " + Capabilities.hasIME +
"\nhasMP3: " + Capabilities.hasMP3 +
"\nhasPrinting: " + Capabilities.hasPrinting +
"\nhasScreenBroadcast: " + Capabilities.hasScreenBroadcast +
"\nhasScreenPlayback: " + Capabilities.hasScreenPlayback +
"\nhasStreamingAudio: " + Capabilities.hasStreamingAudio +
"\nhasStreamingVideo: " + Capabilities.hasStreamingVideo +
"\nhasTLS: " + Capabilities.hasTLS +
"\nhasVideoEncoder: " + Capabilities.hasVideoEncoder +
"\nisDebugger: " + Capabilities.isDebugger +
"\nisEmbeddedInAcrobat: " + Capabilities.isEmbeddedInAcrobat +
"\nlanguage: " + Capabilities.language +
"\nlocalFileReadDisable: " + Capabilities.localFileReadDisable +
"\nmanufacturer: " + Capabilities.manufacturer +
"\nmaxLevelIDC: " + Capabilities.maxLevelIDC +
"\nos: " + Capabilities.os +
"\npixelAspectRatio: " + Capabilities.pixelAspectRatio +
"\nplayerType: " + Capabilities.playerType +
"\nscreenColor: " + Capabilities.screenColor +
"\nscreenDPI: " + Capabilities.screenDPI +
"\nscreenResolutionX: " + Capabilities.screenResolutionX +
"\nscreenResolutionY: " + Capabilities.screenResolutionY +
"\nserverString: " + Capabilities.serverString +
"\ntouchscreenType: " + Capabilities.touchscreenType +
// The following capabilities are supported only when publishing for AIR.
// If you are publishing for AIR, uncomment the following lines.
//"\nlanguages: " + Capabilities.languages +
//"\ncpuArchitecture: " + Capabilities.cpuArchitecture +
//"\nsupports32BitProcesses: " + Capabilities.supports32BitProcesses +
//"\nsupports64BitProcesses: " + Capabilities.supports64BitProcesses +
"\nversion: " + Capabilities.version;
addChild(tf);
trace("avHardwareDisable: " + Capabilities.avHardwareDisable);
trace("hasAccessibility: " + Capabilities.hasAccessibility);
trace("hasAudio: " + Capabilities.hasAudio);
trace("hasAudioEncoder: " + Capabilities.hasAudioEncoder);
trace("hasEmbeddedVideo: " + Capabilities.hasEmbeddedVideo);
trace("hasIME: " + Capabilities.hasIME);
trace("hasMP3: " + Capabilities.hasMP3);
trace("hasPrinting: " + Capabilities.hasPrinting);
trace("hasScreenBroadcast: " + Capabilities.hasScreenBroadcast);
trace("hasScreenPlayback: " + Capabilities.hasScreenPlayback);
trace("hasStreamingAudio: " + Capabilities.hasStreamingAudio);
trace("hasStreamingVideo: " + Capabilities.hasStreamingVideo);
trace("hasTLS: " + Capabilities.hasTLS);
trace("hasVideoEncoder: " + Capabilities.hasVideoEncoder);
trace("isDebugger: " + Capabilities.isDebugger);
trace("isEmbeddedInAcrobat: " + Capabilities.isEmbeddedInAcrobat);
trace("language: " + Capabilities.language);
trace("localFileReadDisable: " + Capabilities.localFileReadDisable);
trace("manufacturer: " + Capabilities.manufacturer);
trace("maxLevelIDC: " + Capabilities.maxLevelIDC);
trace("os: " + Capabilities.os);
trace("pixelAspectRatio: " + Capabilities.pixelAspectRatio);
trace("playerType: " + Capabilities.playerType);
trace("screenColor: " + Capabilities.screenColor);
trace("screenDPI: " + Capabilities.screenDPI);
trace("screenResolutionX: " + Capabilities.screenResolutionX);
trace("screenResolutionY: " + Capabilities.screenResolutionY);
trace("serverString: " + Capabilities.serverString);
trace("touchscreenType: " + Capabilities.touchscreenType);
// The following capabilities are supported only when publishing for AIR.
// If you are publishing for AIR, uncomment the following lines.
//trace("cpuArchitecture: " + Capabilities.cpuArchitecture);
//trace("languages: " + Capabilities.languages);
//trace("supports32BitProcesses: " + Capabilities.supports32BitProcesses);
//trace("supports64BitProcesses: " + Capabilities.supports64BitProcesses);
trace("version: " + Capabilities.version);
}
}
}
Tue Jun 12 2018, 12:06 PM Z