AIR.SWF tarayıcı içi API'si

SDK'yle beraber sağlanan badge.swf dosyasını kullanmaya ek olarak, bir tarayıcı sayfasında kullanmak için kendi SWF dosyanızı oluşturabilirsiniz. Özel SWF dosyanız çalışma zamanıyla şu şekillerde etkileşimde bulunabilir:

• Bir AIR uygulaması yükleyebilir. Bkz. Tarayıcıdan AIR uygulaması yükleme .

• Belirli bir AIR uygulamasının yüklenip yüklenmediğine bakmak için kontrol edebilir. Bkz. AIR uygulamasının yüklenip yüklenmediğini bir web sayfasından kontrol etme .

• Çalışma zamanının yüklenip yüklenmediğine bakmak için kontrol edebilir. Bkz. Çalışma zamanının yüklenip yüklenmediğini kontrol etme .

• Yüklenmiş bir AIR uygulamasını kullanıcının sisteminde başlatabilir. Bkz. Yüklenmiş bir AIR uygulamasını tarayıcıdan başlatma .

Bu özelliklerin tümü, adobe.com adresinde bulunan bir SWF dosyasındaki API'ler çağrılarak sağlanır: air.swf. badge.swf dosyasını özelleştirebilir ve kendi SWF dosyanızdan air.swf API'lerini çağırabilirsiniz.

Buna ek olarak tarayıcıda çalışan bir SWF dosyası, LocalConnection sınıfını kullanarak, çalışan bir AIR uygulamasıyla iletişim kurabilir. Daha fazla bilgi için bkz. Diğer Flash Player ve AIR örnekleri ile iletişim (ActionScript geliştiricileri için) veya Diğer Flash Player ve AIR örnekleri ile iletişim (HTML geliştiricileri için).

AIR SDK ve Flex SDK'de bir badge.swf dosyası mevcuttur, bu dosya sayesinde kesintisiz yükleme özelliğini kolaylıkla kullanabilirsiniz. badge.swf dosyası, çalışma zamanını ve AIR uygulamasını web sayfasındaki bir bağdan yükleyebilir. badge.swf dosyası ve kaynak kodu, web sitenizde yayınlamanız için size sağlanır.

Bir tarayıcıdaki web sayfasından çalışma zamanı ve AIR uygulamalarıyla etkileşimde bulunmak için air.swf dosyasındaki API'leri kullanan kendi SWF dosyanızı oluşturabilirsiniz. air.swf dosyası http://airdownload.adobe.com/air/browserapi/air.swf adresinde bulunmaktadır. air.swf API'lerine SWF dosyanızdan başvurmak için, air.swf dosyasını SWF dosyanızla aynı uygulama etki alanına yükleyin. Aşağıdaki kod, yükleme SWF dosyasının uygulama etki alanına air.swf dosyasını yüklemeye dair bir örnek gösterir:

var airSWF:Object; // This is the reference to the main class of air.swf 
var airSWFLoader:Loader = new Loader(); // Used to load the SWF 
var loaderContext:LoaderContext = new LoaderContext();  
                                // Used to set the application domain  
 
loaderContext.applicationDomain = ApplicationDomain.currentDomain; 
 
airSWFLoader.contentLoaderInfo.addEventListener(Event.INIT, onInit); 
airSWFLoader.load(new URLRequest("http://airdownload.adobe.com/air/browserapi/air.swf"),  
                    loaderContext); 
 
function onInit(e:Event):void  
{ 
    airSWF = e.target.content; 
}

air.swf dosyası yüklendikten sonra (Loader nesnesinin contentLoaderInfo nesnesi init olayını gönderdiğinde), aşağıdaki bölümlerde anlatılan biçimde air.swf API'lerinden herhangi birini çağırabilirsiniz.

SWF dosyası, http://airdownload.adobe.com/air/browserapi/air.swf adresinden yüklenen air.swf dosyasındaki getStatus( ) yöntemini çağırarak, çalışma zamanının yüklenip yüklenmediğini kontrol edebilir. Ayrıntılar için bkz. air.swf dosyasını yükleme .

