| Version du langage : | ActionScript 3.0 |
| Version du lecteur : | 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 les informations sur les capacités du lecteur, 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 donne la liste des propriétés ActionScript possibles et des chaînes serveur correspondantes :
| Propriété ActionScript | 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 |
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 |
| Version du lecteur : | 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.
Implémentation
public static function get avHardwareDisable():Boolean
Voir aussi
hasAccessibility:Boolean [lecture-seule]
| Version du langage : | ActionScript 3.0 |
| Version du lecteur : | Flash Player 9 |
Spécifie si le lecteur s'exécute dans un environnement qui prend en charge (true) ou non (false) les communications avec les fonctions d'accessibilité. La chaîne serveur est ACC.
Implémentation
public static function get hasAccessibility():Boolean
Voir aussi
hasAudio:Boolean [lecture-seule]
| Version du langage : | ActionScript 3.0 |
| Version du lecteur : | Flash Player 9 |
Spécifie si le lecteur s'exécute sur un système qui dispose 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():Boolean
hasAudioEncoder:Boolean [lecture-seule]
| Version du langage : | ActionScript 3.0 |
| Version du lecteur : | Flash Player 9 |
Spécifie si le lecteur 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():Boolean
hasEmbeddedVideo:Boolean [lecture-seule]
| Version du langage : | ActionScript 3.0 |
| Version du lecteur : | Flash Player 9 |
Spécifie si le lecteur s'exécute sur un système qui prend en charge (true) ou non (false) l'intégration de vidéos. La chaîne serveur est EV.
Implémentation
public static function get hasEmbeddedVideo():Boolean
hasIME:Boolean [lecture-seule]
| Version du langage : | ActionScript 3.0 |
| Version du lecteur : | Flash Player 9 |
Spécifie si le lecteur s'exécute sur un système qui dispose (true) ou non (false) d'un éditeur de méthode d'entrée (IME). La chaîne serveur est IME.
Implémentation
public static function get hasIME():Boolean
Voir aussi
hasMP3:Boolean [lecture-seule]
| Version du langage : | ActionScript 3.0 |
| Version du lecteur : | Flash Player 9 |
Spécifie si le lecteur s'exécute sur un système qui dispose (true) ou non (false) d'un décodeur MP3. La chaîne serveur est MP3.
Implémentation
public static function get hasMP3():Boolean
Voir aussi
hasPrinting:Boolean [lecture-seule]
| Version du langage : | ActionScript 3.0 |
| Version du lecteur : | Flash Player 9 |
Spécifie si le lecteur s'exécute sur un système qui prend en charge (true) ou non (false) l'impression. La chaîne serveur est PR.
Implémentation
public static function get hasPrinting():Boolean
hasScreenBroadcast:Boolean [lecture-seule]
| Version du langage : | ActionScript 3.0 |
| Version du lecteur : | Flash Player 9 |
Spécifie si le lecteur 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():Boolean
hasScreenPlayback:Boolean [lecture-seule]
| Version du langage : | ActionScript 3.0 |
| Version du lecteur : | Flash Player 9 |
Spécifie si le lecteur 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():Boolean
hasStreamingAudio:Boolean [lecture-seule]
| Version du langage : | ActionScript 3.0 |
| Version du lecteur : | Flash Player 9 |
Spécifie si le lecteur 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():Boolean
hasStreamingVideo:Boolean [lecture-seule]
| Version du langage : | ActionScript 3.0 |
| Version du lecteur : | Flash Player 9 |
Spécifie si le lecteur 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():Boolean
hasTLS:Boolean [lecture-seule]
| Version du langage : | ActionScript 3.0 |
| Version du lecteur : | Flash Player 9 |
Spécifie si le lecteur figure sur un système qui prend en charge les sockets SSL natifs à l'aide de NetConnection (true) ou non (false). La chaîne serveur est TLS.
Implémentation
public static function get hasTLS():Boolean
Voir aussi
hasVideoEncoder:Boolean [lecture-seule]
| Version du langage : | ActionScript 3.0 |
| Version du lecteur : | Flash Player 9 |
Spécifie si le lecteur 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():Boolean
isDebugger:Boolean [lecture-seule]
| Version du langage : | ActionScript 3.0 |
| Version du lecteur : | Flash Player 9 |
Spécifie si le lecteur est une version de débogage (true) ou une version officielle (false). La chaîne serveur est DEB.
Implémentation
public static function get isDebugger():Boolean
language:String [lecture-seule]
| Version du langage : | ActionScript 3.0 |
| Version du lecteur : | Flash Player 9 |
Indique le code de langue du système sur lequel s'exécute le lecteur. 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 | en |
| 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 |
La chaîne serveur est L.
Implémentation
public static function get language():String
Exemple
Dans l'exemple suivant, un contenu différent est affiché, selon 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, une 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);
}
}
}
localFileReadDisable:Boolean [lecture-seule]
| Version du langage : | ActionScript 3.0 |
| Version du lecteur : | 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. Si la propriété est définie sur true, Flash Player ne peut pas lire de fichiers (y compris le premier fichier SWF de démarrage de Flash Player) 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 sera é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():Boolean
Voir aussi
manufacturer:String [lecture-seule]
| Version du langage : | ActionScript 3.0 |
| Version du lecteur : | Flash Player 9 |
Spécifie l'éditeur de Flash Player, au format « Adobe NomSE ». 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():String
os:String [lecture-seule]
| Version du langage : | ActionScript 3.0 |
| Version du lecteur : | 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 seulement en version Flash Player SDK, et pas en version de bureau), « Linux » et « MacOS ». La chaîne serveur est OS.
Implémentation
public static function get os():String
pixelAspectRatio:Number [lecture-seule]
| Version du langage : | ActionScript 3.0 |
| Version du lecteur : | Flash Player 9 |
Indique les proportions en pixel de l'écran. La chaîne serveur est AR.
Implémentation
public static function get pixelAspectRatio():Number
playerType:String [lecture-seule]
| Version du langage : | ActionScript 3.0 |
| Version du lecteur : | Flash Player 9 |
Définit le type de lecteur. Cette propriété peut avoir l'une des valeurs suivantes :
"StandAlone" pour le lecteur Flash Player autonome.
"External" pour le lecteur Flash Player autonome ou en mode test
"PlugIn" pour le plug-in du navigateur Flash Player
"ActiveX" pour le contrôle ActiveX de Flash Player utilisé par Microsoft Internet Explorer
La chaîne serveur est PT.
Implémentation
public static function get playerType():String
screenColor:String [lecture-seule]
| Version du langage : | ActionScript 3.0 |
| Version du lecteur : | 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():String
screenDPI:Number [lecture-seule]
| Version du langage : | ActionScript 3.0 |
| Version du lecteur : | 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():Number
screenResolutionX:Number [lecture-seule]
| Version du langage : | ActionScript 3.0 |
| Version du lecteur : | 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).
Implémentation
public static function get screenResolutionX():Number
Voir aussi
screenResolutionY:Number [lecture-seule]
| Version du langage : | ActionScript 3.0 |
| Version du lecteur : | 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).
Implémentation
public static function get screenResolutionY():Number
Voir aussi
serverString:String [lecture-seule]
| Version du langage : | ActionScript 3.0 |
| Version du lecteur : | 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():String
Voir aussi
version:String [lecture-seule]
| Version du langage : | ActionScript 3.0 |
| Version du lecteur : | Flash Player 9 |
Spécifie la plate-forme de Flash Player et des informations sur la version. Le format du numéro de version est : platform majorVersion, minorVersion, buildNumber, internalBuildNumber. Les valeurs possibles pour platform are "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
UNIX 5,0,55,0 // Flash Player 5 for UNIX
La chaîne serveur est V.
Implémentation
public static function get version():String
Voir 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-2007 Adobe Systems Incorporated. Tous droits réservés.
Fri Oct 12 2007, 2:53 AM GMT-07:00
Page en cours: http://livedocs.adobe.com/flash/9.0_fr/ActionScriptLangRefV3/flash/system/Capabilities.html