Capabilities  - AS3

Especifica se o acesso à câmera e ao microfone do usuário foi administrativamente proibido (true) ou (false). A string de servidor é AVD.

Para o conteúdo no Adobe AIR™, esta propriedade se aplica somente ao conteúdo nas caixas de proteção de segurança diferentes das do aplicativo. O conteúdo da área de segurança do aplicativo sempre pode acessar a câmera e o microfone do usuário.

Elementos da API relacionados

Especifica a arquitetura de CPU atual. A propriedade cpuArchitecture pode retornar as seguintes strings: "PowerPC", "x86", "SPARC" e "ARM". A string de servidor é ARCH.

Especifica se o sistema oferece suporte (true) ou não (false) para comunicação com ferramentas de acessibilidade. A string do servidor é ACC.

Elementos da API relacionados

Especifica se o sistema possui capacidades de áudio. Esta propriedade é sempre true. A string de servidor é A.

Especifica se o sistema pode (true) ou não (false) codificar um fluxo de áudio, como o proveniente de um microfone. A string de servidor é AE.

Especifica se o sistema oferece suporte (true) ou não (false) para vídeo incorporado. A string de servidor é EV.

Especifica se o sistema possui (true) ou não (false) um editor de método de entrada (IME) instalado. A string de servidor é IME.

Elementos da API relacionados

Especifica se o sistema tem (true) ou não (false) um decodificador MP3. A string de servidor é MP3.

Especifica se o sistema oferece suporte (true) ou não (false) para impressão. A string de servidor é PR.

Especifica se o sistema oferece (true) ou não oferece (false) para o desenvolvimento de aplicativos de transmissão na tela a serem executados através do Flash Media Server. A string de servidor é SB.

Especifica se o sistema oferece (true) ou não oferece (false) suporte para a reprodução de aplicativos de transmissão na tela que estão sendo executados através do Flash Media Server. A string de servidor é SP.

Especifica se o sistema pode (true) ou não pode (false) reproduzir áudio de streaming. A string de servidor é SA.

Especifica se o sistema pode (true) ou não pode (false) reproduzir vídeo de streaming. A string de servidor é SV.

Especifica se o sistema oferece suporte a soquetes SSL nativos através de NetConnection (true) ou não (false). A string de servidor é TLS.

Elementos da API relacionados

Especifica se o sistema pode (true) ou não pode(false) codificar um fluxo de vídeo, como o proveniente de uma câmera da Web. A string de servidor é VE.

Especifica se o sistema é uma versão de depuração especial (true) ou uma versão oficialmente lançada (false). A string de servidor é DEB. Essa propriedade é definida como true ao executar a versão de depuração do Flash Player ou do AIR Debug Launcher (ADL).

Especifica se o tempo de execução do Flash está incorporado em um arquivo PDF que é aberto no Acrobat 9.0 ou posterior (true) ou não (false).

Especifica o código de idioma do sistema no qual o conteúdo está sendo executado. O idioma é especificado como um código de ISO 639-1 de idioma de duas letras em minúsculas. Para o chinês, um código ISO 3166 adicional do país de duas letras em maiúsculas diferencia entre o chinês tradicional e o simplificado. Os códigos de idiomas se baseiam nos nomes em inglês do idioma: por exemplo, hu especifica o húngaro.

Nos sistemas em inglês, esta propriedade retorna apenas o código do idioma (en) e não o código do país. Nos sistemas Microsoft Windows, esta propriedade retorna o idioma da interface do usuário (UI), que se refere ao idioma usado em todos os menus, caixas de diálogo, mensagens de erro e arquivos de ajuda. A tabela a seguir lista os valores possíveis:

Observação: O valor da propriedade Capabilities.language está limitado aos valores possíveis dessa lista. Em virtude dessa limitação, os aplicativos Adobe AIR devem usar o primeiro elemento da matriz Capabilities.languages para determinar o idioma da interface do usuário principal do sistema.

A string de servidor é L.

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

