版本: Unity 6 (6000.0)
语言英语
  • C#

PlayerSettings

UnityEditor 中的类

/

继承自: Object

留下反馈
建议更改

成功！

感谢您帮助我们提高 Unity 文档的质量。虽然我们无法接受所有提交内容，但我们确实会阅读用户提出的每项建议更改，并在适用时进行更新。

关闭

提交失败

由于某种原因，您的建议更改无法提交。请<a>稍后再试</a>。感谢您抽出时间帮助我们提高 Unity 文档的质量。

关闭

取消

切换到手册

描述

Player Settings 是您定义将在 Unity 中构建的最终游戏各种参数的地方。其中一些值用于在您打开独立游戏时启动的 Resolution Dialog 中。

静态属性

accelerometerFrequency加速度计更新频率。
actionOnDotNetUnhandledException设置 .NET 未处理异常的崩溃行为。
advancedLicense是否正在使用高级版本？
allowedAutorotateToLandscapeLeft是否支持自动旋转到横向左侧？
allowedAutorotateToLandscapeRight是否支持自动旋转到横向右侧？
allowedAutorotateToPortrait是否支持自动旋转到纵向？
allowedAutorotateToPortraitUpsideDown是否支持自动旋转到倒置纵向？
allowFullscreenSwitch如果启用，允许用户使用特定于操作系统的键盘快捷键在全屏和窗口模式之间切换。
allowHDRDisplaySupport准备应用程序以对 HDR 显示器进行图像编码。
allowUnsafeCode允许为预定义程序集编译不安全的 C# 代码。
applicationIdentifier当前选定构建目标的应用程序标识符。
bakeCollisionMeshes在玩家构建时预先烘焙碰撞网格。
bundleVersioniOS 和 Android 平台之间共享的应用程序包版本。
colorSpace设置当前项目的渲染颜色空间。
companyName您公司的名称。
cursorHotspot默认光标的点击位置，以光标图像左上角的像素为单位。
dedicatedServerOptimizations对专用服务器构建执行其他优化。
defaultCursor应用程序的默认光标。
defaultInterfaceOrientation移动设备的默认屏幕方向。
defaultScreenHeight独立播放器窗口的默认垂直尺寸。
defaultScreenWidth独立播放器窗口的默认水平尺寸。
defaultWebScreenHeightWeb 播放器窗口的默认垂直尺寸。
defaultWebScreenWidthWeb 播放器窗口的默认水平尺寸。
enable360StereoCapture在当前构建目标上启用 360 立体声捕获支持。
enableCrashReportAPI启用 CrashReport API。
enableFrameTimingStats启用帧计时统计信息。
enableInternalProfiler启用内部探查器。
enableMetalAPIValidation在编辑器中启用 Metal API 验证。
enableOpenGLProfilerGPURecorders启用 ProfilerRecorder 使用来记录使用 OpenGL 渲染时的 GPU 计时。
forceSingleInstance将独立播放器限制为单个并发运行实例。
fullScreenMode与平台无关的设置，用于定义全屏行为。并非所有平台都支持所有模式。
gcIncremental允许您启用或禁用垃圾回收的增量模式。
gpuSkinning将来会被弃用。使用 PlayerSettings.meshDeformation 代替。
graphicsJobMode选择在支持原生、传统和拆分图形作业的平台上使用的图形作业模式。
graphicsJobs启用图形作业（多线程渲染）。
hdrBitDepth交换链缓冲区中每个颜色通道的位数。
insecureHttpOption确定是否允许纯文本 HTTP 连接。
legacyClampBlendShapeWeights定义 SkinnedMeshRenderers 中的 BlendShape 权重范围是否被钳位。
logObjCUncaughtExceptions是否记录 ObjC 未捕获的异常？
macRetinaSupport为 macOS 启用 Retina 支持。
meshDeformation指定 Unity 用于处理蒙皮的网格变形的方法。
mipStripping为所有平台启用 mip 剥离。
MTRendering是否启用了多线程渲染？
muteOtherAudioSources在您的 Unity 应用程序运行时停止或允许来自其他应用程序的音频在后台播放。
openGLRequireES31指定应用程序是否需要 OpenGL ES 3.1 支持。
openGLRequireES31AEP指定应用程序是否需要 OpenGL ES 3.1 AEP 支持。
openGLRequireES32指定应用程序是否需要 OpenGL ES 3.2 支持。
preserveFramebufferAlpha启用后，保留帧缓冲区中的 alpha 值，以支持在 Android 上在原生 UI 上进行渲染。
productName您的产品的名称。
resetResolutionOnWindowResize指示当原生窗口大小发生变化时是否重置应用程序的屏幕分辨率。
resizableWindow在独立播放器构建中使用可调整大小的窗口。
runInBackground如果启用，您的游戏将在失去焦点后继续运行。
spriteBatchVertexThreshold指定 Sprite 批处理的最大顶点限制。
statusBarHidden返回是否应隐藏状态栏。仅在 iOS 上受支持；在 Android 上，状态栏始终隐藏。
stereoRenderingPath活动立体渲染路径
strictShaderVariantMatching在播放器中启用严格的着色器变体匹配。
stripEngineCode从您的构建中删除未使用的引擎代码（仅限 IL2CPP）。
stripUnusedMeshComponents是否应将未使用的网格组件排除在游戏构建之外？
suppressCommonWarnings禁止常见的 C# 警告。
tvOSBundleVersionTVOS 平台的应用程序包版本。
use32BitDisplayBuffer使用 32 位显示缓冲区。
useAnimatedAutorotation让操作系统在设备方向发生变化时自动旋转屏幕。
useFlipModelSwapchain对 D3D11 使用 DXGI 翻转模型交换链。
useHDRDisplay将主显示器切换到 HDR 模式（如果可用）。
useMacAppStoreValidation为 Mac App Store 启用收据验证。
usePlayerLog使用调试信息写入日志文件。
virtualRealitySplashScreen虚拟现实特定的启动画面。
visibleInBackground在 Windows 上，如果使用全屏窗口模式，则在后台显示应用程序。
visionOSBundleVersionVisionOS 平台的应用程序包版本。
vulkanEnableLateAcquireNextImage延迟获取交换链图像，直到渲染完帧后。
vulkanEnablePreTransform在渲染期间应用显示旋转。
vulkanEnableSetSRGBWrite在 Vulkan 渲染器上启用 Graphics.SetSRGBWrite()。
vulkanNumSwapchainBuffers设置要与 Vulkan 渲染器一起使用的交换链缓冲区数量
windowsGamepadBackendHint指定要用于输入的所需 Windows API。

