iOS の設定

Adobe AIR 3.3 以降のバージョンでは、以下の特定のバックグラウンド動作を有効にすることで、iOS でのマルチタスクがサポートされます。

• オーディオ

• 位置情報の更新

• ネットワーク

• アプリケーションのバックグラウンドでの実行の終了

<InfoAdditions> 
                                <![CDATA[ 
                                <key>UIBackgroundModes</key> 
                                <array> 
                                <string>audio</string> 
                                </array> 
                                ]]> 
                                </InfoAdditions>

<InfoAdditions> 
                                <![CDATA[ 
                                <key>UIBackgroundModes</key> 
                                <array> 
                                <string>location</string> 
                                </array> 
                                ]]> 
                                </InfoAdditions>

<InfoAdditions> 
                                <![CDATA[ 
                                <key>UIApplicationExitsOnSuspend</key> 
                                <true/> 
                                ]]> 
                                </InfoAdditions>

AIR は、生成された Info.plist ファイルに複数のエントリを設定して、アプリケーションとランタイム機能が正しく動作するようにします。次の設定を定義することはできません。

iPad をサポートするには、 InfoAdditions エレメント内に UIDeviceFamily の適切なキーと値の設定を含めます。 UIDeviceFamily 設定は string の配列です。各 string ではサポートするデバイスを定義します。 <string>1</string> 設定は、iPhone および iPod Touch のサポートを定義します。 <string>2</string> 設定は iPad のサポートを定義します。 <string>3</string> 設定は tvOS のサポートを定義します。これらの設定の一方のみを指定した場合、そのデバイス群のみがサポートされます。例えば、次の設定では iPad のサポートのみに限定されます。

<key>UIDeviceFamily</key> 
                            <array> 
                            <string>2</string> 
                            </array>>

次の設定では、両方のデバイス群（iPhone/iPod Touch と iPad）がサポートされます。

<key>UIDeviceFamily</key> 
                            <array> 
                            <string>1</string> 
                            <string>2</string> 
                            </array>

さらに、AIR 3.7 以降では forceCPURenderModeForDevices タグを使用して、指定したデバイスのセットに対して強制的に CPU レンダリングモードを使用し、その他の iOS デバイスに対しては GPU レンダリングモードを有効にすることができます。

このタグは iPhone タグの子として追加し、デバイスのモデル名のリストをスペース区切りで指定します。有効なデバイスのモデル名のリストについては、 forceCPURenderModeForDevices を参照してください。

例えば、旧バージョンの iPod、iPhone、iPad で CPU モードを使用し、その他のすべてのデバイスで GPU モードを有効にするには、アプリケーション記述子で以下を指定します。

... 
                            <renderMode>GPU</renderMode> 
                            ... 
                            <iPhone> 
                            ... 
                               <forceCPURenderModeForDevices>iPad1,1 iPhone1,1 iPhone1,2 iPod1,1 
                               </forceCPURenderModeForDevices> 
                            </iPhone>

requestedDisplayResolution エレメントでは、アプリケーションが、高解像度画面を備えた iOS デバイスで 標準 解像度モードと 高 解像度モードのどちらを使用するのかを指定します。

<requestedDisplayResolution>high</requestedDisplayResolution>

高解像度モードでは、高解像度ディスプレイの各ピクセルを個別に処理できます。標準解像度モードでは、デバイスの画面は、アプリケーションに対して標準解像度画面として示されます。標準モードで単一のピクセルを描画すると、高解像度画面で 4 つのピクセルの色が設定されます。

デフォルト設定は、 standard （標準）です。iOS デバイスを対象とする場合は、 requestedDisplayResolution エレメントを、（ InfoAdditions エレメントや initialWindow エレメントではなく） iPhone エレメントの子として使用します。

デバイスごとに異なる設定を使用する場合は、 requestedDisplayResolution エレメントの値としてデフォルト値を指定します。また、 excludeDevices 属性を使用して、その逆の値を使用するデバイスを指定します。例えば、以下のコードでは、第 3 世代 iPad 以外の高解像度モードをサポートするすべてのデバイスで高解像度モードを使用し、第 3 世代 iPad では標準モードを使用します。

<requestedDisplayResolution excludeDevices="iPad3">high</requestedDisplayResolution>

excludeDevices 属性は、AIR 3.6 以降で使用できます。

