| Paket | flash.system |
| Klasse | public final class Capabilities |
| Vererbung | Capabilities  Object |
| Sprachversion: | ActionScript 3.0 |
| Laufzeitversionen: | Flash Player 9, AIR 1.0, Flash Lite 4 |
Einige Funktionen von Adobe AIR sind allerdings nicht als Eigenschaften in der Capabilities-Klasse aufgelistet. Sie sind Eigenschaften anderer Klassen:
| Eigenschaft | Beschreibung |
|---|---|
NativeApplication.supportsDockIcon
| Gibt an, ob das Betriebssystem Anwendungsdock-Symbole unterstützt. |
NativeApplication.supportsMenu
| Gibt an, ob das Betriebssystem eine globale Anwendungsmenüleiste unterstützt. |
NativeApplication.supportsSystemTrayIcon
| Gibt an, ob das Betriebssystem Taskleistensymbole unterstützt. |
NativeWindow.supportsMenu
| Gibt an, ob das Betriebssystem Fenstermenüs unterstützt. |
NativeWindow.supportsTransparency
| Gibt an, ob das Betriebssystem transparente Fenster unterstützt. |
Verwenden Sie nicht
Capabilities.os bzw. Capabilities.manufacturer, um eine betriebssystemspezifische Funktionalität zu ermitteln. Die Funktionalität auf dem Betriebssystem basieren zu lassen, wird nicht empfohlen, da dies zu Problemen führt, wenn eine Anwendung nicht alle möglichen Zielbetriebssysteme berücksichtigt. Verwenden Sie stattdessen die Eigenschaft, die der von Ihnen zu testenden Funktionalität entspricht.
Sie können Daten zum Funktionsumfang, die in der Capabilities.serverString-Eigenschaft als URL-kodierter String gespeichert sind, senden, und zwar mithilfe der HTTP-Methode GET oder POST. Im folgenden Beispiel ist ein Serverstring für einen Computer mit MP3-Unterstützung und einer Auflösung von 1600 x 1200 Pixel dargestellt, auf dem Windows XP mit einem installierten Eingabemethoden-Editor (IME) ausgeführt wird und das kein Mehrkanalaudio unterstützt:
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
In der folgenden Tabelle sind die Eigenschaften der Capabilities-Klasse und die entsprechenden Serverstrings aufgeführt. Außerdem sind die Serverstrings für die Mehrkanalaudiotypen aufgeführt.
| Eigenschaften der Capabilities-Klasse | Serverstring |
|---|---|
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
|
supports Dolby Digital audio
|
DD
|
supports Dolby Digital Plus audio
|
DDP
|
supports DTS audio
|
DTS
|
supports DTS Express audio
|
DTE
|
supports DTS-HD High Resolution Audio
|
DTH
|
supports DTS-HD Master Audio
|
DTM
|
Es gibt auch einen WD-Serverstring, der festlegt, ob der fensterlose Modus deaktiviert ist. Der fensterlose Modus kann in Flash Player aufgrund einer Inkompatibilität mit dem Webbrowser oder einer Benutzereinstellung in der Datei mms.cfg deaktiviert werden. Es gibt keine entsprechende Capabilities-Eigenschaft.
Alle Eigenschaften der Capabilities-Klasse sind schreibgeschützt.
Vererbte öffentliche Eigenschaften ausblenden
Vererbte öffentliche Eigenschaften anzeigen| Eigenschaft | Definiert von | ||
|---|---|---|---|
| avHardwareDisable : Boolean [statisch] [schreibgeschützt]
Gibt an, ob der Zugriff auf die Kamera und das Mikrofon eines Benutzers vom Administrator untersagt (true) oder zugelassen (false) wurde. | Capabilities | ||
 | constructor : Object
