Korzystanie z zewnętrznego interfejsu API

Flash Player 9 i nowsze wersje, Adobe AIR 1.0 i nowsze wersje

Zewnętrzne wywołanie interfejsu API języka ActionScript 3.0 ( flash.external.ExternalInterface ) pozwala w prosty sposób zrealizować komunikację między kodem ActionScript a aplikacją-kontenerem, w której działa program Adobe Flash Player. Na potrzeby interakcji między dokumentem SWF a kodem JavaScript na stronie HTML należy używać interfejsu API ExternalInterface.

Ten zewnętrzny interfejs API umożliwia interakcję z aplikacją kontenera oraz przekazywanie danych między kodem ActionScript a kodem JavaScript na stronie HTML.

Do zadań interfejsu zewnętrznego API należą m.in.:

  • Pobieranie informacji o aplikacji kontenera

  • Korzystanie z języka ActionScript w celu wywoływania kodu na stronie internetowej wyświetlanej w przeglądarce lub w aplikacji AIR dla komputerów

  • Wywołanie kodu ActionScript ze strony internetowej

  • Tworzenie funkcji proxy w celu uproszczenia wywoływania kodu ActionScript ze strony internetowej

Uwaga: To omówienie interfejsu zewnętrznego zawiera tylko informacje dotyczące komunikacji między językiem ActionScript w pliku SWF a aplikacją kontenera, która zawiera odwołanie do programu Flash Player lub instancji, do której załadowany jest plik SWF. Inne zastosowania programu Flash Player w aplikacji nie zostały omówione w niniejszej dokumentacji. Program Flash Player jest przeznaczony do użycia jako wtyczka przeglądarki lub jako projektor (aplikacja samodzielna). Inne scenariusze użycia mogą być obsługiwane w ograniczonym zakresie.

Korzystanie z zewnętrznego interfejsu API w środowisku AIR

Ponieważ aplikacja AIR nie zawiera kontenera zewnętrznego, ten interfejs zewnętrzny nie ma zastosowania — nie jest w ogóle potrzebny. Po bezpośrednim załadowaniu pliku SWF przez aplikację AIR kod aplikacji może nawiązać komunikację bezpośrednio z kodem ActionScript w pliku SWF (z uwzględnieniem ograniczeń bezpiecznego obszaru izolowanego).

Jednak po załadowaniu pliku SWF przez aplikację AIR za pomocą strony HTML w obiekcie HTMLLoader (lub komponentu HTML w środowisku Flex) obiekt HTMLLoader będzie pełnił funkcję kontenera zewnętrznego. W ten sposób można użyć interfejsu zewnętrznego w celu nawiązania komunikacji między kodem ActionScript w załadowanym pliku SWF a kodem JavaScript na stronie HTML załadowanej do obiektu HTMLLoader.