カスタム URI スキームを登録することにより、デバイス上にある Web ページ内のリンクやその他のネイティブアプリケーションからアプリケーションを呼び出せるようになります。URI スキームを登録するには、InfoAdditions エレメントに CFBundleURLTypes キーを追加します。次の例では、 com.example.app という名前の URI スキームを登録し、 example://foo という形式の URL からアプリケーションを呼び出せるようにします。

<key>CFBundleURLTypes</key> 
                            <array> 
                            <dict> 
                            <key>CFBundleURLSchemes</key> 
                            <array> 
                            <string>example</string> 
                            </array> 
                            <key>CFBundleURLName</key> 
                            <string>com.example.app</string> 
                            </dict> 
                            </array>

アプリケーションがカスタム URI を介して呼び出されると、NativeApplication オブジェクトは invoke イベントを送出します。クエリーパラメーターを含むリンクの URL は、InvokeEvent オブジェクトの arguments 配列に配置されます。任意の数のカスタム URI スキームを使用できます。

特定のハードウェアまたはソフトウェア機能を持つデバイスでのみアプリケーションを使用できるようにする場合は、 InfoAdditions エレメント内の UIRequiredDeviceCapabilities 配列にエントリを追加します。例えば、次のエントリは、アプリケーションはスチールカメラとマイクを必要としていることを示しています。

<key>UIRequiredDeviceCapabilities</key> 
                            <array> 
                            <string>microphone</string> 
                            <string>still-camera</string> 
                            </array>

対応する機能がデバイスにない場合は、アプリケーションはインストールできません。AIR アプリケーションに関連する機能の設定には次のものが含まれます。

AIR 2.6 以降では、必須機能のリストに armv7 と opengles-2 が自動的に追加されます。

ユーザーが AIR アプリケーションから切り替えると、AIR アプリケーションはバックグラウンドモードに入り一時停止します。アプリケーションを一時停止せずに完全に終了する場合は、 UIApplicationExitsOnSuspend プロパティを YES に設定します。

<key>UIApplicationExitsOnSuspend</key> 
                            <true/>

アプリケーションによって使用される SWF のサブセットをパッケージ化し、 Loader.load() メソッドを使用してランタイムでその他の（アセットのみの）外部 SWF をロードすることで、最初のアプリケーションのダウンロードサイズを最小限に抑えることができます。この機能を使用するには、ADT がアセットのみを含む SWF ファイルを残し、外部でロードされた SWF ファイルからメインアプリケーションの SWF にすべての ActionScript バイトコード（ABC）を移動するアプリケーションをパッケージ化する必要があります。これは、アプリケーションがインストールされた後にコードをダウンロードすることを禁じる Apple Store のルールに従うためです。

ADT は、外部でロードされた SWF（除外された SWF とも呼ばれます）をサポートするために以下を行います。

• <iPhone> エレメントの <externalSwfs> サブエレメント内で指定されたテキストファイルを読み取って、実行時にロードされる SWF の行区切りリストにアクセスします。

  <iPhone> 
                                         ... 
                                         <externalSwfs>FilewithPathsOfSWFsThatAreToNotToBePackaged.txt</externalSwfs> 
                                      </iPhone>

• 外部でロードされた各 SWF からメインの実行可能ファイルに ABC コードを転送します。

• 外部でロードされた SWF を .ipa ファイルから除外します。

• 除外された SWF を .remoteStrippedSWFs ディレクトリにコピーします。これらの SWF を Web サーバーでホストすると、アプリケーションはこれらを必要に応じてランタイムにロードします。

以下の例のように、テキストファイルで 1 行に 1 つずつ名前を指定して、ランタイムでロードする SWF ファイルを指定します。

assets/Level1/Level1.swf 
                            assets/Level2/Level2.swf 
                            assets/Level3/Level3.swf 
                            assets/Level4/Level4.swf

指定するファイルパスは、アプリケーション記述ファイルからの相対パスです。また、これらの swf は adt コマンドでアセットとして指定する必要があります。

サンプルコードを含め、この機能について詳細は、アドビのエンジニア Abhinav Dhandh のブログ「 External hosting of secondary SWFs for AIR apps on iOS 」を参照してください。

Geolocation をサポートするために、以下のいずれかのキーと値のペアを InfoAdditions エレメントに追加します。

<InfoAdditions> 
                            <![CDATA[ 
                            <key>NSLocationAlwaysUsageDescription</key> 
                            <string>Sample description to allow geolocation always</string> 
                            <key>NSLocationWhenInUseUsageDescription</key> 
                            <string>Sample description to allow geolocation when application is in foreground</string>               
                            ]]> 
                            </InfoAdditions>