MacOS Player settings

This page details the Player settings specific to Mac OSX. For a description of the general Player settings, see Player Settings.

以下のセクションのプロパティが説明されています。

• Icon (アイコン)
• Resolution and Presentation (解像度と表示)
• Splash Image (スプラッシュ画像)
• Other Settings (その他の設定)

Icon

デスクトップゲームにカスタムアイコンを割り当てるには、Override for Windows, Mac, Linux 設定を有効にします。それぞれの四角に合ったさまざまなサイズのアイコンをアップロードできます。

Resolution and Presentation

Resolution and Presentation (解像度と表示) セクションの Resolution と Standalone Player Options を使用して、画面の表示をカスタマイズします。

Resolution

このセクションでは、スクリーンモードとデフォルトサイズをカスタマイズできます。

プロパティ		機能
Fullscreen Mode		全画面のモードを選択します。起動時のデフォルトの画面モードを定義します。
	Fullscreen Window	Set your app window to the full-screen native display resolution, covering the whole screen. This mode is also known as borderless full-screen. Unity renders the app content at the resolution set by a script, or the native display resolution if none is set and scales it to fill the window. When scaling, Unity adds black bars to the rendered output to match the display aspect ratio to prevent content stretching. This process is called letterboxing. The OS overlay UI displays on top of the full-screen window (such as IME input windows). All platforms support this mode.
	Exclusive Fullscreen (Windows only)	Set your app to maintain sole full-screen use of a display. Unlike Fullscreen Window, this mode changes the OS resolution of the display to match the app’s chosen resolution. This option is only supported on Windows.
	Maximized Window (Mac only)	Set the app window to the operating system’s definition of maximized, which is typically a full-screen window with a hidden menu bar and dock on macOS. This option is only supported on macOS. Fullscreen Window is the default setting for other platforms.
	Windowed	Set your app to a standard, non-full-screen movable window, the size of which is dependent on the app resolution. In this mode, the window is resizable by default. Use the Resizable Window setting to disable this. All desktop platforms support this full-screen mode.
Default Is Native Resolution		Enable this option to make the game use the default resolution used on the target machine. This option isn’t available if the Fullscreen Mode is set to Windowed.
Default Screen Width		ゲーム画面のデフォルトの幅をピクセル単位で設定します。このオプションは、Full Screen Mode が Windowed に設定されている場合にのみ使用できます。
Default Screen Height		ゲーム画面のデフォルトの高さをピクセル単位で設定します。このオプションは、Full Screen Mode が Windowed に設定されている場合にのみ使用できます。
Mac Retina Support		Enable this option to enable support for high DPI (Retina) screens on a Mac. Unity enables this by default. This enhances Projects on a Retina display, but it’s somewhat resource-intensive when active.
Run In background		Enable this option to have the game running in the background instead of pausing if the app loses focus.

Standalone Player Options

このセクションを使って、画面をカスタマイズできます。例えば、ユーザーが画面のサイズを変更できるかどうかや、同時に実行できるインスタンスの数などを決定できます。

プロパティ	機能
Capture Single Screen	これを有効にすると、全画面モード のスタンドアロンゲームで、マルチモニター設定時に補助モニターが暗くならないようにします。Mac OS X ではサポートされていません。
Use Player Log	これを有効にすると、デバッグ情報を含むログファイルを作成します。デフォルトは有効です。 注意 アプリケーションを Mac App Store に提出する場合は、このオプションを無効にします。詳細は、Mac App Store へ公開 を参照してください。
Resizable Window	Enable this option to allow resizing of the desktop player window. Note: If you disable this option, your application can’t use the Windowed Fullscreen Mode.
Visible in Background	これを有効にすると、Windows で Fullscreen Mode の Windowed が使用されている場合に、アプリケーションを背景で表示します。
Allow FullScreen Switch	これを有効にすると、デフォルトの全画面キーを押して全画面のモードと Windowed モードを切り替えることができます。
Force Single Instance	これを有効にすると、デスクトッププレイヤーを 1 つの同時実行インスタンスに制限できます。
Supported Aspect Ratios	起動時に解像度ダイアログに表示したいアスペクト比を有効にします (ユーザーのモニターにサポートされている場合)。

Splash Image

Virtual Reality Splash Image 設定を使用して、VR ディスプレイのカスタムスプラッシュ画像を指定します。一般的なスプラッシュスクリーン の設定については、スプラッシュスクリーン を参照してください。

Other Settings (その他の設定)

このセクションでは、以下のグループに分類されたさまざまなオプションをカスタマイズできます。

• Rendering (レンダリング)
• Vulkan Settings (Vulkan 設定)
• Mac App Store Options (Mac App Store オプション)
• Configuration (設定)
• Shader Variant Loading
• Script Compilation
• Optimization (最適化)
• Logging (ログ)
• Legacy (古い機能)

