Version: 2021.1
LanguageEnglish
  • C#

PlayerSettings

class in UnityEditor

/

Inherits from:Object

Suggest a change

Success!

Thank you for helping us improve the quality of Unity Documentation. Although we cannot accept all submissions, we do read each suggested change from our users and will make updates where applicable.

Close

Submission failed

For some reason your suggested change could not be submitted. Please <a>try again</a> in a few minutes. And thank you for taking the time to help us improve the quality of Unity Documentation.

Close

Cancel

Switch to Manual

Description

Player Settings is where you define various parameters for the final game that you will build in Unity. Some of these values are used in the Resolution Dialog that launches when you open a standalone game.

Static Properties

accelerometerFrequencyAccelerometer update frequency.
actionOnDotNetUnhandledExceptionSets the crash behavior on .NET unhandled exception.
advancedLicenseIs the advanced version being used?
allowedAutorotateToLandscapeLeftIs auto-rotation to landscape left supported?
allowedAutorotateToLandscapeRightIs auto-rotation to landscape right supported?
allowedAutorotateToPortraitIs auto-rotation to portrait supported?
allowedAutorotateToPortraitUpsideDownIs auto-rotation to portrait upside-down supported?
allowFullscreenSwitchIf enabled, allows the user to switch between full screen and windowed mode using OS specific keyboard short cuts.
allowUnsafeCodeAllow 'unsafe' C# code code to be compiled for predefined assemblies.
aotOptionsAdditional AOT compilation options. Shared by AOT platforms.
applicationIdentifierThe application identifier for the currently selected build target.
assemblyVersionValidationSet to true to exact version matching for strong named assemblies.
bakeCollisionMeshesPre bake collision meshes on player build.
bundleVersionApplication bundle version shared between iOS & Android platforms.
captureSingleScreenDefines if fullscreen games should darken secondary displays.
colorSpaceSet the rendering color space for the current project.
companyNameThe name of your company.
cursorHotspotDefault cursor's click position in pixels from the top left corner of the cursor image.
D3DHDRBitDepthThe number of bits in each color channel for swap chain buffers. (Direct3D 11 and Direct3D 12 mode).
defaultCursorThe default cursor for your application.
defaultInterfaceOrientationDefault screen orientation for mobiles.
defaultScreenHeightDefault vertical dimension of stand-alone player window.
defaultScreenWidthDefault horizontal dimension of stand-alone player window.
defaultWebScreenHeightDefault vertical dimension of web player window.
defaultWebScreenWidthDefault horizontal dimension of web player window.
enable360StereoCaptureEnable 360 Stereo Capture support on the current build target.
enableCrashReportAPIEnables CrashReport API.
enableFrameTimingStatsEnable frame timing statistics.
enableInternalProfilerEnables internal profiler.
enableMetalAPIValidationEnables Metal API validation in the Editor.
forceSingleInstanceRestrict standalone players to a single concurrent running instance.
fullScreenModePlatform agnostic setting to define fullscreen behavior. Not all platforms support all modes.
gcIncrementalAllows you to enable or disable incremental mode for garbage collection.
gpuSkinningEnable GPU skinning on capable platforms.
graphicsJobModeSelects the graphics job mode to use on platforms that support both Native and Legacy graphics jobs.
graphicsJobsEnable graphics jobs (multi threaded rendering).
keyaliasPassPassword for the key used for signing an Android application.
keystorePassPassword used for interacting with the Android Keystore.
legacyClampBlendShapeWeightsDefines whether the BlendShape weight range in SkinnedMeshRenderers is clamped.
logObjCUncaughtExceptionsAre ObjC uncaught exceptions logged?
macRetinaSupportEnable Retina support for macOS.
mipStrippingEnable mip stripping for all platforms.
MTRenderingIs multi-threaded rendering enabled?
muteOtherAudioSourcesStops or allows audio from other applications to play in the background while your Unity application is running.
openGLRequireES31Specifies whether the application requires OpenGL ES 3.1 support.
openGLRequireES31AEPSpecifies whether the application requires OpenGL ES 3.1 AEP support.
openGLRequireES32Specifies whether the application requires OpenGL ES 3.2 support.
preserveFramebufferAlphaWhen enabled, preserves the alpha value in the framebuffer to support rendering over native UI on Android.
productNameThe name of your product.
resizableWindowUse resizable window in standalone player builds.
runInBackgroundIf enabled, your game will continue to run after lost focus.
statusBarHiddenReturns if status bar should be hidden. Supported on iOS only; on Android, the status bar is always hidden.
stereoRenderingPathActive stereo rendering path
stripEngineCodeRemove unused Engine code from your build (IL2CPP-only).
stripUnusedMeshComponentsShould unused Mesh components be excluded from game build?
suppressCommonWarningsSuppresses common C# warnings.
use32BitDisplayBuffer32-bit Display Buffer is used.
useAnimatedAutorotationLet the OS autorotate the screen as the device orientation changes.
useFlipModelSwapchainUse DXGI Flip Model Swapchain for D3D11
useHDRDisplaySwitch display to HDR mode (if available).
useMacAppStoreValidationEnable receipt validation for the Mac App Store.
usePlayerLogWrite a log file with debugging information.
virtualRealitySplashScreenVirtual Reality specific splash screen.
visibleInBackgroundOn Windows, show the application in the background if Fullscreen Windowed mode is used.
vulkanEnableLateAcquireNextImageDelays acquiring the swapchain image until after the frame is rendered.
vulkanEnablePreTransformApplies the display rotation during rendering.
vulkanEnableSetSRGBWriteEnables Graphics.SetSRGBWrite() on Vulkan renderer.
vulkanNumSwapchainBuffersSet number of swapchain buffers to be used with Vulkan renderer

