ドキュメント

Unity Engine

Unity Engine

Unity スクリプトシンボルリファレンス

Unity が提供する定義済みスクリプトシンボルのリファレンス。
読み終わるまでの所要時間 13 分最終更新 5日前

プラットフォームシンボル

Unity は、オーサリングとビルドのターゲットプラットプラットフォームに基づいて、特定のシンボルを自動的に定義します。これらは以下のとおりです。

定義

function

UNITY_EDITOR
ゲームコードから Unity エディタースクリプトをコールためのスクリプトシンボル
UNITY_EDITOR_WIN
Windows エディターコードのスクリプトシンボル
UNITY_EDITOR_OSX
macOS のエディターコードのスクリプトシンボル
UNITY_EDITOR_LINUX
Linux エディターコードのスクリプトシンボル
UNITY_EMBEDDED_LINUX
埋め込まれた Linux のスクリプトシンボル。
UNITY_QNX
QNX のスクリプトシンボル。
UNITY_STANDALONE_OSX
macOS(Universal、PPC、Intel アーキテクチャを含む)専用のコードをコンパイルまたは実行するためのスクリプトシンボル。
UNITY_STANDALONE_WIN
Windows スタンドアロンプリケーション専用のコードをコンパイル/実行するためのスクリプトシンボル
UNITY_STANDALONE_LINUX
Linux スタンドアロンプリケーション専用のコードをコンパイル/実行するためのスクリプトシンボル
UNITY_STANDALONE
スタンドアロンアロンプラットプラットフォーム (Mac OS X、Windows、Linux) のコードをコンパイル/実行するためのスクリプトシンボル
UNITY_SERVER
Dedicated Server(macOS、Windows、Linux)のコードをコンパイル/実行するためのスクリプトシンボル。
UNITY_IOS
iOS プラットフォームのコードをコンパイル/実行するためのスクリプトシンボル。
UNITY_ANDROID
Android プラットフォームのスクリプトシンボル。
UNITY_TVOS
Apple TV プラットフォームのスクリプトシンボル。
UNITY_VISIONOS
VisionOS プラットフォームのスクリプトシンボル。
UNITY_WSA
ユニバーサル Windows プラットフォーム (UWP) のスクリプトシンボル。
UNITY_WSA_10_0
ユニバーサル Windows プラットフォーム (UWP) のスクリプトシンボル。
UNITY_WEBGL
ウェブのスクリプトシンボル。
UNITY_ANALYTICS
ゲームコードから Unity Analytics メソッドを呼び出すためのスクリプトシンボル。
UNITY_ASSERTIONS
アサーションコントロールプロセスのスクリプトシンボル。
UNITY_64
64 ビットプラットフォームのスクリプトシンボル。実際には、これはすべての 64 ビットアーキテクチャで動作するわけではなく、プラットフォーム上の異なる CPU アーキテクチャが同じコンパイル済みアセンブリを共有できるため、使用すべきではありません。アーキテクチャに基づいてコードを条件付きで実行するには、IntPtr.Size をチェックする標準の
if
ステートメントを使用します。IntPtr.Size は、32 ビットプロセスの
4
と 64 ビットプロセスの
8
です。例については、 ディレクティブの代替方法 を参照してください。

Unity エディターバージョンシンボル

Unity は、現在使用している Unity エディターのバージョンに基づいて、特定のスクリプトシンボルを自動的に定義します。
バージョン番号の
X.Y.Z
(例えば、6000.0.33)がある場合、Unity は以下の形式で 3 つのグローバル スクリプト シンボルを公開します。
UNITY_X
、
UNITY_X_Y
、
UNITY_X_Y_Z
。
Unity 6000.0.33 で公開されたスクリプト シンボルの例を次に示します。

定義

function

UNITY_6000
Unity 6 のリリースバージョンのスクリプトシンボル。6000.Y.Z リリースごとに公開されたされています。
UNITY_6000_0
6000.0.Z リリースごとに公開された Unity 6.0 のメジャー バージョンのスクリプトシンボル。
UNITY_6000_0_33
Unity のマイナーバージョン 6000.0.33 のスクリプトシンボル。
コードスニペットのセクションをコンパイルまたは実行するために必要な最も古いバージョンの Unity に基づいて、コードを選択的にコンパイルすることもできます。前に説明したのと同じバージョン形式 (
X.Y
) に従って、Unity は形式
UNITY_X_Y_OR_NEWER
(例えば
UNITY_6000_0_OR_NEWER
) で 1 つのグローバル
#define
を公開し、この目的に使用できます。

