Packageflash.system
Classepublic final class Capabilities
HéritageCapabilities Inheritance Object

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é ActionScriptChaîne serveur
avHardwareDisableAVD
hasAccessibilityACC
hasAudioA
hasAudioEncoderAE
hasEmbeddedVideoEV
hasIMEIME
hasMP3MP3
hasPrintingPR
hasScreenBroadcastSB
hasScreenPlaybackSP
hasStreamingAudioSA
hasStreamingVideoSV
hasTLSTLS
hasVideoEncoderVE
isDebuggerDEB
languageL
localFileReadDisableLFD
manufacturerM
osOS
pixelAspectRatioAR
playerTypePT
screenColorCOL
screenDPIDP
screenResolutionXR
screenResolutionYR
versionV

Toutes les propriétés de la classe Capabilities sont accessibles en lecture seule.

Consulter les exemples

Voir aussi

Utilisation de la classe Capabilities


Propriétés publiques
 PropriétéDéfini par
  avHardwareDisable : Boolean
[static] [lecture-seule] 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.
Capabilities
 Inheritedconstructor : Object
Référence à l'objet de classe ou à la fonction constructeur d'une occurrence donnée d'un objet.
Object
  hasAccessibility : Boolean
[static] [lecture-seule] 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é.
Capabilities
  hasAudio : Boolean
[static] [lecture-seule] Spécifie si le lecteur s'exécute sur un système qui dispose de fonctionnalités audio.
Capabilities
  hasAudioEncoder : Boolean
[static] [lecture-seule] Spécifie si le lecteur peut (true) ou ne peut pas (false) coder un flux audio continu, en provenance d'un microphone par exemple.
Capabilities
  hasEmbeddedVideo : Boolean
[static] [lecture-seule] 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.
Capabilities
  hasIME : Boolean
[static] [lecture-seule] 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).
Capabilities
  hasMP3 : Boolean
[static] [lecture-seule] Spécifie si le lecteur s'exécute sur un système qui dispose (true) ou non (false) d'un décodeur MP3.
Capabilities
  hasPrinting : Boolean
[static] [lecture-seule] Spécifie si le lecteur s'exécute sur un système qui prend en charge (true) ou non (false) l'impression.
Capabilities
  hasScreenBroadcast : Boolean
[static] [lecture-seule] 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.
Capabilities
  hasScreenPlayback : Boolean
[static] [lecture-seule] Spécifie si le lecteur prend en charge (true) ou non (false) la lecture d'applications de diffusion à l'écran avec Flash Media Server.
Capabilities
  hasStreamingAudio : Boolean
[static] [lecture-seule] Spécifie si le lecteur peut (true) ou ne peut pas (false) lire des données audio en diffusion continue.
Capabilities
  hasStreamingVideo : Boolean
[static] [lecture-seule] Spécifie si le lecteur peut (true) ou ne peut pas (false) lire des données vidéo en diffusion continue.
Capabilities
  hasTLS : Boolean
[static] [lecture-seule] 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).
Capabilities
  hasVideoEncoder : Boolean
[static] [lecture-seule] 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.
Capabilities
  isDebugger : Boolean
[static] [lecture-seule] Spécifie si le lecteur est une version de débogage (true) ou une version officielle (false).
Capabilities
  language : String
[static] [lecture-seule] Indique le code de langue du système sur lequel s'exécute le lecteur.
Capabilities
  localFileReadDisable : Boolean
[static] [lecture-seule] Spécifie si l'accès en lecture au disque dur de l'utilisateur a été interdit (true) ou autorisé (false) par l'administrateur.
Capabilities
  manufacturer : String
[static] [lecture-seule] Spécifie l'éditeur de Flash Player, au format « Adobe NomSE ».
Capabilities
  os : String
[static] [lecture-seule] Spécifie le système d'exploitation actuel.
Capabilities
  pixelAspectRatio : Number
[static] [lecture-seule] Indique les proportions en pixel de l'écran.
Capabilities
  playerType : String
[static] [lecture-seule] Définit le type de lecteur.
Capabilities
 Inheritedprototype : Object
[static] Référence à l’objet prototype d’un objet de classe ou fonction.
Object
  screenColor : String
[static] [lecture-seule] Permet de spécifier la couleur de l'écran.
Capabilities
  screenDPI : Number
[static] [lecture-seule] Spécifie la résolution en points par pouce (dpi) de l'écran, en pixels.
Capabilities
  screenResolutionX : Number
[static] [lecture-seule] Spécifie la résolution horizontale maximale de l'écran.
Capabilities
  screenResolutionY : Number
[static] [lecture-seule] Spécifie la résolution verticale maximale de l'écran.
Capabilities
  serverString : String
[static] [lecture-seule] Chaîne codée au format URL qui spécifie des valeurs pour chaque propriété Capabilities.
Capabilities
  version : String
[static] [lecture-seule] Spécifie la plate-forme de Flash Player et des informations sur la version.
Capabilities
Méthodes publiques
 MéthodeDéfini par
 Inherited
Indique si la propriété spécifiée d'un objet est définie.
Object
 Inherited
Indique si une occurrence de la classe Object figure dans la chaîne de prototype de l'objet spécifié en tant que paramètre.
Object
 Inherited
Indique si la propriété spécifiée existe et est énumérable.
Object
 Inherited
Définit la disponibilité d'une propriété dynamique pour les opérations en boucle.
Object
 Inherited
Renvoie la représentation sous forme de chaîne de l'objet spécifié.
Object
 Inherited
Renvoie la valeur primitive de l'objet spécifié.
Object
Détails des propriétés
avHardwareDisablepropriété
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

hasAccessibilitypropriété 
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

hasAudiopropriété 
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
hasAudioEncoderpropriété 
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
hasEmbeddedVideopropriété 
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
hasIMEpropriété 
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

hasMP3propriété 
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

hasPrintingpropriété 
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
hasScreenBroadcastpropriété 
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
hasScreenPlaybackpropriété 
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
hasStreamingAudiopropriété 
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
hasStreamingVideopropriété 
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
hasTLSpropriété 
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

hasVideoEncoderpropriété 
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
isDebuggerpropriété 
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
languagepropriété 
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 :

LangueValeur
Tchèquecs
Danoisda
Néerlandaisnl
Anglaisen
Finnoisfi
Françaisfr
Allemandde
Hongroishu
Italienit
Japonaisja
Coréenko
Norvégienno
Autre/inconnuxu
Polonaispl
Portugaispt
Russeru
Chinois simplifiézh-CN
Espagnoles
Suédoissv
Chinois traditionnelzh-TW
Turctr

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);
        }
    }
}
localFileReadDisablepropriété 
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

manufacturerpropriété 
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
ospropriété 
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
pixelAspectRatiopropriété 
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
playerTypepropriété 
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 :

La chaîne serveur est PT.


Implémentation
    public static function get playerType():String
screenColorpropriété 
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
screenDPIpropriété 
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
screenResolutionXpropriété 
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

screenResolutionYpropriété 
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

serverStringpropriété 
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

versionpropriété 
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

Exemples Utilisation des exemples
CapabilitiesExample.as

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




 

M'envoyer un message électronique lorsque des commentaires sont ajoutés à cette page | Rapport de commentaire

Page en cours: http://livedocs.adobe.com/flash/9.0_fr/ActionScriptLangRefV3/flash/system/Capabilities.html