Unity 사용자 매뉴얼: 커스텀 검색 공급자 만들기

개요

이 문서는 Unity에서 커스텀 검색 공급자를 만드는 방법에 대해 설명합니다. 검색 공급자는 특정 행동을 등록할 수 있으며, 이를 통해 사용자가 검색 결과에 대해 다양한 작업을 수행할 수 있습니다.

행동 핸들러 등록

행동 핸들러를 등록하려면 SearchActionsProvider 속성을 사용하여 함수를 만들고, 이 함수가 IEnumerable<SearchAction>을 반환하도록 합니다. 다음은 에셋 검색 공급자의 행동을 등록하는 예시입니다.

예제 코드

[SearchActionsProvider]
internal static IEnumerable<SearchAction> ActionHandlers()
{
    return new[]
    {
        new SearchAction("asset", "select", Icons.@goto, "Select asset...")
        {
            handler = (item, context) =>
            {
                var asset = AssetDatabase.LoadAssetAtPath<Object>(item.id);
                if (asset != null)
                {
                    Selection.activeObject = asset;
                    EditorGUIUtility.PingObject(asset);
                    EditorWindow.FocusWindowIfItsOpen(
                        Utils.GetProjectBrowserWindowType());
                }
            }
        },
        new SearchAction("asset", "open", SearchIcon.open, "Open asset... (Alt+Enter)")
        {
            handler = (item, context) =>
            {
                var asset = AssetDatabase.LoadAssetAtPath<Object>(item.id);
                if (asset != null)
                    AssetDatabase.OpenAsset(asset);
            }
        },
        new SearchAction("asset", "reveal", SearchIcon.folder, "Show in Explorer")
        {
            handler = (item, context) =>
            {
                EditorUtility.RevealInFinder(item.id);
            }
        }
    };
}

SearchAction 클래스

SearchAction 클래스는 행동을 설명하고 특정 SearchItem에 대해 행동을 실행하기 위한 핸들러를 제공합니다.

• providerType: 행동을 등록할 공급자의 고유 ID입니다.

행동 핸들러 설정

ActionHandler의 서명은 다음과 같습니다.

public delegate void ActionHandler(SearchItem item, SearchContext context);

isEnabled 술어를 사용하여 특정 아이템에 대해 행동할 수 있는지 여부를 결정할 수 있습니다.

컨텍스트 검색 행동

검색 결과에서 특정 타입의 아이템에 대한 컨텍스트(오른쪽 클릭) 행동을 제공하려면 context라는 검색 공급자의 행동을 등록해야 합니다. 다음은 에셋 검색 공급자의 예제입니다.

예제 코드

new SearchAction(type, "context", null, "Context")
{
    handler = (item, context) =>
    {
        var asset = AssetDatabase.LoadAssetAtPath<Object>(item.id);
        if (asset != null)
        {
            Selection.activeObject = asset;
            EditorUtility.DisplayPopupMenu(
                QuickSearchTool.ContextualActionPosition,
                "Assets/", null);
        }
    }
}

결론

이 문서는 Unity에서 커스텀 검색 공급자를 만드는 방법과 검색 행동을 등록하는 방법에 대해 설명하였습니다. 이를 통해 여러분은 Unity Editor의 검색 기능을 더욱 확장하고, 다양한 경험을 사용자에게 제공할 수 있습니다.