Harici API'yi kullanma temelleri

Önemli kavramlar ve terimler

Aşağıdaki başvuru listesi bu özellikle ilgili önemli terimler içerir:

Kap uygulaması

Flash Player'ın içinde çalıştığı uygulama, Flash Player içeriği bulunduran web tarayıcısı ve HTML sayfası veya bir web sayfasında SWF'yi yükleyen AIR uygulaması gibi bir SWF dosyasıdır.

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ışma

Bu 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:

1. Flash Professional'ı kullanarak yeni bir belge oluşturun ve belgeyi bilgisayarınıza kaydedin.

2. Ana menüden, Dosya > Yayınlama Ayarları seçeneklerini belirleyin.

3. Yayınlama Ayarları iletişim kutusunda, Biçimler sekmesinde Flash ve HTML onay kutularının seçilmiş olduğunu doğrulayın.

4. 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.

5. 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.

6. Yayınlama Ayarları iletişim kutusunu kapatmak için Tamam'ı tıklatın.

7. 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>

8. HTML dosyasını kaydedin ve Flash uygulamasına geri dönün.

9. Zaman Çizelgesi'nin Kare 1'inde anahtar kareyi seçin ve Eylemler panelini açın.

10. ActionScript kod listesini Komut Dosyası bölmesine kopyalayın.

11. SWF dosyasını yaptığınız değişikliklerle güncellemek için, ana menüden, Dosya > Yayınla seçeneklerini belirleyin.

12. 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:

1. 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.

2. Ana menüden, Dosya > Yayınlama Ayarları seçeneklerini belirleyin.

3. Yayınlama Ayarları iletişim kutusunda, Biçimler sekmesinde yalnızca Flash onay kutusunun seçilmiş olduğunu doğrulayın.

4. 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.

5. Zaman Çizelgesi'nin Kare 1'inde anahtar kareyi seçin ve Eylemler panelini açın.

6. Örneğin ActionScript kodunu, Komut Dosyası bölmesine kopyalayın.

7. SWF dosyasını yeniden yayınlamak için ana menüden, Dosya > Yayınla seçeneklerini belirleyin.

8. ActionScript ile kap uygulaması arasındaki iletişimi test etmek için kap uygulamanızı oluşturup çalıştırın.