Capabilities  - AS3

Spécifie si l’accès à la caméra et au microphone de l’utilisateur a été interdit (true) ou autorisé (false) par l’administrateur. La chaîne serveur est AVD.

Pour le contenu dans Adobe AIR™, cette propriété s’applique uniquement au contenu des sandboxes de sécurité autres que le sandbox de sécurité de l’application. Le contenu du sandbox de sécurité de l’application peut toujours accéder au microphone et à la caméra de l’utilisateur.

Eléments de l’API associés

Spécifie l’architecture de l’unité centrale de traitement (CPU) actuelle. La propriété cpuArchitecture peut renvoyer les chaînes suivantes : PowerPC, x86, SPARC et ARM. La chaîne serveur est ARCH.

Spécifie si le système prend en charge (true) ou non (false) la communication avec des aides d’accessibilité. La chaîne serveur est ACC.

Eléments de l’API associés

Spécifie si le système est doté de fonctionnalités audio. Cette propriété est toujours définie sur true. La chaîne serveur est A.

Spécifie si le système peut (true) ou ne peut pas (false) coder un flux audio continu, en provenance d’un microphone par exemple. La chaîne serveur est AE.

Spécifie si le système prend en charge (true) ou non (false) la vidéo incorporée. La chaîne serveur est EV.

Spécifie si un IME est installé (true) ou non (false) sur le système. La chaîne serveur est IME.

Plus d’exemples

Eléments de l’API associés

Spécifie si le système est équipé (true) ou non (false) d’un décodeur MP3. La chaîne serveur est MP3.

Plus d’exemples

Spécifie si le système prend en charge (true) ou non (false) l’impression. La chaîne serveur est PR.

Spécifie si le système prend en charge (true) ou non (false) le développement d’applications de diffusion à l’écran avec Flash Media Server. La chaîne serveur est SB.

Spécifie si le système prend en charge (true) ou non (false) la lecture d’applications de diffusion à l’écran avec Flash Media Server. La chaîne serveur est SP.

Spécifie si le système peut (true) ou ne peut pas (false) lire des données audio en diffusion continue. La chaîne serveur est SA.

Spécifie si le système peut (true) ou ne peut pas (false) lire des données vidéo en diffusion continue. La chaîne serveur est SV.

Spécifie si le système prend en charge les sockets SSL natifs via NetConnection (true) ou non (false). La chaîne serveur est TLS.

Eléments de l’API associés

Spécifie si le système peut (true) ou ne peut pas (false) coder un flux vidéo continu, en provenance d’une caméra Web par exemple. La chaîne serveur est VE.

Spécifie si le système est une version débogueur (true) ou une version officielle (false). La chaîne serveur est DEB. Cette propriété est définie sur true lorsqu’elle est exécutée dans la version débogueur de Flash Player ou l’application de débogage du lanceur AIR.

Indique si le moteur d’exécution de Flash est intégré dans un fichier PDF ouvert dans Acrobat 9.0 ou version ultérieure (true) ou non (false).

Plus d’exemples

Spécifie le code de langue du système sur lequel s’exécute le contenu. La langue est spécifiée sous forme de code de langue à deux lettres minuscules conformément à ISO 639-1. Pour le Chinois, un code de pays à deux lettres majuscules, conformément à ISO 3166, permet de faire la distinction entre le Chinois traditionnel et le Chinois simplifié. Les codes de langue reposent sur les noms anglais de langue : par exemple, hu correspond au Hongrois (Hungarian).

Sur les systèmes en anglais, cette propriété renvoie uniquement le code de langue (en) et non pas le code du pays. Sur les systèmes Microsoft Windows, cette propriété renvoie la langue de l’interface utilisateur (UI), qui se rapporte à la langue utilisée pour les menus, boîtes de dialogue, messages d’erreur et fichiers d’aide. Le tableau suivant présente les valeurs possibles :

Remarque : la valeur de la propriété Capabilities.language est limitée aux valeurs possibles de cette liste. Du fait de cette restriction, les applications Adobe AIR doivent utiliser le premier élément du tableau Capabilities.languages pour connaître la langue d’interface utilisateur principale du système.

La chaîne serveur est L.

Plus d’exemples

Eléments de l’API associés

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

