Unity 사용자 매뉴얼: 커스텀 검색 공급자 만들기
이 문서는 Unity의 커스텀 검색 공급자를 만드는 방법을 설명합니다. SearchProvider 클래스는 특정 유형의 아이템에 대한 검색을 실행하고 썸네일, 설명, 하위 필터를 관리하는 기본 API를 제공합니다.
SearchProvider 클래스
SearchProvider 클래스의 기본 구조는 아래와 같습니다.
public class SearchProvider
{
public SearchProvider(string id, string displayName = null);
public SearchItem CreateItem(string id, string label = null, string description = null, Texture2D thumbnail = null);
public static bool MatchSearchGroups(string searchContext, string content);
public static bool MatchSearchGroups(string searchContext, string content, out int startIndex, out int endIndex);
public NameId name;
public string filterId;
public bool isExplicitProvider;
public FetchStringHandler fetchLabel;
public FetchStringHandler fetchDescription;
public PreviewHandler fetchThumbnail;
public StartDragHandler startDrag;
public TrackSelectionHandler trackSelection;
public GetItemsHandler fetchItems;
public GetKeywordsHandler fetchKeywords;
public List<NameId> subCategories;
public Action onEnable;
public Action onDisable;
public int priority;
public IsEnabledForContextualSearch isEnabledForContextualSearch;
}
주요 속성 및 메서드 설명
| 속성/메서드 | 설명 |
|---|---|
name |
공급자의 고유 ID |
filterId |
공급자를 필터링하는 텍스트 토큰 |
isExplicitProvider |
명시적으로 사용되는 공급자인지 여부 |
fetchLabel |
아이템 레이블을 가져오는 핸들러 |
fetchDescription |
아이템 설명을 비동기로 제공하는 핸들러 |
fetchThumbnail |
아이템 썸네일을 비동기로 제공하는 핸들러 |
startDrag |
드래그 상호작용을 지원하는 핸들러 |
trackSelection |
선택 변경 시 호출되는 핸들러 |
fetchItems |
검색 컨텍스트를 위한 아이템을 가져오는 필수 핸들러 |
fetchKeywords |
사용자가 검색 쿼리를 완성하는 데 도움이 되는 단어 목록을 제공 |
subCategories |
FilterWindow에 표시되는 하위 필터 목록 |
onEnable |
검색 창이 열릴 때 호출되는 액션 |
onDisable |
검색 창이 닫힐 때 호출되는 액션 |
priority |
공급자를 정렬하는 정수 값 |
isEnabledForContextualSearch |
컨텍스트 검색에 대한 활성화 여부를 결정하는 핸들러 |
리소스 캐시와 릴리스
onEnable: 검색 창을 열면 리소스를 캐시하는 데 사용됩니다.onDisable: 검색 창을 닫으면 리소스를 릴리스하는 데 사용됩니다.
초기화
검색 아이템 리스트는 가상 스크롤 알고리즘을 사용하여 제공됩니다. 일부 SearchItem 필드(예: label, thumbnail, description)는 요청 시에 페치됩니다. 아이템이 생성된 후 해당 필드를 채우려면 SearchProvider를 특정 핸들러(fetchLabel, fetchDescription, fetchThumbnail)로 초기화해야 합니다.
아이템 선택 트래킹
trackSelection에 콜백을 등록하면 마우스나 키보드를 사용하여 검색 결과에서 아이템을 선택할 때마다 검색을 수행할 수 있습니다. 예를 들어, 에셋과 씬 공급자는 이 콜백을 사용하여 선택한 아이템 정보를 주고받습니다.
드래그 앤 드롭 활성화
일부 검색 공급자는 씬으로 끌어다 놓을 수 있는 아이템을 반환합니다. 아이템이 드래그 앤 드롭을 지원하는 커스텀 공급자를 생성하는 경우, startDrag를 구현해야 합니다.
컨텍스트 검색
Alt + Shift + C 단축키를 사용하여 검색 창을 열면 컨텍스트 검색이 시작됩니다. isEnabledForContextualSearch를 오버라이드하면 특정 검색 컨텍스트에 대해 공급자를 활성화할 수 있습니다.
isEnabledForContextualSearch = () =>
||
|---|
QuickSearchTool.IsFocusedWindowTypeName("SceneHierarchyWindow");
결론
이 문서는 Unity에서 커스텀 검색 공급자를 만드는 기본적인 방법을 설명했습니다. 위의 예제를 바탕으로 필요에 맞게 커스터마이징할 수 있습니다. Unity의 검색 공급자 기능을 활용하여 사용자에게 더욱 편리한 검색 경험을 제공해보세요.