Paqueteflash.system
Clasepublic final class Capabilities
HerenciaCapabilities Inheritance Object

Versión del lenguaje: ActionScript 3.0
Versión del reproductor: Flash Player 9

La clase Capabilities ofrece propiedades que describen el sistema y el reproductor que alojan un archivo SWF. Por ejemplo, la pantalla de un teléfono móvil puede tener 100 píxeles cuadrados en blanco y negro, mientras que la pantalla de un ordenador puede tener 1000 píxeles cuadrados en color. Al utilizar el objeto Capabilities para determinar el tipo de dispositivo de un usuario, puede proporcionar contenido adecuado a tantos usuarios como sea posible. Cuando se conocen las prestaciones del dispositivo, se puede indicar al servidor que envíe los archivos SWF adecuados o indicar al archivo SWF que modifique su presentación.

Puede enviar la información de las prestaciones de un reproductor. Ésta se guarda en la propiedad Capabilities.serverString como una cadena URL codificada. Utilice los métodos HTTP GET o POST. En el ejemplo siguiente, se muestra una cadena de servidor para un equipo compatible con MP3, con resolución de 1600 x 1200 píxeles y que ejecuta Windows XP con un editor de método de entrada (IME) instalado:

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

La tabla siguiente contiene las posibles propiedades de ActionScript y sus cadenas de servidor correspondientes:

Propiedad de ActionScriptCadena de servidor
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

Todas la propiedades de la clase Capabilities son de sólo lectura.

Ver los ejemplos

Véase también

Utilización de la clase Capabilities


Propiedades públicas
 PropiedadDefinido por
  avHardwareDisable : Boolean
[static] [read-only] Especifica si el acceso a la cámara y al micrófono del usuario se ha prohibido (true) o autorizado (false) administrativamente.
Capabilities
 Inheritedconstructor : Object
Una referencia a la clase de objeto o función constructora para una instancia de objeto determinada.
Object
  hasAccessibility : Boolean
[static] [read-only] Especifica si el reproductor se ejecuta en un entorno que admite (true) o no admite (false) la comunicación con elementos de accesibilidad.
Capabilities
  hasAudio : Boolean
[static] [read-only] Especifica si el reproductor se ejecuta en un sistema con prestaciones de audio.
Capabilities
  hasAudioEncoder : Boolean
[static] [read-only] Especifica si el reproductor puede (true) o no puede (false) codificar una transmisión de audio como, por ejemplo, el procedente de un micrófono.
Capabilities
  hasEmbeddedVideo : Boolean
[static] [read-only] Especifica si el reproductor se ejecuta en un sistema que admite (true) o no admite (false) vídeo incorporado.
Capabilities
  hasIME : Boolean
[static] [read-only] Especifica si el reproductor se ejecuta en un sistema que tiene (true) o no tiene (false) un editor de método de entrada (IME) instalado.
Capabilities
  hasMP3 : Boolean
[static] [read-only] Especifica si el reproductor se ejecuta en un sistema que admite (true) o no admite (false) un decodificador MP3.
Capabilities
  hasPrinting : Boolean
[static] [read-only] Especifica si el reproductor se ejecuta en un sistema que admite (true) o no admite (false) impresión.
Capabilities
  hasScreenBroadcast : Boolean
[static] [read-only] Especifica si el reproductor admite (true) o no admite (false) el desarrollo de aplicaciones de difusión de pantallas para su ejecución a través de Flash Media Server.
Capabilities
  hasScreenPlayback : Boolean
[static] [read-only] Especifica si el reproductor admite (true) o no admite (false) la reproducción de aplicaciones de difusión de pantallas que se ejecutan a través de Flash Media Server.
Capabilities
  hasStreamingAudio : Boolean
[static] [read-only] Especifica si el reproductor puede (true) o no puede (false) reproducir transmisiones de audio.
Capabilities
  hasStreamingVideo : Boolean
[static] [read-only] Especifica si el reproductor puede (true) o no puede (false) reproducir transmisiones de vídeo.
Capabilities
  hasTLS : Boolean
