Capabilities  - AS3

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.

Para el contenido en Adobe AIR™, esta propiedad se aplica sólo al contenido de entornos limitados de seguridad distintos al de la aplicación. El contenido del entorno limitado de seguridad de la aplicación siempre puede acceder a la cámara y el micrófono del usuario.

Elementos de API relacionados

Especifica la arquitectura actual de la CPU. La propiedad cpuArchitecture puede devolver las cadenas siguientes: "PowerPC", "x86", "SPARC" y "ARM". La cadena de servidor es ARCH.

Especifica si el sistema admite la comunicación con elementos de accesibilidad (true) o no (false). La cadena de servidor es ACC.

Elementos de API relacionados

Especifica si el sistema tiene prestaciones de audio. Esta propiedad siempre es true. La cadena de servidor es A.

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

Especifica si el sistema admite vídeo incorporado (true) o no (false) La cadena de servidor es EV.

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

Elementos de API relacionados

Especifica si el sistema tiene un descodificador de MP3 (true) o no (false). La cadena de servidor es MP3.

Especifica si el sistema admite la impresión (true) o no (false). La cadena de servidor es PR.

Especifica si el sistema 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.

Especifica si el sistema 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.

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

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

Especifica si el sistema admite sockets SSL nativos mediante NetConnection (true) o no (false). La cadena de servidor es TLS.

Elementos de API relacionados

Especifica si el sistema puede (true) o no puede (false) codificar un flujo de vídeo, por ejemplo, el procedente de una cámara web. La cadena de servidor es VE.

Especifica si el sistema 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. Esta propiedad se establece en true cuando se ejecuta la versión de depuración de Flash Player o o el iniciador de depuración de AIR (ADL).

Especifica si el motor de ejecución de Flash está incorporado en un archivo PDF abierto en Acrobat 9.0 o superior (true) o no (false).

Especifica el código de idioma del sistema en el que se está ejecutando el contenido. 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:

Nota: el valor de la propiedad Capabilities.language se limita a los valores posibles incluidos en esta lista. Debido a esta limitación, las aplicaciones de Adobe AIR deben utilizar el primer elemento del conjunto Capabilities.languages para determinar la interfaz de usuario principal del sistema.

La cadena de servidor es L.

Elementos de API relacionados

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

Un conjunto de cadenas que contienen información sobre los idiomas de interfaz de usuario preferidos del usuario, según la configuración establecida en el sistema operativo. Las cadenas contendrán etiquetas de idioma (junto con información de script y región, si procede) definidas por RFC4646 (http://www.ietf.org/rfc/rfc4646.txt) y utilizarán un guión como delimitador (por ejemplo, "en-US" o "ja-JP"). Los idiomas aparecen en el conjunto por orden de preferencia, conforme a la configuración del sistema operativo.

Los sistemas operativos son distintos respecto a la información devuelta en cadenas de configuración regional. Un sistema operativo puede devolver "en-us", mientras que otro puede devolver "en".

La primera entrada del conjunto devuelto suele tener el mismo ID de idioma principal que la propiedad Capabilities.language. Por ejemplo, si Capabilities.languages[0] se establece como "en-US", la propiedad language se establece como "en". No obstante, si la propiedad Capabilities.language se establece como "xu" (especificando un idioma desconocido), el primer elemento del conjunto será diferente. Por este motivo, Capabilities.languages[0] puede ser más preciso que Capabilities.language.

La cadena de servidor es LS.

Especifica si el acceso de lectura al disco duro del usuario ha sido prohibido (true) o autorizado (false) administrativamente. Para el contenido en Adobe AIR, esta propiedad se aplica sólo al contenido de entornos limitados de seguridad distintos al de la aplicación. (El contenido del entorno limitado de seguridad de la aplicación siempre puede leer desde el sistema de archivos.) Si esta propiedad es true, Flash Player no podrá leer archivos (incluido el primer archivo con el que se inicia Flash Player) del disco duro del usuario. Si esta propiedad es true, el contenido de AIR que esté fuera del entorno limitado de seguridad de la aplicación no podrá leer archivos 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.

Elementos de API relacionados

Especifica el fabricante de la versión ejecutada de Flash Player o el tiempo de ejecución de AIR, con el formato "Adobe NombreSO". El valor de NombreSO puede ser ""Windows"", ""Macintosh"", "Linux" o cualquier otro nombre de sistema operativo. La cadena de servidor es M.

No utilice Capabilities.manufacturer para determinar una capacidad basada en el sistema operativo si existen una propiedad más específica. Basar un capacidad en el sistema operativo no es buena idea, ya que puede generar problemas si una aplicación no tiene en cuenta todos los posibles sistemas operativos de destino. En su lugar, utilice la propiedad correspondiente a la capacidad del que esté probando. Para más información, consulte la descripción de la clase Capabilities.

Recupera el IDC de nivel H.264 más alto admitido por el hardware del cliente. Se garantiza la ejecución de los medios en este nivel; no obstante, los medios que se ejecuten en el nivel más alto tal vez no lo hagan con la mayor calidad. Esta propiedad resulta útil en servidores que intenten cumplir las capacidades de un cliente. Si utiliza esta propiedad, un servidor puede determinar el nivel de vídeo que se envía al cliente.

La cadena de servidor es ML.

Especifica el sistema operativo actual. La propiedad os puede devolver las siguientes cadenas:

La cadena de servidor es OS.

No utilice Capabilities.os para determinar una capacidad basada en el sistema operativo si existen una propiedad más específica. Basar un capacidad en el sistema operativo no es buena idea, ya que puede generar problemas si una aplicación no tiene en cuenta todos los posibles sistemas operativos de destino. En su lugar, utilice la propiedad correspondiente a la capacidad del que esté probando. Para más información, consulte la descripción de la clase Capabilities.

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

Especifica el tipo de entorno de tiempo de ejecución. Esta propiedad puede tener uno de los siguientes valores:

• "ActiveX" para el control ActiveX de Flash Player utilizado por Microsoft Internet Explorer.
• "Desktop" para el tiempo de ejecución de Adobe AIR (excepto para el contenido SWF cargado por una página HTML, el cual tiene Capabilities.playerType establecida como "PlugIn")
• "External" para Flash Player externo o en modo de prueba.
• "PlugIn" para el plug-in de navegador de Flash Player (y para el contenido SWF cargado por una página HTML en una aplicación de AIR)
• "StandAlone" para Flash Player autónomo.

La cadena de servidor es PT.

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.

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

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). Esta propiedad no se actualiza con la resolución de pantalla del usuario. Sólo indica la resolución en el momento en que se inicia Flash Player o una aplicación de Adobe AIR. Asimismo, el valor sólo especifica la pantalla principal.

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). Esta propiedad no se actualiza con la resolución de pantalla del usuario. Sólo indica la resolución en el momento en que se inicia Flash Player o una aplicación de Adobe AIR. Asimismo, el valor sólo especifica la pantalla principal.

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

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

