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. Harici API'yi kullanmak isteyebileceğiniz birçok durum vardır—örneğin, bir HTML sayfasında SWF belgesi ile JavaScript arasında etkileşim oluşturduğunuzda veya bir SWF dosyasını görüntülemek için Flash Player uygulamasını kullanan bir masaüstü uygulaması oluşturduğunuzda.

Bir kap uygulaması ile etkileşim kurmak, bir HTML sayfasında ActionScript ile JavaScript arasında veri aktarmak ve ActionScript ile bir masaüstü uygulaması arasında iletişim kurup veri alışverişi yapmak için harici API’yi kullanabilirsiniz.

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

  • Kap uygulaması hakkında bilgi alma

  • Web sayfası veya masaüstü uygulaması dahil olmak üzere, bir kap uygulamasında kod çağırmak için ActionScript uygulamasını kullanma

  • Bir kap uygulamasındaki koddan ActionScript kodunu çağırma

  • Bir kap uygulamasından ActionScript kodu çağrılmasını 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.