Version: Unity 6.0 (6000.0)
语言 : 中文
macOS 要求和兼容性
针对 macOS 开发

macOS 播放器设置参考

本页面将详细介绍 macOS 特有的__播放器 (Player)__ 设置。有关常规__播放器__设置的描述,请参阅播放器设置 (Player Settings) 相关文档。

您可以在以下部分找到这些属性的文档:

图标

激活__覆盖 Windows、Mac、Linux (Override for Windows, Mac, Linux)__ 设置,为桌面游戏指定自定义图标。可以上传不同大小的图标来填充提供的每个方块。

分辨率和演示

使用__分辨率和演示 (Resolution and Presentation)__ 部分可以自定义屏幕外观的各个方面。

分辨率

此部分可以自定义屏幕模式和默认大小。

属性 描述
Run In background 启用此选项可在应用程序失去焦点时继续在后台运行。禁用时,应用程序会在失去焦点时暂停。
Fullscreen Mode 选择全屏模式。此设置定义了启动时的默认窗口模式。
Fullscreen Window 将应用程序窗口设置为全屏原生显示分辨率,覆盖整个屏幕。此模式也称为无边框全屏。Unity 会根据脚本设置的分辨率渲染应用程序内容,如果没有设置,则使用原生显示分辨率,并将其缩放以填充窗口。在缩放过程中,Unity 会添加黑边以匹配显示宽高比,从而防止内容拉伸。这一过程称为黑边填充。操作系统界面(例如 IME 输入窗口)会显示在全屏窗口的顶部。所有平台均支持此模式。
独占全屏(仅限 Windows) 设置应用程序以独占方式全屏使用显示器。与全屏窗口不同,此模式会更改显示器的操作系统分辨率以匹配应用程序选择的分辨率。仅在 Windows 操作系统上支持。
最大化窗口(仅限 Windows 和 Mac) 将应用程序窗口设置为操作系统的最大化状态。在 Windows 上,这是一个带有标题栏的全屏窗口。在 macOS 上,这是一个带有隐藏菜单栏和停靠栏的全屏窗口。对于其他平台,默认设置为全屏窗口
窗口化 将应用程序设置为标准的非全屏可移动窗口,窗口大小取决于应用程序的分辨率。在此模式下,默认情况下窗口可调整大小。可以通过可调整窗口大小设置禁用此功能。所有桌面平台都支持此全屏模式。
Default Is Native Resolution 启用此选项可使游戏使用目标设备的默认分辨率。
注意:如果将__全屏模式__设置为窗口化,此属性将不可见。
Default Screen Width 设置游戏画面的默认宽度(以像素为单位)。

注意:仅当__全屏模式__设置为窗口化时,此属性才可见。
Default Screen Height 设置游戏画面的默认高度(以像素为单位)。

注意:仅当__全屏模式__设置为窗口化时,此属性才可见。
Mac Retina Support 启用此选项可在 Mac 上启用高 DPI (Retina) 屏幕支持。Unity 默认情况下启用此功能。启用后可提升在 Retina 显示屏上的显示效果,但会增加一定的资源消耗。

独立平台播放器选项

使用此部分可指定屏幕自定义设置。例如,可以设置选项用于让用户调整屏幕大小并指定可以同时运行的实例数。

属性 描述
Use Player Log 激活此选项可向日志文件写入调试信息。
警告:如果计划将应用程序提交到 Mac App Store,则停用此选项。有关更多信息,请参阅发布到 Mac App Store
Resizable Window 激活此选项可调整桌面端播放器窗口的大小。
注意:如果停用此选项,则应用程序无法使用窗口化全屏模式
Visible in Background 在使用窗口化全屏模式时,激活此选项可在背景中显示应用程序。macOS 不支持此选项。
Allow Fullscreen Switch 激活此选项可允许通过默认操作系统全屏按键在全屏模式和窗口模式之间切换。
Force Single Instance 激活此选项可将桌面端播放器限制为单个并发运行实例。
Use DXGI flip model swap chain for D3D11 使用翻转模型可确保最佳性能。此设置会影响 D3D11 图形 API。停用此选项可回退到 Windows 7 风格的 BitBlt 模型。有关更多信息,请参阅 PlayerSettings.useFlipModelSwapchain

