ExtensionContext  - AS3

Objet ActionScript, s’il existe, associé à ce contexte.

Vous pouvez associer tout objet ActionScript à une occurrence d’ExtensionContext. L’implémentation native peut également obtenir et définir cet objet ActionScript. Par conséquent, vous pouvez utiliser actionScriptData pour partager des données entre le côté ActionScript et le côté natif d’une extension.

Vous pouvez également définir la valeur de actionScriptData sur null.

Appelle la fonction native spécifiée par functionName. Tout argument supplémentaire est transmis à la fonction native.

Paramètres

Crée une occurrence de ExtensionContext pour l’identifiant d’extension et le type de contexte spécifiés.

Paramètres

Supprime cette occurrence de ExtensionContext.

Le moteur d’exécution en informe l’implémentation native, qui peut libérer toutes les ressources natives associées. Après l’appel de la méthode dispose(), le code ne peut pas appeler la méthode call(), et ne peut pas obtenir ou définir la propriété actionScriptData.

Renvoie le répertoire dans lequel l’extension est installée sur le périphérique.

Il peut arriver qu’une extension comprenne des ressources, notamment des images, auxquelles vous souhaitez accéder à partir du code ActionScript de l’extension. Le code peut également avoir besoin d’informations disponibles dans le fichier descripteur de l’extension, telles que le numéro de version de l’extension. Vous pouvez utiliser cette méthode pour accéder au répertoire de base de l’extension.

Où que se trouve l’extension sur le périphérique, ses fichiers sont toujours au même emplacement par rapport à ce répertoire de base de l’extension. L’occurrence File que cette méthode renvoie permet d’accéder à certains fichiers inclus avec l’extension et de les manipuler.

Le répertoire de l’extension présente la structure suivante :

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

L’emplacement du répertoire de l’extension varie selon que l’extension est disponible via un regroupement d’applications ou un regroupement de périphériques, comme suit :

• Avec le regroupement d’applications, le répertoire de l’extension se trouve dans le répertoire de l’application.
• Avec le regroupement de périphériques, l’emplacement du répertoire de l’extension dépend du périphérique.

Il existe une exception à l’utilisation de getExtensionDirectory() pour les extensions natives des périphériques iOS. Les ressources de ces extensions ne se trouvent pas dans le répertoire de l’extension. Elles se trouvent dans le répertoire racine de l’application.

Paramètres

La classe ExtensionContext fournit une interface pour les appels de fonctions dans l’implémentation native d’une extension native pour Adobe AIR. Vous pouvez utiliser cette classe uniquement dans les classes ActionScript qui font partie de l’extension.

Prise en charge du profil AIR : cette fonctionnalité est prise en charge sur les périphériques mobiles à partir d’AIR 3. Elle est également prise en charge à partir d’AIR 3 sur les périphériques de bureau dans des applications qui utilisent le profil de périphérique extendedDesktop. Elle est prise en charge sur les périphériques AIR pour TV à partir d’AIR 2.5 dans des applications qui utilisent le profil de périphérique extendedTV.

Une extension native est une combinaison de :

• Classes ActionScript.
• Code natif. Le code natif est le code qui s’exécute sur un périphérique à l’extérieur du moteur d’exécution. Par exemple, le code que vous écrivez dans C est un code natif.

Vous pouvez créer une extension native pour :

• Permettre à une application AIR d’accéder aux fonctions propres à un périphérique.
• Réutiliser le code natif existant.
• Fournir un traitement plus efficace à l’aide du code natif par rapport au code ActionScript.

Utilisez la classe ExtensionContext du côté d’une extension ActionScript pour accéder au côté natif de l’extension. Commencez par créer une occurrence de la classe ExtensionContext. Pour ce faire, appelez la méthode statique ExtensionContext.createExtensionContext().

Après la création de l’occurrence de la classe ExtensionContext, utilisez la méthode call() de l’occurrence pour appeler une fonction native.

Lorsque vous avez terminé d’utiliser l’occurrence de la classe ExtensionContext, appelez la méthode dispose() pour libérer toutes les ressources natives associées. Sans un appel explicite à la méthode dispose(), le nettoyeur du moteur d’exécution appelle dispose() lorsqu’il supprime l’occurrence. Un appel explicite à la méthode dispose() se produit généralement beaucoup plus tôt que d’attendre le nettoyeur.

Une occurrence de la classe ExtensionContext peut écouter les événements StatusEvent que le code natif distribue lorsque certains événements asynchrones se produisent dans l’implémentation native de l’extension. Etant donné que la classe ExtensionContext dérive de EventDispatcher, elle peut à son tour distribuer des événements.

Les propriétés de cet événement sont les suivantes :