その他のシンボル

Unity が定義するその他のシンボルは以下のとおりです。

定義

function

CSHARP_7_3_OR_NEWER
C# 7.3 以降をサポートするスクリプトをビルドするときに定義されます。
ENABLE_MONO
Mono のスクリプティングバック終了 #define
ENABLE_IL2CPP
IL2CPP のスクリプティングバックエンド #define 終了。
ENABLE_VR
ターゲット ビルド プラットフォームがVRをサポートする場合に定義されます。VRが現在有効になっている、またはVRのサポートに必要なプラグインとパッケージがインストールされていることを意味するものではありません。
NET_2_0
Mono および IL2CPP の .NET 2.0 API 互換性レベルに対してスクリプトをビルドするときに定義されます。
NET_2_0_SUBSET
Mono および IL2CPP の .NET 2.0 Subset API 互換性レベルに対してスクリプトをビルドするときに定義されます。
NET_LEGACY
Mono および IL2CPP の .NET 2.0 または .NET 2.0 Subset API 互換性レベルに対してスクリプトをビルドするときに定義されます。
NET_4_6
Mono および IL2CPP の .NET 4.x API 互換性レベルに対してスクリプトをビルドするときに定義されます。
NET_STANDARD_2_0
Mono および IL2CPP の .NET Standard 2.0 API 互換性レベルに対してスクリプトをビルドするときに定義されます。
NET_STANDARD_2_1
Mono および IL2CPP の .NET Standard 2.1 API 互換性レベルに対してスクリプトをビルドするときに定義されます。
NET_STANDARD
Mono および IL2CPP の .NET Standard 2.1 API 互換性レベルに対してスクリプトをビルドするときに定義されます。
NETSTANDARD2_1
Mono および IL2CPP の .NET Standard 2.1 API 互換性レベルに対してスクリプトをビルドするときに定義されます。
NETSTANDARD
Mono および IL2CPP の .NET Standard 2.1 API 互換性レベルに対してスクリプトをビルドするときに定義されます。
ENABLE_WINMD_SUPPORT
IL2CPP で WIndows ランタイム サポートが有効になっている場合に定義されます。詳細は、「 WinRT API in C# scripts for UWP 」を参照してください。
ENABLE_INPUT_SYSTEM
プレイヤー設定で Input System パッケージが有効になっている場合に定義されます。
ENABLE_LEGACY_INPUT_MANAGER
プレイヤー設定で古い機能の入力マネージャが有効になっている場合に定義されます。
DEVELOPMENT_BUILD
開発ビルド オプションを有効にしてビルドされたプレイヤーでスクリプトを実行するときに定義されます。

この定義は、ビルド時に開発ビルド オプションが有効になっていたかどうかのみ反映されます。スクリプトが開発ビルドモードで実行されているかどうかを確認するには、 debug.isDebugBuild を使用します。ほとんどのプラットフォームでは、プロジェクトを再ビルドせずに開発ビルドと非開発ビルド間で変更できるため、現在開発ビルドで実行されているかどうかは
DEVELOPMENT_BUILD
で判断できません。ただし、一部のプラットフォームでは、Unity はエディターでの開発ビルドと開発以外のビルドの切り替えをサポートしておらず、ビルドの完了後に切り替える必要があります。例えば、Windows では、Create Visual Studio Solution オプションを選択して、Visual Studio で開発ビルドを行うか、非開発ビルドを行うかを選択できます。Visual Studio で切り替えてもスクリプトは再コンパイルされないため、スクリプト定義は再評価されません。ゲームビルド内の
UnityPlayer.dll
をライブゲームビルドのデバッグ用の開発ビルドのものと入れ替えて、最終ゲームビルドから開発ビルドに切り替えることもできます。
UNITY_CLOUD_BUILD
Unity Build Automation でプロジェクトをビルドするときに定義されます。
注
DEBUG
シンボルは C# で事前定義されており、Unity でディレクティブ
#if DEBUG
を使用することは
#if UNITY_EDITOR || DEVELOPMENT_BUILD
と同等です。

追加リソース