启动画面

使用虚拟现实启动画面 (Virtual Reality Splash Image) 设置以选择虚拟现实 (Virtual Reality) 显示的自定义启动画面。有关常见启动画面 (Splash Screen) 设置的信息,请参阅启动画面

其他设置

渲染

使用这些设置可自定义 Unity 针对桌面平台渲染游戏的方式。

    
属性 描述
Color Space 选择要用于渲染的颜色空间。有关更多信息,请参阅线性渲染概述
Gamma Gamma 颜色空间通常用于帧缓冲区格式的每通道限制为 8 位的旧硬件上的光照计算。即使当今的监视器是数字显示器,它们仍会采用伽马编码信号作为输入信号。
Linear 线性颜色空间渲染可提供更精确的结果。选择线性颜色空间时,编辑器默认启用 sRGB 采样。如果纹理 处于线性颜色空间,则需要在编辑器中禁用每个纹理的 sRGB 采样。
Auto Graphics API for Windows 启用此选项可在运行应用程序的 Windows 计算机上使用最佳图形 API。禁用此选项可添加和删除支持的图形 API。
Auto Graphics API for Mac 启用此选项可在运行应用程序的 macOS 计算机上使用最佳图形 API。禁用此选项可添加和删除支持的图形 API。
Auto Graphics API for Linux 启用此选项可在运行应用程序的 Linux 计算机上使用最佳图形 API。禁用此选项可添加和删除支持的图形 API。
Color Gamut 您可以添加或移除色域 以用于渲染。单击加号 (+) 图标以查看可用色域的列表。色域定义了特定设备(如显示器或屏幕)能够呈现的颜色范围。sRGB 色域是默认色域(也是必需色域)。
Metal API 验证 启用此选项可使用编辑器内置工具调试着色器问题。在绘制调用时,该工具会检查着色器预期的纹理和缓冲区是否与实际附加的资源匹配,并确认其兼容性。检查结果将显示在控制台中。

Metal API 验证 不会启用 Apple 的 Metal API 验证,但您可以通过在 macOSiOS 的构建设置 (Build Settings) 窗口中将 Run in Xcode as 设置为 Debug 来启用它。

注意:此设置仅在 macOS 上运行 Unity 编辑器时显示。
Metal Write-Only Backbuffer 允许在非默认设备方向上提高性能。此属性会在后缓冲区上设置 frameBufferOnly 标志,因此会阻止从后缓冲区的回读,并可实现一定程度的驱动程序优化。
Force hard shadows on Metal 启用此选项可强制 Unity 在 Metal 中对阴影使用点采样。这样会降低阴影质量,但可以提高性能。
Memoryless Depth 选择何时使用无记忆渲染纹理。无记忆渲染纹理在渲染时会临时存储于片上内存,而不是存储在 CPU 或 GPU 内存中。这可以减少应用的内存占用,但无法对这些渲染纹理进行读取或写入操作。

注意:无记忆渲染纹理仅支持在 iOS、tvOS 10.0+、Metal 和 Vulkan 平台上使用。在其他平台上,渲染纹理将受到读/写保护,并存储在 CPU 或 GPU 内存中。
Unused 从不使用无记忆帧缓冲区深度。
Forced 始终使用无记忆帧缓冲区深度。
Automatic 让 Unity 决定何时使用无记忆帧缓冲区深度。
Static Batching 启用此选项可使用静态批处理
Dynamic Batching 在构建中启用动态批处理(默认情况下启用)。