Rendering

Use these settings to customize how Unity renders your game for desktop platforms.

設定		機能
Color Space		レンダリングに Gamma と Linear どちらの色空間を使用するかを選択します。 2 つの色空間の違いの説明は リニアレンダリングの概要 を参照してください。
Auto Graphics API		これを有効にすると、ゲームが実行されている Mac マシンで最高のグラフィックス API を使用できます。これを無効にすると、サポートされているグラフィックス API を追加したり削除したりできます。
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		Choose between ASTC, ETC2 and ETC (ETC1 for RGB, ETC2 for RGBA). See texture compression format overview for more information on how to pick the right format. See Texture compression settings for more details on how this interacts with the texture compression setting in the Build Settings.
Normal Map Encoding		XYZ または DXT5nm-style を選択して、法線マップのエンコードを設定します。DXT5nm-style 法線マップは高品質ですが、シェーダーでのデコードにコストがかかります。
Lightmap Encoding		ライトマップのエンコードを設定するには、Low Quality、Normal Quality、High Quality のいずれかを選択します。この設定は、ライトマップのエンコードスキームと圧縮形式に影響します。
HDR Cubemap Encoding		Choose Low Quality, Normal Quality, or High Quality to set the HDR Cubemap encoding. This setting affects the encoding scheme and compression format of the HDR Cubemaps.
Lightmap Streaming Enabled		Whether to use Mipmap Streaming for lightmaps. Unity applies this setting to all lightmaps when it generates them. Note: To use this setting, you must enable the Texture Streaming Quality setting.
Streaming Priority		Set the priority for all lightmaps in the Mipmap Streaming system. Unity applies this setting to all lightmaps when it generates them. Positive numbers give higher priority. Valid values range from –128 to 127.
Enable Frame Timing Stats		これを有効にすると、CPU/GPUフレームタイミング統計を収集します。
Swap Chain Bit Depth		スワップチェーンバッファの各色チャンネルのビット数を選択します。HDR (ハイダイナミックレンジ) モードが有効な場合にのみ使用可能です。
Bit Depth 10		Unity は、R10G10B10A2 バッファ形式と ST2084 PQ エンコードの Rec2020 プライマリを使用します。
Bit Depth 16		Unity は R16G16B16A16 バッファ形式とリニア色の Rec709 プライマリ (エンコード無し) を使用します。
Virtual Texturing		Indicates whether to enable Virtual Texturing. Note: Virtual Texturing isn’t compatible with Android.
Shader precision model		Controls the default precision of samplers used in shaders. See Shader data types and precision for more details.
360 Stereo Capture		Indicates whether Unity can capture stereoscopic 360 images and videos. When enabled, Unity compiles additional shader variants to support 360 capture (currently only on Windows/OSX). When enabled, enable_360_capture keyword is added during the Stereo RenderCubemap call. Note that this keyword is not triggered outside the Stereo RenderCubemap function. For more information, see Stereo 360 Image and Video Capture.

Vulkan Settings

Property	Description
SRGB Write Mode	Enable this option to allow Graphics.SetSRGBWrite() renderer to toggle the sRGB write mode during runtime. That is, if you want to temporarily turn off Linear-to-sRGB write color conversion, you can use this property to achieve that. Enabling this has a negative impact on performance on mobile tile-based GPUs; therefore, do NOT enable this for mobile.
Number of swapchain buffers	Set this option to 2 for double-buffering, or 3 for triple-buffering to use with Vulkan renderer. This setting may help with latency on some platforms, but in most cases you should not change this from the default value of 3. Double-buffering might have a negative impact on performance. Do not use this setting on Android.
Acquire swapchain image late as possible	If enabled, Vulkan delays acquiring the backbuffer until after it renders the frame to an offscreen image. Vulkan uses a staging image to achieve this. Enabling this setting causes an extra blit when presenting the backbuffer. This setting, in combination with double-buffering, can improve performance. However, it also can cause performance issues because the additional blit takes up bandwidth.
Recycle command buffers	Indicates whether to recycle or free CommandBuffers after Unity executes them.

Mac App Store Options

プロパティ		機能
Override Default Bundle Identifier		Indicates whether you can manually set the bundle identifier. Note: This setting affects macOS, iOS, tvOS, and Android.
	Bundle Identifier	Enter the Bundle Identifier of your application. This appears as CFBundleIdentifier in the associated info.plist file. The Bundle Identifier must follow the convention com.YourCompanyName.YourProductName and must contain only alphanumeric and hyphen characters. For more information, see CFBundleIdentifier. Important: Unity automatically replaces any invalid characters you type with a hyphen. To set this property, enable Override Default Bundle Identifier.