[static] [read-only] Especifica si el reproductor se encuentra en un sistema que admite sockets SSL nativos mediante NetConnection (true) o no (false).
Capabilities
  hasVideoEncoder : Boolean
[static] [read-only] Especifica si el reproductor puede (true) o no puede (false) codificar una transmisión de vídeo, por ejemplo, la procedente de una cámara.
Capabilities
  isDebugger : Boolean
[static] [read-only] Especifica si el reproductor es una versión de depuración especial (true) o si se trata de una versión oficial (false).
Capabilities
  language : String
[static] [read-only] Especifica el código de idioma del sistema en el que se está ejecutando el reproductor.
Capabilities
  localFileReadDisable : Boolean
[static] [read-only] Especifica si el acceso de lectura al disco duro del usuario se ha prohibido (true) o autorizado (false) administrativamente.
Capabilities
  manufacturer : String
[static] [read-only] Especifica el fabricante de Flash Player, en el formato "Adobe OSName".
Capabilities
  os : String
[static] [read-only] Especifica el sistema operativo actual.
Capabilities
  pixelAspectRatio : Number
[static] [read-only] Especifica la proporción en píxeles de la pantalla.
Capabilities
  playerType : String
[static] [read-only] Especifica el tipo de reproductor.
Capabilities
 Inheritedprototype : Object
[static] Una referencia al objeto prototipo de una clase u objeto de función.
Object
  screenColor : String
[static] [read-only] Especifica el color de la pantalla.
Capabilities
  screenDPI : Number
[static] [read-only] Especifica la resolución de puntos por pulgada (ppp) de la pantalla expresada en píxeles.
Capabilities
  screenResolutionX : Number
[static] [read-only] Especifica la resolución horizontal máxima de la pantalla.
Capabilities
  screenResolutionY : Number
[static] [read-only] Especifica la resolución vertical máxima de la pantalla.
Capabilities
  serverString : String
[static] [read-only] Cadena con codificación URL que especifica valores para las propiedades Capabilities.
Capabilities
  version : String
[static] [read-only] Especifica la información de la versión y la plataforma de Flash Player.
Capabilities
Métodos públicos
 MétodoDefinido por
 Inherited
Indica si un objeto tiene definida una propiedad especificada.
Object
 Inherited
Indica si hay una instancia de la clase Object en la cadena de prototipo del objeto especificado como parámetro.
Object
 Inherited
Indica si existe la propiedad especificada y si es enumerable.
Object
 Inherited
Establece la disponibilidad de una propiedad dinámica para operaciones de bucle.
Object
 Inherited
Devuelve la representación de cadena del objeto especificado.
Object
 Inherited
Devuelve el valor simple del objeto especificado.
Object
Información sobre propiedades
avHardwareDisablepropiedad
avHardwareDisable:Boolean  [read-only]

Versión del lenguaje: ActionScript 3.0
Versión del reproductor: Flash Player 9

Especifica si el acceso a la cámara y al micrófono del usuario ha sido prohibido (true) o autorizado (false) administrativamente. La cadena de servidor es AVD.


Implementación
    public static function get avHardwareDisable():Boolean

Véase también

hasAccessibilitypropiedad 
hasAccessibility:Boolean  [read-only]

Versión del lenguaje: ActionScript 3.0
Versión del reproductor: Flash Player 9

Especifica si el reproductor se ejecuta en un entorno que admite (true) o no admite (false) la comunicación con elementos de accesibilidad. La cadena de servidor es ACC.


Implementación
    public static function get hasAccessibility():Boolean

Véase también

hasAudiopropiedad 
hasAudio:Boolean  [read-only]

Versión del lenguaje: ActionScript 3.0
Versión del reproductor: Flash Player 9

Especifica si el reproductor se ejecuta en un sistema con prestaciones de audio. Esta propiedad siempre es true. La cadena de servidor es A.


Implementación
    public static function get hasAudio():Boolean
hasAudioEncoderpropiedad 
hasAudioEncoder:Boolean  [read-only]

