| Sprachversion : | ActionScript 3.0 |
| Player-Version : | Flash Player 9 |
Die Capabilities-Klasse enthält Eigenschaften, die das System und den Player einer SWF-Datei beschreiben. Zum Beispiel hat das Display eines Mobiltelefons möglicherweise eine Größe von 100 Quadratpixel und ist schwarzweiß, während der Bildschirm eines Computers eine Größe von 1000 Quadratpixel hat und farbig ist. Über das Capabilities-Objekt können Sie den Gerätetyp eines Benutzers festlegen und so den entsprechenden Inhalt für möglichst viele Benutzer bereitstellen. Wenn Sie den Funktionsumfang des Geräts kennen, können Sie festlegen, dass der Server die entsprechenden SWF-Dateien sendet oder dass die Darstellung der SWF-Datei geändert wird.
Sie können Daten zum Funktionsumfang eines Players, die in der Capabilities.serverString-Eigenschaft als URL-codierter 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 ausgeführt und ein Eingabemethoden-Editor (IME) installiert ist.
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
In der folgenden Tabelle sind die möglichen ActionScript-Eigenschaften und die entsprechenden Serverstrings aufgeführt.
| ActionScript-Eigenschaft | 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 |
os | OS |
pixelAspectRatio | AR |
playerType | PT |
screenColor | COL |
screenDPI | DP |
screenResolutionX | R |
screenResolutionY | R |
version | V |
Alle Eigenschaften der Capabilities-Klasse sind schreibgeschützt.
Beispiele anzeigen
avHardwareDisable:Boolean [read-only]
| Sprachversion : | ActionScript 3.0 |
| Player-Version : | Flash Player 9 |
Gibt an, ob der Zugriff auf die Kamera und das Mikrofon eines Benutzers vom Administrator untersagt (true) oder zugelassen (false) wurde. Der Serverstring lautet AVD.
Implementierung
public static function get avHardwareDisable():Boolean
Siehe auch
hasAccessibility:Boolean [read-only]
| Sprachversion : | ActionScript 3.0 |
| Player-Version : | Flash Player 9 |
Gibt an, ob der Player in einer Umgebung ausgeführt wird, in der die Verwendung von Eingabehilfen unterstützt (true) oder nicht unterstützt (false) wird. Der Serverstring lautet ACC.
Implementierung
public static function get hasAccessibility():Boolean
Siehe auch
hasAudio:Boolean [read-only]
| Sprachversion : | ActionScript 3.0 |
| Player-Version : | Flash Player 9 |
Gibt an, ob der Player auf einem System mit Audiofunktionen ausgeführt wird. Diese Eigenschaft ist immer auf true gesetzt. Der Serverstring lautet A.
Implementierung
public static function get hasAudio():Boolean
hasAudioEncoder:Boolean [read-only]
| Sprachversion : | ActionScript 3.0 |
| Player-Version : | Flash Player 9 |
Gibt an, ob der Player einen Audio-Stream, der beispielsweise von einem Mikrofon stammt, codieren kann (true) oder nicht (false). Der Serverstring lautet AE.
Implementierung
public static function get hasAudioEncoder():Boolean
hasEmbeddedVideo:Boolean [read-only]
| Sprachversion : | ActionScript 3.0 |
| Player-Version : | Flash Player 9 |
Gibt an, ob der Player auf einem System ausgeführt wird, auf dem eingebettete Videos unterstützt (true) oder nicht unterstützt (false) werden. Der Serverstring lautet EV.
Implementierung
public static function get hasEmbeddedVideo():Boolean
hasIME:Boolean [read-only]
| Sprachversion : | ActionScript 3.0 |
| Player-Version : | Flash Player 9 |
Gibt an, ob der Player auf einem System ausgeführt wird, auf dem ein Eingabemethoden-Editor (IME) installiert (true) oder nicht installiert (false) ist. Der Serverstring lautet IME.
Implementierung
public static function get hasIME():Boolean
Siehe auch
hasMP3:Boolean [read-only]
| Sprachversion : | ActionScript 3.0 |
| Player-Version : | Flash Player 9 |
Gibt an, ob der Player auf einem System mit MP3-Decoder (true) oder ohne MP3-Decoder (false) ausgeführt wird. Der Serverstring lautet MP3.
Implementierung
public static function get hasMP3():Boolean
Siehe auch
hasPrinting:Boolean [read-only]
| Sprachversion : | ActionScript 3.0 |
| Player-Version : | Flash Player 9 |
Gibt an, ob der Player auf einem System ausgeführt wird, auf dem Druckfunktionen unterstützt (true) oder nicht unterstützt (false) werden. Der Serverstring lautet PR.
Implementierung
public static function get hasPrinting():Boolean
hasScreenBroadcast:Boolean [read-only]
| Sprachversion : | ActionScript 3.0 |
| Player-Version : | Flash Player 9 |
Gibt an, ob der Player die Entwicklung von Bildschirm-Broadcast-Anwendungen unterstützt (true) oder nicht unterstützt (false), die über Flash Media Server ausgeführt werden sollen. Der Serverstring lautet SB.
Implementierung
public static function get hasScreenBroadcast():Boolean
hasScreenPlayback:Boolean [read-only]
| Sprachversion : | ActionScript 3.0 |
| Player-Version : | Flash Player 9 |
Gibt an, ob der Player die Wiedergabe von Bildschirm-Broadcast-Anwendungen unterstützt (true) oder nicht unterstützt (false), die über Flash Media Server ausgeführt werden. Der Serverstring lautet SP.
Implementierung
public static function get hasScreenPlayback():Boolean
hasStreamingAudio:Boolean [read-only]
| Sprachversion : | ActionScript 3.0 |
| Player-Version : | Flash Player 9 |
Gibt an, ob der Player Streaming-Sounds wiedergeben (true) oder nicht wiedergeben (false) kann. Der Serverstring lautet SA.
Implementierung
public static function get hasStreamingAudio():Boolean
hasStreamingVideo:Boolean [read-only]
| Sprachversion : | ActionScript 3.0 |
| Player-Version : | Flash Player 9 |
Gibt an, ob der Player Streaming-Videos wiedergeben (true) oder nicht wiedergeben (false) kann. Der Serverstring lautet SV.
Implementierung
public static function get hasStreamingVideo():Boolean
hasTLS:Boolean [read-only]
| Sprachversion : | ActionScript 3.0 |
| Player-Version : | Flash Player 9 |
Gibt an, ob der Player auf einem System ausgeführt wird, auf dem native SSL-Sockets über NetConnection unterstützt (true) oder nicht unterstützt (false) werden. Der Serverstring lautet TLS.
Implementierung
public static function get hasTLS():Boolean
Siehe auch
hasVideoEncoder:Boolean [read-only]
| Sprachversion : | ActionScript 3.0 |
| Player-Version : | Flash Player 9 |
Gibt an, ob der Player einen Video-Stream, der beispielsweise von einer Webkamera stammt, codieren (true) oder nicht codieren (false) kann. Der Serverstring lautet VE.
Implementierung
public static function get hasVideoEncoder():Boolean
isDebugger:Boolean [read-only]
| Sprachversion : | ActionScript 3.0 |
| Player-Version : | Flash Player 9 |
Gibt an, ob es sich bei dem Player um eine spezielle Debugging-Version (true) oder um eine offiziell freigegebene Version (false) handelt. Der Serverstring lautet DEB.
Implementierung
public static function get isDebugger():Boolean
language:String [read-only]
| Sprachversion : | ActionScript 3.0 |
| Player-Version : | Flash Player 9 |
Gibt den Sprachcode des Systems an, auf dem der Player 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. Folgende Werte sind möglich:
| Sprache | Wert |
| Tschechisch | cs |
| Dänisch | da |
| Niederländisch | nl |
| Englisch | en |
| Finnisch | fi |
| Französisch | fr |
| Deutsch | de |
| Ungarisch | hu |
| Italienisch | it |
| Japanisch | ja |
| Koreanisch | ko |
| Norwegisch | no |
| Andere/unbekannt | xu |
| Polnisch | pl |
| Portugiesisch | pt |
| Russisch | ru |
| Chinesisch (VRC) | zh-CN |
| Spanisch | es |
| Schwedisch | sv |
| Chinesisch (Taiwan) | zh-TW |
| Türkisch | tr |
Der Serverstring lautet L.
Implementierung
public static function get language():String
Beispiel
Im folgenden Beispiel wird abhängig von der Sprache des vom Benutzer verwendeten Betriebssystems unterschiedlicher Inhalt angezeigt.
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);
}
}
}
localFileReadDisable:Boolean [read-only]
| Sprachversion : | ActionScript 3.0 |
| Player-Version : | Flash Player 9 |
Gibt an, ob der Lesezugriff auf die Festplatte des Benutzers vom Administrator verweigert (true) oder zugelassen (false) wurde. Wenn diese Eigenschaft auf true gesetzt ist, kann Flash Player keine Dateien (einschließlich der ersten SWF-Datei, mit der Flash Player gestartet wird) auf 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 lautet LFD.
Implementierung
public static function get localFileReadDisable():Boolean
Siehe auch
manufacturer:String [read-only]
| Sprachversion : | ActionScript 3.0 |
| Player-Version : | Flash Player 9 |
Gibt den Hersteller von Flash Player im Format "Adobe OSName" an. <Check Alignment of PHs>Der Wert für OSName kann "Windows", "Macintosh", "Linux" oder der Name eines anderen Betriebssystems sein. Der Serverstring lautet M.
Implementierung
public static function get manufacturer():String
os:String [read-only]
| Sprachversion : | ActionScript 3.0 |
| Player-Version : | Flash Player 9 |
Gibt das aktuelle Betriebssystem an. Die os-Eigenschaft kann folgende Strings zurückgeben: "Windows XP", "Windows 2000", "Windows NT", "Windows 98/ME", "Windows 95", "Windows CE" (nur bei Flash Player SDK, nicht in der Desktop-Version), "Linux" und "MacOS". Der Serverstring lautet OS.
Implementierung
public static function get os():String
pixelAspectRatio:Number [read-only]
| Sprachversion : | ActionScript 3.0 |
| Player-Version : | Flash Player 9 |
Gibt das Pixelseitenverhältnis des Bildschirms an. Der Serverstring lautet AR.
Implementierung
public static function get pixelAspectRatio():Number
playerType:String [read-only]
| Sprachversion : | ActionScript 3.0 |
| Player-Version : | Flash Player 9 |
Gibt den Typ des Players an. Diese Eigenschaft weist einen der folgenden Werte auf:
"StandAlone" für den eigenständigen Flash Player
"External" für den externen Flash Player oder im Testmodus
"PlugIn" für das Browser-Plug-In von Flash Player
"ActiveX" für das in Microsoft Internet Explorer verwendete Flash Player-ActiveX-Steuerelement
Der Serverstring lautet PT.
Implementierung
public static function get playerType():String
screenColor:String [read-only]
| Sprachversion : | ActionScript 3.0 |
| Player-Version : | Flash Player 9 |
Gibt die Bildschirmfarbe an. Dieser Eigenschaft können die Werte "color", "gray" (Graustufen) oder "bw" (schwarzweiß) zugeordnet werden. Der Serverstring lautet COL.
Implementierung
public static function get screenColor():String
screenDPI:Number [read-only]
| Sprachversion : | ActionScript 3.0 |
| Player-Version : | Flash Player 9 |
Gibt den dpi-Wert der Bildschirmauflösung in Pixel an. Der Serverstring lautet DP.
Implementierung
public static function get screenDPI():Number
screenResolutionX:Number [read-only]
| Sprachversion : | ActionScript 3.0 |
| Player-Version : | Flash Player 9 |
Gibt die maximale horizontale Auflösung des Bildschirms an. Der Serverstring lautet R (und gibt die Breite und Höhe des Bildschirms zurück).
Implementierung
public static function get screenResolutionX():Number
Siehe auch
screenResolutionY:Number [read-only]
| Sprachversion : | ActionScript 3.0 |
| Player-Version : | Flash Player 9 |
Gibt die maximale vertikale Auflösung des Bildschirms an. Der Serverstring lautet R (und gibt die Breite und Höhe des Bildschirms zurück).
Implementierung
public static function get screenResolutionY():Number
Siehe auch
serverString:String [read-only]
| Sprachversion : | ActionScript 3.0 |
| Player-Version : | Flash Player 9 |
Ein URL-codierter String, der die Werte für jede Capabilities-Eigenschaft angibt.
Im folgenden Beispiel ist ein URL-codierter 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():String
Siehe auch
version:String [read-only]
| Sprachversion : | ActionScript 3.0 |
| Player-Version : | Flash Player 9 |
Gibt die Plattform und Version von Flash Player an. Das Format der Versionsnummer sieht folgendermaßen aus: Plattform majorVersion, minorVersion, buildNumber, internalBuildNumber. Mögliche Werte für die Plattform sind "WIN", "MAC" und "UNIX". Es folgen einige Beispiele für die Versionsangabe:
WIN 9,0,0,0 // Flash Player 9 für Windows
MAC 7,0,25,0 // Flash Player 7 für
Macintosh UNIX 5,0,55,0 // Flash Player 5 für UNIX
Der Serverstring lautet V.
Implementierung
public static function get version():String
Siehe auch
Im folgenden Beispiel wird einfach der im flash.system.Capabilities-Objekt gefundene Wert mit mehreren Aufrufen von
trace() ausgegeben.
package {
import flash.display.Sprite;
import flash.system.Capabilities;
public class CapabilitiesExample extends Sprite {
public function CapabilitiesExample() {
showCapabilities();
}
private function showCapabilities():void {
trace("avHardwareDisable: " + Capabilities.avHardwareDisable);
trace("hasAccessibility: " + Capabilities.hasAccessibility);
trace("hasAudio: " + Capabilities.hasAudio);
trace("hasAudioEncoder: " + Capabilities.hasAudioEncoder);
trace("hasEmbeddedVideo: " + Capabilities.hasEmbeddedVideo);
trace("hasMP3: " + Capabilities.hasMP3);
trace("hasPrinting: " + Capabilities.hasPrinting);
trace("hasScreenBroadcast: " + Capabilities.hasScreenBroadcast);
trace("hasScreenPlayback: " + Capabilities.hasScreenPlayback);
trace("hasStreamingAudio: " + Capabilities.hasStreamingAudio);
trace("hasVideoEncoder: " + Capabilities.hasVideoEncoder);
trace("isDebugger: " + Capabilities.isDebugger);
trace("language: " + Capabilities.language);
trace("localFileReadDisable: " + Capabilities.localFileReadDisable);
trace("manufacturer: " + Capabilities.manufacturer);
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("version: " + Capabilities.version);
}
}
}
© 2004-2007 Adobe Systems Incorporated. All rights reserved.
Fri Oct 12 2007, 2:03 AM GMT-07:00
Aktuelle Seite: http://livedocs.adobe.com/flash/9.0_de/ActionScriptLangRefV3/flash/system/Capabilities.html