Unity scripting symbol reference
A reference of the predefined scripting symbols Unity provides.
阅读时间4 分钟最后更新于 18 天前
Platform symbols
Unity automatically defines certain symbols based on the authoring and build target platform. These are as follows:
Define | Function |
|---|---|
| Scripting symbol to call Unity Editor scripts from your game code. |
| Scripting symbol for Editor code on Windows. |
| Scripting symbol for Editor code in macOS. |
| Scripting symbol for Editor code on Linux. |
| Scripting symbol for embedded Linux. |
| Scripting symbol for QNX. |
| Scripting symbol to compile or execute code specifically for macOS (including Universal, PPC and Intel architectures). |
| Scripting symbol for compiling/executing code specifically for Windows standalone applications. |
| Scripting symbol for compiling/executing code specifically for Linux standalone applications. |
| Scripting symbol for compiling/executing code for any standalone platform (Mac OS X, Windows or Linux). |
| Scripting symbol for compiling/executing code for a dedicated server (macOS, Windows or Linux). |
| Scripting symbol for compiling/executing code for the iOS platform. |
| Scripting symbol for the Android platform. |
| Scripting symbol for the Apple TV platform. |
| Scripting symbol for the VisionOS platform. |
| Scripting symbol for Universal Windows Platform. |
| Scripting symbol for Universal Windows Platform. |
| Scripting symbol for Web. |
| Scripting symbol for calling Unity Analytics methods from your game code. |
| Scripting symbol for assertions control process. |
| Scripting symbol for enabling safety checks. |
| Scripting symbol for enabling instrumentation code paths, such as the profiler. |
Unity Editor version symbols
Unity automatically defines certain scripting symbols based on the version of the Unity Editor that you're currently using.
Given a version number (for example, 6000.0.33), Unity exposes three global scripting symbols in the following formats: , and .
X.Y.ZUNITY_XUNITY_X_YUNITY_X_Y_ZHere is an example of scripting symbols exposed in Unity 6000.0.33:
Define | Function |
|---|---|
| Scripting symbol for the release version of Unity 6, exposed in every 6000.Y.Z release. |
| Scripting symbol for the major version of Unity 6.0, exposed in every 6000.0.Z release. |
| Scripting symbol for the minor version of Unity 6000.0.33. |
You can also compile code selectively based on the earliest version of Unity required to compile or execute a section of code snippet. Following the same version format describd previously (), Unity exposes one global in the format (for example, ), that you can use for this purpose.
X.Y#defineUNITY_X_Y_OR_NEWERUNITY_6000_0_OR_NEWEROther symbols
The other symbols Unity defines are:
Define | Function |
|---|---|
| Defined when building scripts with support for C# 7.3 or newer. |
| Scripting back end #define for IL2CPP. |
| Defined when the target build platform supports VR. Doesn't imply that VR is currently enabled or that the necessary plug-ins and packages needed to support VR are installed. |
| Defined when building scripts against .NET Standard 2.1 API compatibility level. |
| Defined when building scripts against .NET Standard 2.1 API compatibility level. |
| Defined when building scripts against .NET Standard 2.1 API compatibility level. |
| Defined when building scripts against .NET Standard 2.1 API compatibility level. |
| Defined when Windows Runtime support is enabled on IL2CPP. For more information, refer to WinRT API in C# scripts for UWP. |
| Defined when the Input System package is enabled in Player Settings. |
| Defined when the legacy Input Manager is enabled in Player Settings. |
| Defined when the project is built with Unity Build Automation. |
注意
The symbol is predefined in C#. Unity defines it for Editor code and for builds that use the Debug managed code variant or have Script Debugging enabled.
DEBUG