Static Methods

GetAdditionalCompilerArgumentsForGroupGets an array of additional compiler arguments set for a specific BuildTargetGroup.
GetAdditionalIl2CppArgsIL2CPP build arguments.
GetApiCompatibilityLevelGets .NET API compatibility level for specified BuildTargetGroup.
GetApplicationIdentifierGet the application identifier for the specified platform.
GetArchitectureGets the BuildTargetPlatformGroup architecture.
GetDefaultScriptingBackendReturns the default ScriptingImplementation used for the given platform group.
GetGraphicsAPIsGet graphics APIs to be used on a build platform.
GetIconsForTargetGroupReturns the list of assigned icons for the specified platform.
GetIconSizesForTargetGroupReturns a list of icon sizes for the specified platform.
GetIl2CppCompilerConfigurationGets compiler configuration used when compiling generated C++ code for a particular BuildTargetGroup.
GetIncrementalIl2CppBuildDoes IL2CPP platform use incremental build?
GetManagedStrippingLevelReturns the ManagedStrippingLevel used for the given platform group.
GetMobileMTRenderingCheck if multithreaded rendering option for mobile platform is enabled.
GetNormalMapEncodingReturns the NormalMapEncoding used for the given platform group.
GetPlatformIconsReturns the list of available icon slots for the specified platform and kind.
GetPreloadedAssetsReturns the assets that will be loaded at start up in the player and be kept alive until the player terminates.
GetScriptingBackendGets the scripting framework for a BuildTargetPlatformGroup.
GetScriptingDefineSymbolsForGroupGet user-specified symbols for script compilation for the given build target group.
GetShaderPrecisionModelGets the active shader precision model.
GetStackTraceLogTypeGet stack trace logging options.
GetSupportedIconKindsForPlatformRetrieve all icon kinds supported by the specified platform.
GetTemplateCustomValueReturns a value of a custom template variable.
GetUseDefaultGraphicsAPIsIs a build platform using automatic graphics API choice?
GetVirtualTexturingSupportEnabledIs virtual texturing enabled.
HasAspectRatioReturns whether or not the specified aspect ratio is enabled.
SetAdditionalCompilerArgumentsForGroupSets additional compiler arguments for a BuildTargetGroup.
SetAdditionalIl2CppArgsIL2CPP build arguments.
SetApiCompatibilityLevelSets .NET API compatibility level for specified BuildTargetGroup.
SetApplicationIdentifierSet the application identifier for the specified platform.
SetArchitectureSets the BuildTargetPlatformGroup architecture.
SetAspectRatioEnables the specified aspect ratio.
SetGraphicsAPIsSets the graphics APIs used on a build platform.
SetIconsForTargetGroupAssign a list of icons for the specified platform.
SetIl2CppCompilerConfigurationSets compiler configuration used when compiling generated C++ code for a particular BuildTargetGroup.
SetIncrementalIl2CppBuildSets incremental build flag.
SetManagedStrippingLevelSets the managed code stripping level for specified BuildTargetGroup.
SetMobileMTRenderingEnable or disable multithreaded rendering option for mobile platform.
SetNormalMapEncodingSets the normal map encoding for the given platform.
SetPlatformIconsAssign a list of icons for the specified platform and icon kind.
SetPreloadedAssetsAssigns the assets that will be loaded at start up in the player and be kept alive until the player terminates.
SetScriptingBackendSets the scripting framework for a BuildTargetPlatformGroup.
SetScriptingDefineSymbolsForGroupSet user-specified symbols for script compilation for the given build target group.
SetShaderPrecisionModelSets the shader precision model.
SetStackTraceLogTypeSet stack trace logging options. Note: calling this function will implicitly call Application.SetStackTraceLogType.
SetTemplateCustomValueSets a value of a custom template variable.
SetUseDefaultGraphicsAPIsShould a build platform use automatic graphics API choice.
SetVirtualTexturingSupportEnabledEnable virtual texturing.

Inherited Members

Properties

hideFlagsShould the object be hidden, saved with the Scene or modifiable by the user?
nameThe name of the object.

Public Methods

GetInstanceIDGets the instance ID of the object.
ToStringReturns the name of the object.

Static Methods

DestroyRemoves a GameObject, component or asset.
DestroyImmediateDestroys the object obj immediately. You are strongly recommended to use Destroy instead.
DontDestroyOnLoadDo not destroy the target Object when loading a new Scene.
FindObjectOfTypeReturns the first active loaded object of Type type.
FindObjectsOfTypeGets a list of all loaded objects of Type type.
InstantiateClones the object original and returns the clone.

Operators

boolDoes the object exist?
operator !=Compares if two objects refer to a different object.
operator ==Compares two object references to see if they refer to the same object.