注意:可编程渲染管线 处于激活状态时,动态批处理将无效。因此,仅当 可编程渲染管线资源图形 设置为空时,此设置才会显示。
精灵批处理阈值 (Sprite Batching Threshold) 控制批处理时使用的最大顶点阈值。
GPU Skinning 启用此选项可使用着色器在 GPU 上计算网格蒙皮和混合形状。
Graphics Jobs 启用此选项后,Unity 会将图形任务(渲染循环)分配到其他 CPU 核心上运行的工作线程中。此功能可以减少主线程中 Camera.Render 的执行时间,而这一环节通常是性能瓶颈所在。
Lightmap Encoding 定义影响光照贴图的编码方案和压缩格式。
您可以选择 Low QualityNormal QualityHigh Quality
HDR 立方体贴图编码 (HDR Cubemap Encoding) 定义 HDR 立方体贴图的编码方案和压缩格式。
您可以选择 Low QualityNormal QualityHigh Quality。有关更多信息,请参阅 光照贴图:技术信息
Lightmap Streaming 启用此选项可对光照贴图使用Mipmap 串流。Unity 在生成所有光照贴图时将此设置应用于这些光照贴图。
注意:要使用此设置,必须启用纹理 Mipmap 串流质量 设置。
Streaming Priority 设置 Mipmap 串流系统 中所有光照贴图的优先级。Unity 在生成所有光照贴图时将此设置应用于这些光照贴图。
数值越大,优先级越高。有效值范围为 -128127
Frame Timing Stats 启用此选项可收集 CPU/GPU 帧时序统计信息。
OpenGL:Profiler GPU Recorders 使用 OpenGL 渲染时启用性能分析器记录器。
Allow HDR Display Output 在应用程序运行时激活 HDR 模式输出。此设置仅适用于支持该功能的显示屏。如果显示屏不支持 HDR 模式,则游戏将在标准模式下运行。
Swap Chain Bit Depth 选择每个颜色通道中用于交换链缓冲区的位数。可选择 Bit Depth 10Bit Depth 16。仅当启用了 HDR 模式时,才可以选择位深度 (Bit Depth)。

有关位深度的更多信息,请参阅 D3DHDRDisplayBitDepth 的脚本 API 页面。
Bit Depth 10 Unity 将使用 R10G10B10A2 缓冲区格式和 Rec2020 原色(采用 ST2084 PQ 编码)。
Bit Depth 16 Unity 将使用 R16G16B16A16 缓冲区格式和 Rec709 原色及线性颜色(无编码)。
Virtual Texturing 如果场景中有许多高分辨率纹理,启用此选项可以减少 GPU 内存使用量和纹理加载时间。有关更多信息,请参阅 虚拟纹理

注意:Unity 编辑器需要重新启动才能使此设置生效。
360 Stereo Capture 指示 Unity 是否可以捕获立体 360 图像和视频。启用后,Unity 会编译其他着色器变体,以支持 360 度捕获(目前仅适用于 Windows/OSX)。enable_360_capture 关键字会在调用 RenderToCubemap 时添加,但不会在该函数外部触发。
加载/存储操作调试模式 (Load/Store Action Debug Mode) 突出显示可能导致移动平台上渲染问题的未定义像素。这会影响 Unity 编辑器中的游戏视图,并且如果在构建设置中选择了 Development Build,也会影响构建好的应用程序。请参阅 LoadStoreActionDebugModeSettings 以了解更多信息。

Vulkan 设置

属性 描述
SRGB Write Mode 启用此选项可以使 Graphics.SetSRGBWrite() 在运行时切换 sRGB 写入模式。使用此属性可停用线性到 sRGB 写入颜色转换。
Number of swapchain buffers 使用 Vulkan 渲染器,可以将此选项设置为 2 表示双缓冲,设置为 3 表示三缓冲。此设置可能有助于解决某些平台上的延迟问题,但通常不应更改这个默认值 3。双缓冲可能会对性能产生负面影响。
Acquire swapchain image late as possible 启用此选项可在帧渲染到屏幕外临时图像后获取后备缓冲区。启用此设置会在呈现后备缓冲区时添加额外的 blit。此设置与双缓冲相结合可以提高性能。但是,由于额外的 blit 使用额外的带宽,因此也可能导致性能问题。
Recycle command buffers 启用此选项可在 Unity 执行 CommandBuffer 后回收它们。

Mac App Store 选项

属性 描述
Override Default Bundle Identifier 指示是否可以手动设置捆绑包标识符。

注意:此设置会影响 macOS、iOS、tvOS 和 Android。
捆绑包标识符 (Bundle Identifier) 输入应用程序的捆绑包标识符。此信息在关联的 info.plist 文件中显示为 CFBundleIdentifier。捆绑包标识符必须遵循约定 com.YourCompanyName.YourProductName,并且只能包含字母数字和连字符。有关更多信息,请参阅 CFBundleIdentifier