静态方法

GetAdditionalCompilerArguments获取为特定 NamedBuildTarget 设置的一组附加编译器参数。
GetAdditionalIl2CppArgs获取在播放器构建过程中传递给 IL2CPP 编译器的附加参数。
GetApiCompatibilityLevel获取指定构建目标的 .NET API 兼容性级别。
GetApplicationIdentifier获取指定平台的应用程序标识符。
GetArchitecture获取给定构建目标的体系结构。
GetCaptureStartupLogs返回给定构建目标是否配置为捕获启动日志
GetDefaultScriptingBackend返回您选择的构建目标的默认 ScriptingImplementation。
GetDefaultShaderChunkCount获取 Unity 加载并保存在内存中的着色器变体块数量的默认限制。
GetDefaultShaderChunkSizeInMB获取压缩着色器变体块的默认大小。
GetDynamicBatchingForPlatform如果为给定的 BuildTarget 启用了动态批处理，则返回 true。
GetEditorAssembliesCompatibilityLevel获取编辑器程序集的 .NET API 兼容性级别。
GetGraphicsAPIs获取要在构建平台上使用的图形 API。
GetIcons返回为指定构建目标分配的图标列表。
GetIconSizes返回指定平台的图标大小列表。
GetIl2CppCodeGeneration获取 IL2CPP 的代码生成选项的值。
GetIl2CppCompilerConfiguration获取编译为指定构建目标生成的 C++ 代码时使用的编译器配置。
GetIl2CppStacktraceInformation获取为指定构建目标的 il2cpp 构建设置的堆栈跟踪信息选项。
GetManagedStrippingLevel获取为选定的构建目标设置的托管代码剥离级别
GetMobileMTRendering检查移动平台的多线程渲染选项是否已启用。
GetNormalMapEncoding获取您选择的构建目标的 NormalMapEncoding。
GetOverrideShaderChunkSettingsForPlatform如果值为 true，则构建目标的设置将覆盖默认设置。
GetPlatformIcons获取为指定构建目标和种类提供的可用图标插槽列表。
GetPreloadedAssets返回将在播放器启动时加载并在播放器终止之前保持活动的资产。
GetScriptingBackend获取您选择的构建目标的脚本框架。
GetScriptingDefineSymbols获取为选定的构建目标设置的脚本编译的用户指定符号。
GetShaderChunkCountForPlatform获取 Unity 为构建目标加载并保存在内存中的着色器变体块数量的默认限制。
GetShaderChunkSizeInMBForPlatform获取构建目标的压缩着色器变体块的默认大小。
GetShaderPrecisionModel获取活动的着色器精度模型。
GetStackTraceLogType获取堆栈跟踪记录选项。
GetStaticBatchingForPlatform如果为给定的 BuildTarget 启用了静态批处理，则返回 true。
GetSupportedIconKinds检索指定构建目标支持的所有图标种类
GetTemplateCustomValue返回自定义模板变量的值。
GetUseDefaultGraphicsAPIs构建平台是否使用自动图形 API 选择？
GetVirtualTexturingSupportEnabled是否启用了虚拟纹理？
SetAdditionalCompilerArguments为构建目标设置附加编译器参数。
SetAdditionalIl2CppArgs设置构建过程中传递给 IL2CPP 编译器的附加参数。
SetApiCompatibilityLevel为指定构建目标设置 .NET API 兼容性级别。
SetApplicationIdentifier为指定平台设置应用程序标识符。
SetArchitecture为给定构建目标设置体系结构。
SetCaptureStartupLogs设置给定构建目标是否配置为捕获启动日志
SetDefaultShaderChunkCount设置 Unity 加载并保存在内存中的着色器变体块数量的默认限制。
SetDefaultShaderChunkSizeInMB设置压缩着色器变体块的默认大小。
SetDynamicBatchingForPlatform为给定的 BuildTarget 设置动态批处理。
SetEditorAssembliesCompatibilityLevel设置编辑器程序集的 .NET API 兼容性级别。
SetGraphicsAPIs设置构建平台上使用的图形 API。
SetIcons为指定平台分配一组图标。
SetIl2CppCodeGeneration为指定构建目标设置 IL2CPP 的代码生成选项。
SetIl2CppCompilerConfiguration设置编译为特定构建目标生成的 C++ 代码时使用的编译器配置。
SetIl2CppStacktraceInformation为指定构建目标设置 il2cpp 构建的堆栈跟踪信息选项。
SetManagedStrippingLevel为指定构建目标设置托管代码剥离级别。
SetMobileMTRendering启用或禁用移动平台的多线程渲染选项。
SetNormalMapEncoding为给定构建目标设置法线贴图编码。
SetOverrideShaderChunkSettingsForPlatform启用此选项以覆盖默认的着色器变体块设置。
SetPlatformIcons为指定平台和图标类型分配一个图标列表。
SetPreloadedAssets分配将在播放器启动时加载并在播放器终止之前保持活动状态的资产。
SetScriptingBackend为给定构建目标设置脚本框架。
SetScriptingDefineSymbols为给定构建目标设置用户指定的脚本编译符号。
SetShaderChunkCountForPlatform设置构建目标上 Unity 加载和保存在内存中的着色器变体块数量的默认限制。
SetShaderChunkSizeInMBForPlatform设置构建目标上压缩着色器变体块的默认大小。
SetShaderPrecisionModel设置着色器精度模型。
SetStackTraceLogType设置堆栈跟踪日志记录选项。注意：调用此函数将隐式调用 Application.SetStackTraceLogType。
SetStaticBatchingForPlatform为给定的构建目标设置静态批处理。
SetTemplateCustomValue设置自定义模板变量的值。
SetUseDefaultGraphicsAPIs构建平台是否应该使用自动图形 API 选择。
SetVirtualTexturingSupportEnabled启用虚拟纹理。