Versión del lenguaje: ActionScript 3.0
Versión del reproductor: Flash Player 9

Especifica si el reproductor puede (true) o no puede (false) codificar una transmisión de audio, por ejemplo, el procedente de un micrófono. La cadena de servidor es AE.


Implementación
    public static function get hasAudioEncoder():Boolean
hasEmbeddedVideopropiedad 
hasEmbeddedVideo:Boolean  [read-only]

Versión del lenguaje: ActionScript 3.0
Versión del reproductor: Flash Player 9

Especifica si el reproductor se ejecuta en un sistema que admite (true) o no admite (false) vídeo incorporado. La cadena de servidor es EV.


Implementación
    public static function get hasEmbeddedVideo():Boolean
hasIMEpropiedad 
hasIME:Boolean  [read-only]

Versión del lenguaje: ActionScript 3.0
Versión del reproductor: Flash Player 9

Especifica si el reproductor se ejecuta en un sistema que tiene (true) o no tiene (false) un editor de método de entrada (IME) instalado. La cadena de servidor es IME.


Implementación
    public static function get hasIME():Boolean

Véase también

hasMP3propiedad 
hasMP3:Boolean  [read-only]

Versión del lenguaje: ActionScript 3.0
Versión del reproductor: Flash Player 9

Especifica si el reproductor se ejecuta en un sistema que tiene (true) o no tiene (false) un decodificador MP3. La cadena de servidor es MP3.


Implementación
    public static function get hasMP3():Boolean

Véase también

hasPrintingpropiedad 
hasPrinting:Boolean  [read-only]

Versión del lenguaje: ActionScript 3.0
Versión del reproductor: Flash Player 9

Especifica si el reproductor se ejecuta en un sistema que admite (true) o no admite (false) impresión. La cadena de servidor es PR.


Implementación
    public static function get hasPrinting():Boolean
hasScreenBroadcastpropiedad 
hasScreenBroadcast:Boolean  [read-only]

Versión del lenguaje: ActionScript 3.0
Versión del reproductor: Flash Player 9

Especifica si el reproductor admite (true) o no admite (false) el desarrollo de aplicaciones de difusión de pantallas para su ejecución a través de Flash Media Server. La cadena de servidor es SB.


Implementación
    public static function get hasScreenBroadcast():Boolean
hasScreenPlaybackpropiedad 
hasScreenPlayback:Boolean  [read-only]

Versión del lenguaje: ActionScript 3.0
Versión del reproductor: Flash Player 9

Especifica si el reproductor admite (true) o no admite (false) la reproducción de aplicaciones de difusión de pantallas que se ejecutan a través de Flash Media Server. La cadena de servidor es SP.


Implementación
    public static function get hasScreenPlayback():Boolean
hasStreamingAudiopropiedad 
hasStreamingAudio:Boolean  [read-only]

Versión del lenguaje: ActionScript 3.0
Versión del reproductor: Flash Player 9

Especifica si el reproductor puede (true) o no puede (false) reproducir transmisiones de audio. La cadena de servidor es SA.


Implementación
    public static function get hasStreamingAudio():Boolean
hasStreamingVideopropiedad 
hasStreamingVideo:Boolean  [read-only]

Versión del lenguaje: ActionScript 3.0
Versión del reproductor: Flash Player 9

Especifica si el reproductor puede (true) o no puede (false) reproducir transmisiones de vídeo. La cadena de servidor es SV.


Implementación
    public static function get hasStreamingVideo():Boolean
hasTLSpropiedad 
hasTLS:Boolean  [read-only]

Versión del lenguaje: ActionScript 3.0
Versión del reproductor: Flash Player 9

Especifica si el reproductor se encuentra en un sistema que admite sockets SSL nativos mediante NetConnection (true) o no (false). La cadena de servidor es TLS.


Implementación
    public static function get hasTLS():Boolean

Véase también

hasVideoEncoderpropiedad 
hasVideoEncoder:Boolean  [read-only]