重要提示:Unity 会自动将输入的任何无效字符替换为连字符。
Build 输入此应用版本的内部版本号。此信息在关联的 info.plist 文件中显示为 CFBundleVersion。有关更多信息,请参阅 CFBundleVersion
Category 输入与应用程序类型对应的字符串。App Store 使用此字符串来选择应用程序的相应分类。默认情况下,此设置为 public.app-category.games。有关更多信息,请参阅 LSApplicationCategoryType
Mac App Store Validation 通过激活此属性,可确保只有当应用程序具有来自 Mac App Store 的有效收据时才会运行。这样可以防止用户在不同的设备上运行游戏。仅当您已实施自己的收据验证时,才应停用此设置。

发布到 Mac App Store

使用播放器日志 (Use Player Log) 属性会创建一个包含调试信息的日志文件,有助于调查游戏出现的任何问题。在为 Apple 的 Mac App Store 发布游戏时应停用此功能,因为如果激活此功能,Apple 可能会拒绝您提交。有关更多信息,请参阅日志文件使用 Mac App Store 验证 (Use Mac App Store Validation) 属性可激活 Mac App Store 的收据验证。如果激活此属性,则只有当游戏具有来自 Mac App Store 的有效收据时才会运行。将游戏提交给 Apple 以便在 App Store 上发布时,应使用此功能。这样可以防止用户在不同的计算机上运行游戏。

注意:此功能不具备任何强大的复制保护。特别需要说明的是,针对一个 Unity 游戏的任何潜在破解将对其他任何 Unity 内容都有效。因此,建议使用 Unity 的插件功能在此基础上实现您自己的收据验证代码。由于 Apple 要求在显示屏幕设置对话框之前的最初阶段进行插件验证,因此建议激活此属性,以免 Apple 拒绝提交。

配置

属性 描述
Scripting Backend 选择要使用的脚本后端。脚本后端决定了 Unity 在项目中如何编译和执行 C# 代码。
Mono 将 C# 代码编译为 .NET 公共中间语言 (CIL),并通过公共语言运行时执行该 CIL。有关更多信息,请参阅 Mono
IL2CPP 将 C# 代码编译为 CIL,然后将 CIL 转换为 C++ 代码,最终将 C++ 编译成本地机器代码,该代码在运行时直接执行。请参阅 IL2CPP 以了解更多信息。
API Compatibility Level 选择项目中可以使用的 .NET API 版本。此设置可能会影响与第三方库的兼容性。但是,它对编辑器特定的代码(编辑器目录中的代码或编辑器特定的程序集定义中的代码)没有影响。

提示:如果您遇到第三方程序集的问题,可以尝试下文的 API 兼容性级别 部分中的建议。
.Net Framework 兼容 .NET Framework 4(包含 .NET Standard 2.0 配置文件中的所有内容以及额外的 API)。当使用的库需要访问 .NET Standard 2.0 中未包含的 API 时,请选择此选项。此选项会生成较大的构建文件,并且额外的 API 可能不被所有平台支持。更多信息,请参阅引用其他类库程序集
.Net Standard 2.1 生成较小的构建文件,并提供完整的跨平台支持。
编辑器程序集兼容性级别 选择在编辑器程序集中使用的 .NET API。
.NET Framework 兼容 .NET Framework 4(包含 .NET Standard 2.1 中的所有 API 以及额外的 API)。当使用的库需要访问 .NET Standard 2.1 未涵盖的 API 时,选择此选项。此选项会生成较大的构建文件,并且额外的 API 可能不被所有平台支持。更多信息,请参阅引用其他类库程序集
.NET Standard 兼容 .NET Standard 2.1。生成较小的构建文件,并提供完整的跨平台支持。
IL2CPP 代码生成 定义 Unity 如何管理 IL2CPP 代码生成。