Tableau de chaînes contenant des informations sur les langues de l’interface utilisateur que l’utilisateur préfère, telles que définies dans le système d’exploitation. Les chaînes contiennent des balises de langue (et des informations de zone et de script, le cas échéant) définies par RFC4646 (http://www.ietf.org/rfc/rfc4646.txt) et utilisent le tiret comme séparateur (par exemple, "en-US" ou "ja-JP"). Les langues apparaissent dans le tableau par ordre de préférence, tel que déterminé par les paramètres du système d’exploitation.

Les informations régionales renvoyées dans les chaînes de paramètres régionaux varient en fonction des systèmes d’exploitation. Un système d’exploitation peut renvoyer "fr-fr", alors qu’un autre renvoyer simplement "fr".

La première entrée du tableau renvoyé possède généralement le même identifiant de langue principale que la propriété Capabilities.language. Par exemple, si Capabilities.languages[0] est définie sur "en-US", la propriété language est définie sur "en". Toutefois, si la propriété Capabilities.language est définie sur "xu" (spécifiant une langue inconnue), le premier élément de ce tableau diffère. Pour cette raison, la propriété Capabilities.languages[0] est en général plus précise que la propriété Capabilities.language.

La chaîne serveur est LS.

Plus d’exemples

Spécifie si l’accès en lecture au disque dur de l’utilisateur a été interdit (true) ou autorisé (false) par l’administrateur. Pour le contenu dans Adobe AIR, cette propriété s’applique uniquement au contenu des sandboxes de sécurité autres que le sandbox de sécurité de l’application (le contenu dans le sandbox de sécurité de l’application peut toujours lire à partir du système de fichiers). Si la propriété est définie sur true, Flash Player ne peut pas lire de fichiers (y compris le premier fichier de démarrage de Flash Player) sur le disque dur de l’utilisateur. Si cette propriété est définie sur true, le contenu AIR situé en dehors du sandbox de sécurité de l’application ne peut pas lire de fichiers sur le disque dur de l’utilisateur. Par exemple, toute tentative de lecture d’un fichier sur le disque dur de l’utilisateur à l’aide des méthodes de chargement échoue si cette propriété est définie sur true.

La lecture de bibliothèques partagées à l’exécution est également bloquée si cette propriété est définie sur true ; en revanche, la lecture d’objets partagés localement est autorisée, indépendamment de la valeur de cette propriété.

La chaîne serveur est LFD.

Eléments de l’API associés

Spécifie le fabricant de la version active de Flash Player ou du moteur d’exécution AIR, au format "Adobe OSName". La valeur de NomSE peut être "Windows", "Macintosh", "Linux" ou tout autre nom de système d’exploitation. La chaîne serveur est M.

N’utilisez pas la classe Capabilities.manufacturer pour déterminer une fonctionnalité en fonction du système d’exploitation si une propriété de fonctionnalité plus spécifique existe. Fonder une fonctionnalité sur le système d’exploitation est une mauvaise idée, car cela peut engendrer des problèmes si une application ne prend pas en compte tous les systèmes d’exploitation cible potentiels. En revanche, vous pouvez utiliser la propriété qui correspond à la fonctionnalité pour laquelle vous effectuez le test. Pour plus d’informations, voir la description de la classe Capabilities.

Récupère le plus haut niveau IDC H.264 pris en charge par matériel du client. L’exécution des fichiers multimédia à ce niveau est garantie. Toutefois, il est possible que leur qualité ne soit pas optimale s’ils sont exécutés au niveau le plus élevé. Cette propriété est utile pour les serveurs qui tentent de cibler les capacités d’un client. Grâce à cette propriété, un serveur peut déterminer le niveau de vidéo à envoyer au client.

La chaîne serveur est ML.

Spécifie le système d’exploitation actuel. La propriété os peut renvoyer les chaînes suivantes :

La chaîne serveur est OS.

N’utilisez pas la classe Capabilities.os pour déterminer une fonctionnalité en fonction du système d’exploitation si une propriété de fonctionnalité plus spécifique existe. Fonder une fonctionnalité sur le système d’exploitation est une mauvaise idée, car cela peut engendrer des problèmes si une application ne prend pas en compte tous les systèmes d’exploitation cible potentiels. En revanche, vous pouvez utiliser la propriété qui correspond à la fonctionnalité pour laquelle vous effectuez le test. Pour plus d’informations, voir la description de la classe Capabilities.

Indique le format de l’écran, en pixels. La chaîne serveur est AR.

Spécifie le type d’environnement d’exécution. Cette propriété peut avoir l’une des valeurs suivantes :

• "ActiveX" pour le contrôle ActiveX de Flash Player utilisé par Microsoft Internet Explorer
• "Desktop" pour le moteur d’exécution Adobe AIR (sauf pour le contenu SWF chargé par une page HTML, ayant Capabilities.playerType réglé sur "PlugIn")
• "External" pour le lecteur Flash Player autonome ou en mode test
• "PlugIn" pour le module du navigateur Flash Player (et pour le contenu SWF chargé par une page HTML dans une application AIR)
• "StandAlone" pour le lecteur Flash Player autonome.

La chaîne serveur est PT.

Permet de spécifier la couleur de l’écran. Cette propriété peut avoir la valeur "color", "gray" (pour niveaux de gris) ou "bw" (pour le noir et blanc). La chaîne serveur est COL.

Spécifie la résolution en points par pouce (dpi) de l’écran, en pixels. La chaîne serveur est DP.

Spécifie la résolution horizontale maximale de l’écran. La chaîne serveur est R (qui renvoie la largeur et la hauteur de l’écran). Cette propriété n’est pas mise à jour avec une résolution d’écran utilisateur mais indique uniquement la résolution au moment du démarrage de Flash Player ou d’une application Adobe AIR. De plus, la valeur spécifie uniquement l’écran principal.

Plus d’exemples

Spécifie la résolution verticale maximale de l’écran. La chaîne serveur est R (qui renvoie la largeur et la hauteur de l’écran). Cette propriété n’est pas mise à jour avec une résolution d’écran utilisateur mais indique uniquement la résolution au moment du démarrage de Flash Player ou d’une application Adobe AIR. De plus, la valeur spécifie uniquement l’écran principal.

Plus d’exemples

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

Chaîne codée au format URL qui spécifie des valeurs pour chaque propriété Capabilities.

L’exemple suivant illustre une chaîne de code 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

Plus d’exemples

Indique si le système prend en charge l’exécution des traitements 32 bits. La chaîne serveur est PR32.

Indique si le système prend en charge l’exécution des traitements 64 bits. La chaîne serveur est PR64.

Spécifie le type d’écran tactile pris en charge, le cas échéant. Les valeurs sont définies dans la classe flash.system.TouchscreenType.

Eléments de l’API associés

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

Indique les informations de version et de plateforme de Flash Player ou Adobe^® AIR^®. Le format du numéro de version est : platform majorVersion, minorVersion, buildNumber, internalBuildNumber. Les valeurs valides pour la propriété platform sont les suivantes : "WIN", "MAC", "LNX" et "AND". Vous trouverez ci-dessous quelques exemples d’informations sur la version :

	 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
	 

N’utilisez pas la classe Capabilities.version pour déterminer une fonctionnalité en fonction du système d’exploitation si une propriété de fonctionnalité plus spécifique existe. Fonder une fonctionnalité sur le système d’exploitation est une mauvaise idée, car cela peut engendrer des problèmes si une application ne prend pas en compte tous les systèmes d’exploitation cible potentiels. En revanche, vous pouvez utiliser la propriété qui correspond à la fonctionnalité pour laquelle vous effectuez le test. Pour plus d’informations, voir la description de la classe Capabilities.

La chaîne serveur est V.

Plus d’exemples

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

Indique si le système prend en charge le son multicanal d’un type spécifique. La classe flash.media.AudioDecoder énumère les types possibles.

Prise en charge du profil AIR : le son multicanaux est pris en charge uniquement sur les périphériques AIR pour TV. Sur tous les autres périphériques, cette méthode renvoie toujours false. Voir Prise en charge du profil AIR pour plus d’informations sur la prise en charge de l’API dans plusieurs profils.

Remarque : lorsque vous utilisez l’un des codecs audio DTS, il existe des scénarios dans lesquels hasMultiChannelAudio() renvoie true, mais où le son DTS n’est pas lu. Prenons par exemple un lecteur Blu-ray muni d’une sortie S/PDIF, raccordé à un ancien amplificateur. L’ancien d’amplificateur ne prend pas en charge DTS, mais S/PDIF ne dispose d’aucun protocole pour en informer le lecteur Blu-ray. Si le lecteur Blu-ray envoie le flux DTS à l’ancien amplificateur, l’utilisateur n’entend rien. Par conséquent, lors de l’utilisation de DTS, il est recommandé de fournir une interface utilisateur afin que l’utilisateur puisse indiquer si aucun son n’est en cours de lecture. Votre application peut ensuite utiliser un autre codec.

Le tableau ci-dessous présente la chaîne serveur pour chaque type de son multicanal :

Paramètres

Eléments de l’API associés

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