| 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 ActionScript | Cadena de servidor |
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 |
Todas la propiedades de la clase Capabilities son de sólo lectura.
Ver los ejemplos
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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:
| Idioma | Valor |
| Checo | cs |
| Danés | da |
| Holandés | nl |
| Inglés | en |
| Finés | fi |
| Francés | fr |
| Alemán | de |
| Húngaro | hu |
| Italiano | it |
| Japonés | ja |
| Coreano | ko |
| Noruego | no |
| Otro/desconocido | xu |
| Polaco | pl |
| Portugués | pt |
| Ruso | ru |
| Chino simplificado | zh-CN |
| Español | es |
| Sueco | sv |
| Chino tradicional | zh-TW |
| Turco | tr |
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);
}
}
}
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
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
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
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
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:
"StandAlone" para Flash Player autónomo.
"External" para Flash Player externo o en modo de prueba.
"PlugIn" para el plug-in de navegador de Flash Player.
"ActiveX" para el control ActiveX de Flash Player utilizado por Microsoft Internet Explorer.
La cadena de servidor es PT.
Implementación
public static function get playerType():String
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
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
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
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
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
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
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);
}
}
}
© 2004-2007 Adobe Systems Incorporated. Todos los derechos reservados.
Fri Oct 12 2007, 2:30 AM GMT-07:00
Página actual: http://livedocs.adobe.com/flash/9.0_es/ActionScriptLangRefV3/flash/system/Capabilities.html