注意:要使用此功能,请将 脚本后端 设置为 IL2CPP
C++ Compiler Configuration 选择用于编译 IL2CPP 生成代码的 C++ 编译器配置。
Debug Debug 配置禁用所有优化,这使得代码的编译速度更快,但运行速度较慢。
Release Release 配置启用优化,使编译后的代码运行速度更快,生成的二进制文件体积更小,但编译时间会更长。
Master Master 配置启用所有可能的优化,以最大限度地提升性能。例如,在使用 MSVC++ 编译器的平台上,此配置会启用链接时代码生成。使用此配置编译代码的时间可能会显著长于 Release 配置。如果可以接受构建时间的增加,Unity 建议使用 Master 配置来构建游戏的发布版本。
IL2CPP Stacktrace Information 选择要包含在堆栈跟踪中的信息。有关信息类型的更多详细信息,请参阅 托管堆栈跟踪与 IL2CPP
方法名称 在堆栈跟踪中包含每个托管方法的名称。
方法名称、文件名称和行号 在堆栈跟踪中包含每个托管方法的名称、文件名和行号信息。

注意:启用此选项可能会增加构建时间和最终程序的体积。
Use incremental GC 启用增量式垃圾回收器,该功能可将垃圾回收任务分散到多个帧中,从而减少因垃圾回收导致的帧时间峰值。更多信息,请参阅自动内存管理
Allow downloads over HTTP (nonsecure) 表示是否允许通过 HTTP 下载内容。由于建议的协议为 HTTPS,因此默认选项为 Not allowed,这样更安全。
不允许 不允许通过 HTTP 下载。
创建开发版 仅允许在开发版中通过 HTTP 下载。
始终允许 允许在开发和发布版本中通过 HTTP 下载。
Target minimum macOS Version 输入应用程序将运行的最低 macOS 版本。
Active Input Handling 选择如何处理来自用户的输入。
Input Manager(旧版) 使用传统的输入 设置。
输入系统包(新版) 使用输入 系统。此选项需要您安装 InputSystem 包
Both 同时使用这两个系统。

API 兼容性级别

可为所有目标选择 mono API 兼容性级别。有时,第三方 .NET 库会使用 .NET 兼容性级别之外的功能。要了解在这种情况下可能发生的问题以及如何以最佳方案修复问题,请尝试以下解决方案:

  1. 安装适用于 Windows 的 ILSpy
  2. 将遇到问题的 API 兼容性级别的 .NET 程序集拖入 ILSpy。这些可以在 Frameworks/Mono/lib/mono/YOURSUBSET/ 下找到。
  3. 拖入第三方程序集。
  4. 右键单击第三方程序集并选择分析 (Analyze)
  5. 在分析报告中,检查取决于 (Depends on) 部分。若第三方程序集所依赖的内容在所选的 .NET 兼容性级别中不可用,这些内容将以红色字体显示。

Mac 配置

属性 描述
Camera Usage Description 输入在设备上访问摄像机的原因。
Microphone Usage Description 输入在设备上访问麦克风的原因。
Bluetooth Usage Description 输入访问设备蓝牙连接的原因。
Supported URL schemes 支持的 URL 方案 的列表。要添加新方案,请增加__大小 (Size)__ 属性的值,然后在出现的新__元素 (Element)__ 框中设置对要加载的资源的引用。

着色器设置

属性 描述
Shader Precision Model 选择着色器使用的默认精度。有关更多信息,请参阅在着色器中使用 16 位精度
平台默认值 (Platform default) 在移动平台上使用较低的精度,在其他平台上使用全精度。
统一 (Unified) 如果平台支持,请使用较低的精度。
Strict shader variant matching 如果缺少着色器变体并在控制台中显示错误,请使用错误着色器。
Keep Loaded Shaders Alive 保持所有加载的着色器处于活动状态,防止其被卸载。

着色器变体加载设置

使用这些设置可以控制着色器在运行时的内存使用量。

属性 描述
Default chunk size (MB) 设置 Unity 在构建的应用程序中为所有平台存储的压缩着色器变体数据块的最大大小。默认值为 16。有关更多信息,请参阅着色器加载
Default chunk count 设置 Unity 在所有平台上保留在内存中的解压缩块数量的默认限制。默认值为 0,表示无限制。
Override 启用此选项可为此构建目标覆盖__默认块大小__和__默认块数量__的设置。
Chunk size (MB) 覆盖此构建目标上的__默认块大小 (MB)__ 值。
Chunk count 覆盖此构建目标上的__默认块数量__值。

脚本编译

属性 描述
Scripting Define Symbols 设置自定义编译标志。

