Capabilities  - AS3

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.

Verwandte API-Elemente

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.

Gibt an, ob das System die Kommunikation über Eingabehilfen zur Barrierefreiheit unterstützt (true) oder nicht (false). Der Serverstring ist ACC.

Verwandte API-Elemente

Gibt an, ob das System über Audiofunktionen verfügt. Diese Eigenschaft ist immer auf true gesetzt. Der Serverstring ist A.

Gibt an, ob das System einen Audiostream, der beispielsweise von einem Mikrofon stammt, kodieren kann (true) oder nicht (false). Der Serverstring ist AE.

Gibt an, ob das System eingebettetes Video unterstützt (true) oder nicht (false). Der Serverstring ist EV.

Gibt an, ob auf dem System ein Eingabemethoden-Editor (IME) installiert ist (true) oder nicht (false). Der Serverstring ist IME.

Verwandte API-Elemente

Gibt an, ob das System über einen MP3-Decoder verfügt (true) oder nicht (false). Der Serverstring ist MP3.

Gibt an, ob das System das Drucken unterstützt (true) oder nicht (false). Der Serverstring ist PR.

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.

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.

Gibt an, ob das System Streamingsound wiedergeben kann (true) oder nicht (false). Der Serverstring ist SA.

Gibt an, ob das System Streaming-Video wiedergeben kann (true) oder nicht (false). Der Serverstring ist SV.

Gibt an, ob das System native SSL-Sockets über NetConnection unterstützt werden (true) oder nicht (false). Der Serverstring ist TLS.

Verwandte API-Elemente

Gibt an, ob das System einen Videostream, der beispielsweise von einer Webkamera stammt, kodieren (true) oder nicht kodieren (false) kann. Der Serverstring ist VE.

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.

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).

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:

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.

Verwandte API-Elemente

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

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.

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.

Verwandte API-Elemente

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.

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.

Gibt das aktuelle Betriebssystem an. Die os-Eigenschaft kann die folgenden Strings zurückgeben:

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.

Gibt das Pixelseitenverhältnis des Bildschirms an. Der Serverstring ist AR.

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, wobei Capabilities.playerType auf „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.

Gibt die Bildschirmfarbe an. Dieser Eigenschaft können die Werte "color", "gray" (Graustufen) oder "bw" (schwarzweiß) zugeordnet werden. Der Serverstring ist COL.

Gibt den dpi-Wert der Bildschirmauflösung in Pixeln an. Der Serverstring ist DP.

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.

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.

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

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

Gibt an, ob das System die Ausführung von 32-Bit-Prozessen unterstützt. Der Serverstring ist PR32.

Gibt an, ob das System die Ausführung von 64-Bit-Prozessen unterstützt. Der Serverstring ist PR64.

Gibt den Typ des unterstützten Touchscreens an, falls vorhanden. Werte sind in der flash.system.TouchscreenType-Klasse definiert.

Verwandte API-Elemente

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

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.

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

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:

Parameter

Verwandte API-Elemente

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