air.swf dosyası yüklendikten sonra, SWF dosyası, aşağıda olduğu gibi air.swf dosyasının getStatus( ) yöntemini çağırabilir:

var status:String = airSWF.getStatus();

getStatus() yöntemi, bilgisayardaki çalışma zamanının durumuna bağlı olarak aşağıdaki dize değerlerinden birini döndürür:

Gerekli Flash Player sürümü (Windows ve Mac OS'de sürüm 9 güncelleme 3 veya Linux'ta sürüm 10) tarayıcıya yüklenmediğinde getStatus() yöntemi bir hata atar.

SWF dosyası, http://airdownload.adobe.com/air/browserapi/air.swf adresinden yüklenen air.swf dosyasındaki getApplicationVersion( ) yöntemini çağırarak AIR uygulamasının (eşleşen bir uygulama kimliği ve yayıncı kimliğiyle) yüklenip yüklenmediğini kontrol edebilir. Ayrıntılar için bkz. air.swf dosyasını yükleme .

air.swf dosyası yüklendikten sonra, SWF dosyası, aşağıda olduğu gibi air.swf dosyasının getApplicationVersion( ) yöntemini çağırır:

var appID:String = "com.example.air.myTestApplication"; 
var pubID:String = "02D88EEED35F84C264A183921344EEA353A629FD.1"; 
airSWF.getApplicationVersion(appID, pubID, versionDetectCallback); 
 
function versionDetectCallback(version:String):void 
{ 
    if (version == null) 
    { 
        trace("Not installed."); 
        // Take appropriate actions. For instance, present the user with 
        // an option to install the application. 
    } 
    else 
    { 
        trace("Version", version, "installed."); 
        // Take appropriate actions. For instance, enable the 
        // user interface to launch the application. 
    } 
}

getApplicationVersion() yöntemi aşağıdaki parametreleri içerir:

Gerekli Flash Player sürümü (Windows ve Mac OS'de sürüm 9 güncelleme 3 veya daha yenisi veya Linux'ta sürüm 10) tarayıcıda yüklü değilse getApplicationVersion() yöntemi hata verir.

SWF dosyası, http://airdownload.adobe.com/air/browserapi/air.swf adresinden yüklenen air.swf dosyasındaki installApplication( ) yöntemini çağırarak bir AIR uygulaması yükleyebilir. Ayrıntılar için bkz. air.swf dosyasını yükleme .

air.swf dosyası yüklendikten sonra, SWF dosyası, aşağıdaki kodda olduğu gibi air.swf dosyasının installApplication( ) yöntemini çağırabilir:

var url:String = "http://www.example.com/myApplication.air"; 
var runtimeVersion:String = "1.0"; 
var arguments:Array = ["launchFromBrowser"]; // Optional 
airSWF.installApplication(url, runtimeVersion, arguments); 

installApplication() yöntemi, kullanıcının bilgisayarında belirtilen uygulamayı yükler. Bu yöntem aşağıdaki parametrelere sahiptir:

installApplication() yöntemi yalnızca, fare tıklatması gibi bir kullanıcı olayına yönelik olay işleyicisinde çağrıldığında çalışabilir.

Gerekli Flash Player sürümü (Windows ve Mac OS'de sürüm 9 güncelleme 3 veya daha yenisi veya Linux'ta sürüm 10) tarayıcıda yüklü değilse installApplication() yöntemi hata verir.

Mac OS'de bir uygulamanın güncellenen sürümünü yüklemek için, kullanıcının uygulama dizinine yüklemek üzere yeterli sistem ayrıcalığına (ve uygulama çalışma zamanını güncelliyorsa yönetici ayrıcalıklarına) sahip olması gerekir. Windows'ta kullanıcı yönetici ayrıcalıklarına sahip olmalıdır.

Ayrıca, bir uygulamanın önceden yüklenip yüklenmediğini kontrol etmek için air.swf dosyasının getApplicationVersion() yöntemini de çağırabilirsiniz. Bu yöntemi uygulama yükleme işlemi başlamadan önce veya yükleme başladıktan sonra çağırabilirsiniz. Ayrıntılar için bkz. AIR uygulamasının yüklenip yüklenmediğini bir web sayfasından kontrol etme . Uygulama çalıştıktan sonra, LocalConnection sınıfını kullanarak tarayıcıdaki SWF içeriğiyle iletişim kurabilir. Daha fazla bilgi için bkz. Diğer Flash Player ve AIR örnekleri ile iletişim (ActionScript geliştiricileri için) veya Diğer Flash Player ve AIR örnekleri ile iletişim (HTML geliştiricileri için).

