Egenskaper i programbeskrivningsfilen för AIR for TV

Ange den version av AIR-miljön som krävs för ditt program med hjälp av namnutrymmet i programbeskrivningsfilen.

Namnutrymmet, som tilldelas i elementet application , avgör till stor del vilka funktioner ditt program kan använda. Tänk dig till exempel ett program som använder AIR 2.5-namnutrymmet, men där användaren har en senare version installerad. I så fall ser ditt program AIR 2.5-beteendet, även om beteendet har ändrats i den senare AIR-versionen. Ditt program får inte tillgång till de nya beteendena och funktionerna förrän du ändrar namnutrymmet och publicerar en uppdatering. Säkerhetskorrigeringar är viktiga undantag till den här regeln.

Ange namnutrymmet med xmlns -attributet för rotelementet application :

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

AIR 2.5 är den första versionen av AIR som har stöd för tv-program.

Det är flera inställningar som bör vara unika för varje program du publicerar. Bland dessa inställningar finns elementen id , name och filename .

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

Ange programversionen i elementet versionNumber . När du anger ett värde för versionNumber kan du använda en sekvens med upp till tre siffror, åtskilda med punkter, t.ex. ”0.1.2”. Varje segment i versionsnumret kan ha upp till tre siffror. (Följaktligen är ”999.999.999” det största versionsnummer som tillåts.) Du behöver inte inkludera alla tre segment i versionsnumret; "1" och "1.0" är också giltiga versionsnummer.

Du kan också ange en etikett för versionen med elementet versionLabel . När du lägger till en versionsetikett visas den i stället för versionsnumret.

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

Ange den huvudsakliga SWF-programfilen i det underordnade versionLabel -elementet för initialWindow -elementet. När du har enheter i tv-profilen som mål måste du använda en SWF-fil (HTML-baserade program stöds inte).

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

Du måste inkludera filen i AIR-paketet (med ADT eller den integrerade utvecklingsmiljön). Det räcker inte att bara referera till namnet i programbeskrivningen för att filen automatiskt ska inkluderas i paketet.

Flera underordnade element till elementet initialWindow styr det inledande utseendet och beteendet för huvudprogramskärmen. De flesta av dessa egenskaper ignoreras på enheter i tv-profilerna, men du kan använda elementet fullScreen :

• fullScreen – Anger om programmet får uppta hela enhetens skärm eller om det ska dela skärmen med vanliga systemkontroller.

  <fullScreen>true</fullScreen>

Elementet visible är ett underordnat element till initialWindow -elementet. I AIR for TV ignoreras visible -elementet eftersom programmets innehåll alltid visas på AIR for TV-enheter.

Du kan emellertid ställa in true för visible -elementet om programmet även ska användas på datorer.

På datorer är elementets standardvärde false . Om du därför inkluderar elementet visible kommer programinnehållet att visas på en dator. Trots att du kan använda ActionScript-klassen NativeWindow för att göra innehållet synligt på datorer, har tv-enhetsprofilerna inte stöd för klassen NativeWindow. Programmet kommer inte att läsas in om du försöker använda klassen NativeWindow i ett program som körs på en AIR for TV-enhet. Det har ingen betydelse om du anropar en metod i klassen NativeWindow; ett program som använder klassen kommer inte att läsas in på AIR for TV-enheter.

Om ditt program bara är avsett för tv-enheter kan du förhindra att det kan installeras på andra sorters enheter. Uteslut andra profiler från listan över profiler som stöds i elementet supportedProfiles :

<supportedProfiles>tv extendedTV</supportedProfiles>

Om ett program använder ett ANE-tillägg inkluderar du endast profilen extendedTV i listan över profiler som stöds:

<supportedProfiles>extendedTV</supportedProfiles>

Om du utelämnar elementet supportedProfiles antas programmet ha stöd för alla profiler.

Inkludera inte enbart tv -profilen i supportedProfiles -listan. Vissa tv-enheter kör alltid AIR for TV i ett läge som motsvarar profilen extendedTV . Detta beteende innebär att AIR for TV kan köra program där ANE-tillägg används. Om supportedProfiles -elementet endast anger tv , innebär det att innehållet inte är kompatibelt med AIR for TV-läget för extendedTV . Därför kommer vissa tv-apparater inte att läsa in program som endast anger tv -profilen.

En lista över de ActionScript-klasser som stöds i profilerna tv och extendedTV finns i Funktioner i de olika profilerna .