Especifica si el sistema admite procesos de 32 bits. La cadena de servidor es PR32.

Especifica si el sistema admite procesos de 64 bits. La cadena de servidor es PR64.

Especifica el tipo de pantalla táctil admitida, si existe. Los valores se definen en la clase flash.system.TouchscreenType.

Elementos de API relacionados

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

Especifica la plataforma y la información de versión de Flash Player o Adobe^® AIR^®. 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 posibles valores de platform son "WIN", "MAC", "LNX" y "AND". A continuación se muestran algunos ejemplos de información de la versión:

	 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
	 

No utilice Capabilities.version para determinar una capacidad basada en el sistema operativo si existen una propiedad más específica. Basar un capacidad en el sistema operativo no es buena idea, ya que puede generar problemas si una aplicación no tiene en cuenta todos los posibles sistemas operativos de destino. En su lugar, utilice la propiedad correspondiente a la capacidad del que esté probando. Para más información, consulte la descripción de la clase Capabilities.

La cadena de servidor es V.

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

Especifica si el sistema admite audio multicanal de un tipo específico. La clase flash.media.AudioDecoder enumera los posibles tipos.

Compatibilidad con perfil de AIR: el audio multicanal sólo se admite dispositivos de AIR para TV. En todos los demás dispositivos, este método siempre devuelve false. Consulte Compatibilidad con perfil de AIR para obtener información sobre la compatibilidad de la API con varios perfiles.

Nota: al usar uno de los códecs de audio DTS, pueden darse casos en los que hasMultiChannelAudio() devuelva true pero no se reproduzca audio DTS. Por ejemplo, un reproductor de Blu-ray con una salida S/PDIF, conectado a un amplificador antiguo. El amplificador antiguo no admite DTS, pero S/PDIF no tiene ningún protocolo para notificar al reproductor de Blu-ray. Si el reproductor de Blu-ray envía el flujo DTS al amplificador antiguo, el usuario no oye nada. Por lo tanto, cuando se utiliza DTS lo mejor es proporcionar una interfaz de usuario para que el usuario pueda indicar si no se está reproduciendo ningún sonido. A continuación, la aplicación puede volver a un códec diferente.

La siguiente tabla muestra la cadena de servidor para cada tipo de audio multicanal:

Parámetros

Elementos de API relacionados

    trace(Capabilities.hasMultiChannelAudio(flash.media.AudioDecoder.DOLBY_DIGITAL);