AIR for TV uygulaması tanımlayıcısı özellikleri

Diğer AIR uygulamalarında olduğu gibi, temel uygulama özelliklerini uygulama tanımlayıcı dosyasında ayarlarsınız. TV profili uygulamaları pencere boyutu ve saydamlık gibi bazı masaüstüne özgü özellikleri yok sayar. extendedTV profilindeki aygıtları hedefleyen uygulamalar yerel uzantıları kullanabilir. Bu uygulamalar bir extensions öğesinde kullanılan yerel uzantıları tanımlar.

Ortak ayarlar

Çeşitli uygulama tanımlayıcısı ayarları tüm TV profili uygulamaları için önemlidir.

Gerekli AIR çalışma zamanı sürümü

Uygulama tanımlayıcı dosyasının ad alanını kullanarak uygulamanızın gerektirdiği AIR çalışma zamanı sürümünü belirtin.

application öğesinde atanan ad alanı büyük bir bölümünde uygulamanızın hangi özellikleri kullandığını belirler. Örneğin, AIR 2.5 ad alanını kullanan bir uygulama olduğunu, ancak kullanıcının daha sonraki bir sürüme sahip olduğunu düşünün. Bu durumda, uygulama davranış sonraki AIR sürümünde farklı olsa bile AIR 2.5 davranışını görür. Yalnızca ad alanını değiştirdiğinizde ve bir güncelleme yayınladığınızda uygulamanız yeni davranışa ve özelliklere erişebilir. Güvenlik düzeltmeleri bu kuraldaki önemli istisnalardır.

Ad alanını kök application öğesinin xmlns niteliğini kullanarak belirtin:

<application xmlns="http://ns.adobe.com/air/application/2.5">

AIR 2.5, TV uygulamalarını destekleyen ilk AIR sürümüdür.

Uygulama kimliği

Yayınladığınız her uygulama için birkaç ayar benzersiz olmalıdır. Bu ayarlar id , name ve filename öğelerini içerir.

<id>com.example.MyApp</id> 
<name>My Application</name> 
<filename>MyApplication</filename>

Uygulama sürümü

Uygulama sürümünü versionNumber öğesinde belirtin. versionNumber için değer belirtirken noktalarla ayrılmış, üç numaraya kadar sayı içerebilen şunun gibi bir sıralama kullanabilirsiniz: “0.1.2”. Sürüm numarasının her bir parçası en fazla üç basamak içerebilir. (Başka bir deyişle, "999.999.999" izin verilen en büyük sürüm sayısıdır.) Sayıda tüm parçaları içermeniz gerekmez; “1” ve “1.0” örnekleri de geçerli sayılardır.

Ayrıca versionLabel öğesini kullanan sürüm için de bir etiket belirtebilirsiniz. Sürüm etiketi eklediğinizde sürüm numarasının yerine görüntülenir.

<versionNumber>1.23.7<versionNumber> 
<versionLabel>1.23 Beta 7</versionLabel>

Ana uygulama SWF'si

initialWindow öğesinin versionLabel alt öğesinde ana uygulama SWF dosyasını belirtin. TV profilindeki aygıtları hedef aldığınızda, bir SWF dosyası kullanmanız gerekir (HTML tabanlı uygulamalar desteklenmez).

<initialWindow> 
    <content>MyApplication.swf</content> 
</initialWindow>

