AIR for TV アプリケーション記述子のプロパティ

アプリケーション記述ファイルの名前空間を使用して、アプリケーションに必要な AIR ランタイムのバージョンを指定します。

application エレメントに割り当てられている名前空間によって、アプリケーションが使用する機能の大部分が決まります。例えば、アプリケーションでは AIR 2.5 名前空間を使用しているが、ユーザーが将来のバージョンの AIR をインストールしている場合を考えてみましょう。この場合、将来のバージョンの AIR では動作が異なっていても、アプリケーションでは AIR 2.5 の動作を参照します。名前空間を変更し、アップデートをパブリッシュした場合にのみ、アプリケーションは新しい動作と機能にアクセスできます。セキュリティの修正は、この規則には該当しない重要な例外です。

ルートの application エレメントの xmlns 属性を使用して、名前空間を指定します。

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

AIR 2.5 は、テレビアプリケーションをサポートする最初の AIR バージョンです。

いくつかの設定は、パブリッシュするアプリケーションごとに一意にする必要があります。例えば、 id エレメント、 name エレメントおよび filename エレメントの設定が該当します。

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

versionNumber エレメントでアプリケーションのバージョンを指定します。 versionNumber の値を指定するとき、一連の数値をドットで 3 つまで区切って指定することができます。例えば、「0.1.2」のようにします。バージョン番号の各セグメントには、3 桁までの数字を指定できます（つまり、「999.999.999」が、許可される最大のバージョン番号になります）。番号に 3 つのセグメントをすべて含める必要はありません。「1」や「1.0」なども有効なバージョン番号です。

versionLabel エレメントを使用して、バージョンのラベルを指定することもできます。バージョンのラベルを追加すると、バージョン番号の代わりに表示されます。

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

メインアプリケーションの SWF ファイルを、 initialWindow エレメントの子である versionLabel に指定します。tv プロファイルでデバイスをターゲットにするとき、SWF ファイルを使用する必要があります（HTML ベースのアプリケーションはサポートされていません）。

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

ファイルは AIR パッケージに含める必要があります（ADT または IDE を使用します）。アプリケーション記述子内の名前を参照するだけでは、ファイルはパッケージに自動的には取り込まれません。

initialWindow エレメントの子エレメントのいくつかは、メインアプリケーション画面の最初の外観と動作を制御します。これらのプロパティのほとんどはテレビプロファイル内のデバイスでは無視されますが、次の fullScreen エレメントは使用することができます。

• fullScreen - アプリケーションが、デバイスの画面全体を使用するか、通常のオペレーティングシステムクロムと画面を共有するかを指定します。

  <fullScreen>true</fullScreen>

visible エレメントは、 initialWindow エレメントの子エレメントです。AIR for TV デバイスではアプリケーションのコンテンツが常に表示されるため、AIR for TV では visible エレメントは無視されます。

ただし、アプリケーションがデスクトップデバイスもターゲットにしている場合は、 visible エレメントを true に設定します。

デスクトップデバイスで、このエレメントのデフォルト値は false です。したがって、 visible エレメントを含めないと、アプリケーションのコンテンツはデスクトップデバイスで表示されなくなります。ActionScript クラスの NativeWindow を使用することによってデスクトップデバイスにコンテンツを表示することもできますが、テレビのデバイスプロファイルでは NativeWindow クラスはサポートされません。AIR for TV デバイスで実行されているアプリケーションで NativeWindow クラスを使用すると、そのアプリケーションは読み込めなくなります。NativeWindow クラスのメソッドを呼び出すかどうかに関係なく、このクラスを使用しているアプリケーションを AIR for TV デバイスに読み込むことはできません。

アプリケーションがテレビデバイスにのみ対応する場合は、他の種類のコンピューティングデバイスへのインストールを防ぐことができます。 supportedProfiles エレメント内のサポートされるプロファイルのリストから、その他のプロファイルを除外します。

<supportedProfiles>tv extendedTV</supportedProfiles>

アプリケーションでネイティブ拡張を使用している場合は、サポートされるプロファイルリストに extendedTV プロファイルのみを含めます。

<supportedProfiles>extendedTV</supportedProfiles>

supportedProfiles エレメントを省略すると、アプリケーションはすべてのプロファイルをサポートするものと見なされます。

supportedProfiles リストに tv プロファイルのみを含めることは避けてください。一部のテレビデバイスでは、AIR for TV は常に、 extendedTV プロファイルに対応するモードで実行されます。この動作は、ネイティブ拡張を使用するアプリケーションを実行できるようにするためです。 supportedProfiles エレメントで tv しか指定しないと、コンテンツに AIR for TV の extendedTV 用モードとの互換性がないと宣言していることになります。 tv プロファイルしか指定されていないアプリケーションが一部のテレビデバイスで読み込まれないのは、そのためです。

tv および extendedTV プロファイルでサポートされている ActionScript クラスの一覧については、 様々なプロファイルの機能 を参照してください。