Version: 2023.2

PlayerSettings

class in UnityEditor

/

继承自:Object

切换到手册

描述

Player Settings 是您为即将在 Unity 中构建的最终游戏定义各种参数的地方。其中一些值将用于您打开独立平台游戏时所启动的分辨率对话框。

静态变量

accelerometerFrequency加速度计更新频率。
actionOnDotNetUnhandledException针对未经处理的 .NET 异常设置崩溃行为。
advancedLicense使用的是否为高级版本?
allowedAutorotateToLandscapeLeft是否支持自动旋转到左侧横向模式?
allowedAutorotateToLandscapeRight是否支持自动旋转到右侧横向模式?
allowedAutorotateToPortrait是否支持自动旋转到纵向模式?
allowedAutorotateToPortraitUpsideDown是否支持自动旋转到纵向倒置模式?
allowFullscreenSwitch如启用,则允许用户使用特定于操作系统的键盘快捷键在全屏模式和窗口模式之间切换。
allowHDRDisplaySupportPrepare the application to encode images for an HDR display.
allowUnsafeCodeAllow unsafe C# code to be compiled for predefined assemblies.
aotOptions其他 AOT 编译选项。由 AOT 平台共享。
applicationIdentifier当前所选构建目标的应用程序标识符。
bakeCollisionMeshes在播放器构建时预烘焙碰撞网格。
bundleVersioniOS 和 Android 平台之间共享的应用程序捆绑包版本。
captureSingleScreen定义全屏游戏是否应使辅助显示变暗。
colorSpace设置当前项目的渲染颜色空间。
companyName您公司的名称。
cursorHotspot默认光标单击位置(以像素为单位),位于光标图像的左上角。
dedicatedServerOptimizationsPerforms additional optimizations on Dedicated Server builds.
defaultCursor应用程序的默认光标。
defaultInterfaceOrientation移动平台的默认屏幕方向。
defaultScreenHeight独立平台播放器窗口的默认垂直尺寸。
defaultScreenWidth独立平台播放器窗口的默认水平尺寸。
defaultWebScreenHeightWeb 播放器窗口的默认垂直尺寸。
defaultWebScreenWidthWeb 播放器窗口的默认水平尺寸。
enable360StereoCapture在当前构建目标上启用 360 度立体捕获支持。
enableCrashReportAPI启用 CrashReport API。
enableFrameTimingStats启用帧计时统计。
enableInternalProfiler启用内部性能分析器。
enableMetalAPIValidation在编辑器中启用 Metal API 验证。
enableOpenGLProfilerGPURecordersEnable ProfilerRecorder usage to record GPU timings when rendering with OpenGL.
forceSingleInstance将独立平台播放器限制为单个并发运行实例。
fullScreenMode用于定义全屏行为的平台无关性设置。并不是所有平台都支持所有模式。
gcIncremental用于启用或禁用垃圾收集增量模式。
gpuSkinningMarked for deprecation in the future. Use PlayerSettings.meshDeformation instead.
graphicsJobModeSelects the graphics job mode to use on platforms that support Native, Legacy and Split graphics jobs.
graphicsJobs启用图形作业(多线程渲染)。
hdrBitDepthThe number of bits in each color channel for swap chain buffers.
insecureHttpOptionDetermines if plain text HTTP connections are allowed.
legacyClampBlendShapeWeights定义 SkinnedMeshRenderers 中的 BlendShape 权重范围是否受到钳制。
logObjCUncaughtExceptions是否记录了 ObjC 未捕获的异常?
macRetinaSupport针对 macOS 启用 Retina 支持。
meshDeformationSpecifies which method Unity uses to process mesh deformations for skinning.
mipStrippingEnable mip stripping for all platforms.
MTRendering是否启用多线程渲染?
muteOtherAudioSources运行 Unity 应用程序时,停止或允许在后台播放来自其他应用程序的音频。
openGLRequireES31指定应用程序是否需要 OpenGL ES 3.1 支持。
openGLRequireES31AEP指定应用程序是否需要 OpenGL ES 3.1 AEP 支持。
openGLRequireES32指定应用程序是否需要 OpenGL ES 3.2 支持。
preserveFramebufferAlpha启用后,将在帧缓冲区中保存 Alpha 值以支持渲染 Android 上的原生 UI。
productName商品名称。
resetResolutionOnWindowResizeIndicates whether to reset the application's screen resolution when the native window size changes.
resizableWindow在独立平台播放器构建中使用可调节大小的窗口。
runInBackground如已启用,游戏将在失去焦点后继续运行。
spriteBatchVertexThresholdSpecifies the max vertex limit for Sprite batching.
statusBarHidden返回关于状态栏是否应隐藏的信息。仅 iOS 支持;在 Android 中,状态栏一直处于隐藏状态。
stereoRenderingPath有效立体渲染路径
strictShaderVariantMatchingEnable strict shader variant matching in the player.
stripEngineCode从构建中删除所有未使用的引擎代码(仅适限 IL2CPP)。
stripUnusedMeshComponents是否应从游戏构建中排除未使用的 Mesh 组件?
suppressCommonWarningsSuppresses common C# warnings.
use32BitDisplayBuffer使用 32 位显示缓冲区。
useAnimatedAutorotation更改设备方向时,允许操作系统自动旋转屏幕。
useFlipModelSwapchainUse DXGI flip model swap chain for D3D11.
useHDRDisplaySwitch the main display to HDR mode (if available).
useMacAppStoreValidation启用 Mac App Store 的收据验证。
usePlayerLog向日志文件写入调试信息。
virtualRealitySplashScreen特定于虚拟现实的启动画面。
visibleInBackgroundOn Windows, shows the application in the background if the Fullscreen Windowed mode is used.
vulkanEnableLateAcquireNextImageDelays acquiring the swapchain image until after the frame is rendered.
vulkanEnablePreTransformApplies the display rotation during rendering.
vulkanEnableSetSRGBWrite在 Vulkan 渲染器中启用 Graphics.SetSRGBWrite()。
vulkanNumSwapchainBuffers设置将与 Vulkan 渲染器结合使用的交换链缓冲区的数量
windowsGamepadBackendHintSpecifies the desired Windows API to be used for input.

