ドキュメント

Unity Engine

Unity Engine

Cリフレクションのオーバーヘッドを回避

ランタイムに Cリフレクションを使用しないことで、ガベージコレクターのオーバーヘッドを削減します。
読み終わるまでの所要時間 6 分最終更新 5日前

MonoとIL2CPPの両方のスクリプト バックエンドは、すべてのC#
System.Reflection
オブジェクトを内部的にキャッシュし、Unityはそれらをガベージ コレクションしません。つまり、ガベージコレクターは、アプリケーションの生存期間期間中にキャッシュされた Cリフレクションオブジェクトを継続的にスキャンし、ガベージコレクターの不必要で潜在的なオーバーヘッドを発生させます。
ガベージコレクターのオーバーヘッドを最小化するには、
Assembly.GetTypes
や
Type.GetMethods
など、ランタイムに多くの C# リフレクションオブジェクトを作成するメソッドの使用を避けます。代わりに、Unity エディターでアセンブリをスキャンして必要なデータをシリアライズするか、コード生成を使用してデータをランタイムで使用可能にしてください。

エディターでアセンブリをスキャン

以下の例は、エディターでアセンブリをスキャンし、データをシリアライズし、リフレクションなしでランタイムに使用する方法を示しています。
IMyFeature
というインターフェースを実装するすべての型を検索し、ランタイムにその情報を使用するとします。次のように、
IMyFeature
を実装するすべての型をスキャンし、その名前を
ScriptableObject
または JSON ファイルに保存するエディタースクリプトを作成できます。
using UnityEngine;using UnityEditor;using System;using System.Linq;using System.Reflection;using System.Collections.Generic;[CreateAssetMenu(menuName = "Feature/FeatureTypeList")]public class FeatureTypeList :ScriptableObject{ public List<string> typeNames;}public static class FeatureTypeScanner{ [メニュー項目("Tools/Scan IMyFeature Types")] public static void ScanTypes() { var featureType = typeof(IMyFeature); var types = AppDomain.CurrentDomain.GetAssemblies() .SelectMany(a => a.GetTypes()) .Where(t => featureType.IsAssignableFrom(t) && !t.IsInterface && !t.IsAbstract) .Select(t => t.FullName) .ToList(); // Create/overwrite the asset var asset = ScriptableObject.CreateInstance<FeatureTypeList>(); asset.typeNames = types; AssetDatabase.CreateAsset(asset, "Assets/FeatureTypeList.asset"); AssetDatabase.SaveAssets(); デバッグ.Log($"IMyFeatureを実装する{types.Count}タイプが見つかりました。"FeatureTypeList.アセットに保存"); }}
メニューから Tools> Scan IMyFeature Types を実行します。これにより、型名のリストを含む
Assets/FeatureTypeList.asset
が作成されます。
ランタイムに、このアセットをロードし、型名を
Activator.CreateInstance
経由でインスタンス化したり、ディスプレイのみに使用することができます。次のように、codegen を使用する場合はリフレクションは必要ありません。
public class FeatureTypeLoader : MonoBehaviour{ public FeatureTypeList featureTypes; void Start() { var assemblyName = this.GetType().Assembly.FullName; Foreach (featureTypes.typeNames の var typeName) { Debug.Log("Instantiating feature type: " + typeName); Activator.CreateInstance(assemblyName, typeName); // You can also use Type.GetType(typeName) (both of these still uses reflection but only on the pre-selected feature types instead of casting a wider net across all sort of types in the assembly.) } }}

コード生成の使用

型名を格納する代わりに、型またはデリゲートの静的配列を含む C# ファイルをエディター時に生成して、ランタイムリフレクションをすべて排除できます。以下のコード例では、検出された型の静的配列を持つファイル
Assets/GeneratedFeatureTypes.cs
を生成します。このファイルは、リフレクションなしでランタイムに使用できます。
using UnityEditor;using System;using System.Linq;using System.Text;using System.IO;public static class FeatureTypeCodeGen{ [MenuItem("Tools/CodeGen IMyFeature Types")] public static void CodeGenTypes() { var featureType = typeof(IMyFeature); var types = AppDomain.CurrentDomain.GetAssemblies() .SelectMany(a => a.GetTypes()) .Where(t => featureType.IsAssignableFrom(t) && !t.IsInterface && !t.IsAbstract) .ToList(); StringBuilder sb = new StringBuilder(); sb.AppendLine("public static class GeneratedFeatureTypes {"); sb.AppendLine(" public static readonly System.Type[] Types = new System.Type[] {"); foreach (型の変数 t) { sb.AppendLine($" typeof({t.FullName}),"); } sb.AppendLine(" };"); sb.AppendLine("}"); File.WriteAllText("Assets/GeneratedFeatureTypes.cs", sb.ToString()); AssetDatabase.Refresh(); Debug.Log("Generated FeatureTypes.cs with " + types.Count + " types."); }}

追加リソース