Versión del lenguaje: ActionScript 3.0
Versión del reproductor: Flash Player 9

Especifica si el reproductor puede (true) o no puede (false) codificar una transmisión de vídeo, por ejemplo, la procedente de una cámara. La cadena de servidor es VE.


Implementación
    public static function get hasVideoEncoder():Boolean
isDebuggerpropiedad 
isDebugger:Boolean  [read-only]

Versión del lenguaje: ActionScript 3.0
Versión del reproductor: Flash Player 9

Especifica si el reproductor es una versión de depuración especial (true) o si se trata de una versión oficial (false). La cadena de servidor es DEB.


Implementación
    public static function get isDebugger():Boolean
languagepropiedad 
language:String  [read-only]

Versión del lenguaje: ActionScript 3.0
Versión del reproductor: Flash Player 9

Especifica el código de idioma del sistema en el que se está ejecutando el reproductor. El idioma se especifica como un código de idioma de dos letras en minúsculas de ISO 639-1. En el caso del idioma chino, un código de dos letras de país de ISO 3166 adicional permite distinguir si se trata de chino simplificado o tradicional. Los códigos de idioma se basan en los nombres de los idiomas en inglés: por ejemplo, hu especifica el idioma húngaro.

En sistemas anglosajones, esta propiedad sólo devuelve el código de idioma (en), no el código del país. En sistemas de Microsoft Windows, esta propiedad devuelve el idioma de la interfaz del usuario (IU), es decir, el idioma empleado en todos los menús, cuadros de diálogo, mensajes de error y archivos de ayuda. En la siguiente tabla se enumeran los valores posibles:

IdiomaValor
Checocs
Danésda
Holandésnl
Inglésen
Finésfi
Francésfr
Alemánde
Húngarohu
Italianoit
Japonésja
Coreanoko
Noruegono
Otro/desconocidoxu
Polacopl
Portuguéspt
Rusoru
Chino simplificadozh-CN
Españoles
Suecosv
Chino tradicionalzh-TW
Turcotr

La cadena de servidor es L.


Implementación
    public static function get language():String

Ejemplo

En el ejemplo siguiente, según el idioma del sistema operativo del usuario, se muestra contenido diferente.

La propiedad Capabilities.language devuelve el código de idioma ISO 639-1 (por ejemplo, "en" para el inglés). La sentencia switch comprueba el código del idioma y establece el contenido del campo de texto myTextField con un saludo específico en ese idioma. Si el código del idioma no se admite en el ejemplo, se devuelve una cadena de error predeterminada.

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);
        }
    }
}
localFileReadDisablepropiedad 
localFileReadDisable:Boolean  [read-only]

Versión del lenguaje: ActionScript 3.0
Versión del reproductor: Flash Player 9

Especifica si el acceso de lectura al disco duro del usuario ha sido prohibido (true) o autorizado (false) administrativamente. Si esta propiedad es true, Flash Player no podrá leer archivos (incluido el primer archivo SWF con el que se inicia Flash Player) del disco duro del usuario. Por ejemplo, los intentos de lectura de un archivo del disco duro del usuario mediante métodos de carga fallarán si esta propiedad se establece como true.

La lectura de bibliotecas compartidas en tiempo de ejecución también se bloqueará si esta propiedad se establece como true, aunque se autorizará la lectura de objetos compartidos locales con independencia de cuál sea el valor de esta propiedad. La cadena de servidor es LFD.


Implementación
    public static function get localFileReadDisable():Boolean

Véase también

manufacturerpropiedad 
manufacturer:String  [read-only]

Versión del lenguaje: ActionScript 3.0
Versión del reproductor: Flash Player 9

Especifica el fabricante de Flash Player, en el formato "Adobe OSName". El valor de OSName puede ser "Windows", "Macintosh", "Linux" o cualquier otro nombre de sistema operativo. La cadena de servidor es M.


Implementación
    public static function get manufacturer():String
ospropiedad 
os:String  [read-only]

Versión del lenguaje: ActionScript 3.0
Versión del reproductor: Flash Player 9

