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