Package | flash.system |
Classe | public final class Capabilities |
Héritage | Capabilities Object |
Version du langage: | ActionScript 3.0 |
Versions du moteur d’exécution: | Flash Player 9, AIR 1.0, Flash Lite 4 |
Toutefois, certaines fonctionnalités d’Adobe AIR ne sont pas répertoriés comme propriétés de la classe Capabilities. Il s’agit de propriétés d’autres classes :
Propriété | Description |
---|---|
NativeApplication.supportsDockIcon
| Indique si le système d’exploitation prend en charge les icônes d’application dans le Dock. |
NativeApplication.supportsMenu
| Indique si le système d’exploitation prend en charge une barre de menus d’application globale. |
NativeApplication.supportsSystemTrayIcon
| Indique si le système d’exploitation prend en charge les icônes de la barre d’état système. |
NativeWindow.supportsMenu
| Indique si le système d’exploitation prend en charge les menus de fenêtre. |
NativeWindow.supportsTransparency
| Indique si le système d’exploitation prend en charge les fenêtres transparentes. |
N’utilisez pas les classes Capabilities.os
ou Capabilities.manufacturer
pour déterminer une fonctionnalité en fonction du système d’exploitation. 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.
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, disposant d’une résolution de 1 600 x 1 200 pixels, exécutant Windows XP où un Editeur de méthode d’entrée (IME) est installé et ne prenant pas en charge le son multicanal :
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&DD=f& DDP=f&DTS=f&DTE=f&DTH=f&DTM=f
Le tableau suivant dresse la liste des propriétés de la classe Capabilities et des chaînes serveur correspondantes : Il répertorie également les chaînes serveur pour les types de son multicanal.
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
|
prend en charge le son Dolby Digital
|
DD
|
prend en charge le son Dolby Digital Plus
|
DDP
|
prend en charge le son DTS
|
DTS
|
prend en charge le son DTS Express
|
DTE
|
prend en charge le son DTS-HD haute résolution
|
DTH
|
prend en charge le son DTS-HD Master
|
DTM
|
Il existe également une chaîne de serveur WD
qui indique si lz mode sans fenêtre est désactivé. Le mode sans fenêtre peut être désactivé dans Flash Player en raison d’incompatibilité avec le navigateur Web ou d’un paramètre utilisateur dans le fichier mms.cfg. Il n’existe pas de propriété Capabilities équivalente.
Toutes les propriétés de la classe Capabilities sont accessibles en lecture seule.
Plus d’exemples
Propriété | Défini par | ||
---|---|---|---|
avHardwareDisable : Boolean [statique] [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 | ||
constructor : Object
Référence à l’objet de classe ou à la fonction constructeur d’une occurrence donnée d’un objet. | Object | ||
cpuArchitecture : String [statique] [lecture seule]
Spécifie l’architecture de l’unité centrale de traitement (CPU) actuelle. | Capabilities | ||
hasAccessibility : Boolean [statique] [lecture seule]
Spécifie si le système prend en charge (true) ou non (false) la communication avec des aides d’accessibilité. | Capabilities | ||
hasAudio : Boolean [statique] [lecture seule]
Spécifie si le système est doté de fonctionnalités audio. | Capabilities | ||
hasAudioEncoder : Boolean [statique] [lecture seule]
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. | Capabilities | ||
hasEmbeddedVideo : Boolean [statique] [lecture seule]
Spécifie si le système prend en charge (true) ou non (false) la vidéo incorporée. | Capabilities | ||
hasIME : Boolean [statique] [lecture seule]
Spécifie si un IME est installé (true) ou non (false) sur le système. | Capabilities | ||
hasMP3 : Boolean [statique] [lecture seule]
Spécifie si le système est équipé (true) ou non (false) d’un décodeur MP3. | Capabilities | ||
hasPrinting : Boolean [statique] [lecture seule]
Spécifie si le système prend en charge (true) ou non (false) l’impression. | Capabilities | ||
hasScreenBroadcast : Boolean [statique] [lecture seule]
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. | Capabilities | ||
hasScreenPlayback : Boolean [statique] [lecture seule]
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. | Capabilities | ||
hasStreamingAudio : Boolean [statique] [lecture seule]
Spécifie si le système peut (true) ou ne peut pas (false) lire des données audio en diffusion continue. | Capabilities | ||
hasStreamingVideo : Boolean [statique] [lecture seule]
Spécifie si le système peut (true) ou ne peut pas (false) lire des données vidéo en diffusion continue. | Capabilities | ||
hasTLS : Boolean [statique] [lecture seule]
Spécifie si le système prend en charge les sockets SSL natifs via NetConnection (true) ou non (false). | Capabilities | ||
hasVideoEncoder : Boolean [statique] [lecture seule]
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. | Capabilities | ||
isDebugger : Boolean [statique] [lecture seule]
Spécifie si le système est une version débogueur (true) ou une version officielle (false). | Capabilities | ||
isEmbeddedInAcrobat : Boolean [statique] [lecture seule]
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). | Capabilities | ||
language : String [statique] [lecture seule]
Spécifie le code de langue du système sur lequel s’exécute le contenu. | Capabilities | ||
languages : Array [statique] [lecture seule]
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. | Capabilities | ||
localFileReadDisable : Boolean [statique] [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 [statique] [lecture seule]
Spécifie le fabricant de la version active de Flash Player ou du moteur d’exécution AIR, au format « Adobe OSName ». | Capabilities | ||
maxLevelIDC : String [statique] [lecture seule]
Récupère le plus haut niveau IDC H.264 pris en charge par matériel du client. | Capabilities | ||
os : String [statique] [lecture seule]
Spécifie le système d’exploitation actuel. | Capabilities | ||
pixelAspectRatio : Number [statique] [lecture seule]
Indique le format de l’écran, en pixels. | Capabilities | ||
playerType : String [statique] [lecture seule]
Spécifie le type d’environnement d’exécution. | Capabilities | ||
screenColor : String [statique] [lecture seule]
Permet de spécifier la couleur de l’écran. | Capabilities | ||
screenDPI : Number [statique] [lecture seule]
Spécifie la résolution en points par pouce (dpi) de l’écran, en pixels. | Capabilities | ||
screenResolutionX : Number [statique] [lecture seule]
Spécifie la résolution horizontale maximale de l’écran. | Capabilities | ||
screenResolutionY : Number [statique] [lecture seule]
Spécifie la résolution verticale maximale de l’écran. | Capabilities | ||
serverString : String [statique] [lecture seule]
Chaîne codée au format URL qui spécifie des valeurs pour chaque propriété Capabilities. | Capabilities | ||
supports32BitProcesses : Boolean [statique] [lecture seule]
Indique si le système prend en charge l’exécution des traitements 32 bits. | Capabilities | ||
supports64BitProcesses : Boolean [statique] [lecture seule]
Indique si le système prend en charge l’exécution des traitements 64 bits. | Capabilities | ||
touchscreenType : String [statique] [lecture seule]
Spécifie le type d’écran tactile pris en charge, le cas échéant. | Capabilities | ||
version : String [statique] [lecture seule]
Indique les informations de version et de plateforme de Flash Player ou Adobe® AIR®. | Capabilities |
Méthode | Défini par | ||
---|---|---|---|
[statique]
Indique si le système prend en charge le son multicanal d’un type spécifique. | Capabilities | ||
Indique si la propriété spécifiée d’un objet est définie. | Object | ||
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 | ||
Indique si la propriété spécifiée existe et est énumérable. | Object | ||
Définit la disponibilité d’une propriété dynamique pour les opérations en boucle. | Object | ||
Renvoie la représentation de chaîne de cet objet, formatée selon les paramètres régionaux en vigueur. | Object | ||
Renvoie la représentation sous forme de chaîne de l’objet spécifié. | Object | ||
Renvoie la valeur primitive de l’objet spécifié. | Object |
avHardwareDisable | propriété |
avHardwareDisable:Boolean
[lecture seule] Version du langage: | ActionScript 3.0 |
Versions du moteur d’exécution: | Flash Player 9, AIR 1.0, Flash Lite 4 |
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():Boolean
Eléments de l’API associés
cpuArchitecture | propriété |
cpuArchitecture:String
[lecture seule] Version du langage: | ActionScript 3.0 |
Versions du moteur d’exécution: | Flash Player 10.0.32, AIR 1.5.1 |
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
.
Implémentation
public static function get cpuArchitecture():String
hasAccessibility | propriété |
hasAccessibility:Boolean
[lecture seule] Version du langage: | ActionScript 3.0 |
Versions du moteur d’exécution: | Flash Player 9, AIR 1.0, Flash Lite 4 |
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():Boolean
Eléments de l’API associés
hasAudio | propriété |
hasAudio:Boolean
[lecture seule] Version du langage: | ActionScript 3.0 |
Versions du moteur d’exécution: | Flash Player 9, AIR 1.0, Flash Lite 4 |
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():Boolean
hasAudioEncoder | propriété |
hasAudioEncoder:Boolean
[lecture seule] Version du langage: | ActionScript 3.0 |
Versions du moteur d’exécution: | Flash Player 9, AIR 1.0, Flash Lite 4 |
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():Boolean
hasEmbeddedVideo | propriété |
hasEmbeddedVideo:Boolean
[lecture seule] Version du langage: | ActionScript 3.0 |
Versions du moteur d’exécution: | Flash Player 9, AIR 1.0, Flash Lite 4 |
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():Boolean
hasIME | propriété |
hasIME:Boolean
[lecture seule] Version du langage: | ActionScript 3.0 |
Versions du moteur d’exécution: | Flash Player 9, AIR 1.0, Flash Lite 4 |
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():Boolean
Plus d’exemples
Eléments de l’API associés
hasMP3 | propriété |
hasMP3:Boolean
[lecture seule] Version du langage: | ActionScript 3.0 |
Versions du moteur d’exécution: | Flash Player 9, AIR 1.0, Flash Lite 4 |
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():Boolean
Plus d’exemples
hasPrinting | propriété |
hasPrinting:Boolean
[lecture seule] Version du langage: | ActionScript 3.0 |
Versions du moteur d’exécution: | Flash Player 9, AIR 1.0, Flash Lite 4 |
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():Boolean
hasScreenBroadcast | propriété |
hasScreenBroadcast:Boolean
[lecture seule] Version du langage: | ActionScript 3.0 |
Versions du moteur d’exécution: | Flash Player 9, AIR 1.0, Flash Lite 4 |
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():Boolean
hasScreenPlayback | propriété |
hasScreenPlayback:Boolean
[lecture seule] Version du langage: | ActionScript 3.0 |
Versions du moteur d’exécution: | Flash Player 9, AIR 1.0, Flash Lite 4 |
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():Boolean
hasStreamingAudio | propriété |
hasStreamingAudio:Boolean
[lecture seule] Version du langage: | ActionScript 3.0 |
Versions du moteur d’exécution: | Flash Player 9, AIR 1.0, Flash Lite 4 |
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():Boolean
hasStreamingVideo | propriété |
hasStreamingVideo:Boolean
[lecture seule] Version du langage: | ActionScript 3.0 |
Versions du moteur d’exécution: | Flash Player 9, AIR 1.0, Flash Lite 4 |
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():Boolean
hasTLS | propriété |
hasTLS:Boolean
[lecture seule] Version du langage: | ActionScript 3.0 |
Versions du moteur d’exécution: | Flash Player 9, AIR 1.0, Flash Lite 4 |
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():Boolean
Eléments de l’API associés
hasVideoEncoder | propriété |
hasVideoEncoder:Boolean
[lecture seule] Version du langage: | ActionScript 3.0 |
Versions du moteur d’exécution: | Flash Player 9, AIR 1.0, Flash Lite 4 |
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():Boolean
isDebugger | propriété |
isDebugger:Boolean
[lecture seule] Version du langage: | ActionScript 3.0 |
Versions du moteur d’exécution: | Flash Player 9, AIR 1.0, Flash Lite 4 |
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():Boolean
isEmbeddedInAcrobat | propriété |
isEmbeddedInAcrobat:Boolean
[lecture seule] Version du langage: | ActionScript 3.0 |
Versions du moteur d’exécution: | Flash Player 9.0.127.0, AIR 1.1, Flash Lite 4 |
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
).
Implémentation
public static function get isEmbeddedInAcrobat():Boolean
Plus d’exemples
language | propriété |
language:String
[lecture seule] Version du langage: | ActionScript 3.0 |
Versions du moteur d’exécution: | Flash Player 9, AIR 1.0, Flash Lite 4 |
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 | nb |
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():String
Plus d’exemples
Eléments de l’API associés
Exemple ( Comment utiliser cet exemple )
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 | propriété |
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 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
.
Implémentation
public static function get languages():Array
Plus d’exemples
localFileReadDisable | propriété |
localFileReadDisable:Boolean
[lecture seule] Version du langage: | ActionScript 3.0 |
Versions du moteur d’exécution: | Flash Player 9, AIR 1.0, Flash Lite 4 |
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():Boolean
Eléments de l’API associés
manufacturer | propriété |
manufacturer:String
[lecture seule] Version du langage: | ActionScript 3.0 |
Versions du moteur d’exécution: | Flash Player 9, AIR 1.0, Flash Lite 4 |
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.
Implémentation
public static function get manufacturer():String
maxLevelIDC | propriété |
maxLevelIDC:String
[lecture seule] Version du langage: | ActionScript 3.0 |
Versions du moteur d’exécution: | Flash Player 10, AIR 1.5, Flash Lite 4 |
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():String
os | propriété |
os:String
[lecture seule] Version du langage: | ActionScript 3.0 |
Versions du moteur d’exécution: | Flash Player 9, AIR 1.0, Flash Lite 4 |
Spécifie le système d’exploitation actuel. La propriété os
peut renvoyer les chaînes suivantes :
Système d’exploitation | Valeur |
---|---|
Windows 10 | "Windows 10" |
Windows 8 | "Windows 8" |
Windows 7 | "Windows 7" |
Windows Vista | "Windows Vista" |
Windows Server 2012 | "Windows Server 2012" |
Windows Server 2008 R2 | "Windows Server 2008 R2" |
Windows Server 2008 | "Windows Server 2008" |
Windows Home Server | "Windows Home Server" |
Windows Server 2003 R2 | "Windows Server 2003 R2" |
Windows Server 2003 | "Windows Server 2003" |
Windows XP 64 | "Windows Server XP 64" |
Windows XP | "Windows XP" |
Windows 98 | "Windows 98" |
Windows 95 | "Windows 95" |
Windows NT | "Windows NT" |
Windows 2000 | "Windows 2000" |
Windows ME | "Windows ME" |
Windows CE | "Windows CE" |
Windows SmartPhone | "Windows SmartPhone" |
Windows PocketPC | "Windows PocketPC" |
Windows CEPC | "Windows CEPC" |
Windows Mobile | "Windows Mobile" |
Mac OS | "Mac OS X.Y.Z" (où X.Y.Z correspond au numéro de version, par exemple : "Mac OS 10.5.2" ) |
Linux | "Linux" (Flash Player associe la version Linux, telle que "Linux 2.6.15-1.2054_FC5smp" . |
iPhone OS 4.1 | "iPhone3,1" |
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.
Implémentation
public static function get os():String
pixelAspectRatio | propriété |
playerType | propriété |
playerType:String
[lecture seule] Version du langage: | ActionScript 3.0 |
Versions du moteur d’exécution: | Flash Player 9, AIR 1.0, Flash Lite 4 |
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, ayantCapabilities.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
.
Implémentation
public static function get playerType():String
screenColor | propriété |
screenColor:String
[lecture seule] Version du langage: | ActionScript 3.0 |
Versions du moteur d’exécution: | Flash Player 9, AIR 1.0, Flash Lite 4 |
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 | propriété |
screenResolutionX | propriété |
screenResolutionX:Number
[lecture seule] Version du langage: | ActionScript 3.0 |
Versions du moteur d’exécution: | Flash Player 9, AIR 1.0, Flash Lite 4 |
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.
Implémentation
public static function get screenResolutionX():Number
Plus d’exemples
screenResolutionY | propriété |
screenResolutionY:Number
[lecture seule] Version du langage: | ActionScript 3.0 |
Versions du moteur d’exécution: | Flash Player 9, AIR 1.0, Flash Lite 4 |
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.
Implémentation
public static function get screenResolutionY():Number
Plus d’exemples
Exemple ( Comment utiliser cet exemple )
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; }
serverString | propriété |
serverString:String
[lecture seule] Version du langage: | ActionScript 3.0 |
Versions du moteur d’exécution: | Flash Player 9, AIR 1.0, Flash Lite 4 |
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
Plus d’exemples
supports32BitProcesses | propriété |
supports32BitProcesses:Boolean
[lecture seule] Version du langage: | ActionScript 3.0 |
Versions du moteur d’exécution: | Flash Player 10.0.32, AIR 1.5.2 |
Indique si le système prend en charge l’exécution des traitements 32 bits. La chaîne serveur est PR32
.
Implémentation
public static function get supports32BitProcesses():Boolean
supports64BitProcesses | propriété |
supports64BitProcesses:Boolean
[lecture seule] Version du langage: | ActionScript 3.0 |
Versions du moteur d’exécution: | Flash Player 10.0.32, AIR 1.5.2 |
Indique si le système prend en charge l’exécution des traitements 64 bits. La chaîne serveur est PR64
.
Implémentation
public static function get supports64BitProcesses():Boolean
touchscreenType | propriété |
touchscreenType:String
[lecture seule] Version du langage: | ActionScript 3.0 |
Versions du moteur d’exécution: | Flash Player 10.1, AIR 2 |
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.
Implémentation
public static function get touchscreenType():String
Eléments de l’API associés
Exemple ( Comment utiliser cet exemple )
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; }
version | propriété |
version:String
[lecture seule] Version du langage: | ActionScript 3.0 |
Versions du moteur d’exécution: | Flash Player 9, AIR 1.0, Flash Lite 4 |
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
.
Implémentation
public static function get version():String
Plus d’exemples
Exemple ( Comment utiliser cet exemple )
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; }
hasMultiChannelAudio | () | méthode |
public static function hasMultiChannelAudio(type:String):Boolean
Version du langage: | ActionScript 3.0 |
Versions du moteur d’exécution: | Flash Player 11, AIR 3 |
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 :
Type de son multicanal | Chaîne serveur |
---|---|
AudioDecoder.DOLBY_DIGITAL | DD |
AudioDecoder.DOLBY_DIGITAL_PLUS | DDP |
AudioDecoder.DTS | DTS |
AudioDecoder.DTS_EXPRESS | DTE |
AudioDecoder.DTS_HD_HIGH_RESOLUTION_AUDIO | DTH |
AudioDecoder.DTS_HD_MASTER_AUDIO | DTM |
Paramètres
type:String — Valeur de chaîne représentant un type de son multicanal. Les valeurs possibles sont les constantes définies dans flash.media.AudioDecoder.
|
Boolean — La valeur booléenne true si le système prend en charge le type de son multicanal transmis dans le paramètre type . Sinon, la valeur renvoyée est false .
|
Eléments de l’API associés
Exemple ( Comment utiliser cet exemple )
hasMultiChannelAudio()
. La valeur renvoyée indique si le système prend en charge le son Dolby Digital multicanal.
trace(Capabilities.hasMultiChannelAudio(flash.media.AudioDecoder.DOLBY_DIGITAL);
trace()
.
package { import flash.display.Sprite; import flash.system.Capabilities; import flash.text.TextField; import flash.text.TextFieldAutoSize; public class CapabilitiesExample extends Sprite { public function CapabilitiesExample() { showCapabilities(); } private function showCapabilities():void { var tf:TextField = new TextField(); tf.height = 600; tf.width = 400; tf.autoSize = TextFieldAutoSize.LEFT; tf.wordWrap = true; tf.text = "avHardwareDisable: " + Capabilities.avHardwareDisable + "\nhasAccessibility: " + Capabilities.hasAccessibility + "\nhasAudio: " + Capabilities.hasAudio + "\nhasAudioEncoder: " + Capabilities.hasAudioEncoder + "\nhasEmbeddedVideo: " + Capabilities.hasEmbeddedVideo + "\nhasIME: " + Capabilities.hasIME + "\nhasMP3: " + Capabilities.hasMP3 + "\nhasPrinting: " + Capabilities.hasPrinting + "\nhasScreenBroadcast: " + Capabilities.hasScreenBroadcast + "\nhasScreenPlayback: " + Capabilities.hasScreenPlayback + "\nhasStreamingAudio: " + Capabilities.hasStreamingAudio + "\nhasStreamingVideo: " + Capabilities.hasStreamingVideo + "\nhasTLS: " + Capabilities.hasTLS + "\nhasVideoEncoder: " + Capabilities.hasVideoEncoder + "\nisDebugger: " + Capabilities.isDebugger + "\nisEmbeddedInAcrobat: " + Capabilities.isEmbeddedInAcrobat + "\nlanguage: " + Capabilities.language + "\nlocalFileReadDisable: " + Capabilities.localFileReadDisable + "\nmanufacturer: " + Capabilities.manufacturer + "\nmaxLevelIDC: " + Capabilities.maxLevelIDC + "\nos: " + Capabilities.os + "\npixelAspectRatio: " + Capabilities.pixelAspectRatio + "\nplayerType: " + Capabilities.playerType + "\nscreenColor: " + Capabilities.screenColor + "\nscreenDPI: " + Capabilities.screenDPI + "\nscreenResolutionX: " + Capabilities.screenResolutionX + "\nscreenResolutionY: " + Capabilities.screenResolutionY + "\nserverString: " + Capabilities.serverString + "\ntouchscreenType: " + Capabilities.touchscreenType + // The following capabilities are supported only when publishing for AIR. // If you are publishing for AIR, uncomment the following lines. //"\nlanguages: " + Capabilities.languages + //"\ncpuArchitecture: " + Capabilities.cpuArchitecture + //"\nsupports32BitProcesses: " + Capabilities.supports32BitProcesses + //"\nsupports64BitProcesses: " + Capabilities.supports64BitProcesses + "\nversion: " + Capabilities.version; addChild(tf); trace("avHardwareDisable: " + Capabilities.avHardwareDisable); trace("hasAccessibility: " + Capabilities.hasAccessibility); trace("hasAudio: " + Capabilities.hasAudio); trace("hasAudioEncoder: " + Capabilities.hasAudioEncoder); trace("hasEmbeddedVideo: " + Capabilities.hasEmbeddedVideo); trace("hasIME: " + Capabilities.hasIME); trace("hasMP3: " + Capabilities.hasMP3); trace("hasPrinting: " + Capabilities.hasPrinting); trace("hasScreenBroadcast: " + Capabilities.hasScreenBroadcast); trace("hasScreenPlayback: " + Capabilities.hasScreenPlayback); trace("hasStreamingAudio: " + Capabilities.hasStreamingAudio); trace("hasStreamingVideo: " + Capabilities.hasStreamingVideo); trace("hasTLS: " + Capabilities.hasTLS); trace("hasVideoEncoder: " + Capabilities.hasVideoEncoder); trace("isDebugger: " + Capabilities.isDebugger); trace("isEmbeddedInAcrobat: " + Capabilities.isEmbeddedInAcrobat); trace("language: " + Capabilities.language); trace("localFileReadDisable: " + Capabilities.localFileReadDisable); trace("manufacturer: " + Capabilities.manufacturer); trace("maxLevelIDC: " + Capabilities.maxLevelIDC); 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("touchscreenType: " + Capabilities.touchscreenType); // The following capabilities are supported only when publishing for AIR. // If you are publishing for AIR, uncomment the following lines. //trace("cpuArchitecture: " + Capabilities.cpuArchitecture); //trace("languages: " + Capabilities.languages); //trace("supports32BitProcesses: " + Capabilities.supports32BitProcesses); //trace("supports64BitProcesses: " + Capabilities.supports64BitProcesses); trace("version: " + Capabilities.version); } } }
Tue Jun 12 2018, 09:30 AM Z