Build		アプリケーションのこのバージョンのビルド番号を入力します。関連する info.plist ファイルに CFBundleVersion として表示されます。詳しくは、Apple 開発者ドキュメントで CFBundleVersion を参照してください。
Category		アプリケーションのタイプに関連する文字列を入力します。App Store はこの文字列を使用して、アプリケーションの適切なカテゴリを決定します。デフォルトでは、ゲームカテゴリ public.app-category.games に設定されています。使用可能なカテゴリのリストは、Apple の開発者のドキュメントのLSApplicationCategoryType を参照してください。
Mac App Store Validation		これを有効にすると、Mac App Store からの有効な証明書がある場合にのみアプリケーションが実行されます。これにより、アプリケーションを購入したデバイスとは異なるデバイスで実行することができなくなります。独自の証明書の検証を実装している場合にのみ、この設定を無効にしてください。

Publishing to the Mac App Store

Use Player Log プロパティを使用すると、デバッグ情報を持つログファイルを作成できます。これは、ゲームの問題を調査するのに便利です。ただし、Apple の Mac App Store 用にゲームを公開する場合は、これを無効にする必要があります。これが有効になっていると、Apple から提出を拒否される場合があるためです。ログファイルの詳細は、Unity マニュアルの ログファイル のページを参照してください。

Use Mac App Store Validation プロパティは、Mac App Store のレシート検証を有効にします。有効にすると、ゲームは、Mac App Store からの有効なレシートを持つ場合にのみ実行されます。ゲームを App Store に公開するために提出する場合は、このオプションを有効にします。すると、ゲームを購入したコンピューター以外のコンピューターでゲームを実行できなくなります。

この機能は強力なコピープロテクションを実装していないことに注意してください。特に、ある 1 つの Unity ゲームを不正利用できる能力は、他の Unity コンテンツに対しても不正利用を行うことが可能である恐れがあります。このため、Unity のプラグイン機能を使用して、独自のレシート検証コードを実装することが推奨されます。ただし、画面設定ダイアログを表示する前に Apple による最初のプラグインの検証が必要であるため、このプロパティを有効にして、Apple によってゲームの提出が拒否されるのを避ける必要があります。

Configuration

Property		Description
Scripting Backend		Choose the scripting backend you want to use. The scripting backend determines how Unity compiles and executes C# code in your Project.
	Mono	Compiles C# code into .NET Common Intermediate Language (CIL) and executes that CIL using a Common Language Runtime. For more information, see Mono.
	IL2CPP	Compiles C# code into CIL, converts the CIL to C++ and then compiles that C++ into native machine code, which executes directly at run time. See IL2CPP for more information.
API Compatibility Level	Choose which .NET APIs you can use in your project. This setting can affect compatibility with third-party libraries. However, it has no effect on Editor-specific code (code in an Editor directory, or within an Editor-specific Assembly Definition). Tip: If you are having problems with a third-party assembly, you can try the suggestion in the API Compatibility Level section below.
	.Net Standard	Compatible with .NET Standard 2.0. Produces smaller builds and has full cross-platform support.
	.Net Framework	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 usng 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.
IL2CPP Code Generation		Defines how Unity manages IL2CPP code generation. This option is only available if you use the IL2CPP scripting backend.
	Faster runtime	Generates code optimized for runtime performance. This setting is enabled by default.
	Faster (smaller) builds)	Generates code optimized for build size and iteration. This setting generates less code and produces a smaller build, but may reduce runtime performance, especially for generic code. Use this option when faster build times are important, such as when iterating on changes.
C++ Compiler Configuration		Choose the C++ compiler configuration used when compiling IL2CPP generated code. Note: This property is disabled unless Scripting Backend is set to IL2CPP.
Use incremental GC		Uses the incremental garbage collector, which spreads garbage collection over several frames to reduce garbage collection-related spikes in frame duration. For more information, see Automatic Memory Management.
Allow downloads over HTTP	Indicates whether to allow downloading content over HTTP. The options are Not allowed, Allowed in Development builds only, and Always allowed. The default option is Not allowed due to the recommended protocol being HTTPS, which is more secure.
Active Input Handling	Chooses how to handle input from users.
	Input Manager (old)	Use the default Input window.
	Input System (Preview)	Use the newer Input system. The Input System is provided as a preview package for this release. To try a preview of the Input System, install the InputSystem package.
	Both	Use both systems side by side.

Shader Variant Loading

Use these settings to control how much memory shaders use at runtime.

設定	機能
Default chunk size (MB)	Sets the maximum size of compressed shader variant data chunks Unity stores in your built application for all platforms. The default is 16. See Shader loading for more information.
Default chunk count	Sets the default limit on how many decompressed chunks Unity keeps in memory on all platforms. The default is 0, which means there’s no limit.
Override	Enables overriding Default chunk size and Default chunk count for this build target.
Chunk size (MB)	Overrides the value of Default chunk size (MB) on this build target.
Chunk count	Overrides the value of Default chunk count on this build target.

