Eigenschappen van het descriptorbestand van de AIR for TV-toepassing

Geef de versie op van de AIR-runtime die wordt vereist door uw toepassing en gebruik daarbij de naamruimte van het toepassingsdescriptorbestand.

De naamruimte, die wordt toegewezen in het application -element, bepaalt voor een groot deel welke functies uw toepassing kan gebruiken. Neem bijvoorbeeld een toepassing die de AIR 2.5-naamruimte gebruikt, maar waarvan de gebruiker een nieuwere versie heeft geïnstalleerd. In dit geval vertoont de toepassing toch de functionaliteit van AIR 2.5, ook als deze afwijkt van de nieuwere AIR-versie. Uw toepassing heeft uitsluitend toegang tot de nieuwe functionaliteit en functies als u de naamruimte wijzigt en een update publiceert. Beveiligingsfixes zijn een belangrijke uitzondering op deze regel.

Geef de naamruimte op met behulp van het xmlns -attribuut van het basiselement application :

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

AIR 2.5 is de eerste versie van AIR die tv-toepassingen ondersteunt.

Verschillende instellingen moeten uniek zijn voor elke toepassing die u publiceert. Deze instellingen bevatten de elementen id , name en filename .

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

Geef de toepassingsversie op in het element versionNumber . Wanneer u een waarde opgeeft voor versionNumber , kunt u een reeks gebruiken van hoogstens drie nummers, gescheiden door punten, zoals "0.1.2". Elk segment van het versienummer kan hoogstens drie cijfers hebben. (Met andere woorden: “999.999.999” is het hoogste versienummer dat is toegestaan.) U hoeft niet alle drie de segmenten in het cijfer op te nemen. “1” en “1.0” zijn ook geldige versienummers.

U kunt ook een label voor de versie opgeven met behulp van het element versionLabel . Wanneer u een versielabel toevoegt, wordt dit weergegeven in plaats van het versienummer.

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

Geef het hoofdtoepassings-SWF-bestand op in het onderliggende element versionLabel van het element initialWindow . Wanneer u apparaten in het tv-profiel als doel instelt, moet u een SWF-bestand gebruiken (HTML-toepassingen worden niet ondersteund).

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

U moet het bestand in het AIR-pakket opnemen (met behulp van ADT of uw IDE). Door alleen te verwijzen naar de naam in de toepassingsdescriptor wordt het bestand niet automatisch in het pakket opgenomen.

Verschillende onderliggende elementen van het element initialWindow bepalen de initiële weergave en de functionaliteit van het hoofdscherm van de toepassing. De meeste van deze eigenschappen worden genegeerd op apparaten in de tv-profielen, maar u kunt het element fullScreen wel gebruiken:

• fullScreen — Geeft op of de toepassing de volledige weergave moet gebruiken, of de weergave moet delen met de standaardinterface.

  <fullScreen>true</fullScreen>

Het element visible is een onderliggend element van het element initialWindow initialWindow AIR for TV negeert het element visible , omdat de inhoud van uw toepassing altijd zichtbaar is op AIR for TV-apparaten.

Stel het element visible echter in op true als uw toepassing ook bestemd is voor bureaubladapparatuur.

Op bureaubladapparatuur is de standaardwaarde van dit element false . Als u het element visible dus niet opneemt, is de inhoud van de toepassing niet zichtbaar op bureaubladapparatuur. Hoewel u de ActionScript-klasse NativeWindow kunt gebruiken om inhoud zichtbaar te maken op bureaubladapparatuur, ondersteunen TV-apparaatprofielen de klasse NativeWindow niet. Als u probeert de klasse NativeWindow te gebruiken voor een toepassing die wordt uitgevoerd op een AIR for TV-apparaat, kan de toepassing niet worden geladen. Het maakt niet uit of u een methode van de klasse NativeWindow aanroept, toepassingen die deze klasse gebruiken, worden niet geladen op AIR for TV-apparaten.

Als uw toepassing uitsluitend is bedoeld voor televisie, kunt u de installatie ervan op andere typen apparaten voorkomen. Sluit de overige profielen uit in de lijst met ondersteunde profielen in het element supportedProfiles :

<supportedProfiles>tv extendedTV</supportedProfiles>

Als een toepassing een native extensie gebruikt, neemt u alleen het extendedTV -profiel op in de lijst met ondersteunde profielen:

<supportedProfiles>extendedTV</supportedProfiles>

Als u het element supportedProfiles weglaat, wordt aangenomen dat de toepassing alle profielen ondersteunt.

Neem niet alleen het profiel tv op in de lijst supportedProfiles . Op sommige tv-apparaten wordt AIR for TV altijd uitgevoerd in een modus die overeenkomt met het profiel extendedTV . Op deze manier kan AIR for TV toepassingen uitvoeren die native extensies gebruiken. Als uw element supportedProfiles alleen tv opgeeft, wordt aangegeven dat uw inhoud niet compatibel is met de AIR for TV-modus voor extendedTV . Daarom worden toepassingen die alleen het profiel tv opgeven op sommige tv's niet geladen.

Een lijst met ActionScript-klassen die worden ondersteund in de profielen tv en extendedTV vindt u in Mogelijkheden van de verschillende profielen .