Prise en charge du profil AIR : cette fonctionnalité est prise en charge uniquement sur les périphériques AIR pour TV dans des applications qui font appel au profil de périphérique
Une extension ActionScript est une combinaison de :
Vous pouvez créer une extension ActionScript pour permettre à une application AIR d’accéder aux fonctions propres au périphérique. Vous pouvez également créer une extension ActionScript pour réutiliser le code natif existant, ou pour fournir un traitement plus efficace à l’aide de code natif que vous pouvez fournir avec du code ActionScript. Pour plus d’informations sur l’écriture, la création et la mise en package d’extensions d’ActionScript, voir le document PDF
Utilisez la classe ExtensionContext du côté ActionScript 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
Après la création de l’occurrence de la classe ExtensionContext, utilisez la méthode
Lorsque vous avez terminé d’utiliser l’occurrence de la classe ExtensionContext, appelez la méthode
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.
La classe ExtensionContext fournit également une méthode statique,
Remarque : les applications AIR ayant recours au profil
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
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.
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
Vous pouvez également définir la valeur de
La classe ExternalInterface permet d’appeler une fonction ActionScript dans le moteur d’exécution de Flash à l’aide de JavaScript dans la page HTML. La fonction ActionScript peut renvoyer une valeur que JavaScript reçoit immédiatement comme valeur de renvoi de l’appel.
Cette fonctionnalité remplace la méthode
Utilisez la classe ExternalInterface pour les combinaisons suivantes de navigateurs et de systèmes d’exploitation :
Flash Player pour Linux version 9.0.31.0 et supérieure prend en charge la classe ExternalInterface dans les navigateurs suivants :
La classe ExternalInterface nécessite la prise en charge, par le navigateur Web de l’utilisateur, d’ActiveX® ou de l’API NPRuntime qui est exposée par certains navigateurs pour les scripts de plug-ins. Même si une combinaison navigateur/système d’exploitation n’apparaît pas dans la liste ci-dessus, elle devrait prendre en charge la classe ExternalInterface si elle gère l’API NPRuntime. Visitez le site
Remarque : lors de l’intégration de fichiers SWF dans une page HTML, vérifiez que l’attribut
. - + ~~ / \
Remarque concernant les applications de Flash Player : Flash Player 9.0.115.0 et les versions ultérieures autorisent l’utilisation du caractère
Remarque concernant les applications de Flash Player : dans Flash Player 10 et les versions ultérieures s’exécutant dans un navigateur, il est possible que vous ne puissiez pas utiliser cette classe par programmation pour ouvrir une fenêtre contextuelle. Certains navigateurs (et configurations de navigateur) peuvent bloquer les fenêtres contextuelles ; il n’est donc pas possible de garantir l’ouverture de toutes les fenêtres contextuelles. Toutefois, pour un résultat optimal, utilisez cette classe pour ouvrir une fenêtre contextuelle uniquement dans le code qui s’exécute comme conséquence directe de l’action d’un utilisateur (par exemple, un événement de type clic de souris ou pression de touche).
A partir d’ActionScript, vous pouvez effectuer les opérations suivantes sur la page HTML :
A partir de JavaScript, vous pouvez effectuer les opérations suivantes sur la page HTML :
Remarque concernant les applications de Flash Player : Flash Player ne prend actuellement pas en charge les fichiers SWF intégrés à des formulaires HTML.
Remarque concernant les applications d’AIR : dans Adobe AIR, la classe ExternalInterface peut être utilisée pour communiquer entre JavaScript dans une page HTML chargée dans un contrôle HTMLLoader et ActionScript dans un contenu SWF incorporé à cette page HTML.
Remarque : répéter
Remarque : pour le contenu local s’exécutant dans un navigateur, les appels à la méthode
Si le conteneur correspond à une page HTML, cette méthode appelle une fonction JavaScript dans un élément
Si le conteneur est un autre conteneur de type ActiveX, cette méthode distribue l’événement FlashCall ActiveX au nom spécifié ; le conteneur traite alors l’événement.
Si le conteneur renferme le plug-in Netscape, vous pouvez soit écrire le support personnalisé pour la nouvelle interface NPRuntime, soit intégrer un contrôle HTML et intégrer le lecteur au contrôle HTML. Si vous intégrez un contrôle HTML, vous pouvez communiquer avec le lecteur via une interface JavaScript qui dialogue avec l’application conteneur native.
Remarque : pour le contenu local s’exécutant dans un navigateur, les appels à la méthode
Remarque concernant les applications de Flash Player : dans Flash Player 10 et Flash Player 9 Mise à jour 5, certains navigateurs Web ne prennent pas en charge cette méthode si un bloqueur de fenêtres publicitaires intempestives est activé. Dans ce cas, l’appel de cette méthode aboutit uniquement en réponse à l’événement d’un utilisateur (notamment lorsque celui-ci clique sur une souris ou appuie sur une touche).
Remarque : si vous utilisez l’API externe avec HTML, assurez-vous toujours que le chargement du code HTML est terminé avant de tenter d’appeler toute méthode JavaScript.