有关更多信息,请参阅依赖于平台的编译
Additional Compiler Arguments 向此列表添加条目,以将附加参数传递给 Roslyn 编译器。每个附加参数使用一个新条目。
要创建新条目,请单击添加 (Add) (+)。要删除条目,请单击删除 (Remove)-)。

添加完所有所需参数后,单击应用 (Apply),以便在后续编译中包含这些附加参数。单击还原 (Revert) 可将此列表重置为最新应用的状态。
Suppress Common Warnings 指示是否显示 C# 警告 CS0169CS0649
Allow ‘unsafe’ Code 激活对预定义程序集(例如,Assembly-CSharp.dll)中“不安全”C# 代码的编译。
对于程序集定义文件 (.asmdef),请选中其中一个 .asmdef 文件,并在打开的检视面板 (Inspector) 窗口中激活该选项。
Use Deterministic Compilation 指定是否禁用 -deterministic C# 编译标志。激活此设置后,每次编译生成的程序集在字节级别上完全一致。

有关更多信息,请参阅 Microsoft 的确定性编译器选项

优化

属性 描述
Prebake Collision Meshes 在构建时将碰撞数据添加到网格
Preloaded Assets 设置一个资源数组,供播放器在启动时加载。
要添加新资源,请增加 Size 属性的值,随后在新出现的 Element 槽位中设置要加载的资源引用。
Managed Stripping Level 选择 Unity 剥离未使用托管 (C#) 代码时的激进程度。在构建应用程序时,Unity Linker 进程可以从项目使用的托管 DLL 中剥离未使用的代码。剥离代码可以显著减小生成的可执行文件大小,但也可能会错误地删除正在使用的代码。

有关这些选项以及使用 IL2CPP 进行字节码剥离的更多信息,请参阅 ManagedStrippingLevel
最低 剥离类库、UnityEngine 和 Windows 运行时程序集,并复制所有其他程序集。
删除无法访问的托管代码以减少构建大小和 Mono/IL2CPP 构建时间。
运行 UnityLinker,进一步减小代码大小,超越 Low 级别所能实现的效果。可能需要使用自定义的 link.xml 文件,某些反射代码路径的行为可能会有所不同。
UnityLinker 将尽可能多地剥离代码这将进一步减小代码大小,超出 Medium 可以实现的效果,但某些方法的托管代码调试可能不再有效。可能需要使用自定义的 link.xml 文件,某些反射代码路径的行为可能会有所不同。
Vertex Compression 设置每个通道的顶点压缩。此设置会影响项目中的所有网格。
通常,顶点压缩用于减小网格数据在内存中的占用、减小文件大小,并提升 GPU 性能。

有关顶点压缩的配置方法及其限制的详细信息,请参阅压缩网格数据
Optimize Mesh Data 启用此选项可从用于构建的网格中移除未使用的顶点属性。此功能可减少网格数据量,从而有助于减小构建文件大小、缩短加载时间以及降低运行时内存占用。

警告:如果启用此选项,请勿在运行时更改材质或着色器设置。

有关更多信息,请参阅 PlayerSettings.stripUnusedMeshComponents
纹理 Mipmap 剥离 为所有平台启用 Mipmap 剥离功能。在构建过程中,Unity 会从纹理中剥离未使用的 Mipmap 级别。
Unity 通过将 Mipmap 级别与当前平台的质量设置进行比较,以确定哪些 Mipmap 级别未被使用。如果在当前平台的所有质量设置中都排除了某个 Mipmap 级别,Unity 会在构建时将这些 Mipmap 级别剥离。如果 QualitySettings.globalTextureMipmapLimit 被设置为一个已剥离的 Mipmap 级别,Unity 会将其值调整为最近的未剥离的 Mipmap 级别。

堆栈跟踪

通过启用与每种日志类型对应的选项来选择您的首选日志记录类型。

属性 描述
None 从不记录任何日志。
ScriptOnly 仅在运行脚本时记录日志。
Full 始终记录日志。

有关更多信息,请参阅堆栈跟踪日志记录

旧版

属性 描述
Clamp BlendShapes(已弃用) 激活此选项可在 SkinnedMeshRenderers 中限制混合形状权重的范围。
macOS 要求和兼容性
针对 macOS 开发