Uma matriz de strings que contém informações sobre os idiomas de interface preferenciais do usuário, conforme definido no sistema operacional. As strings conterão identificadores de idioma (e informações sobre scripts e regiões, se for o caso) definidas por RFC4646 (http://www.ietf.org/rfc/rfc4646.txt) e usarão traços como delimitador (por exemplo, "en-US" ou "ja-JP"). Idiomas relacionados na matriz, na ordem de preferência, conforme determinado pelas configurações do sistema operacional.

Sistemas operacionais diferem em termos de informações sobre a região retornadas em strings de localidade. Um sistema operacional pode retornar "en-us", e outro pode retornar "en".

A primeira entrada na matriz retornada normalmente tem a mesma ID de idioma primária da propriedade Capabilities.language. Por exemplo, caso Capabilities.languages[0] seja definida como "en-US", a propriedade language é definida como "en". Entretanto, se a propriedade Capabilities.language for definida como "xu" (especificando um idioma desconhecido), o primeiro elemento dessa matriz será diferente. Por esse motivo, Capabilities.languages[0] pode ser mais preciso que Capabilities.language.

A string de servidor é LS.

Especifica se o acesso de leitura ao disco rígido do usuário foi administrativamente proibido (true) ou permitido (false). Para o conteúdo no Adobe AIR, esta propriedade se aplica somente ao conteúdo nas caixas de proteção de segurança diferentes das do aplicativo. (O conteúdo na área de segurança do aplicativo pode sempre ler a partir dos arquivos do sistema.) Se esta propriedade for true, o Flash Player não pode ler arquivos (incluindo o primeiro arquivo SWF iniciado com o Flash Player) do disco rígido do usuário. Se esta propriedade for true, o conteúdo do AIR fora da área de segurança não pode ler arquivos do disco rígido do usuário. Por exemplo, as tentativas de ler um arquivo no disco rígido do usuário usando métodos load falharão se a propriedade for definida como true.

A leitura das bibliotecas compartilhadas de tempo de execução também é bloqueada se a propriedade estiver definida como true, mas a leitura de objetos compartilhados locais é permitida sem considerar o valor dessa propriedade.

A string de servidor é LFD.

Elementos da API relacionados

Especifica o fabricante da versão em execução do Flash Player ou d o tempo de execução do AIR, no formato "Adobe OSName". O valor de OSName pode ser "Windows", "Macintosh", "Linux" ou outro nome de sistema operacional. A string de servidor é M.

Não use Capabilities.manufacturer para determinar um recurso com base no sistema operacional se uma propriedade de recurso mais específica existir. Basear um recurso no sistema operacional é uma má ideia, uma vez que ele pode levar a problemas se um aplicativo não considerar todos os sistemas operacionais de destino potenciais. Em vez disso, use a propriedade correspondente ao recurso que você está testando. Para obter mais informações, consulte a descrição da classe Capabilities.

Recupera o IDC de nível H.264 mais alto ao qual o hardware cliente oferece suporte. A execução de mídia nesse nível é garantida, no entanto, a execução de mídia no nível mais alto poderá não ocorrer com a qualidade mais alta. Essa propriedade é útil para servidores que tentam direcionar os recursos de um cliente. Com essa propriedade, um servidor pode determinar o nível de vídeo a ser despachado ao cliente.

A string de servidor é ML.

Especifica o sistema operacional atual. A propriedade os pode retornar as seguintes strings:

A string de servidor é OS.

Não use Capabilities.os para determinar um recurso com base no sistema operacional se uma propriedade de recurso mais específica existir. Basear um recurso no sistema operacional é uma má ideia, uma vez que ele pode levar a problemas se um aplicativo não considerar todos os sistemas operacionais de destino potenciais. Em vez disso, use a propriedade correspondente ao recurso que você está testando. Para obter mais informações, consulte a descrição da classe Capabilities.

Especifica a proporção de pixels da tela. A string de servidor é AR.

Especifica o tipo de ambiente do tempo de execução. Esta propriedade pode ter um dos seguintes valores:

• "ActiveX" para o controle ActiveX do Flash Player usado pelo Microsoft Internet Explorer
• "Desktop" para o tempo de execução do Adobe AIR (exceto para o conteúdo SWF carregado por uma página HTML, que tem Capabilities.playerType definida para "PlugIn")
• "External" para o Flash Player externo ou em modo de teste
• "PlugIn" para o plug-in do navegador do Flash Player (e para o conteúdo SWF carregado por uma página HTML em um aplicativo AIR)
• "StandAlone" para o Flash Player independente

A string de servidor é PT.

Especifica a cor da tela. Esta propriedade pode ter o valor "color", "gray" (para tons de cinza) ou "bw" (para preto e branco). A string de servidor é COL.

Especifica a resolução em pontos por polegada (dpi) da tela, em pixels. A string de servidor é DP.

Especifica a resolução horizontal máxima da tela. A string de servidor éR (que retorna a largura e a altura da tela). Esta propriedade não atualiza com uma resolução de tela do usuário e em vez disso, indica somente a resolução no momento do início de um aplicativo Flash Player ou Adobe AIR. O valor também especifica somente a tela principal.

Especifica a resolução vertical máxima da tela. A string de servidor éR (que retorna a largura e a altura da tela). Esta propriedade não atualiza com uma resolução de tela do usuário e em vez disso, indica somente a resolução no momento do início de um aplicativo Flash Player ou Adobe AIR. O valor também especifica somente a tela 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;
}