API Compatibility Level

You can choose your mono API compatibility level for all targets. Sometimes a 3rd-party .NET library uses functionality that’s outside of your .NET compatibility level. To understand what’s going on in such cases, and how to best fix it, try following these suggestions:

1. Install ILSpy for Windows.
2. Drag the .NET assemblies for the API compatilibity level that you are having issues with into ILSpy. You can find these under Frameworks/Mono/lib/mono/YOURSUBSET/.
3. サードパーティ製のアセンブリをドラッグします。
4. サードパーティ製のアセンブリを右クリックし、Analyze を選択します。
5. 分析レポートの中で、Depends on セクションを調べます。サードパーティ製品依存でありながら、選択した .NET 互換性レベルで対応しないものはすべてここで赤字でハイライトされます。

Script Compilation

プロパティ	説明
Scripting Define Symbols	Sets custom compilation flags. For more details, see Platform dependent compilation.
Additional Compiler Arguments	Adds entries to this list to pass additional arguments to the Roslyn compiler. Use one new entry for each additional argument. To create a new entry, click Add (+). To remove an entry, click Remove (-). When you have added all desired arguments, click Apply to include your additional arguments in future compilations. Click Revert to reset this list to the most recent applied state.
Suppress Common Warnings	Indicates whether to display the C# warnings CS0169 and CS0649.
Allow ‘unsafe’ Code	Enables support for compiling ‘unsafe’ C# code in a pre-defined assembly (for example, Assembly-CSharp.dll). For Assembly Definition Files (.asmdef), click on one of your .asmdef files and enable the option in the Inspector window that appears.
Use Deterministic Compilation	Indicates whether to prevent compilation with the -deterministic C# flag. With this setting enabled, compiled assemblies are byte-for-byte identical each time they are compiled. For more information, see Microsoft’s deterministic compiler option.
Enable Roslyn Analyzers	Indicates whether to compile user-written scripts without Roslyn analyzer DLLs that might be present in your project.

Optimization

Property		Description
Prebake Collision Meshes		Adds collision data to Meshes at build time.
Keep Loaded Shaders Alive		Indicates whether to prevent shaders from being unloaded. For more information, see Shader Loading.
Preloaded Assets		Sets an array of Assets for the player to load on startup. To add new Assets, increase the value of the Size property and then set a reference to the Asset to load in the new Element box that appears.
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		Chooses how aggressively Unity strips unused managed (C#) code. The options are Minimal, Low, Medium, and High. When Unity builds your app, the Unity Linker process can strip unused code from the managed DLLs your Project uses. Stripping code can make the resulting executable significantly smaller, but can sometimes accidentally remove code that’s in use. For more information about these options and bytecode stripping with IL2CPP, see ManagedStrippingLevel.
Vertex Compression		Sets vertex compression per channel. This affects all the meshes in your project. Typically, Vertex Compression is used to reduce the size of mesh data in memory, reduce file size, and improve GPU performance. For more information on how to configure vertex compression and limitations of this setting, see Compressing mesh data.
Optimize Mesh Data		Enable this option to strip unused vertex attributes from the mesh used in a build. This option reduces the amount of data in the mesh, which can help reduce build size, loading times, and runtime memory usage. Warning: If you have this setting enabled, you should remember to not change material or shader settings at runtime. See PlayerSettings.stripUnusedMeshComponents for more information.
Texture MipMap Stripping		Enables mipmap stripping for all platforms. This strips unused mipmaps from Textures at build time. Unity determines unused mipmaps by comparing the value of the mipmap against the Quality Settings for the current platform. If a mipmap value is excluded from every Quality Setting for the current platform, then Unity strips those mipmaps from the build at build time. If QualitySettings.masterTextureLimit is set to a mipmap value that has been stripped, Unity will set the value to the closest mipmap value that has not been stripped.

Logging

• Select your preferred stack trace method by enabling the option that corresponds to each Log Type (Error, Assert, Warning, Log, and Exception) based on the type of logging you require. For example:
  
  • ScriptOnly: Logs only when running scripts.
    
  • Full: Logs all the time.
    
  • None: No logs are ever recorded.
    

See stack trace logging for more information.

Legacy

プロパティ	機能
Clamp BlendShapes (Deprecated)	これを有効にすると、SkinnedMeshRenderers でブレンドシェイプのウェイトの範囲を固定できます。
Upload Cleared Texture Data	これは古い機能で現在は必要ありません。なぜなら、帯域幅を使用するからです。デフォルトでは、デバッグのために有効になっています。この設定を有効にすると、初期データがクリアされ、テクスチャがスクリプトからビデオメモリに自動的にアップロードされます。