ExtensionContext  - AS3

O objeto ActionScript associado a este contexto, se houver.

Você pode associar qualquer objeto ActionScript a uma instância de ExtensionContext. A implementação nativa também pode obter e definir este objeto ActionScript. Por isso, você pode usar actionScriptData para compartilhar dados entre o lado do ActionScript e o lado nativo de uma extensão.

Também pode definir o valor de actionScriptData como null.

Chama a função nativa especificada por functionName. Quaisquer argumentos adicionais são passados para a função nativa.

Parâmetros

Cria uma instância de ExtensionContext para o identificador de extensão e o tipo de contexto específicos.

Parâmetros

Descarta essa instância de ExtensionContext.

O tempo de execução notifica a implementação nativa, que pode liberar quaisquer recursos nativos associados. Depois de chamar dispose(), o código não pode chamar o método call() e não pode obter nem definir a propriedade actionScriptData.

Retorna o diretório no qual a extensão está instalada no dispositivo.

Às vezes, uma extensão inclui recursos, como imagens que você deseja acessar a partir do código ActionScript da extensão. Às vezes, o código também requer informações que são disponíveis no arquivo descritor de extensão, como o número de versão de extensão. Você pode usar este método para acessar o diretório base da extensão.

Independentemente de onde a extensão está localizada no dispositivo, os arquivos de extensão estão sempre no mesmo local relativo a este diretório base da extensão. Usando a instância de File que este método retorna, você pode navegar até arquivos específicos incluídos com a extensão e manipulá-los.

O diretório de extensão tem a seguinte estrutura:

			 extension base directory/
			      platform independent files
			      META-INF/
			           ANE/
			                extension.xml
			                platform name/
			                     platform-dependent files and directories
			 

O local do diretório de extensão depende de se a extensão está disponível por meio de integração do aplicativo ou integração do dispositivo como se segue:

• Com a integração do aplicativo, o diretório de extensão está localizado dentro do diretório de aplicativo.
• Com a integração do dispositivo, local do diretório de extensão depende do dispositivo.

Existe uma exceção ao uso de getExtensionDirectory() para extensões nativas de dispositivos iOS. Os recursos destas extensões não estão localizados no diretório de extensão. Em vez disso, eles estão localizados no diretório de aplicativo de nível superior.

Parâmetros

A classe ExtensionContext fornece uma interface de funções de chamada na implementação nativa de uma extensão nativa do Adobe AIR. Você pode usar esta classe somente em classes ActionScript que fazem parte da extensão.

Suporte a perfil do AIR: esse recurso é suportado em dispositivos móveis que iniciam em AIR 3. Também é suportado iniciando em AIR 3 em dispositivos de desktop em aplicativos que usam o perfil de dispositivo extendedDesktop. É suportado em dispositivos do AIR para TV que iniciam em AIR 2.5 em aplicativos que usam o perfil de dispositivo extendedTV.

Uma extensão nativa é uma combinação de:

• Classes ActionScript.
• Código nativo. O código nativo é o código executado em um dispositivo fora do tempo de execução. Por exemplo, o código que você programa em C é código nativo.

Você pode criar uma extensão nativa para:

• Dê acesso de aplicativo de AIR a recursos específicos de dispositivo.
• Reutilize código nativo existente.
• Fornece processamento mais eficiente utilizando o código nativo que você pode fornecer com o código de ActionScript.

Use a classe ExtensionContext no lado do de uma extensão ActionScript para acessar o lado nativo da extensão. Primeiro, crie uma instância da classe ExtensionContext. Para isso, chame o método estático ExtensionContext.createExtensionContext().

Depois de criar a instância de ExtensionContext, use o método call() da instância para chamar uma função nativa.

Quando tiver terminado com a instância de ExtensionContext, chame dispose() para liberar quaisquer recursos nativos associados. Sem uma chamada explícita a dispose(), o coletor de lixo em tempo de execução chama dispose() ao descartar a instância. Um chamada explícita a dispose() normalmente ocorre muito mais cedo do que a espera pelo coletor de lixo.

Uma instância de ExtensionContext pode ouvir eventos StatusEvent que o código nativo emite quando algum evento assíncrono ocorre na implementação nativa da extensão. Visto que a classe ExtensionContext deriva de EventDispatcher, pode despachar eventos.

Esse evento tem as seguintes propriedades: