Harici API'yi kullanma

Flash Player 9 ve üstü, Adobe AIR 1.0 ve üstü

ActionScript 3.0 harici API'si ( flash.external.ExternalInterface ) ActionScript ve Adobe Flash Player'ın içinde çalıştığı kap uygulaması arasında doğrudan iletişime olanak tanır. Bir HTML sayfasında SWF belgesi ve JavaScript arasında etkileşim oluşturmak için ExternalInterface API'yi kullanın.

Kapsayıcı bir uygulamayla etkileşim kurmak için harici API'yi kullanabilir, bir HTML sayfasında ActionScript ve JavaScript arasında veri gönderebilirsiniz.

Bazı yaygın harici API görevleri şunlardır:

Kap uygulaması hakkında bilgi alma
Bir tarayıcı veya AIR masaüstü uygulaması içinde görüntülenen web sayfasında kod çağırmak için ActionScript'i kullanma
Bir web sayfasından ActionScript kodunu çağırma
Bir web sayfasından ActionScript kodu çağırmayı kolaylaştırmak için bir proxy oluşturma

Not: Harici arabirim tartışması yalnızca bir SWF dosyasındaki ActionScript ile Flash Player’a başvuru veya SWF’nin yüklendiği örneği içeren kap uygulaması arasındaki iletişimi kapsamaktadır. Bir uygulama içinde Flash Player uygulamasının diğer kullanımları, bu belgenin kapsamı dışında kalır. Flash Player, bir tarayıcı eklentisi veya projektör (bağımsız uygulama) olarak kullanılmak üzere tasarlanmıştır. Diğer kullanım senaryoları sınırlı destek içerebilir.

Harici API’yi AIR’de kullanma

AIR uygulaması harici bir kaba sahip olmadığından, bu harici arabirim genellikle geçerli değildir--veya genellikle gerekmez. AIR uygulamanız bir SWF dosyasını doğrudan yüklediğinde, uygulama kodu doğrudan SWF içerisindeki ActionScript koduyla iletişim kurabilir (güvenlik sanal alan sınırlamalarına tabidir).

Ancak, AIR uygulamanız bir HTMLLoeader nesnesi (veya Flex içerisinde bir HTML bileşeni) içerisindeki bir HTML sayfasını kullanarak SWF dosyası yüklediğinde, HTMLLoader nesnesi harici kap olarak görev yapar. Dolayısıyla, yüklenmiş SWF’deki ActionScript kodu ile HTMLLoeader’a yüklenmiş HTML sayfasındaki JavaScript kodu arasında iletişim kurmak için harici arabirimi kullanabilirsiniz.