文档

Unity 引擎

Unity 引擎

Unity 脚本符号参考

Unity 提供的预定义脚本符号的引用。
阅读时间7 分钟最后更新于 5 天前

平台符号

Unity 根据创作和生成目标平台自动定义某些符号。它们如下:

定义

函数

UNITY_EDITOR
用于从游戏代码调用 Unity Editor 脚本的脚本符号。
UNITY_EDITOR_WIN
ON Windows Editor 代码的脚本符号。
UNITY_EDITOR_OSX
macOS 中 Editor 代码的脚本符号。
UNITY_EDITOR_LINUX
ON Linux Editor 代码的脚本符号。
UNITY_EMBEDDED_LINUX
嵌入式 Linux 的脚本符号。
UNITY_QNX
QNX 的脚本符号。
UNITY_STANDALONE_OSX
用于编译或执行专为 macOS(包括 Universal、PPC 和 Intel 架构)编写的代码的脚本符号。
UNITY_STANDALONE_WIN
用于编译/执行专为 Windows 独立平台Applications程序编写的代码的脚本符号。
UNITY_STANDALONE_LINUX
用于编译/执行专为 Linux 平台 Applications 编写的代码的脚本符号。
UNITY_STANDALONE
用于编译/执行Any独立平台(Mac OS X、Windows 或 Linux)的代码的脚本符号。
UNITY_SERVER
用于编译/执行专用服务器(macOS、Windows 或 Linux)代码的脚本符号。
UNITY_IOS
用于为 iOS 平台台编译/执行代码的脚本符号。
UNITY_ANDROID
Android 平台的脚本符号。
UNITY_TVOS
Apple TV 平台的脚本符号。
UNITY_VISIONOS
VisionOS 平台的脚本符号。
UNITY_WSA
通用 Windows 平台的脚本符号。
UNITY_WSA_10_0
通用 Windows 平台的脚本符号。
UNITY_WEBGL
Web 的脚本符号。
UNITY_ANALYTICS
用于从游戏代码调用 Unity 数据分析平台 方法的脚本符号。
UNITY_ASSERTIONS
断言Control过程的脚本符号。
UNITY_64
64 位平台的脚本符号。实际上不应使用此方法,因为它不适用于 ON 所有 64 位架构,并且给定平台的不同 CPU 架构可以共享相同的编译程序集。要基于 ON 架构有条件地执行代码,请使用标准
if
语句来检查 IntPtr.大小,这是 32 位进程中的
4
,也是 64 位进程中的
8
。有关示例,请参阅替代指令。

Unity Editor 版本符号

Unity 根据您当前使用的 Unity Editor 版本自动定义某些脚本符号。
根据版本数量
X.Y.Z
(例如 6000.0.33),Unity 公开了以下格式的三个全局脚本符号:
UNITY_X
、
UNITY_X_Y
和
UNITY_X_Y_Z
。
以下是 Unity 6000.0.33 中公开的脚本符号示例:

定义

函数

UNITY_6000
Unity 6 释放版本的脚本符号,在每个 6000.Y.Z 释放本中公开。
UNITY_6000_0
Unity 6.0 主要版本的脚本符号,在每个 6000.0.Z 释放中公开。
UNITY_6000_0_33
Unity 6000.0.33 次要版本的脚本符号。
还可以根据编译或执行代码片段所需的最早 Unity 版本有选择地编译代码。遵循先前描述的相同版本格式(
X.Y
),Unity 以 Format
UNITY_X_Y_OR_NEWER
公开一个全局
#define
(例如,
UNITY_6000_0_OR_NEWER
),您可以将其用于此目的。

Other符号

Unity 定义的Other符号包括:

定义

函数

CSHARP_7_3_OR_NEWER
在构建Support C# 7.3 或更高版本的脚本When定义。
ENABLE_MONO
Scripting Backend #define for Mono。
ENABLE_IL2CPP
IL2CPP 的Scripting Backend #define。
ENABLE_VR
在Target构构建平台支持 VR When定义。并不意味着当前已已启用 VR,也不意味着已安装Support VR 所需的必要插件和包。
NET_2_0
ON Mono 和 IL2CPP 上根据 .NET 2.0 API 兼容性级别别构脚本。
NET_2_0_SUBSET
ON Mono 和 IL2CPP 上根据 .NET 2.0 Subset API 兼容性级别别构脚本。
NET_LEGACY
ON Mono 和 IL2CPP 上根据 .NET 2.0 或 .NET 2.0 Subset API 兼容性级别别构脚本。
NET_4_6
ON Mono 和 IL2CPP 上根据 .NET 4.x API 兼容性级别别构脚本。
NET_STANDARD_2_0
ON Mono 和 IL2CPP 上根据 .NET 标准 2.0 API 兼容性级别别构脚本。
NET_STANDARD_2_1
ON Mono 和 IL2CPP 上根据 .NET 标准 2.1 API 兼容性级别别构脚本。
NET_STANDARD
ON Mono 和 IL2CPP 上根据 .NET 标准 2.1 API 兼容性级别别构脚本。
NETSTANDARD2_1
ON Mono 和 IL2CPP 上根据 .NET 标准 2.1 API 兼容性级别别构脚本。
NETSTANDARD
ON Mono 和 IL2CPP 上根据 .NET 标准 2.1 API 兼容性级别别构脚本。
ENABLE_WINMD_SUPPORT
ON IL2CPP 上已启用 Windows 运行时支持When定义。有关更多信息,请参阅 C# 脚本中的 WinRT API for UWP。
ENABLE_INPUT_SYSTEM
在 Player Settings 中已启用用Input System包义。
ENABLE_LEGACY_INPUT_MANAGER
在 Player Settings 中已启用Legacy 输入管理器 When定义。
DEVELOPMENT_BUILD
当脚本在已启用 Development Build 选项的 Player 中运行时定义。

此定义仅反映版本时间是否已启用了开发版选项。要了解脚本是否以开发版模式运行,请使用 Debug.isDebugBuild。
DEVELOPMENT_BUILD
不足以确定当前是否以开发版运行,因为大多数平台允许在 Development 和非开发版之间更改而不重新构建 Project。但是,在某些平台上,Unity 不支持在 Editor 中的 Development 和非 Development 版本之间切换,并要求您在版本完成后进行切换。例如,在 Windows 上,可以选择 Create Visual Studio solution 选项,从而选择在 Visual Studio 中进行 Development 还是非开发版。在 Visual Studio 中切换不会重新编译脚本,因此不会重新评估脚本定义。也可以通过将游戏生成中的
UnityPlayer.dll
与用于调试实时游戏版本的开发版中的代码交换,从最终游戏生成切换到开发版。
UNITY_CLOUD_BUILD
使用 Unity Build Automation 构建项目时定义。
注意
在 C# 中预定义了
DEBUG
符号,在 Unity 中,使用指令
#if DEBUG
等同于
#if UNITY_EDITOR || DEVELOPMENT_BUILD

其他资源