Właściwości deskryptora aplikacji AIR dla urządzeń telewizyjnych

Wersję środowiska wykonawczego AIR, która jest wymagana przez aplikację, należy określić przy użyciu przestrzeni nazw pliku deskryptora aplikacji.

Przestrzeń nazw (przypisana w elemencie application ) w dużej mierze określa funkcje, których aplikacja może używać. Na przykład aplikacja korzysta z przestrzeni nazw środowiska AIR 2.5, ale użytkownik ma zainstalowaną nowszą wersję. W takim wypadku aplikacja nadal rozpoznaje zachowania środowiska AIR 2.5, nawet jeśli są one inne w nowszej wersji środowiska AIR. Dopiero zmiana przestrzeni nazw i opublikowanie aktualizacji pozwoli aplikacji na uzyskanie dostępu do nowych zachowań i funkcji. Poprawki zabezpieczeń stanowią ważny wyjątek od tej reguły.

Przestrzeń nazw należy określić przy użyciu atrybutu xmlns głównego elementu application .

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

Aplikacje AIR dla urządzeń telewizyjnych są obsługiwane od środowiska AIR w wersji 2.5.

Niektóre ustawienia powinny być niepowtarzalne dla każdej publikowanej aplikacji. Do tych ustawień należą elementy id , name , i filename .

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

Wersję aplikacji należy określić w elemencie versionNumber . Podczas określania wartości w elemencie versionNumber można użyć maksymalnie trzech liczb oddzielonych kropkami, na przykład „0.1.2”. Każda z tych liczb w numerze wersji może zawierać do trzech cyfr. Innymi słowy, największym dozwolonym numerem wersji jest „999.999.999”. Numer wersji nie musi zawierać wszystkich trzech liczb. Zarówno „1”, jak i „1.0” stanowią prawidłowe numery wersji.

Element versionLabel pozwala określić etykietę wersji. Po dodaniu etykieta wersji jest wyświetlana zamiast numeru wersji.

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

Należy określić główny plik SWF aplikacji w elemencie potomnym versionLabel elementu initialWindow . Podczas wskazywania urządzeń docelowych w profilu tv należy użyć pliku SWF. (Aplikacje oparte na standardzie HTML nie są obsługiwane).

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

Plik musi zostać umieszczony w pakiecie aplikacji AIR (przy użyciu narzędzia ADT lub środowiska programistycznego). Samo umieszczenie odniesienia do nazwy w deskryptorze aplikacji nie powoduje automatycznego zawarcia pliku w pakiecie.

Kilka elementów potomnych elementu initialWindow steruje początkowym wyglądem i działaniem ekranu głównego aplikacji. Większość z tych właściwości jest ignorowana na urządzeniach o profilu telewizyjnym. Można używać elementu fullScreen .

• Element fullScreen określa, czy aplikacja ma zajmować cały ekran urządzenia, czy współużytkować go z normalną karnacją systemu operacyjnego.

  <fullScreen>true</fullScreen>

Element visible jest elementem potomnym elementu initialWindow . Środowisko AIR dla urządzeń telewizyjnych ignoruje element visible , ponieważ zawartość aplikacji jest zawsze widoczna na urządzeniach telewizyjnych ze środowiskiem AIR.

Jednak dla elementu visible należy ustawić wartość true , jeśli aplikacja jest przeznaczona również dla komputerów.

Na komputerach ten element ma wartość domyślną false . Oznacza to, że jeśli element visible nie zostanie uwzględniony, zawartość aplikacji nie będzie widoczna na komputerach. Klasa NativeWindow języka ActionScript pozwala wyświetlać zawartość na komputerach, ale profile urządzeń telewizyjnych nie obsługują tej klasy. Jeśli zostanie podjęta próba użycia klasy NativeWindow w aplikacji uruchamianej na urządzeniu telewizyjnym ze środowiskiem AIR, wczytywanie aplikacji nie powiedzie się. Niezależnie od tego, czy jest wywoływana dowolna z metod klasy NativeWindow, aplikacja korzystająca z tej klasy nie jest wczytywana na urządzeniu telewizyjnym ze środowiskiem AIR.

Jeśli działanie aplikacji ma sens wyłącznie na urządzeniu telewizyjnym, wówczas można uniemożliwić jej instalację na urządzeniach innych typów. Element supportedProfiles pozwala wykluczyć inne profile z listy obsługiwanych.

<supportedProfiles>tv extendedTV</supportedProfiles>

Jeśli aplikacja korzysta z rozszerzenia natywnego, na liście obsługiwanych profilów należy umieścić tylko profil extendedTV .

<supportedProfiles>extendedTV</supportedProfiles>

Pominięcie elementu supportedProfiles jest jednoznaczne z obsługiwaniem przez aplikację wszystkich profilów.

Nie należy umieszczać wyłącznie profilu tv na liście supportedProfiles . Niektóre urządzenia telewizyjne zawsze uruchamiają środowisko AIR dla urządzeń telewizyjnych w trybie odpowiadającym profilowi extendedTV . Dzięki temu środowisko AIR dla urządzeń telewizyjnych może uruchamiać aplikacje korzystające z rozszerzeń natywnych. Jeśli w elemencie supportedProfiles jest określony wyłącznie profil tv , taka deklaracja oznacza, że zawartość jest niezgodna z trybem środowiska AIR dla urządzeń telewizyjnych dotyczącym profilu extendedTV . Dlatego niektóre urządzenia telewizyjne nie wczytują aplikacji określających wyłącznie profil tv .

Listę klas ActionScript obsługiwanych w profilach tv i extendedTV podano w temacie Możliwości różnych profili .