Tarayıcı başlatma özelliğini kullanmak için (tarayıcıdan başlatılmasına izin vererek), hedef uygulamanın uygulama tanımlayıcı dosyası aşağıdaki ayarı içermelidir:

<allowBrowserInvocation>true</allowBrowserInvocation>

Uygulama tanımlayıcı dosyası hakkında daha fazla bilgi için bkz. AIR uygulama tanımlayıcı dosyaları .

Tarayıcıdaki bir SWF dosyası, http://airdownload.adobe.com/air/browserapi/air.swf adresinden yüklenen air.swf dosyasındaki launchApplication( ) yöntemini çağırarak bir AIR uygulamasını başlatabilir. Ayrıntılar için bkz. air.swf dosyasını yükleme .

air.swf dosyası yüklendikten sonra, SWF dosyası, aşağıdaki kodda olduğu gibi air.swf dosyasının launchApplication( ) yöntemini çağırabilir:

var appID:String = "com.example.air.myTestApplication"; 
var pubID:String = "02D88EEED35F84C264A183921344EEA353A629FD.1"; 
var arguments:Array = ["launchFromBrowser"]; // Optional 
airSWF.launchApplication(appID, pubID, arguments);

launchApplication() yöntemi air.swf dosyasının (kullanıcı arabirimi SWF dosyasının uygulama etki alanında yüklüdür) üst düzeyinde tanımlanır. Bu yöntemi çağırmak AIR'in belirtilen uygulamayı başlatmasına neden olur (yüklüyse ve tarayıcı başlatması olanağı varsa, uygulama tanımlayıcı dosyasındaki allowBrowserInvocation ayarını kullanarak). Bu yöntem aşağıdaki parametrelere sahiptir:

launchApplication() yöntemi yalnızca, fare tıklatması gibi bir user olayı için olay işleyicisinde çağrıldığında çalışabilir.

Gerekli Flash Player sürümü (Windows ve Mac OS'de sürüm 9 güncelleme 3 veya daha yenisi veya Linux'ta sürüm 10) tarayıcıda yüklü değilse launchApplication() yöntemi hata verir.

Uygulama tanımlayıcı dosyasında allowBrowserInvocation öğesi false olarak ayarlıysa, launchApplication() yöntemini çağırmanın hiçbir etkisi yoktur.

Kullanıcı arabirimini uygulamayı başlatmak için sunmadan önce, air.swf dosyasında getApplicationVersion( ) yöntemini çağırmak isteyebilirsiniz. Ayrıntılar için bkz. AIR uygulamasının yüklenip yüklenmediğini bir web sayfasından kontrol etme .

Uygulama tarayıcı başlatma özelliği üzerinden çağrıldığında, uygulamanın NativeApplication nesnesi bir BrowserInvokeEvent nesnesi gönderir. Ayrıntılar için bkz. Tarayıcıdan AIR uygulaması başlatma (ActionScript geliştiricileri için) veya Tarayıcıdan AIR uygulaması başlatma (HTML geliştiricileri için).

Tarayıcı başlatma özelliğini kullanırsanız, güvenlik sonuçlarını dikkate aldığınızdan emin olun. Bu sonuçlar, Tarayıcıdan AIR uygulaması başlatma (ActionScript geliştiricileri için) ve Tarayıcıdan AIR uygulaması başlatma (HTML geliştiricileri için) başlıklarında açıklanmaktadır.

Uygulama çalıştıktan sonra, LocalConnection sınıfını kullanarak tarayıcıdaki SWF içeriğiyle iletişim kurabilir. Daha fazla bilgi için bkz. Diğer Flash Player ve AIR örnekleri ile iletişim (ActionScript geliştiricileri için) veya Diğer Flash Player ve AIR örnekleri ile iletişim (HTML geliştiricileri için).