Especifica el sistema operativo actual. La propiedad os puede devolver las siguientes cadenas: "Windows XP", "Windows 2000", "Windows NT", "Windows 98/ME", "Windows 95", "Windows CE" (sólo disponible en Flash Player SDK, no en la versión de escritorio), "Linux" y "MacOS". La cadena de servidor es OS.


Implementación
    public static function get os():String
pixelAspectRatiopropiedad 
pixelAspectRatio:Number  [read-only]

Versión del lenguaje: ActionScript 3.0
Versión del reproductor: Flash Player 9

Especifica la proporción en píxeles de la pantalla. La cadena de servidor es AR.


Implementación
    public static function get pixelAspectRatio():Number
playerTypepropiedad 
playerType:String  [read-only]

Versión del lenguaje: ActionScript 3.0
Versión del reproductor: Flash Player 9

Especifica el tipo de reproductor. Esta propiedad puede tener uno de los siguientes valores:

La cadena de servidor es PT.


Implementación
    public static function get playerType():String
screenColorpropiedad 
screenColor:String  [read-only]

Versión del lenguaje: ActionScript 3.0
Versión del reproductor: Flash Player 9

Especifica el color de la pantalla. Esta propiedad puede tener el valor "color", "gray" (para escala de grises) o "bw" (para blanco y negro). La cadena de servidor es COL.


Implementación
    public static function get screenColor():String
screenDPIpropiedad 
screenDPI:Number  [read-only]

Versión del lenguaje: ActionScript 3.0
Versión del reproductor: Flash Player 9

Especifica la resolución de puntos por pulgada (ppp) de la pantalla expresada en píxeles. La cadena de servidor es DP.


Implementación
    public static function get screenDPI():Number
screenResolutionXpropiedad 
screenResolutionX:Number  [read-only]

Versión del lenguaje: ActionScript 3.0
Versión del reproductor: Flash Player 9

Especifica la resolución horizontal máxima de la pantalla. La cadena de servidor es R (que devuelve la anchura y la altura de la pantalla).


Implementación
    public static function get screenResolutionX():Number

Véase también

screenResolutionYpropiedad 
screenResolutionY:Number  [read-only]

Versión del lenguaje: ActionScript 3.0
Versión del reproductor: Flash Player 9

Especifica la resolución vertical máxima de la pantalla. La cadena de servidor es R (que devuelve la anchura y la altura de la pantalla).


Implementación
    public static function get screenResolutionY():Number

Véase también

serverStringpropiedad 
serverString:String  [read-only]

Versión del lenguaje: ActionScript 3.0
Versión del reproductor: Flash Player 9

Cadena con codificación URL que especifica valores para las propiedades Capabilities.

En el ejemplo siguiente, se muestra una cadena con codificación 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


Implementación
    public static function get serverString():String

Véase también

versionpropiedad 
version:String  [read-only]

Versión del lenguaje: ActionScript 3.0
Versión del reproductor: Flash Player 9

Especifica la información de la versión y la plataforma de Flash Player. El formato del número de versión es el siguiente: versión principal de plataforma, versión secundaria, número del build, número interno del build. Los valores posibles de la plataforma son "WIN", "MAC" y "UNIX". A continuación se muestran algunos ejemplos de información de la versión:

  WIN 9,0,0,0 // Flash Player 9 para Windows
  MAC 7,0,25,0 // Flash Player 7 para Macintosh
  UNIX 5,0,55,0 // Flash Player 5 para UNIX
  

La cadena de servidor es V.


Implementación
    public static function get version():String

Véase también

Ejemplos Cómo utilizar los ejemplos
CapabilitiesExample.as

En el ejemplo siguiente, simplemente se muestran los valores del objeto flash.system.Capabilities utilizando varias llamadas a 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);
        }
    }
}




 

Enviarme un mensaje de correo electrónico cuando se añadan comentarios a esta página | Informe de comentarios

Página actual: http://livedocs.adobe.com/flash/9.0_es/ActionScriptLangRefV3/flash/system/Capabilities.html