Ein Verweis auf das Klassenobjekt oder die Konstruktorfunktion für eine angegebene Objektinstanz. | Object | |
| cpuArchitecture : String [statisch] [schreibgeschützt]
Gibt die aktuelle CPU-Architektur zurück. | Capabilities | ||
| hasAccessibility : Boolean [statisch] [schreibgeschützt]
Gibt an, ob das System die Kommunikation über Eingabehilfen zur Barrierefreiheit unterstützt (true) oder nicht (false). | Capabilities | ||
| hasAudio : Boolean [statisch] [schreibgeschützt]
Gibt an, ob das System über Audiofunktionen verfügt. | Capabilities | ||
| hasAudioEncoder : Boolean [statisch] [schreibgeschützt]
Gibt an, ob das System einen Audiostream, der beispielsweise von einem Mikrofon stammt, kodieren kann (true) oder nicht (false). | Capabilities | ||
| hasEmbeddedVideo : Boolean [statisch] [schreibgeschützt]
Gibt an, ob das System eingebettetes Video unterstützt (true) oder nicht (false). | Capabilities | ||
| hasIME : Boolean [statisch] [schreibgeschützt]
Gibt an, ob auf dem System ein Eingabemethoden-Editor (IME) installiert ist (true) oder nicht (false). | Capabilities | ||
| hasMP3 : Boolean [statisch] [schreibgeschützt]
Gibt an, ob das System über einen MP3-Decoder verfügt (true) oder nicht (false). | Capabilities | ||
| hasPrinting : Boolean [statisch] [schreibgeschützt]
Gibt an, ob das System das Drucken unterstützt (true) oder nicht (false). | Capabilities | ||
| hasScreenBroadcast : Boolean [statisch] [schreibgeschützt]
Gibt an, ob das System die Entwicklung von Bildschirm-Broadcast-Anwendungen, die über Flash Media Server ausgeführt werden sollen, unterstützt (true) oder nicht unterstützt (false). | Capabilities | ||
| hasScreenPlayback : Boolean [statisch] [schreibgeschützt]
Gibt an, ob das System die Wiedergabe von Bildschirm-Broadcast-Anwendungen unterstützt (true) oder nicht unterstützt (false), die über Flash Media Server ausgeführt werden. | Capabilities | ||
| hasStreamingAudio : Boolean [statisch] [schreibgeschützt]
Gibt an, ob das System Streamingsound wiedergeben kann (true) oder nicht (false). | Capabilities | ||
| hasStreamingVideo : Boolean [statisch] [schreibgeschützt]
Gibt an, ob das System Streaming-Video wiedergeben kann (true) oder nicht (false). | Capabilities | ||
| hasTLS : Boolean [statisch] [schreibgeschützt]
Gibt an, ob das System native SSL-Sockets über NetConnection unterstützt werden (true) oder nicht (false). | Capabilities | ||
| hasVideoEncoder : Boolean [statisch] [schreibgeschützt]
Gibt an, ob das System einen Videostream, der beispielsweise von einer Webkamera stammt, kodieren (true) oder nicht kodieren (false) kann. | Capabilities | ||
| isDebugger : Boolean [statisch] [schreibgeschützt]
Gibt an, ob es sich bei dem System um eine spezielle Debugging-Version (true) oder um eine offiziell freigegebene Version (false) handelt. | Capabilities | ||
| isEmbeddedInAcrobat : Boolean [statisch] [schreibgeschützt]
Gibt an, ob die Flash-Laufzeitumgebung in eine PDF-Datei eingebettet ist, die in Acrobat 9.0 oder höher geöffnet ist (true) oder nicht (false). | Capabilities | ||
| language : String [statisch] [schreibgeschützt]
Gibt den Sprachcode des Systems an, auf dem der Inhalt ausgeführt wird. | Capabilities | ||
| languages : Array [statisch] [schreibgeschützt]
Ein Array mit Strings, die Informationen über die im Betriebssystem festgesetzten bevorzugten Sprachen des Benutzers für Benutzeroberflächen enthalten. | Capabilities | ||
| localFileReadDisable : Boolean [statisch] [schreibgeschützt]
Gibt an, ob der Lesezugriff auf die Festplatte des Benutzers vom Administrator verweigert (true) oder zugelassen (false) wurde. | Capabilities | ||
| manufacturer : String [statisch] [schreibgeschützt]
Gibt den Hersteller der ausgeführten Version des Flash Player oder der AIR-Laufzeitumgebung im Format „Adobe Betriebssystemname“ an. | Capabilities | ||
| maxLevelIDC : String [statisch] [schreibgeschützt]
Ruft die höchste H.264 Level IDC ab, die von der Hardware des Clients unterstützt wird. | Capabilities | ||
| os : String [statisch] [schreibgeschützt]
Gibt das aktuelle Betriebssystem an. | Capabilities | ||
| pixelAspectRatio : Number [statisch] [schreibgeschützt]
Gibt das Pixelseitenverhältnis des Bildschirms an. | Capabilities | ||
| playerType : String [statisch] [schreibgeschützt]
Gibt den Typ der Laufzeitumgebung an. | Capabilities | ||
| screenColor : String [statisch] [schreibgeschützt]
Gibt die Bildschirmfarbe an. | Capabilities | ||
| screenDPI : Number [statisch] [schreibgeschützt]
Gibt den dpi-Wert der Bildschirmauflösung in Pixeln an. | Capabilities | ||
| screenResolutionX : Number [statisch] [schreibgeschützt]
Gibt die maximale horizontale Auflösung des Bildschirms an. | Capabilities | ||
| screenResolutionY : Number [statisch] [schreibgeschützt]
Gibt die maximale vertikale Auflösung des Bildschirms an. | Capabilities | ||
| serverString : String [statisch] [schreibgeschützt]
Ein URL-kodierter String, der die Werte für jede Capabilities-Eigenschaft angibt. | Capabilities | ||
| supports32BitProcesses : Boolean [statisch] [schreibgeschützt]
Gibt an, ob das System das Ausführen von 32-Bit-Prozessen unterstützt. | Capabilities | ||
| supports64BitProcesses : Boolean [statisch] [schreibgeschützt]
Gibt an, ob das System die Ausführung von 64-Bit-Prozessen unterstützt. | Capabilities | ||
| touchscreenType : String [statisch] [schreibgeschützt]
Gibt den Typ des unterstützten Touchscreens an, falls vorhanden. | Capabilities | ||
| version : String [statisch] [schreibgeschützt]
Gibt die Flash Player- oder Adobe® AIR®-Plattform. sowie Versionsinformationen an. | Capabilities | ||
| Methode | Definiert von | ||
|---|---|---|---|
[statisch]
Gibt an, ob das System Mehrkanalaudio eines bestimmten Typs unterstützt. | Capabilities | ||
|
Gibt an, ob für ein Objekt eine bestimmte Eigenschaft definiert wurde. | Object | |
|
Gibt an, ob eine Instanz der Object-Klasse in der Prototypkette des Objekts vorhanden ist, das als Parameter angegeben wurde. | Object | |
|
Gibt an, ob die angegebene Eigenschaft vorhanden ist und durchlaufen werden kann. | Object | |
|
Legt die Verfügbarkeit einer dynamischen Eigenschaft für Schleifenoperationen fest. | Object | |
|
Gibt die Stringdarstellung dieses Objekts zurück, formatiert entsprechend den Konventionen des Gebietsschemas. | Object | |
|
Gibt das angegebene Objekt als String zurück. | Object | |
|
Gibt den Grundwert des angegebenen Objekts zurück. | Object | |
avHardwareDisable | Eigenschaft |
avHardwareDisable:Boolean [schreibgeschützt] | Sprachversion: | ActionScript 3.0 |
| Laufzeitversionen: | Flash Player 9, AIR 1.0, Flash Lite 4 |
Gibt an, ob der Zugriff auf die Kamera und das Mikrofon eines Benutzers vom Administrator untersagt (true) oder zugelassen (false) wurde. Der Serverstring ist AVD.
Für Inhalt in Adobe AIR™ gilt diese Eigenschaft nur für Inhalt in Sicherheitssandboxen, bei denen es sich nicht um die Sicherheitssandbox der Anwendung handelt. Inhalt in der Sicherheitssandbox der Anwendung kann immer auf die Kamera und das Mikrofon des Benutzers zugreifen.
Implementierung
public static function get avHardwareDisable():BooleanVerwandte API-Elemente
cpuArchitecture | Eigenschaft |
cpuArchitecture:String [schreibgeschützt] | Sprachversion: | ActionScript 3.0 |
| Laufzeitversionen: | Flash Player 10.0.32, AIR 1.5.1 |
Gibt die aktuelle CPU-Architektur zurück. Die cpuArchitecture-Eigenschaft kann die folgenden Strings zurückgeben: "PowerPC", "x86", "SPARC" und "ARM". Der Serverstring ist ARCH.
Implementierung
public static function get cpuArchitecture():StringhasAccessibility | Eigenschaft |
hasAccessibility:Boolean [schreibgeschützt] | Sprachversion: | ActionScript 3.0 |
| Laufzeitversionen: | Flash Player 9, AIR 1.0, Flash Lite 4 |
Gibt an, ob das System die Kommunikation über Eingabehilfen zur Barrierefreiheit unterstützt (true) oder nicht (false). Der Serverstring ist ACC.
Implementierung
public static function get hasAccessibility():BooleanVerwandte API-Elemente
hasAudio | Eigenschaft |
hasAudio:Boolean [schreibgeschützt] | Sprachversion: | ActionScript 3.0 |
| Laufzeitversionen: | Flash Player 9, AIR 1.0, Flash Lite 4 |
Gibt an, ob das System über Audiofunktionen verfügt. Diese Eigenschaft ist immer auf true gesetzt. Der Serverstring ist A.
Implementierung
public static function get hasAudio():BooleanhasAudioEncoder | Eigenschaft |
hasAudioEncoder:Boolean [schreibgeschützt] | Sprachversion: | ActionScript 3.0 |
| Laufzeitversionen: | Flash Player 9, AIR 1.0, Flash Lite 4 |
Gibt an, ob das System einen Audiostream, der beispielsweise von einem Mikrofon stammt, kodieren kann (true) oder nicht (false). Der Serverstring ist AE.
Implementierung
public static function get hasAudioEncoder():BooleanhasEmbeddedVideo | Eigenschaft |
hasEmbeddedVideo:Boolean [schreibgeschützt] | Sprachversion: | ActionScript 3.0 |
| Laufzeitversionen: | Flash Player 9, AIR 1.0, Flash Lite 4 |
Gibt an, ob das System eingebettetes Video unterstützt (true) oder nicht (false). Der Serverstring ist EV.
Implementierung
public static function get hasEmbeddedVideo():BooleanhasIME | Eigenschaft |
hasIME:Boolean [schreibgeschützt] | Sprachversion: | ActionScript 3.0 |
| Laufzeitversionen: | Flash Player 9, AIR 1.0, Flash Lite 4 |
Gibt an, ob auf dem System ein Eingabemethoden-Editor (IME) installiert ist (true) oder nicht (false). Der Serverstring ist IME.
Implementierung
public static function get hasIME():BooleanVerwandte API-Elemente
hasMP3 | Eigenschaft |
hasPrinting | Eigenschaft |
hasScreenBroadcast | Eigenschaft |
hasScreenBroadcast:Boolean [schreibgeschützt] | Sprachversion: | ActionScript 3.0 |
| Laufzeitversionen: | Flash Player 9, AIR 1.0, Flash Lite 4 |
Gibt an, ob das System die Entwicklung von Bildschirm-Broadcast-Anwendungen, die über Flash Media Server ausgeführt werden sollen, unterstützt (true) oder nicht unterstützt (false). Der Serverstring ist SB.
Implementierung
public static function get hasScreenBroadcast():BooleanhasScreenPlayback | Eigenschaft |
hasScreenPlayback:Boolean [schreibgeschützt] | Sprachversion: | ActionScript 3.0 |
| Laufzeitversionen: | Flash Player 9, AIR 1.0, Flash Lite 4 |
Gibt an, ob das System die Wiedergabe von Bildschirm-Broadcast-Anwendungen unterstützt (true) oder nicht unterstützt (false), die über Flash Media Server ausgeführt werden. Der Serverstring ist SP.
Implementierung
public static function get hasScreenPlayback():BooleanhasStreamingAudio | Eigenschaft |
hasStreamingAudio:Boolean [schreibgeschützt] | Sprachversion: | ActionScript 3.0 |
| Laufzeitversionen: | Flash Player 9, AIR 1.0, Flash Lite 4 |
Gibt an, ob das System Streamingsound wiedergeben kann (true) oder nicht (false). Der Serverstring ist SA.
Implementierung
public static function get hasStreamingAudio():BooleanhasStreamingVideo | Eigenschaft |
hasStreamingVideo:Boolean [schreibgeschützt] | Sprachversion: | ActionScript 3.0 |
| Laufzeitversionen: | Flash Player 9, AIR 1.0, Flash Lite 4 |
Gibt an, ob das System Streaming-Video wiedergeben kann (true) oder nicht (false). Der Serverstring ist SV.
Implementierung
public static function get hasStreamingVideo():BooleanhasTLS | Eigenschaft |
hasTLS:Boolean [schreibgeschützt] | Sprachversion: | ActionScript 3.0 |
| Laufzeitversionen: | Flash Player 9, AIR 1.0, Flash Lite 4 |
Gibt an, ob das System native SSL-Sockets über NetConnection unterstützt werden (true) oder nicht (false). Der Serverstring ist TLS.
Implementierung
public static function get hasTLS():BooleanVerwandte API-Elemente
hasVideoEncoder | Eigenschaft |
hasVideoEncoder:Boolean [schreibgeschützt] | Sprachversion: | ActionScript 3.0 |
| Laufzeitversionen: | Flash Player 9, AIR 1.0, Flash Lite 4 |
Gibt an, ob das System einen Videostream, der beispielsweise von einer Webkamera stammt, kodieren (true) oder nicht kodieren (false) kann. Der Serverstring ist VE.
Implementierung
public static function get hasVideoEncoder():BooleanisDebugger | Eigenschaft |
isDebugger:Boolean [schreibgeschützt] | Sprachversion: | ActionScript 3.0 |
| Laufzeitversionen: | Flash Player 9, AIR 1.0, Flash Lite 4 |
Gibt an, ob es sich bei dem System um eine spezielle Debugging-Version (true) oder um eine offiziell freigegebene Version (false) handelt. Der Serverstring ist DEB. Diese Eigenschaft ist mit true belegt, wenn die Ausführung in der Debug-Version des Flash Player oder im AIR Debug Launcher (ADL) erfolgt.
Implementierung
public static function get isDebugger():BooleanisEmbeddedInAcrobat | Eigenschaft |
isEmbeddedInAcrobat:Boolean [schreibgeschützt] | Sprachversion: | ActionScript 3.0 |
| Laufzeitversionen: | Flash Player 9.0.127.0, AIR 1.1, Flash Lite 4 |
Gibt an, ob die Flash-Laufzeitumgebung in eine PDF-Datei eingebettet ist, die in Acrobat 9.0 oder höher geöffnet ist (true) oder nicht (false).
Implementierung
public static function get isEmbeddedInAcrobat():Booleanlanguage | Eigenschaft |
language:String [schreibgeschützt] | Sprachversion: | ActionScript 3.0 |
| Laufzeitversionen: | Flash Player 9, AIR 1.0, Flash Lite 4 |
Gibt den Sprachcode des Systems an, auf dem der Inhalt ausgeführt wird. Die Sprache wird als ein aus zwei Kleinbuchstaben bestehender Sprachcode nach ISO 639-1 angegeben. Bei Chinesisch unterscheidet ein zusätzlicher aus zwei Großbuchstaben bestehender Ländercode nach ISO 3166 zwischen vereinfachtem und traditionellem Chinesisch. Die Sprachcodes beruhen auf der englischen Bezeichnung der jeweiligen Sprache: mit hu wird beispielsweise Ungarisch (englisch: Hungarian) angegeben.
In englischen Systemen gibt diese Eigenschaft nur den Sprachcode (en), nicht jedoch den Ländercode zurück. In Microsoft Windows-Systemen gibt diese Eigenschaft die in der Benutzeroberfläche bei allen Menüs, Dialogfeldern, Fehlermeldungen und Hilfedateien verwendete Sprache zurück. In der folgenden Tabelle sind die möglichen Werte aufgelistet:
| Sprache | Wert |
|---|---|
| Tschechisch | cs |
| Dänisch | da |
| Niederländisch | nl |
| Englisch | de |
| Finnisch | fi |
| Französisch | fr |
| Deutsch | de |
| Ungarisch | hu |
| Italienisch | it |
| Japanisch | ja |
| Koreanisch | ko |
| Norwegisch | nb |
| Andere/unbekannt | xu |
| Polnisch | pl |
| Portugiesisch | pt |
| Russisch | ru |
| Chinesisch (VRC) | zh-CN |
| Spanisch | es |
| Schwedisch | sv |
| Chinesisch (Taiwan) | zh-TW |
| Türkisch | tr |
Hinweis: Als Wert für die Capabilities.language-Eigenschaft sind nur Werte aus dieser Liste erlaubt. Aufgrund dieser Einschränkung sollten Adobe AIR-Anwendungen das erste Element im Capabilities.languages-Array verwenden, um die primäre Benutzeroberflächensprache für das System zu ermitteln.
Der Serverstring ist L.
Implementierung
public static function get language():StringVerwandte API-Elemente
Beispiel ( Verwendung dieses Beispiels )
Die Eigenschaft Capabilities.language gibt den Sprachcode gemäß ISO 639-1 zurück (zum Beispiel „en“ für Englisch). Die Anweisung switch überprüft den Sprachcode und legt den Inhalt des Textfelds myTextField auf eine Begrüßung in der entsprechenden Sprache fest. Wenn der Sprachcode nicht unterstützt wird, wird ein Standardfehlerstring zurückgegeben.
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 | Eigenschaft |
languages:Array [schreibgeschützt] | Sprachversion: | ActionScript 3.0 |
| Laufzeitversionen: | AIR 1.1 |
Ein Array mit Strings, die Informationen über die im Betriebssystem festgesetzten bevorzugten Sprachen des Benutzers für Benutzeroberflächen enthalten. Die Strings enthalten Sprachtags (und Skript- und regionale Informationen, sofern zutreffend), die in RFC4646 (http://www.ietf.org/rfc/rfc4646.txt) definiert sind, und verwenden Bindestriche als Trennzeichen (z. B. "en-US" oder "ja-JP"). Sprachen werden im Array in der bevorzugten Reihenfolge aufgelistet, die von den Betriebssystemeinstellungen bestimmt wird.
Je nach Betriebssystem werden von den Gebietsschemastrings unterschiedliche regionale Informationen zurückgegeben. Ein Betriebssystem könnte z. B. "en-us" zurückgeben, während ein anderes "en" zurückgeben könnte.
Der erste Eintrag im zurückgegebenen Array hat im Allgemeinen die gleiche primäre Sprach-ID wie die Capabilities.language-Eigenschaft. Wenn Capabilities.languages[0] z. B. auf "en-US" gesetzt ist, dann ist die language-Eigenschaft auf "en" gesetzt. Wenn aber die Capabilities.language-Eigenschaft auf "xu" (eine unbekannte Sprache) gesetzt ist, ist das erste Element in diesem Array anders. Aus diesem Grund kann Capabilities.languages[0] genauer als Capabilities.language sein.
Der Serverstring ist LS.
Implementierung
public static function get languages():ArraylocalFileReadDisable | Eigenschaft |
localFileReadDisable:Boolean [schreibgeschützt] | Sprachversion: | ActionScript 3.0 |
| Laufzeitversionen: | Flash Player 9, AIR 1.0, Flash Lite 4 |
Gibt an, ob der Lesezugriff auf die Festplatte des Benutzers vom Administrator verweigert (true) oder zugelassen (false) wurde. Für Inhalt in Adobe AIR gilt diese Eigenschaft nur für Inhalt in Sicherheitssandboxen, bei denen es sich nicht um die Sicherheitssandbox der Anwendung handelt. (Inhalt in der Sicherheitssandbox der Anwendung kann vom Dateisystem immer gelesen werden.) Wenn diese Eigenschaft auf true gesetzt ist, kann Flash Player keine Dateien (einschließlich der ersten Datei, mit der Flash Player gestartet wird) auf der Festplatte des Benutzers lesen. Wenn diese Eigenschaft auf true gesetzt ist, kann AIR-Inhalt außerhalb der Sicherheitssandbox der Anwendung keine Dateien von der Festplatte des Benutzers lesen. So schlagen beispielsweise Versuche fehl, eine Datei auf der Festplatte des Benutzers mit Lademethoden zu lesen, wenn diese Eigenschaft auf true gesetzt ist.
Darüber hinaus sind auch freigegebene Laufzeitbibliotheken gesperrt, wenn diese Eigenschaft auf true gesetzt ist. Das Lesen freigegebener lokaler Objekte ist jedoch unabhängig vom Wert dieser Eigenschaft möglich.
Der Serverstring ist LFD.
Implementierung
public static function get localFileReadDisable():BooleanVerwandte API-Elemente
manufacturer | Eigenschaft |
manufacturer:String [schreibgeschützt] | Sprachversion: | ActionScript 3.0 |
| Laufzeitversionen: | Flash Player 9, AIR 1.0, Flash Lite 4 |
Gibt den Hersteller der ausgeführten Version des Flash Player oder der AIR-Laufzeitumgebung im Format „Adobe Betriebssystemname“ an. Der Wert für Betriebssystemname kann "Windows", "Macintosh", "Linux" oder der Name eines anderen Betriebssystems sein. Der Serverstring ist M.
Verwenden Sie nicht Capabilities.manufacturer, um eine betriebssystemspezifische Funktionalität zu ermitteln, wenn es eine spezifischere Funktionalitätseigenschaft gibt. Die Funktionalität auf dem Betriebssystem basieren zu lassen, wird nicht empfohlen, da dies zu Problemen führt, wenn eine Anwendung nicht alle möglichen Zielbetriebssysteme berücksichtigt. Verwenden Sie stattdessen die Eigenschaft, die der von Ihnen zu testenden Funktionalität entspricht. Weitere Informationen finden Sie in der Beschreibung der Capabilities-Klasse.
Implementierung
public static function get manufacturer():StringmaxLevelIDC | Eigenschaft |
maxLevelIDC:String [schreibgeschützt] | Sprachversion: | ActionScript 3.0 |
| Laufzeitversionen: | Flash Player 10, AIR 1.5, Flash Lite 4 |
Ruft die höchste H.264 Level IDC ab, die von der Hardware des Clients unterstützt wird. Medien, die auf dieser Stufe ausgeführt werden, können garantiert ausgeführt werden, während Medien, die auf der höchsten Stufe ausgeführt werden, u. U. nicht mit der höchsten Qualität ausgeführt werden. Diese Eigenschaft ist für Server nützlich, die versuchen, die Funktionalität eines Clients zu emulieren. Mit dieser Eigenschaft kann ein Server die Grafikqualität ermitteln, die an den Client gesendet werden kann.
Der Serverstring ist ML.
Implementierung
public static function get maxLevelIDC():Stringos | Eigenschaft |
os:String [schreibgeschützt] | Sprachversion: | ActionScript 3.0 |
| Laufzeitversionen: | Flash Player 9, AIR 1.0, Flash Lite 4 |
Gibt das aktuelle Betriebssystem an. Die os-Eigenschaft kann die folgenden Strings zurückgeben:
| Betriebssystem | Wert |
|---|---|
| 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" (wobei X.Y.Z die Versionsnummer ist, zum Beispiel: "Mac OS 10.5.2") |
| Linux | "Linux" (Flash Player fügt die Linux-Version an, zum Beispiel "Linux 2.6.15-1.2054_FC5smp" |
| iPhone OS 4.1 | "iPhone3,1" |
Der Serverstring ist OS.
Verwenden Sie nicht Capabilities.os, um eine betriebssystemspezifische Funktionalität zu ermitteln, wenn es eine spezifischere Funktionalitätseigenschaft gibt. Die Funktionalität auf dem Betriebssystem basieren zu lassen, wird nicht empfohlen, da dies zu Problemen führt, wenn eine Anwendung nicht alle möglichen Zielbetriebssysteme berücksichtigt. Verwenden Sie stattdessen die Eigenschaft, die der von Ihnen zu testenden Funktionalität entspricht. Weitere Informationen finden Sie in der Beschreibung der Capabilities-Klasse.
Implementierung
public static function get os():StringpixelAspectRatio | Eigenschaft |
playerType | Eigenschaft |
playerType:String [schreibgeschützt] | Sprachversion: | ActionScript 3.0 |
| Laufzeitversionen: | Flash Player 9, AIR 1.0, Flash Lite 4 |
Gibt den Typ der Laufzeitumgebung an. Diese Eigenschaft weist einen der folgenden Werte auf:
„ActiveX“für das in Microsoft Internet Explorer verwendete Flash Player-ActiveX-Steuerelement„Desktop“für die Adobe AIR-Laufzeitumgebung (mit Ausnahme von SWF-Inhalten, die von einer HTML-Seite geladen werden, wobeiCapabilities.playerTypeauf„PlugIn“gesetzt ist)"External"für den externen Flash Player oder im Testmodus"PlugIn"für das Flash Player-Browser-Zusatzmodul (und für SWF-Inhalte, die von einer HTML-Seite in einer AIR-Anwendung geladen werden)"StandAlone"für den eigenständigen Flash Player
Der Serverstring ist PT.
Implementierung
public static function get playerType():StringscreenColor | Eigenschaft |
screenColor:String [schreibgeschützt] | Sprachversion: | ActionScript 3.0 |
| Laufzeitversionen: | Flash Player 9, AIR 1.0, Flash Lite 4 |
Gibt die Bildschirmfarbe an. Dieser Eigenschaft können die Werte "color", "gray" (Graustufen) oder "bw" (schwarzweiß) zugeordnet werden. Der Serverstring ist COL.
Implementierung
public static function get screenColor():StringscreenDPI | Eigenschaft |
screenResolutionX | Eigenschaft |
screenResolutionX:Number [schreibgeschützt] | Sprachversion: | ActionScript 3.0 |
| Laufzeitversionen: | Flash Player 9, AIR 1.0, Flash Lite 4 |
Gibt die maximale horizontale Auflösung des Bildschirms an. Der Serverstring ist R (und gibt die Breite und Höhe des Bildschirms zurück). Diese Eigenschaft wird nicht mit der Bildschirmauflösung des Benutzers aktualisiert und gibt stattdessen lediglich an, welche Auflösung beim Starten einer Flash Player- oder Adobe AIR-Anwendung verwendet wurde. Außerdem gibt der Wert nur die Auflösung des primären Bildschirms an.
Implementierung
public static function get screenResolutionX():NumberscreenResolutionY | Eigenschaft |
screenResolutionY:Number [schreibgeschützt] | Sprachversion: | ActionScript 3.0 |
| Laufzeitversionen: | Flash Player 9, AIR 1.0, Flash Lite 4 |
Gibt die maximale vertikale Auflösung des Bildschirms an. Der Serverstring ist R (und gibt die Breite und Höhe des Bildschirms zurück). Diese Eigenschaft wird nicht mit der Bildschirmauflösung des Benutzers aktualisiert und gibt stattdessen lediglich an, welche Auflösung beim Starten einer Flash Player- oder Adobe AIR-Anwendung verwendet wurde. Außerdem gibt der Wert nur die Auflösung des primären Bildschirms an.
Implementierung
public static function get screenResolutionY():NumberBeispiel ( Verwendung dieses Beispiels )
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 | Eigenschaft |
serverString:String [schreibgeschützt] | Sprachversion: | ActionScript 3.0 |
| Laufzeitversionen: | Flash Player 9, AIR 1.0, Flash Lite 4 |
Ein URL-kodierter String, der die Werte für jede Capabilities-Eigenschaft angibt.
Im folgenden Beispiel ist ein URL-kodierter String dargestellt:
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
Implementierung
public static function get serverString():Stringsupports32BitProcesses | Eigenschaft |
supports32BitProcesses:Boolean [schreibgeschützt] | Sprachversion: | ActionScript 3.0 |
| Laufzeitversionen: | Flash Player 10.0.32, AIR 1.5.2 |
Gibt an, ob das System die Ausführung von 32-Bit-Prozessen unterstützt. Der Serverstring ist PR32.
Implementierung
public static function get supports32BitProcesses():Booleansupports64BitProcesses | Eigenschaft |
supports64BitProcesses:Boolean [schreibgeschützt] | Sprachversion: | ActionScript 3.0 |
| Laufzeitversionen: | Flash Player 10.0.32, AIR 1.5.2 |
Gibt an, ob das System die Ausführung von 64-Bit-Prozessen unterstützt. Der Serverstring ist PR64.
Implementierung
public static function get supports64BitProcesses():BooleantouchscreenType | Eigenschaft |
touchscreenType:String [schreibgeschützt] | Sprachversion: | ActionScript 3.0 |
| Laufzeitversionen: | Flash Player 10.1, AIR 2 |
Gibt den Typ des unterstützten Touchscreens an, falls vorhanden. Werte sind in der flash.system.TouchscreenType-Klasse definiert.
Implementierung
public static function get touchscreenType():StringVerwandte API-Elemente
Beispiel ( Verwendung dieses Beispiels )
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 | Eigenschaft |
version:String [schreibgeschützt] | Sprachversion: | ActionScript 3.0 |
| Laufzeitversionen: | Flash Player 9, AIR 1.0, Flash Lite 4 |
Gibt die Flash Player- oder Adobe® AIR®-Plattform sowie Versionsinformationen an. Das Format der Versionsnummer sieht folgendermaßen aus: Plattform majorVersion, minorVersion, buildNumber, internalBuildNumber. Mögliche Werte für platform sind "WIN", ` "MAC", "LNX" und "AND". Es folgen einige Beispiele für die Versionsangabe:
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
Verwenden Sie nicht Capabilities.version, um eine betriebssystemspezifische Funktionalität zu ermitteln, wenn es eine spezifischere Funktionalitätseigenschaft gibt. Die Funktionalität auf dem Betriebssystem basieren zu lassen, wird nicht empfohlen, da dies zu Problemen führt, wenn eine Anwendung nicht alle möglichen Zielbetriebssysteme berücksichtigt. Verwenden Sie stattdessen die Eigenschaft, die der von Ihnen zu testenden Funktionalität entspricht. Weitere Informationen finden Sie in der Beschreibung der Capabilities-Klasse.
Der Serverstring ist V.
Implementierung
public static function get version():StringBeispiel ( Verwendung dieses Beispiels )
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 | () | Methode |
public static function hasMultiChannelAudio(type:String):Boolean| Sprachversion: | ActionScript 3.0 |
| Laufzeitversionen: | Flash Player 11, AIR 3 |
Gibt an, ob das System Mehrkanalaudio eines bestimmten Typs unterstützt. Die flash.media.AudioDecoder-Klasse zählt die möglichen Typen auf.
AIR-Profilunterstützung: Mehrkanalaudio wird nur auf Geräten mit AIR für TV unterstützt. Bei allen anderen Geräten gibt diese Methode immer false zurück. Weitere Informationen zum AIR-Support über mehrere Profile finden Sie unter Unterstützung von AIR-Profilen.
Hinweis: Bei Verwendung eines der DTS-Audio-Codecs gibt es Szenarien, in denen hasMultiChannelAudio() zwar true zurückgibt, das DTS-Audio aber nicht abgespielt wird. Stellen Sie sich zum Beispiel einen Blu-ray-Player mit einem S/PDIF-Ausgang vor, der an einen alten Verstärker angeschlossen ist. Der alte Verstärker unterstützt DTS nicht, aber S/PDIF verfügt über kein Protokoll, um diesem den Blu-ray-Player zu melden. Wenn der Blu-ray-Player den DTS-Stream an den alten Verstärker sendet, kann der Benutzer nichts hören. Deshalb hat es sich bei Verwendung von DTS bewährt, eine Benutzeroberfläche bereitzustellen, sodass der Benutzer angeben kann, dass kein Ton abgespielt wird. In diesem Fall kann Ihre Anwendung dann einen anderen Codec verwenden.
Die folgende Tabelle zeigt den Serverstring für jeden Mehrkanalaudiotyp:
| Mehrkanalaudiotyp | Serverstring |
|---|---|
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 |
Parameter
type:String — Ein String, der einen Mehrkanalaudiotyp darstellt. Gültige Werte sind die in flash.media.AudioDecoder definierten Konstanten.
|
Boolean — Der boolesche Wert true, wenn das System den im type-Parameter übergebenen Mehrkanalaudiotyp unterstützt. Andernfalls ist der Rückgabewert false.
|
Verwandte API-Elemente
Beispiel ( Verwendung dieses Beispiels )
hasMultiChannelAudio(). Der Rückgabewert gibt an, ob das System Dolby Digital-Mehrkanalaudio unterstützt.
trace(Capabilities.hasMultiChannelAudio(flash.media.AudioDecoder.DOLBY_DIGITAL);
trace() ausgegeben.
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, 10:04 AM Z