Dosyayı AIR paketine dahil etmeniz gerekir (ADT veya IDE'nizi kullanarak) Uygulama tanımlayıcısında ada başvurmak dosyanın otomatik olarak pakete dahil olmasını sağlamaz.

Ana ekran özellikleri

Ana uygulama ekranının ilk görünümünü ve davranışını initialWindow öğesinin çeşitli alt öğeleri denetler. Bu özelliklerin çoğu TV profillerindeki aygıtlarda yok sayılsa da fullScreen öğesini kullanabilirsiniz:

  • fullScreen — Uygulamanın tam aygıt ekranına mı geçmesi gerektiğini yoksa ekranı normal işletim sistemi kromuyla paylaşması mı gerektiğini belirtir.

    <fullScreen>true</fullScreen>

Visible öğesi

visible öğesi initialWindow öğesinin bir alt öğesidir. Uygulamanızın içeriği TV için AIR aygıtlarında her zaman görünür olduğundan, TV için AIR visible öğesini yoksayar.

Ancak uygulamanız aynı zamanda masaüstü aygıtlarını da hedefliyorsa visible öğesini true olarak ayarlayın.

Masaüstü aygıtlarda bu öğenin değeri varsayılan olarak false şeklindedir. Bu nedenle, visible öğesini dahil etmezseniz uygulamanın içeriği masaüstü aygıtlarda görünür olmaz. Masaüstü aygıtlarında içeriği görünür kılmak için ActionScript sınıfı olan NativeWindow sınıfını kullanabilseniz de, TV aygıt profilleri NativeWindow sınıfını desteklemez. TV için AIR aygıtında çalışan bir uygulamada NativeWindow sınıfını kullanmayı denerseniz uygulama yüklenemez. NativeWindow sınıfının bir yöntemini çağırmış olup olmamanız durumu değiştirmez; bu sınıfı kullanan bir uygulama TV için AIR aygıtında yüklenmez.

Desteklenen profiller

Uygulamanız yalnızca televizyon aygıtında anlamlıysa, diğer bilgi işlem aygıtlarında yüklenmesini engelleyebilirsiniz. Diğer profilleri supportedProfiles öğesindeki desteklenenler listesinin dışında bırakın:

<supportedProfiles>tv extendedTV</supportedProfiles>

Bir uygulama yerel uzantı kullanıyorsa, desteklenen profil listesine yalnızca extendedTV profilini dahil edin:

<supportedProfiles>extendedTV</supportedProfiles>

supportedProfiles öğesini yok sayarsanız uygulamanın tüm profilleri desteklediği varsayılır.

supportedProfiles listesine yalnızca tv profilini dahil etmeyin. Bazı TV aygıtları, TV için AIR'yi her zaman extendedTV profiline karşılık gelen bir modda çalıştırır. Bu davranış sayesinde TV için AIR yerel uzantılar kullanan uygulamaları çalıştırabilir. supportedProfiles öğeniz yalnızca tv öğesini belirtiyorsa, bu içeriğinizin extendedTV profiline yönelik TV için AIR modu ile uyumlu olmadığını gösterir. Bu nedenle, bazı TV aygıtları yalnızca tv profilini belirten bir uygulamayı yüklemez.

tv ve extendedTV profillerinde desteklenen ActionScript sınıflarının bir listesi için bkz. Farklı profillerin yetenekleri .

Gerekli yerel uzantılar

extendedTV profilini destekleyen uygulamalar yerel uzantıları kullanabilir.

extensions ve extensionID öğelerini kullanarak uygulama tanımlayıcısında AIR uygulamasının kullandığı tüm yerel uzantıları bildirin. Aşağıdaki örnek, gerekli iki yerel uzantıyı belirtmeye yönelik sözdizimini gösterir:

<extensions> 
     <extensionID>com.example.extendedFeature</extensionID> 
    <extensionID>com.example.anotherFeature</extensionID> 
</extensions>

Bir uzantı listelenmemişse uygulama bunu kullanamaz.

extensionID öğesi uzantı tanımlayıcı dosyasındaki id öğesiyle aynı değere sahiptir. Uzantı tanımlayıcı dosyası extension.xml adlı bir XML dosyasıdır. Aygıt üreticisinden aldığınız ANE dosyasında paketlidir.

Bir uzantıyı extensions öğesinde listelerseniz, ancak uzantı TV için AIR aygıtında yüklü değilse uygulama çalışmaz. TV için AIR uygulamanızla birlikte paketlediğiniz ANE dosyası uzantının bir saplama sürümüne sahipse kuralda istisnai bir durum oluşur. Bu durumda uygulama çalışabilir ve uzantının saplama sürümünü kullanır. Saplama sürümü ActionScript koduna sahiptir, ancak yerel koda sahip değildir.

Uygulama simgeleri

Televizyon aygıtlarındaki uygulama simgesi gereksinimleri aygıta bağlıdır. Örneğin, şunları aygıt üreticisi belirtir:
  • Gerekli simgeleri ve simge boyutlarını.

  • Gerekli dosya türlerini ve adlandırma kurallarını.

  • Uygulamanız için simgelerin nasıl sağlanacağını. Örneğin, uygulamanızla birlikte simgelerin paketlenip paketlenmeyeceğini belirtir.

  • Simgelerin uygulama tanımlayıcı dosyasında icon öğesi içinde belirtilip belirtilmeyeceği.

  • Uygulama simgeleri sağlamazsa sergilenecek davranışı.

Ayrıntılar için aygıt üreticisine başvurun.

Yoksayılan ayarlar

Televizyon aygıtlarındaki uygulamalar mobil, yerel pencere veya masaüstü işletim sistemi özellikleri için geçerli olan uygulama ayarlarını yok sayar. Yoksayılan ayarlar şunlardır:

  • allowBrowserInvocation

  • aspectRatio

  • autoOrients

  • customUpdateUI

  • fileTypes

  • height

  • installFolder

  • maximizable

  • maxSize

  • minimizable

  • minSize

  • programMenuFolder

  • renderMode

  • resizable

  • systemChrome

  • title

  • transparent

  • visible

  • width

  • x

  • y