Harici API'yi kullanma temelleriFlash Player 9 ve üstü, Adobe AIR 1.0 ve üstü
Bazı durumlarda (örneğin, bir SWF projektörü oluşturmak için Adobe®Flash® Professional kullanırsanız) SWF dosyası kendi başına çalışabilse de, çoğu durumda SWF dosyası başka bir uygulamanın içindeki bir öğe olarak çalıştırılır. Genellikle, SWF içeren kap bir HTML dosyasıdır; nadiren bir masaüstü uygulamasının kullanıcı arabiriminin tümü veya bir kısmı için SWF dosyası kullanılır.
Daha gelişmiş uygulamalarda çalıştıkça, SWF dosyası ile kap uygulaması arasında iletişim kurmanız gerektiğini fark edebilirsiniz. Örneğin, web sayfasının HTML'deki metni veya diğer bilgileri görüntülemesi ve grafik ya da video gibi dinamik görsel içerik görüntülemek için bir SWF dosyası içermesi genel bir durumdur. Bu tür bir durumda, kullanıcılar web sayfasındaki bir düğmeyi tıklattığında SWF dosyasındaki bir şeyi değiştirecek şekilde bunu ayarlamak isteyebilirsiniz. ActionScript, SWF dosyasındaki ActionScript ile kap uygulamasındaki diğer kod arasında bu iletişim türünü kolaylaştıran harici API adında bir mekanizma içerir.
Önemli kavramlar ve terimlerAşağıdaki başvuru listesi bu özellikle ilgili önemli terimler içerir:
- ActiveX kabı
- Uygulama içinde SWF içeriğini görüntülemek için Flash Player ActiveX denetiminin örneğini içeren bir kap uygulaması (web tarayıcısı değil).
- Kap uygulaması
- Flash Player'ın bir SWF dosyasını çalıştırdığı, Flash Player içeriğini barındıran bir web tarayıcısı ve HTML sayfası gibi bir uygulama.
- Projektör
- SWF içeriği ve Flash Player'ın gömülü bir sürümünü içeren bir çalıştırılabilir bir dosya. Flash Professional veya tek başına Flash Player kullanarak bir projektör dosyası oluşturabilirsiniz. Projektörler, CD-ROM ile SWF dosyalarını dağıtmak veya indirme boyutunun sorun oluşturmadığı ve SWF yazarının, kullanıcının bilgisayarında Flash Player yüklü olup olmadığına bakılmaksızın kullanıcının SWF dosyasını çalıştırabileceğinden emin olmak istediği benzer durumlarda yaygın olarak kullanılır.
- Proxy
- Bir uygulamadaki (“harici uygulama”) kodu başka bir uygulama (“çağıran uygulama”) adına çağıran ve çağıran uygulamaya değerler döndüren bir aracı uygulama veya kod. Proxy, arasında şunların da yer aldığı bir çok nedenle kullanılabilir:
Çağıran uygulamadaki yerel işlev çağrılarını, harici uygulama tarafından anlaşılan biçime dönüştürerek harici işlev çağrıları yapma işlemini basitleştirmek.
Güvenlik kısıtlamalarına ve çağıranın harici uygulamayla doğrudan iletişim kurmasını önleyen diğer kısıtlamalara yönelik çözüm bulma.
- Serileştirme
- Nesneleri veya veri değerlerini, iki programlama sistemi arasında (örn. Internet üzerinden veya tek bir bilgisayarda çalışan iki farklı uygulama arasında) mesajlardaki değerleri iletmek için kullanılabilir bir biçime dönüştürme.
Örneklerle çalışmaBu bölümdeki kod örneklerinin çoğu, tam çalışma örnekleri veya değerleri kontrol eden kodlardan çok, gösterme amaçlı küçük kod listeleridir. Harici API kullanılması (tanım gereği), kap uygulamasındaki kodun yanı sıra ActionScript yazılmasını da gerektirdiğinden, örneklerin test edilmesi, kap (örneğin, SWF dosyasını içeren bir web sayfası) oluşturulmasını ve kap ile etkileşim kurmak için kod listelerinin kullanılmasını içerir.
ActionScript'ten JavaScript'e iletişim örneğini test etmek için:Flash Professional'ı kullanarak yeni bir belge oluşturun ve belgeyi bilgisayarınıza kaydedin.
Ana menüden, Dosya > Yayınlama Ayarları seçeneklerini belirleyin.
Yayınlama Ayarları iletişim kutusunda, Biçimler sekmesinde Flash ve HTML onay kutularının seçilmiş olduğunu doğrulayın.
Yayınla düğmesini tıklatın. Böylece aynı klasörde ve belgeyi kaydetmek için kullandığınız aynı adla bir SWF dosyası ve HTML dosyası oluşturulur. Yayınlama Ayarları iletişim kutusunu kapatmak için Tamam'ı tıklatın.
HTML onay kutusunun seçimini kaldırın. HTML sayfası oluşturulduğuna göre, uygun JavaScript kodunu eklemek için bunu değiştireceksinizdir. HTML onay kutusunun seçiminin kaldırılması, siz HTML sayfasını değiştirdikten sonra Flash uygulamasının SWF dosyasını yayınlarken yeni bir HTML sayfasıyla değişikliklerinizi geçersiz kılmaması sağlanır.
Yayınlama Ayarları iletişim kutusunu kapatmak için Tamam'ı tıklatın.
SWF dosyasını yayınladığınızda Flash tarafından oluşturulan HTML dosyasını HTML veya metin düzenleyici uygulamasıyla açın. HTML kaynak koduna açma ve kapatma script etiketlerini ekleyin ve bunlara örnek kod listesindeki JavaScript kodunu kopyalayın:
<script>
// add the sample JavaScript code here
</script>
HTML dosyasını kaydedin ve Flash uygulamasına geri dönün.
Zaman Çizelgesi'nin Kare 1'inde anahtar kareyi seçin ve Eylemler panelini açın.
ActionScript kod listesini Komut Dosyası bölmesine kopyalayın.
SWF dosyasını yaptığınız değişikliklerle güncellemek için, ana menüden, Dosya > Yayınla seçeneklerini belirleyin.
Sayfayı görüntülemek ve ActionScript ile HTML arasındaki iletişimi test etmek için, bir web tarayıcısı kullanarak, düzenlediğiniz HTML sayfasını açın.
ActionScript'ten ActiveX kabına iletişim örneğini test etmek için:Flash Professional'ı kullanarak yeni bir belge oluşturun ve belgeyi bilgisayarınıza kaydedin. Bunu, kap uygulamanızın SWF dosyasını bulmayı beklediği klasöre kaydetmek isteyebilirsiniz.
Ana menüden, Dosya > Yayınlama Ayarları seçeneklerini belirleyin.
Yayınlama Ayarları iletişim kutusunda, Biçimler sekmesinde yalnızca Flash onay kutusunun seçilmiş olduğunu doğrulayın.
Flash onay kutusunun yanındaki Dosya alanında, SWF dosyanızın yayınlanacağı klasörü seçmek için klasör simgesini tıklatın. SWF dosyanızın konumunu ayarlayarak, (örneğin) belgeyi tek bir klasörde tutabilir ancak yayınlanan SWF dosyasını, kap uygulamasının kaynak kodunu içeren klasör gibi başka bir klasöre koyabilirsiniz.
Zaman Çizelgesi'nin Kare 1'inde anahtar kareyi seçin ve Eylemler panelini açın.
Örneğin ActionScript kodunu, Komut Dosyası bölmesine kopyalayın.
SWF dosyasını yeniden yayınlamak için ana menüden, Dosya > Yayınla seçeneklerini belirleyin.
ActionScript ile kap uygulaması arasındaki iletişimi test etmek için kap uygulamanızı oluşturup çalıştırın.
Bir HTML sayfasıyla ve bir C# masaüstü uygulamasıyla iletişim kurmak için harici API'yi kullanmakla ilgili tam örnekler için aşağıdaki başlıkları inceleyin:
Bu örnekler, harici API kullanarak kod yazarken kullanmanız gereken, ActionScript ve kap hata denetleme kodu da dahil olmak üzere tam kodu içerir. Harici API kullanmaya ilişkin başka bir tam örnek için, ActionScript 3.0 Başvurusu'ndaki ExternalInterface sınıfının sınıf örneğine bakın.
|
|