| Version du langage: | ActionScript 3.0 |
| Versions du moteur d'exécution: | AIR 1.0 Flash Player 9 |
La classe Capabilities fournit des propriétés qui décrivent le système et le lecteur qui hébergent un fichier SWF. Par exemple, l'écran d'un téléphone portable peut faire 100 pixels de large, en noir et blanc, alors qu'un écran d'ordinateur peut être de 1 000 pixels carrés et en couleurs. En utilisant l'objet Capabilities pour déterminer le type de périphérique de l'utilisateur, vous pouvez fournir du contenu à autant d'utilisateurs que possible. Lorsque vous connaissez les fonctionnalités du périphérique, vous pouvez demander au serveur d'envoyer les fichiers SWF ou demander au fichier SWF de modifier sa présentation.
Vous pouvez envoyer des informations sur les capacités, qui sont stockées dans la propriété Capabilities.serverString en tant que chaîne codée au format URL, à l'aide de la méthode HTTP GET ou POST. L'exemple suivant présente une chaîne serveur pour un ordinateur prenant en charge le format MP3 et disposant d'une résolution de 1 600 x 1 200 pixels, qui exécute Windows XP et où un IME est installé :
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
Le tableau suivant dresse la liste des propriétés de la classe Capabilities et des chaînes serveur correspondantes :
| Propriété de la classe Capabilities | Chaîne serveur |
|---|
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
|
Toutes les propriétés de la classe Capabilities sont accessibles en lecture seule.
Consulter les exemples
avHardwareDisable:Boolean [lecture seule]
| Version du langage: | ActionScript 3.0 |
| Versions du moteur d'exécution: | AIR 1.0 Flash Player 9 |
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.
Implémentation public static function get avHardwareDisable():BooleanVoir aussi
hasAccessibility:Boolean [lecture seule]
| Version du langage: | ActionScript 3.0 |
| Versions du moteur d'exécution: | AIR 1.0 Flash Player 9 |
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.
Implémentation public static function get hasAccessibility():BooleanVoir aussi
hasAudio:Boolean [lecture seule]
| Version du langage: | ActionScript 3.0 |
| Versions du moteur d'exécution: | AIR 1.0 Flash Player 9 |
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.
Implémentation public static function get hasAudio():BooleanhasAudioEncoder:Boolean [lecture seule]
| Version du langage: | ActionScript 3.0 |
| Versions du moteur d'exécution: | AIR 1.0 Flash Player 9 |
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.
Implémentation public static function get hasAudioEncoder():BooleanhasEmbeddedVideo:Boolean [lecture seule]
| Version du langage: | ActionScript 3.0 |
| Versions du moteur d'exécution: | AIR 1.0 Flash Player 9 |
Spécifie si le système prend en charge (true) ou non (false) la vidéo incorporée. La chaîne serveur est EV.
Implémentation public static function get hasEmbeddedVideo():BooleanhasIME:Boolean [lecture seule]
| Version du langage: | ActionScript 3.0 |
| Versions du moteur d'exécution: | AIR 1.0 Flash Player 9 |
Spécifie si un IME est installé (true) ou non (false) sur le système. La chaîne serveur est IME.
Implémentation public static function get hasIME():BooleanVoir aussi
hasMP3:Boolean [lecture seule]
| Version du langage: | ActionScript 3.0 |
| Versions du moteur d'exécution: | AIR 1.0 Flash Player 9 |
Spécifie si le système est équipé (true) ou non (false) d'un décodeur MP3. La chaîne serveur est MP3.
Implémentation public static function get hasMP3():BooleanVoir aussi
hasPrinting:Boolean [lecture seule]
| Version du langage: | ActionScript 3.0 |
| Versions du moteur d'exécution: | AIR 1.0 Flash Player 9 |
Spécifie si le système prend en charge (true) ou non (false) l'impression. La chaîne serveur est PR.
Implémentation public static function get hasPrinting():BooleanhasScreenBroadcast:Boolean [lecture seule]
| Version du langage: | ActionScript 3.0 |
| Versions du moteur d'exécution: | AIR 1.0 Flash Player 9 |
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.
Implémentation public static function get hasScreenBroadcast():BooleanhasScreenPlayback:Boolean [lecture seule]
| Version du langage: | ActionScript 3.0 |
| Versions du moteur d'exécution: | AIR 1.0 Flash Player 9 |
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.
Implémentation public static function get hasScreenPlayback():BooleanhasStreamingAudio:Boolean [lecture seule]
| Version du langage: | ActionScript 3.0 |
| Versions du moteur d'exécution: | AIR 1.0 Flash Player 9 |
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.
Implémentation public static function get hasStreamingAudio():BooleanhasStreamingVideo:Boolean [lecture seule]
| Version du langage: | ActionScript 3.0 |
| Versions du moteur d'exécution: | AIR 1.0 Flash Player 9 |
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.
Implémentation public static function get hasStreamingVideo():BooleanhasTLS:Boolean [lecture seule]
| Version du langage: | ActionScript 3.0 |
| Versions du moteur d'exécution: | AIR 1.0 Flash Player 9 |
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.
Implémentation public static function get hasTLS():BooleanVoir aussi
hasVideoEncoder:Boolean [lecture seule]
| Version du langage: | ActionScript 3.0 |
| Versions du moteur d'exécution: | AIR 1.0 Flash Player 9 |
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.
Implémentation public static function get hasVideoEncoder():BooleanisDebugger:Boolean [lecture seule]
| Version du langage: | ActionScript 3.0 |
| Versions du moteur d'exécution: | AIR 1.0 Flash Player 9 |
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.
Implémentation public static function get isDebugger():BooleanisEmbeddedInAcrobat:Boolean [lecture seule]
| Version du langage: | ActionScript 3.0 |
| Versions du moteur d'exécution: | Flash Player 9.0.127.0, AIR 1.1 |
Indique si le lecteur est intégré dans un fichier PDF ouvert dans Acrobat 9.0 ou version ultérieure (true) ou non (false ).
Implémentation public static function get isEmbeddedInAcrobat():BooleanVoir aussi
language:String [lecture seule]
| Version du langage: | ActionScript 3.0 |
| Versions du moteur d'exécution: | AIR 1.0 Flash Player 9 |
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 :
| Langue | Valeur |
|---|
| Tchèque |
cs
|
| Danois |
da
|
| Néerlandais |
nl
|
| Anglais |
fr
|
| Finnois |
fi
|
| Français |
fr
|
| Allemand |
de
|
| Hongrois |
hu
|
| Italien |
it
|
| Japonais |
ja
|
| Coréen |
ko
|
| Norvégien |
no
|
| Autre/inconnu |
xu
|
| Polonais |
pl
|
| Portugais |
pt
|
| Russe |
ru
|
| Chinois simplifié |
zh-CN
|
| Espagnol |
es
|
| Suédois |
sv
|
| Chinois traditionnel |
zh-TW
|
| Turc |
tr
|
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.
Implémentation public static function get language():StringVoir aussi
Exemple
Dans l'exemple suivant, le contenu qui s'affiche dépend de la langue du système d'exploitation de l'utilisateur.
La propriété Capabilities.language renvoie le code de langue ISO 639-1 (dans l'exemple, « en » pour l'anglais). L'instruction switch vérifie le code de langue et définit le contenu du champ de texte myTextField sur un message d'accueil propre à la langue. Si le code de langue n'est pas pris en charge par l'exemple, la chaîne d'erreur par défaut est renvoyée.
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:Array [lecture seule]
| Version du langage: | ActionScript 3.0 |
| Versions du moteur d'exécution: | AIR 1.1 |
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 séparateur tiret (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.
Implémentation public static function get languages():ArraylocalFileReadDisable:Boolean [lecture seule]
| Version du langage: | ActionScript 3.0 |
| Versions du moteur d'exécution: | AIR 1.0 Flash Player 9 |
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.
Implémentation public static function get localFileReadDisable():BooleanVoir aussi
manufacturer:String [lecture seule]
| Version du langage: | ActionScript 3.0 |
| Versions du moteur d'exécution: | AIR 1.0 Flash Player 9 |
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.
Implémentation public static function get manufacturer():StringmaxLevelIDC:String [lecture seule]
| Version du langage: | ActionScript 3.0 |
| Versions du moteur d'exécution: | Flash Player 10, AIR 1.5 |
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.
Implémentation public static function get maxLevelIDC():Stringos:String [lecture seule]
| Version du langage: | ActionScript 3.0 |
| Versions du moteur d'exécution: | AIR 1.0 Flash Player 9 |
Spécifie le système d'exploitation actuel. La propriété os peut renvoyer les chaînes suivantes : « Windows XP », « Windows 2000 », « Windows NT », « Windows 98/ME », « Windows 95 », « Windows CE » (disponible uniquement en version Flash Player SDK et pas en version de bureau), « Linux » et « Mac OS X.Y.Z » (où X.Y.Z correspond au numéro de version, par exemple, Mac OS 10.5.2). La chaîne serveur est OS.
Implémentation public static function get os():StringpixelAspectRatio:Number [lecture seule]
| Version du langage: | ActionScript 3.0 |
| Versions du moteur d'exécution: | AIR 1.0 Flash Player 9 |
Indique les proportions en pixel de l'écran. La chaîne serveur est AR.
Implémentation public static function get pixelAspectRatio():NumberplayerType:String [lecture seule]
| Version du langage: | ActionScript 3.0 |
| Versions du moteur d'exécution: | AIR 1.0 Flash Player 9 |
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 externe 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.
Implémentation public static function get playerType():StringscreenColor:String [lecture seule]
| Version du langage: | ActionScript 3.0 |
| Versions du moteur d'exécution: | AIR 1.0 Flash Player 9 |
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.
Implémentation public static function get screenColor():StringscreenDPI:Number [lecture seule]
| Version du langage: | ActionScript 3.0 |
| Versions du moteur d'exécution: | AIR 1.0 Flash Player 9 |
Spécifie la résolution en points par pouce (dpi) de l'écran, en pixels. La chaîne serveur est DP.
Implémentation public static function get screenDPI():NumberscreenResolutionX:Number [lecture seule]
| Version du langage: | ActionScript 3.0 |
| Versions du moteur d'exécution: | AIR 1.0 Flash Player 9 |
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 indique uniquement le moniteur principal.
Implémentation public static function get screenResolutionX():NumberVoir aussi
screenResolutionY:Number [lecture seule]
| Version du langage: | ActionScript 3.0 |
| Versions du moteur d'exécution: | AIR 1.0 Flash Player 9 |
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 indique uniquement le moniteur principal.
Implémentation public static function get screenResolutionY():NumberVoir aussi
serverString:String [lecture seule]
| Version du langage: | ActionScript 3.0 |
| Versions du moteur d'exécution: | AIR 1.0 Flash Player 9 |
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
Implémentation public static function get serverString():StringVoir aussi
version:String [lecture seule]
| Version du langage: | ActionScript 3.0 |
| Versions du moteur d'exécution: | AIR 1.0 Flash Player 9 |
Indique les informations de version et de plate-forme de Flash Player ou Adobe® AIR. Le format du numéro de version est : platform majorVersion, minorVersion, buildNumber, internalBuildNumber. Les valeurs possibles pour platform sont les suivantes : "WIN", "MAC" et "UNIX". 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
La chaîne serveur est V.
Implémentation public static function get version():StringVoir aussi
L'exemple suivant renvoie simplement les valeurs de l'objet flash.system.Capabilities à l'aide de plusieurs appels de
trace().
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-2008 Adobe Systems Incorporated. All rights reserved.
Thu Jan 8 2009, 03:00 AM -08:00