Uma string codificada em URL que especifica valores para cada propriedade Capabilities.

O exemplo a seguir mostra uma string codificada em 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 se o sistema suporta processos de 32 bits em execução. A string de servidor é PR32.

Especifica se o sistema suporta processos de 64 bits em execução. A string de servidor é PR64.

Especifica o tipo de touchscreen suportado, se houver algum. Os valores são definidos na classe flash.system.TouchscreenType.

Elementos da 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 as informações de plataforma e versão do Flash Player ou do Adobe^® AIR^®. O formato do número da versão é: platform majorVersion, minorVersion, buildNumber, internalBuildNumber. Os valores possíveis para platform são "WIN", ` "MAC", "LNX" e"AND". Aqui estão alguns exemplos de informações da versão:

	 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ão use Capabilities.version para determinar um recurso com base no sistema operacional se uma propriedade de recurso mais específica existir. Basear um recurso no sistema operacional é uma má ideia, uma vez que ele pode levar a problemas se um aplicativo não considerar todos os sistemas operacionais de destino potenciais. Em vez disso, use a propriedade correspondente ao recurso que você está testando. Para obter mais informações, consulte a descrição da classe Capabilities.

A string de servidor é 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 se o sistema tem suporte a áudio multicanal de um tipo específico. A classe flash.media. AudioDecoder enumera os tipos possíveis.

Suporte a perfil do AIR: este recurso conta com suporte somente em dispositivos AIR for TV. Em todas as outras plataformas, este método sempre retorna false. Consulte Suporte a perfil do AIR para obter mais informações sobre o suporte de API através de múltiplos perfis.

Observe: Usando um dos codecs áudio DTS, os cenários existem em que hasMultiChannelAudio () retornos verdadeiro mas o áudio DTS não é jogado. Por exemplo, considere um player de Blu-raio com uma saída S/PDIF, conectada a um velho ampliador. O velho ampliador não apoia DTS, mas S/PDIF não tem nenhum protocolo para notificar o player de Blu-raio. Se o player de Blu-raio enviar a corrente DTS ao velho ampliador, o usuário não ouve nada. Por isso, como uma prática recomendada usando DTS, forneça uma interface do usuário para que o usuário possa indicar se nenhum som está jogando. Então, o seu aplicativo pode reverter a um codec diferente.

A seguinte tabela mostra a sequência de caracteres de servidor de cada tipo de áudio multicanal:

Parâmetros

Elementos da API relacionados

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