继承成员

属性

hideFlags对象是否应该隐藏、与场景一起保存或可由用户修改？
name对象的名称。

公共方法

GetInstanceID获取对象的实例 ID。
ToString返回对象的名称。

静态方法

Destroy删除游戏对象、组件或资产。
DestroyImmediate立即销毁对象 obj。强烈建议您使用 Destroy 代替。
DontDestroyOnLoad加载新场景时不要销毁目标对象。
FindAnyObjectByType检索任何类型为 type 的活动加载对象。
FindFirstObjectByType检索类型为 type 的第一个活动加载对象。
FindObjectsByType检索类型为 type 的所有加载对象的列表。
Instantiate克隆对象 original 并返回克隆。
InstantiateAsync捕获原始对象（必须与某些游戏对象相关）的快照，并返回 AsyncInstantiateOperation。

运算符

bool对象是否存在？
operator !=比较两个对象是否引用不同的对象。
operator ==比较两个对象引用，查看它们是否引用同一个对象。

这里描述的某些内容是否无法按预期工作？这可能是已知问题。请在 Issue Tracker 上查看： issuetracker.unity3d.com.

版权所有 ©2005-2024 Unity Technologies。保留所有权利。构建自：6000.0.25f1 (91cbff7fd174)。构建于：2024-10-19。
教程 社区问答 知识库 论坛 资产商店 使用条款 法律 隐私政策 Cookies 不销售或共享我的个人信息