Android Player 設定
このページでは、Android プラットフォームに特化した Player 設定について説明します。一般的な Player 設定の説明は、Player 設定 を参照してください。
プロパティのドキュメントは、Player UI のそれぞれのセクションに応じてグループ化されています。
- Icon (アイコン)
- Resolution and Presentation (解像度と表示)
- Splash Image (スプラッシュ画像)
- Other Settings (その他の設定)
- Publishing Settings (公開設定)
Icon
Icon セクションを使用して、デバイスでアプリケーションを表現するアイコンを指定します。
Android のアイコン設定](../uploads/Main/PlayerSetAndroidIcon.png)
| 設定 | 説明 |
|---|---|
| Adaptive | Android 8.0（API レベル 26）以上を搭載するデバイスでアプリケーションを表現する、さまざまなサイズのテクスチャを指定します。 |
| Round | Android 7.1（API レベル 25）以上を搭載するデバイスでアプリケーションを表現する、さまざまなサイズのテクスチャを指定します。 |
| Legacy | Android 7.1 (APIレベル 25)より前のバージョンを搭載するデバイスでアプリケーションを表現する、さまざまなサイズのテクスチャを指定します。 |
Resolution and Presentation
Resolution and Presentation (解像度と表示) セクションを使用して、画面の表示をカスタム化します。
| 設定 | 説明 | |
|---|---|---|
| Fullscreen Mode | デバイス上のウィンドウの表示方法を指定します。起動時のデフォルトのウィンドウモードを設定します。 | |
| Fullscreen Window | アプリケーションウィンドウは、デバイスの全画面のネイティブ解像度を埋めます。全画面ウィンドウを埋めるために、Unity はアプリケーションのコンテンツをスケールします。Resolution Scaling Mode は、Unityがコンテンツをどのようにスケールするかを制御します。このモードでは、ナビゲーションバーは常に非表示です。 | |
| Windowed | このアプリケーションは、標準の、全画面表示ではない、移動可能な画面を使用します。画面サイズはアプリケーションの解像度に依存します。このモードでは、画面はデフォルトでサイズ変更可能です。これを無効にするには、Resizable Window を無効にします。 | |
| Resizable Window | ユーザーがアプリケーションのウィンドウサイズを変更できるがどうかを示します。 この設定にすると、Android の携帯電話やタブレットで、アプリケーションのマルチウィンドウ機能が有効になります。詳しくは、Google の開発者向けドキュメント を参照してください。 |
|
| Default Window Width | アプリケーション画面のデフォルトの幅 (ピクセル単位)。このオプションは、Fullscreen Mode が Windowed に設定されている場合にのみ使用できます。 | |
| Default Window Height | アプリケーション画面のデフォルトの高さ (ピクセル単位)。このオプションは、Fullscreen Mode が Windowed に設定されている場合にのみ使用できます。 | |
| Minimum Window Width | アプリケーション画面の最小幅 (ピクセル単位)。このオプションは、Fullscreen Mode が Windowed に設定されている場合にのみ使用できます。 | |
| Minimum Window Height | アプリケーション画面の最小の高さ (ピクセル単位)。このオプションは、Fullscreen Mode が Windowed に設定されている場合にのみ使用できます。 | |
| Hide Navigation Bar | ウィンドウの上部に表示されるナビゲーションバーを非表示にするかどうかを示します。 | |
| Render outside safe area | ノッチのあるディスプレイの領域を含め、アプリケーションがレンダリングに利用可能なすべての画面スペースを使用するかどうかを示します。 詳細については、Android の ディスプレイ カットアウトのサポート のドキュメントを参照してください。 | |
| Optimized Frame Pacing | Unity がフレームレートのばらつきを少なくするために、フレームを均等に供給するかどうかを示します。このオプションを有効にすると、よりスムーズな体験が可能になります。 | |
その他の Resolution and Presentation 設定は、以下のセクションにグループ化されています。
Resolution Scaling
画面解像度のスケーリングに関する設定をカスタマイズするには、Resolution Scaling セクションを使用します。デバイスのネイティブ解像度よりも低い解像度を使用すると、パフォーマンスとバッテリー寿命が向上します。
| 設定 | 説明 | |
|---|---|---|
| Resolution Scaling Mode | アプリケーションの解像度をスケールするかどうか、またその方法を指定します。スケーリングは、ネイティブの画面解像度と同等またはそれ以下に設定できます。低い解像度を使用すると、パフォーマンスとバッテリー寿命が向上します。 | |
| Disabled | 解像度スケーリングを適用せず、アプリケーションはデバイスのネイティブ画面解像度でレンダリングします。 | |
| FixedDPI | ターゲット DPI を使用して解像度のスケーリングを適用します。パフォーマンスとバッテリ-寿命を最適化したり、特定の DPI 設定をターゲットにする場合に使用します。 | |
| Letterboxed | コンテンツが引き伸ばされないように、描画された出力に黒帯を追加します。この処理は レターボックスと と呼ばれます。 | |
| Target DPI | アプリケーションの解像度。デバイスのネイティブスクリーン DPI がこの値より高い場合、Unity はこの設定に合わせてアプリケーションの解像度をダウンスケールします。スケールを計算するには、Unity は以下を使います。min(Target DPI * Factor / Screen DPI, 1)ここで Factor は Quality settings の Resolution Scaling Fixed DPI Factor です。ノート： このオプションは、Resolution Scaling Mode を Fixed DPI に設定した場合のみ表示されます。 |
|
| Reset resolution on window resize | ネイティブウィンドウサイズが変更されたときに、画面解像度を新しいネイティブウィンドウサイズに設定するかどうかを指定します。 Resolution Scaling Mode を Fixed DPI に設定すると、Unity は Fixed DPI プロパティに基づき解像度を再計算します。 | |
| Blit Type | 最終的な画像を画面にレンダリングする際に、blit を使用するかどうかを制御します。blit の使用はほとんどのデバイスと互換性がありますが、通常、blit を使用しない場合よりも速度が低下します。 | |
| Always | Unity はオフスクリーンバッファにレンダリングし、次に blit を使用してバッファのコンテンツをデバイスのフレームバッファにコピーします。これはほとんどのデバイスと互換性がありますが、通常、blit を使用しない場合よりも速度が低下します。 | |
| Never | Unityは、デバイスのオペレーティングシステムが提供するフレームバッファにレンダリングします。これが失敗すると、アプリケーションはデバイスログに 1 回限りの警告を出力します。これは通常、blit を使用するよりも高速ですが、すべてのデバイスと互換性があるわけではありません。 | |
| Auto | Unity は、可能であればデバイスのオペレーティングシステムが提供するフレームバッファにレンダリングします。これが失敗した場合、Unity はデバイスコンソールに警告を出力し、blit を使用して最終的な画像を画面にレンダリングします。 | |
Supported Aspect Ratio
Supported Aspect Ratio セクションを使用して、サポートするデバイスのアスペクト比に関する設定をカスタマイズします。
| 設定 | 説明 | |
|---|---|---|
| Aspect Ratio Mode | アプリケーションがサポートする最大アスペクト比を指定します。デバイスのアスペクト比がこのアスペクト比より大きい場合、Unity はアプリケーションにこのアスペクト比を使用し、アプリケーションが引き伸ばされないように黒帯を追加します。 | |
| Legacy Wide Screen (1.86) | このアプリケーションは、Android の従来のワイドスクリーンアスペクト比までをサポートします。 | |
| Native Aspect Ratio | このアプリケーションは、Android のネイティブのアスペクト比までをサポートします。 | |
| Custom | このアプリケーションは、Up To で設定したアスペクト比までをサポートします。 | |
| Up To | カスタムの最大アスペクト比。 この設定は、Aspect Ratio Mode を Custom に設定したときのみ表示されます。 |
|
Orientation
Orientation セクションを使用して、デバイス上のアプリケーションの向きに関連する設定をカスタマイ ズすることができます。
Default Orientation ドロップダウンからゲームの画面の向きを選択します。
| 設定 | 説明 | |
|---|---|---|
| Default Orientation | アプリケーションが使用する画面の向きを指定します。 ノート: Unity は、この設定に設定した値を Android と iOS で共有します。 |
|
| Portrait | このアプリケーションは、アプリケーションのウィンドウの下部がデバイスの画面の下部に一致する縦向き画面を使用します。 | |
| Portrait Upside Down | このアプリケーションは、アプリケーションのウィンドウの下部とデバイスの画面の上部が一致する縦向き画面を使用します。 | |
| Landscape Right | このアプリケーションは、アプリケーションのウィンドウの右側がデバイスの画面の下部に位置する横向き画面を使用します。 | |
| Landscape Left | このアプリケーションは、アプリケーションのウィンドウの右側がデバイスの画面の上部に位置する横向き画面を使用します。 | |
| Auto Rotation | 画面は、自動回転に使用できる向き で指定した向きに回転できます。 | |
Allowed Orientations for Auto Rotation
Allowed Orientations for Auto Rotation セクションを使用して、 Default Orientation から Auto Rotation を設定するときにアプリケーションがサポートする方向を指定します。これは、例えば、アプリケーションを横向きのままして、ユーザーが横向きの左と右を切り替えられるようにする場合に便利です。
このセクションは Default Orientation が Auto Rotation に設定されている場合にのみ表示されます。
| 設定 | 説明 |
|---|---|
| Portrait | アプリケーションが、アプリケーションウィンドウの下部がデバイスの画面の下部と揃う縦向きの画面をサポートするかどうかを示します。 |
| Portrait Upside Down | アプリケーションが、アプリケーションウィンドウの下部がデバイスの画面の上部と揃う縦向きの画面をサポートするかどうかを示します。 |
| Landscape Right | アプリケーションが、アプリケーションウィンドウの右側がデバイスの画面の底部と揃う横向きの画面をサポートするかどうかを示します。 |
| Landscape Left | アプリケーションが、アプリケーションウィンドウの右側がデバイスの画面の上部と揃う横向きの画面をサポートするかどうかを示します。 |
Other
Resolution and Presentation セクションには、以下の一般設定も含まれます。
| 設定 | 説明 | |
|---|---|---|
| Use 32-bit Display Buffer | ディスプレイバッファが 16 ビットカラー値ではなく 32 ビットカラー値を保持するかどうかを示します。バンディングが発生したり、ポストプロセスエフェクト でアルファ値が必要な場合は、この設定を有効にします。ポストプロセスエフェクトの中には、ディスプレイバッファと同じ形式で レンダーテクスチャ を作成するものがあるため、この設定が必要です。 | |
| Disable Depth and Stencil | 深度バッファとステンシルバッファを無効にするかどうかを示します。 | |
| Render Over Native UI | Android または iOS で、ネイティブ UI の上にレンダリングするかどうかを示します。この設定を有効にするには、Camera の Clear Flags を設定して、アルファ値が 1 より低いソリッドカラーを使用するようにします。 | |
| Show Loading Indicator | ローディングインジケーターを表示するかどうか、またどのように表示するかを指定します。 | |
| Don’t Show | ローディングインジケーターを表示しません。 | |
| Large | 大きなローディングインジケーターを表示します。 | |
| Inversed Large | 大きなローディングインジケーターを反転色で表示します。 | |
| Small | 小さなローディングインジケーターを表示します。 | |
| Inversed Small | 小さなローディングインジケーターを反転色で表示します。 | |
Splash Image
Virtual Reality Splash Image 設定を使用して、VR ディスプレイのカスタムスプラッシュ画像を指定します。一般的なスプラッシュスクリーン の設定については、スプラッシュスクリーン を参照してください。
一般的な Splash Screen 設定の下で、Android 特有の Static Splash Image を設定できます。
| 設定 | 説明 | |
|---|---|---|
| Image | Android のスプラッシュスクリーンとしてアプリケーションが使用するテクスチャを指定します。スプラッシュスクリーン用画像の標準的なサイズは 320x480 です。 | |
| Scaling | デバイスの画面に合わせてスプラッシュ画像を拡大縮小する方法を指定します。 | |
| Center (only scale down) | 画像が大きすぎる場合を除き、ネイティブの大きさで描画します。画像が大きすぎ場合は、Unity が画像が収まるように縮小します。 | |
| Scale to Fit (letter-boxed) | 画像の縦横どちらか長い方が画面サイズにぴったり合うように描画します。短辺側の空きスペースは、黒で塗りつぶされます。 | |
| Scale to Fill (cropped) | 画像を縦横どちらか短い方が画面サイズにぴったり合うようにスケールします。長辺側の画面におさまらない部分はクロップされます。 | |
Other Settings
Other Settings のセクションでは、以下のグループに分類されたさまざまなオプションをカスタマイズできます。
- Rendering (レンダリング)
- Vulkan Settings (Vulkan 設定)
- Identification (ID)
- Configuration (設定)
- Shader Variant Loading (シェーダーバリアントのロード)
- Script Compilation (スクリプトのコンパイル)
- Optimization (最適化)
- Logging (ログ)
- Legacy (古い機能)
Rendering
これらの設定を使用して、Android プラットフォーム向けにゲームをレンダリングする方法をカスタマイズします。
| 設定 | 機能 | |
|---|---|---|
| Color Space | レンダリングに Gamma と Linear どちらの色空間を使用するかを選択します。 2 つの色空間の違いについては リニアレンダリングの概要 を参照してください。 |
|
| Auto Graphics API | このオプションを無効にすると、グラフィックス API を手動で選択して並べ替えることができます。デフォルトでは、このオプションは有効になっており、Unity は Vulkan を使用しようとします。デバイスが Vulkan をサポートしない場合、Unity は GLES3.2、GLES3.1、または GLES3.0 にフォールバックします。 重要: Auto Graphics API が無効の場合、GLES2 が API のリストにない場合にのみ、Unity は GLES3/GLES3.1/AEP/3.2 の要件を Android アプリマニフェストに追加します。この場合のみ、アプリケーションは Google Play ストアの未サポートデバイスに表示されません。 |
|
| Color Gamut | レンダリングに使用する iOS プラットフォーム用の 色域 を追加または削除することができます。プラス (+) アイコンをクリックすると、使用可能な色域のリストが表示されます。色域は、特定のデバイス (モニターや画面) で使用可能な色の範囲を定義します。sRGB 色域はデフォルトの (そして必須の) 色域です。 広色域ディスプレイを備えた最近の tvOS デバイスをターゲットにする場合は、DisplayP3 を使用してフルディスプレイ機能を利用します。古いデバイスのフォールバックとしては Metal Editor Support を使用してください。 |
|
| Multithreaded Rendering | これを有効にして、マルチスレッドレンダリングを使用します。これは Metal でのみサポートされています。 | |
| Static Batching | このオプションを有効にして、静的バッチ処理を行います。 | |
| Dynamic Batching | これを有効にして、ダイナミックバッチング をビルドに使用します (デフォルトでは有効になっています)。 | |
| Compute Skinning | これを有効にすると、DX11/ES3 GPU コンピュートスキニングを使用して、CPU リソースを解放できます。 | |
| Graphics Jobs (Experimental) | これを有効にすると、Unity がグラフィックスタスク (レンダリングのループ) を他の CPU コア上で動作するワーカースレッドにオフロードします。これは、しばしばボトルネックとなるメインスレッドの Camera.Render で費やされる時間を短縮するためのものです。ノート: この機能は実験的です。プロジェクトのパフォーマンスが向上しない場合があり、クラッシュの原因になる可能性があります。 |
|
| Texture compression format | ASTC、ETC2、ETC (RGB には ETC1、RGBA には ETC2) から選択します。正しいフォーマットを選択する方法の詳細については、テクスチャ圧縮フォーマットの概要 を参照してください。 ビルド設定 のテクスチャ圧縮設定との相互作用の詳細については、テクスチャ圧縮設定 を参照してください。 |
|
| Normal Map Encoding | XYZ または DXT5nm-style を選択して、法線マップのエンコードを設定します。DXT5nm-style 法線マップは高品質ですが、シェーダーでのデコードにコストがかかります。 | |
| Lightmap Encoding | ライトマップのエンコードを設定するには、Low Quality、Normal Quality、High Quality のいずれかを選択します。この設定は、ライトマップのエンコードスキームと圧縮形式に影響します。 | |
| HDR Cubemap Encoding | HDR キューブマップのエンコードを設定するには、Low Quality、Normal Quality、High Quality のいずれかを選択します。この設定は、HDR キューブマップのエンコードスキームと圧縮形式に影響します。 | |
| Lightmap Streaming Enabled | ライトマップに Mipmap Streaming を使用するかどうかを設定します。Unity は、ライトマップを生成するときに、この設定をすべてのライトマップに適用します。 ノート: この設定を使用するには、Texture Streaming Quality 設定を有効にする必要があります。 |
|
| Streaming Priority |
ミップマップストリーミングシステム のすべてのライトマップの優先順位を設定します。Unity は優先順位の値を生成すると、その設定をすべてのライトマップに適用します。 正の数値が優先されます。有効な値の範囲は –128 から 127 です。 |
|
| Enable Frame Timing Stats | これを有効にすると、CPU/GPUフレームタイミング統計を収集します。 | |
| Virtual Texturing |
仮想テクスチャリング を有効にするかどうかを示します。 ノート: Virtual Texturing は Android と互換性がありません。 |
|
| Shader precision model | シェーダーで使用されるサンプラーのデフォルトの精度を制御します。詳細は シェーダーのデータ型と精度 を参照してください。 | |
| Load/Store Action Debug Mode | モバイルプラットフォームでレンダリングの問題を引き起こす可能性のある未定義のピクセルをハイライトします。これは、Unity エディターのゲームビューと、Build Settings で Development Build を選択すると、ビルドされたアプリケーションに影響します。LoadStoreActionDebugModeSettings を参照してください。 | |
| Editor Only | エディターのGameビューで未定義のピクセルをハイライトします。 | |
Vulkan Settings
| プロパティ | 物件概要 |
|---|---|
| SRGB Write Mode | このオプションを有効にすると、Graphics.SetSRGBWrite() レンダラーが、ランタイム中に sRGB 書き込みモードを切り替えられるようになります。つまり、リニアから sRGB への書き込み色変換を一時的にオフにしたい場合は、このプロパティを使用してそれを行えます。有効にした場合、モバイルのタイルベース GPU のパフォーマンスに悪影響を与えるので、モバイルでは有効にしないでください。 |
| Number of swapchain buffers | このオプションを 2 に設定するとダブルバッファリング、3 に設定するとトリプルバッファリングが、Vulkan レンダラーに使用されます。この設定は、一部のプラットフォームでは待ち時間の改善に役立つ場合がありますが、ほとんどの場合はデフォルト値の 3 のままにすることが推奨されます。ダブルバッファリングはパフォーマンスに悪影響を及ぼす可能性があります。Android ではこの設定は使用しないでください。 |
| Acquire swapchain image late as possible | 有効にすると、Vulkan は、バックバッファの取得を遅らせ、フレームをオフスクリーン画像にレンダリングした後でそれを行います。Vulkan は、ステージング画像を使用してこれを行います。この設定を有効にすると、バックバッファを表示する時に Blit が 1 つ追加で発生します。この設定とダブルバッファリングを組み合わせることで、パフォーマンスを向上させることができます。ただし、追加の Blit が帯域幅を使用するため、パフォーマンスの問題を引き起こす可能性もあります。 |
| Recycle command buffers | Unity が CommandBuffers を実行した後に、それを再利用するか解放するか指定します。 |
| Apply display rotation during rendering | Enable this to perform all rendering in the native orientation of the display. This has a performance benefit on many devices. For more information, see documentation on Framebuffer orientation. |
Identification
| プロパティ | 機能 |
|---|---|
| Override Default Package Name | アプリケーションのデフォルトのパッケージ名をオーバーライドするかどうかを示します。 ノート: この設定は、macOS、iOS、tvOS、Android に影響します。 |
| Package Name | アプリケーション ID を設定します。この ID は、デバイス上と Google Play ストア上でアプリケーションを識別します。アプリケーション ID は、com.YourCompanyName.YourProductName 規約に従い、英数字とアンダースコア以外は使用できません。各セグメントはアルファベットで始める必要があります。詳細については、アプリケーション ID の設定 を参照してください。重要: Unity は、入力した無効な文字を自動的に削除します。 このプロパティを設定するには、Override Default Package Name を有効にします。 |
| Version | バンドルのイテレーション (リリースされたかどうかにかかわらず) を示す、バンドルのビルドバージョン番号を入力します。バージョンはドットで区切られた数字を含む一般的な文字列の形式 (4.3.2 など) で特定されます。これは iOS と Android 間で共有されます。 |
| Bundle Version Code | 内部バージョン番号。この数は、あるバージョンがもう 1 つのバージョンよりも新しいかを判断するためだけに使用されます。大きい数はより最近のバージョンであることを表します。これは、ユーザーに表示されるバージョン番号ではありません。その番号は、versionName 属性によって設定されます。値は、100 のような整数で設定する必要があります。ただし、後に続くバージョンに大きな数を与える限り、好きな数を決定できます。例えば、ビルド番号も可能です。または、“x.y” 形式のバージョン番号を “x” と “y” を下位と上位の 16 ビットに別々にエンコードすることによって、整数に変換できます。 Split APKs by target architecture が有効になっている場合、この数を 100000 未満にしてください。各 APK には一意のバージョンコードが必要であるため、Unity は ARMv7 の数に 100000、ARM64 に 200000 を加えます。 |
| Minimum API Level | アプリケーションを実行するのに必要な API の最小バージョン (API レベル) |
| Target API Level | アプリケーションをコンパイルするターゲットの Android バージョン (API レベル) |
Configuration
| プロパティ | 説明 | |
|---|---|---|
| スクリプティングバックエンド | 使用するスクリプティングバックエンドを選択します。スクリプトバックエンドは、Unity が Project 内の C# コードをどのようにコンパイルし、実行するかを決定します。 | |
| Mono | C# コードを .NET 共通中間言語 (CIL) にコンパイルし、共通言語ランタイムを使用して CIL を実行します。詳細は Mono を参照してください。 | |
| IL2CPP | C# コードを CIL にコンパイルし、CIL を C++ に変換し、その C++ をネイティブマシンコードにコンパイルします。これがランタイムで直接実行されます。詳細は IL2CPP を参照してください。 | |
| API Compatibility Level | プロジェクトで使用可能にする .NET API を選択します。この設定は、サードパーティのライブラリとの互換性に影響する可能性があります。ただし、エディター固有のコード (エディターディレクトリ内のコードや、エディター固有のアセンブリ定義内のコード) には影響しません。 ヒント: サードパーティのアセンブリに問題がある場合は、以下の API Compatibility Level セクションに提案されている方法を試してみてください。 |
|
| .Net 2.0 | .Net 2.0 libraries. Maximum .net compatibility, biggest file sizes. Part of the deprecated .NET 3.5 runtime. | |
| .Net 2.0 Subset | Subset of full .net compatibility, smaller file sizes. Part of the deprecated .NET 3.5 runtime. | |
| .Net Standard 2.0 | Compatible with .NET Standard 2.0. Produces smaller builds and has full cross-platform support. | |
| .Net 4.x | Compatible with the .NET Framework 4 (which includes everything in the .NET Standard 2.0 profile as well as additional APIs). Choose this option when using libraries that access APIs not included in .NET Standard 2.0. Produces larger builds and any additional APIs available are not necessarily supported on all platforms. See Referencing additional class library assemblies for more information. | |
| C++ Compiler Configuration | IL2CPP で生成されたコードのコンパイル時に使用する C++ コンパイラーの設定を選択します。 ノート: このプロパティは、 Scripting Backend が IL2CPP に設定されている場合以外は無効になります。 |
|
| Use incremental GC | インクリメンタルガベージコレクターを使用します。これは、ガベージコレクションを複数のフレームに分散させることで、フレーム持続時間中の、ガベージコレクション関連のスパイクを減らすものです。詳細は Automatic Memory Management を参照してください。 | |
| Assembly Version Validation | Indicates whether Mono validates types from a strongly-named assembly. | |
| Allow downloads over HTTP | HTTP 経由でのコンテンツのダウンロードを許可するかどうか指定します。選択可能なオプションは Not allowed、Allowed in Development builds only、Always allowed です。デフォルトのオプションは Not allowed です。これは、より安全なプロトコルである HTTPS が推奨されるためです。 | |
| Mute Other Audio Sources | Enable this option if you want your Unity application to stop Audio from applications running in the background. Otherwise, Audio from background applications continues to play alongside your Unity application. | |
| Target Architectures | Select which CPUs you want to allow the application to run on (32-bit ARM, 64-bit ARM, 32-bit x86, and 64-bit x86–64). Note: Running Android apps in a 64-bit environment has performance benefits and 64-bit apps can address more than 4 GB of memory space. |
|
| Split APKs by target architecture (Experimental) | Enable this option to create a separate APK for each CPU architecture selected in Target Architectures. This makes download size smaller for Google Play Store users. This is primarily a Google Play store feature and may not work in other stores. For more details, refer to Multiple APK Support. | |
| Target Devices | Specifies the target devices on which the APK is allowed to run. | |
| All Devices | The APK is allowed to run on all Android and ChromeOS devices. | |
| Phones and Tablets Only | The APK is allowed to run on Android phones and tablets, but not on ChromeOS devices. | |
| ChromeOS Devices Only | The APK is allowed to run on ChromeOS devices, but not on Android phones or tablets. | |
| Install Location | Specifies application install location on the device (for detailed information, refer to Android Developer documentation on install locations. | |
| Automatic | Let the operating system decide. User will be able to move the app back and forth. | |
| Prefer External | Install the application to external storage (SD card) if possible. The operating system doesn’t guarantee it; if not possible, the app will be installed to internal memory. | |
| Force Internal | Force the application to be installed to internal memory. The user will be unable to move the app to external storage. | |
| Internet Access | Choose whether to always add the networking (INTERNET) permission to the Android App Manifest, even if you are not using any networking APIs. Set to Require by default for development builds. |
|
| Auto | Only add the internet access permission if you are using a networking API. | |
| Require | Always add the internet access permission. | |
| Write Permission | Choose whether to enable write access to the external storage (such as the SD card) and add a corresponding permission to the Android App Manifest. Set to External(SDCard) by default for development builds. | |
| Internal | Only grant write permission to internal storage. | |
| External(SDCard) | Enable write permission to external storage. | |
| Filter Touches When Obscured | Enable this option to discard touches received when another visible window is covering the Unity application. This is to prevent tapjacking. | |
| Sustained Performance Mode | Enable this option to set a predictable and consistent level of device performance over longer periods of time, without thermal throttling. Overall performance might be lower when this setting is enabled. Based on the Android Sustained Performance API. | |
| Maximum Java Heap Size | Set the maximum Java heap size to user for building (in megabytes). Defaults to 4096. | |
| Low Accuracy Location | Enable this option to use low accuracy values with Android location APIs instead. | |
| ChromeOS Input Emulation | ChromeOS’s default behaviour is to convert mouse and touchpad input events into touchscreen input events. Un-check this setting to disable the default behavior. | |
| Android TV Compatibility | Enable this option to mark the application as Android TV compatible. | |
| Android Game | Enable this option to mark the output package (APK) as a game rather than a regular application. | |
| Android Gamepad Support Level | Choose the level of support your application offers for a gamepad. The options are Works with D-Pad, Supports Gamepad, and Requires Gamepad. | |
| Warn about App Bundle size | Enable this option to receive a warning when the size of the Android App Bundle exceeds a certain threshold. This option is selected by default and you can only configure it if you enable the Build App Bundle (Google Play) option in the Build settings. | |
| App Bundle size threshold | Enter a size in Mb. When your App Bundle exceeds this size, Unity will display a warning. | |
| Active Input Handling | ユーザーからの入力をどのように処理するか選択します。 | |
| Input Manager (old) | デフォルトの Input ウィンドウを使用します。 | |
| Input System Package (New) | 新しい Input システムを使用します。新しい Input System の使用を試すには、InputSystem パッケージ をインストールしてください。 | |
| Both | Use both systems side by side. | |
Shader Variant Loading
これらの設定を使用して、ランタイムにシェーダーが使用するメモリの量を制御します。
| 設定 | 説明 |
|---|---|
| Default chunk size (MB) | 全てのプラットフォームに対して、ビルドされたアプリケーション内に Unity が保存する圧縮シェーダーバリアントデータチャンクの最大サイズを設定します。デフォルトは 16 です。詳細は シェーダーロード を参照してください。 |
| Default chunk count | 全てのプラットフォームに対して、Unity がメモリに保持する解凍チャンク数のデフォルト制限を設定します。デフォルトは 0 で、これは制限がないことを意味します。 |
| Override | このビルドターゲットの Default chunk size と Default chunk count のオーバーライドを有効にします。 |
| Chunk size (MB) | このビルドターゲットの Default chunk size (MB) の値をオーバーライドします。 |
| Chunk count | このビルドターゲットの Default chunk count の値をオーバーライドします。 |
API Compatibility Level
全てのターゲットに関して Mono の API 互換性レベルを選択できます。サードパーティ製 .NET ライブラリは、.NET 互換性レベル外の機能を使用することもあります。そのような場合に、何が起きているかを理解し、最善の修正方法を把握するためには、以下を試みてください。
- Windows 用 ILSpy をインストールします。
- 問題のある API 互換性レベルの .NET アセンブリを ILSpy にドラッグします。これらは
Frameworks/Mono/lib/mono/YOURSUBSET/の下にあります。 - サードパーティ製アセンブリをドラッグします。
- サードパーティのアセンブリを右クリックし、Analyze を選択します。
- 分析レポートの中で、Depends on セクションを調査します。このレポートでは “そのサードパーティ製アセンブリに依存するが、選択した .NET 互換性レベルで使用できないもの” が全て強調表示されます。
Script Compilation
| プロパティ | 説明 |
|---|---|
| Scripting Define Symbols | カスタムコンパイルフラグを設定します。 詳細は、プラットフォーム依存コンパイル を参照してください。 |
| Additional Compiler Arguments | 追加的な引数を Roslyn コンパイラーに渡すために、このリストにエントリーを追加します。追加の引数それぞれに対して新しいエントリーを 1 つ使用します。 新しいエントリーを作成するには、Add (+) をクリックしてください。エントリーを削除するには Remove (-) をクリックしてください。 全ての引数を追加し終えたら、Apply をクリックして追加的な引数を未来のコンパイルに含めます。Revert をクリックすると、このリストが最後に適用された状態にリセットされます。 |
| Suppress Common Warnings | C# の警告 CS0169 および CS0649 を表示するかどうかを示します。 |
| Allow ‘unsafe’ Code | 事前に定義されたアセンブリ (例えば Assembly-CSharp.dll) の ‘unsafe’ C# コード をコンパイルするサポートを有効にします。アセンブリ定義ファイル ( .asmdef) の場合、.asmdef ファイルの 1 つをクリックし、表示されたインスペクターウィンドウでオプションを有効にします。 |
| Use Deterministic Compilation | deterministic C# フラグでコンパイルしないようにするかどうかを指定します。この設定を有効にすると、コンパイルされたアセンブリは、コンパイルされるたびにバイト単位で同一になります。 詳細については、Microsoft の 決定論的コンパイルプション を参照してください。 |
| Enable Roslyn Analyzers | プロジェクトに存在する可能性のある Roslyn アナライザー DLL を使用せずに、ユーザーが書いたスクリプトをコンパイルするかどうかを示します。 |
Optimization
| プロパティ | 物件概要 | |
|---|---|---|
| Prebake Collision Meshes | ビルド時間に メッシュ に衝突データを追加します。 | |
| Keep Loaded Shaders Alive | Indicates whether to prevent shaders from being unloaded. For more information, see Shader Loading. |
|
| Preloaded Assets | プレイヤーが起動時にロードするアセットの配列を設定します。 新しいアセットを追加するには、Size プロパティの値を大きくしてから、新しく表示された Element ボックス内に、ロードするアセットへの参照を設定してください。 |
|
| AOT compilation options | Additional options for Ahead of Time (AOT) compilation. This helps optimize the size of the built iOS player. | |
| Strip Engine Code | Enable this option if you want the Unity Linker tool to remove code for Unity Engine features that your Project doesn’t use. This setting is only available with the IL2CPP scripting backend. Most apps don’t use every available DLL. This option strips out DLLs that your app doesn’t use to reduce the size of the built Player. If your app is using one or more classes that would normally be stripped out under your current settings, Unity displays a debug message when you try to build the app. |
|
| Managed Stripping Level | 未使用のマネージ (C#) コードを Unity がどの程度積極的に除去するかを選択します。提供されているオプションは、Minimal、Low、Medium、High です。 アプリケーションのビルド時に、Unity リンカーの処理によって、プロジェクトの使用するマネージ DLL から、使用されていないコードを取り除くことができます。コードを取り除くと、実行ファイルのサイズが大幅に小さくなりますが、使用されているコードが誤って削除されることがあります。 これらのオプションと、IL2CPP によるバイトコードストリッピングに関する詳細は、ManagedStrippingLevel を参照してください。 |
|
| Enable Internal profiler (Deprecated) | Enable this option to get the profiler data from your device in the Android SDK’s adblogcat output while testing your projects. This is only available in development builds. | |
| Vertex Compression | チャンネルごとの頂点圧縮を設定します。これはプロジェクト内の全てのメッシュに影響します。 通常は、Vertex Compression は、メモリ上のメッシュデータのサイズを縮小して、ファイルサイズを縮小し、GPU パフォーマンスを向上させるために使用されます。 頂点圧縮の設定方法と、この設定の制限に関する詳細は、メッシュデータの圧縮 を参照してください。 |
|
| Optimize Mesh Data | このオプションを有効にすると、ビルドに使用されているメッシュから、使用されていない頂点属性が取り除かれます。このオプションはメッシュ内のデータ量を削減し、ビルドサイズ、ロード時間、およびランタイムメモリ使用量の削減に役立ちます。 注意: この設定を有効にした場合は、マテリアルやシェーダーの設定をランタイムに変更しないようにしてください。 詳細は PlayerSettings.stripUnusedMeshComponents を参照してください。 |
|
| Texture MipMap Stripping | 全てのプラットフォームでミップマップストリッピングを有効にします。これにより、ビルド時に、使用されていないミップマップがテクスチャから取り除かれます。Unity は、ミップマップの値を現在のプラットフォームの Quality Settings と比較することによって、使用されていないミップマップを特定します。ミップマップの値が現在のプラットフォームの全ての Quality Setting から除外されている場合は、Unity は、ビルド時にそれらのミップマップをビルドから削除します。QualitySettings.masterTextureLimit に、取り除かれたミップマップ値が設定されている場合、Unity は、取り除かれていない最も近いミップマップ値をそこに設定します。 | |
Logging
特定のコンテキストで許可するログのタイプを選択します。
- 必要なロギングのタイプに基づいて各ログタイプ (Error、Assert、Warning、Log、Exception) に対応するオプションを有効にして、好みのスタックトレース方法を設定します。
-
ScriptOnly: スクリプト実行時にのみログを記録します。
-
Full: 常にログを記録します。
-
None: ログは記録されません。
-
ScriptOnly: スクリプト実行時にのみログを記録します。
詳しくは、スタックトレースロギング を参照してください。
Legacy
Clamp BlendShapes (Deprecated) オプションを有効にすると、SkinnedMeshRenderers でブレンドシェイプのウェイトの範囲を固定できます。
Publishing Settings
Publishing Settings を使って、Unity が Android アプリケーションをビルドする方法を設定します。 Publishing 設定を開くには、Edit > Project Settings に移動し、Player を選択し、Android アイコンを選択し、Publishing Settings パネルを開きます。
このセクションでは、Publishing Settings パネルの各部分とその機能について説明します。以下の内容が含まれます。
ノート: セキュリティ上の理由から、Unity は Keystore や Project Key のパスワードを保存しません。
Keystore Manager ウィンドウを使用して、キーとキーストアを作成、構成、およびロードします。 KeystoreManager またはメインの Android Publishing パネルから、既存のキーストアとキーをロードすることができます。Keystore Manager からこれらをロードすることを選択する場合、Unity は Project Keystore フィールドと Project Key フィールドに自動的に入力します。 詳細については、Keystore Manager のドキュメントを参照してください。
Project Keystore
キーストアとは、アプリケーションのセキュリティのための署名鍵を保持するコンテナです。詳しくは、Android 開発者向けドキュメント Android keystore system を参照してください。
Project Keystore の設定で、開いているプロジェクトに使用するキーストアを選択します。キーストアをロードすると、Unity はそのキーストア内のすべてのキーをロードします。 開いているプロジェクトに既存のキーストアをロードして使用するには、以下を行います。
- Custom Keystore を有効にします。
- Select ドロップダウンを開き、 Browse を選択して、ファイルシステムからキーストアを選択します。
- Keystore password を入力します。
既存のキーストアがない場合は、Custom Keystore を無効にしておきます。
Unity では、アプリケーションの署名にデバッグ用の鍵ストアを使用します。 デバッグ用のキーストアは、作業用のキーストアです。これにより、アプリケーションを署名し、ローカルでテストすることができます。ただし、アプリストアはこの方法で署名されたアプリを拒否します。これは、アプリストアが、デバッグ用のキーストアを使用したアプリケーションの有効性と所有権を検証できないためです。
| プロパティ | 説明 |
|---|---|
| Custom Keystore | Custom Keystore を有効にして、既存のキーストアをロードして使用します。 |
| Select | Custom Keystore が有効な場合、これを使って使用するキーストアを選択します。 Select のドロップダウンにあるパーティション以下のキーストアは、あらかじめ定義された専用の場所に保存されています。詳しくは、キーストアの場所の選択 を参照してください。 |
| Path | キーストアのパスを入力する必要はありません。選択したキーストアに基づいて Unity が提供します。 |
| Password | キーストアのパスワードを入力して、選択したキーストアをロードします。 |
Project Key
キーストアをロードすると、Unity はそのキーストア内のすべてのキーをロードします。Project Key 設定を使ってキーストアから 1 つのキーを選択し、開いているプロジェクトのアクティブキーとして使います。
| プロパティ | 説明 |
|---|---|
| Alias | 開いているプロジェクトで使用するキーを選択します。 |
| Password | キーとなるパスワードを入力します。 |
Build
デフォルトでは、Unity は、Unity のインストール時に提供されたマニフェストファイル、Gradle テンプレート、Proguard ファイルを使ってアプリケーションをビルドします。これらを変更するには、Android Publishing Settings の Build セクションを使用します。
カスタムのマニフェストファイル、Gradle テンプレート、Proguard ファイルを使用する場合は、以下を行います。
- 該当するチェックボックスを有効にします。Unity はプロジェクト内にデフォルトファイルを作成し、チェックボックスの下にファイルの場所が表示されます。
- 新しいファイルを開いて、変更を加えます。
- このファイルに変更を保存してください。Unity は、このファイルに保存された変更を次回のアプリケーションビルド時に自動的に使用します。
Build セクションの設定は、現在のプロジェクトのビルドプロセスにのみ適用されます。
| プロパティ | 説明 |
|---|---|
| Custom Main Manifest | Android の LibraryManifest.xml ファイルのカスタマイズ可能なバージョンです。このファイルには、Android アプリケーションに関する重要なメタデータが含まれています。Main/Unity Library Manifest の機能の詳細は、Unity Library Manifest を参照してください。 |
| Custom Launcher Manifest | Android の LauncherManifest.xml ファイルのカスタマイズ可能なバージョンです。このファイルには、Android アプリケーションのランチャーに関する重要なメタデータが含まれています。Unity Launcher Manifest の機能の詳細は、Unity Launcher Manifest を参照してください。 |
| Custom Main Gradle Template |
mainTemplate.gradle ファイルのカスタマイズ可能なバージョンです。このファイルには、Android アプリケーションをライブラリとしてビルドする方法に関する情報が含まれています。詳細については、Gradle プロジェクトファイル のドキュメントを参照してください。 |
| Custom Launcher Gradle Template |
mainTemplate.gradle ファイルのカスタマイズ可能なバージョンです。このファイルには、Android アプリケーションをビルドする方法に関する情報が含まれています。詳細については、Gradle プロジェクトファイル のドキュメントを参照してください。 |
| Custom Base Gradle Template |
baseProjectTemplate.gradle ファイルのカスタマイズ可能なバージョンです。このファイルには、他のすべてのテンプレートと Gradle プロジェクトの間で共有される設定が含まれています。詳細については、Gradle プロジェクトファイル のドキュメントを参照してください。 |
| Custom Gradle Properties Template |
gradle.properties ファイルのカスタマイズ可能版です。このファイルには、Gradle のビルド環境の構成設定が含まれています。これには以下が含まれます。• JVM(Java Virtual Machine)のメモリ設定 • Gradle が複数の JVM を使ってビルドできるようにするためのプロパティ • 最小化を行うツールを選択するためのプロパティ • アプリケーションバンドルのビルド時にネイティブリブを圧縮しないためのプロパティ |
| Custom Gradle Settings Template |
settingsTemplate.gradle ファイルのカスタマイズ可能なバージョンです。このファイルには、アプリケーションに必要な外部依存関係を解決するためのアーティファクトリポジトリの宣言が含まれています。 |
| Custom Proguard File | proguard.txt ファイルのカスタマイズ可能版です。このファイルには、最小化処理のための構成設定が含まれています。最小化によって、残すべき Java コードが削除されてしまった場合、そのコードを残すためのルールをこのファイルに追加する必要があります。詳細については、Minification のドキュメントを参照してください。 |
Minify
小型化 (Munification) とは、アプリケーションのコードを縮小、難読化、最適化するプロセスです。コードサイズを縮小し、コードを逆アセンブルしにくくすることができます。Minify の設定を使って、いつ、どのように Unity がビルドに小型化を適用するかを定義します。
ほとんどの場合、リリースビルドにのみ小型化を適用し、デバッグビルドには適用しないのが良い習慣です。小型化には時間がかかり、ビルドが遅くなる可能性があるからです。また、コードが小型化されることで、デバッグがより複雑になる可能性があります。
Munify セクションの設定は、現在のプロジェクトのビルドプロセスにのみ適用されます。
| プロパティ | 説明 |
|---|---|
| Release | リリースビルド時にアプリケーションのコードを小型化したい場合は、このチェックボックスを有効にします。 |
| Debug | デバッグビルド時にアプリケーションのコードを小型化したい場合は、このチェックボックスを有効にします。 |
Split Application Binary
Split Application Binary オプションを有効にすると、出力パッケージをメイン (APK) パッケージと拡張 (OBB) パッケージに分割します。これは 100 MB を超えるアプリケーションを公開する場合は、 Goolge Play ストアによって必須とされています。
- 5.5 のアップデート機能
- Sustained Performance Mode は 2017.3 で追加
- .NET 4.x ランタイムは 2018.1 で追加
- Android 複数のAPK 機能は 2018.2 で追加
- Android 用 OpenGL ES 3.2 サポートは、2019.1 で追加NewIn20191
- Input System プレビューは Unity 2019.1 で追加
- Render outside safe area は Unity 2019.1 で追加
- Warn about App Bundle size オプションは Unity 2019.2 で追加
- GPU Skinning の名称が Unity 2019.3 で Compute Skinning に変更されました
- Vuforia は Unity 2019.3 で削除
- ビルトイン XR SDK のサポートは Unity 2019.3 で非推奨NewIn20193
- テクスチャ圧縮用に更新
PlayerSettingsAndroid