静态函数

GetAdditionalCompilerArgumentsGets an array of additional compiler arguments set for a specific NamedBuildTarget.
GetAdditionalIl2CppArgsObtain the additional arguments passed to the IL2CPP compiler during the player build process.
GetApiCompatibilityLevelGets .NET API compatibility level for specified build target.
GetApplicationIdentifier获取指定平台的应用程序标识符。
GetArchitectureGets the architecture for the given build target.
GetCaptureStartupLogsReturns whether a given build target is configured to capture startuplogs
GetDefaultScriptingBackendReturns the default ScriptingImplementation for the build target you select.
GetDefaultShaderChunkCountGets the default limit on the number of shader variant chunks Unity loads and keeps in memory.
GetDefaultShaderChunkSizeInMBGets the default size for compressed shader variant chunks.
GetDynamicBatchingForPlatformReturns true if dynamic batching is enabled for the given BuildTarget.
GetEditorAssembliesCompatibilityLevelGets .NET API compatibility level for the editor assemblies.
GetGraphicsAPIs获取构建平台上使用的图形 API。
GetIconsReturns the list of assigned icons for the specified build target.
GetIconSizes返回指定平台的图标大小的列表。
GetIl2CppCodeGenerationGets the value of code generation option for IL2CPP.
GetIl2CppCompilerConfigurationGets compiler configuration used when compiling generated C++ code for the build target you specify.
GetIl2CppStacktraceInformationGets stack trace information option for il2cpp builds for the build target you specify.
GetManagedStrippingLevelGets the managed code stripping level set for the build target you select
GetMobileMTRendering检查是否已启用移动平台的多线程渲染选项。
GetNormalMapEncodingGets the NormalMapEncoding for the build target you select.
GetOverrideShaderChunkSettingsForPlatformIf the value is true, settings for the buildTarget override the default settings.
GetPlatformIconsGets the list of available icon slots for the specified build target and kind.
GetPreloadedAssets返回将在播放器启动时加载的资源,并保持活动状态直到播放器终止。
GetScriptingBackendGets the scripting framework for the build target you select.
GetScriptingDefineSymbolsGets the user-specified symbols for script compilation for the build target you select.
GetShaderChunkCountForPlatformGets the default limit on the number of shader variant chunks Unity loads and keeps in memory for the build target.
GetShaderChunkSizeInMBForPlatformGets the default size for compressed shader variant chunks for the build target.
GetShaderPrecisionModelGets the active shader precision model.
GetStackTraceLogTypeGets stack trace logging options.
GetStaticBatchingForPlatformReturns true if static batching is enabled for the given BuildTarget.
GetSupportedIconKindsRetrieves all icon kinds that the specified build target supports
GetTemplateCustomValueReturns a value of a custom template variable.
GetUseDefaultGraphicsAPIs构建平台是否使用自动图形 API 选项?
GetVirtualTexturingSupportEnabledIs virtual texturing enabled.
SetAdditionalCompilerArgumentsSets additional compiler arguments for a build target.
SetAdditionalIl2CppArgsSet additional arguments passed to the IL2CPP compiler during the build process.
SetApiCompatibilityLevelSets .NET API compatibility level for specified build target.
SetApplicationIdentifier为指定平台设置应用程序标识符。
SetArchitectureSets the architecture for the given build target.
SetCaptureStartupLogsSet whether a given build target is configured to capture startuplogs
SetDefaultShaderChunkCountSets the default limit on the number of shader variant chunks Unity loads and keeps in memory.
SetDefaultShaderChunkSizeInMBSets the default size for compressed shader variant chunks.
SetDynamicBatchingForPlatformSets dynamic batching for the given BuildTarget.
SetEditorAssembliesCompatibilityLevelSets .NET API compatibility level for Editor Assemblies.
SetGraphicsAPIs设置构建平台上使用的图形 API。
SetIconsAssigns a list of icons for the specified platform.
SetIl2CppCodeGenerationSets the code generation option for IL2CPP for the specified build target.
SetIl2CppCompilerConfigurationSets compiler configuration used when compiling generated C++ code for a particular build target.
SetIl2CppStacktraceInformationSets stack trace information option for il2cpp builds for the build target you specify.
SetManagedStrippingLevelSets the managed code stripping level for specified build target.
SetMobileMTRendering启用或禁用移动平台的多线程渲染选项。
SetNormalMapEncodingSets the normal map encoding for the given build target.
SetOverrideShaderChunkSettingsForPlatformEnable this to override the default shader variant chunk settings.
SetPlatformIcons为指定平台和图标种类分配图标列表。
SetPreloadedAssets分配将在播放器启动时加载的资源,并保持活动状态直到播放器终止。
SetScriptingBackendSets the scripting framework for a given build target.
SetScriptingDefineSymbolsSet user-specified symbols for script compilation for the given build target.
SetShaderChunkCountForPlatformSets the default limit on the number of shader variant chunks Unity loads and keeps in memory on the build target.
SetShaderChunkSizeInMBForPlatformSets the default size for compressed shader variant chunks on the build target.
SetShaderPrecisionModelSets the shader precision model.
SetStackTraceLogType设置堆栈跟踪日志记录选项。 注意:调用该函数将显式调用 Application.SetStackTraceLogType。
SetStaticBatchingForPlatformSets static batching for the given BuildTarget.
SetTemplateCustomValueSets a value of a custom template variable.
SetUseDefaultGraphicsAPIs构建平台是否应使用自动图形 API 选项?
SetVirtualTexturingSupportEnabledEnable virtual texturing.

继承的成员

变量

hideFlags该对象应该隐藏、随场景一起保存还是由用户修改?
name对象的名称。

公共函数

GetInstanceIDGets the instance ID of the object.
ToString返回对象的名称。

静态函数

Destroy移除 GameObject、组件或资源。
DestroyImmediate立即销毁对象 /obj/。强烈建议您改用 Destroy。
DontDestroyOnLoad在加载新的 Scene 时,请勿销毁 Object。
FindAnyObjectByTypeRetrieves any active loaded object of Type type.
FindFirstObjectByTypeRetrieves the first active loaded object of Type type.
FindObjectsByTypeRetrieves a list of all loaded objects of Type type.
Instantiate克隆 original 对象并返回克隆对象。

运算符

bool该对象是否存在?
operator !=比较两个对象是否引用不同的对象。
operator ==比较两个对象引用,判断它们是否引用同一个对象。