Поисковые выражения
Выражения поиска позволяют добавлять в язык поисковых запросов сложные запросы, которые ссылаются на несколько поставщиков, например, для поиска всех объектов в сценеСцена содержит окружение и меню вашей игры. Думайте о каждом уникальном файле сцены как об уникальном уровне. В каждой сцене вы размещаете свое окружение, препятствия и декорации, по сути проектируя и создавая свою игру по частям. Подробнее
См. в Словарь, где используется shaderПрограмма, работающая на графическом процессоре. Подробнее
См. Словарь, который не компилируется.
Выражения поиска можно объединять в цепочки для преобразования элементов поиска или выполнения над ними манипуляций.
Как использовать поисковые выражения
Введите поисковое выражение в окне Поиск, чтобы получить результат:
Создайте выражение для поиска
Выражение поиска начинается с корневого выражения, которое может содержать внутренние выражения.
Простой запрос, такой как t:shader, является выражением. Он возвращает все элементы поиска, соответствующие шейдерам в вашем проекте.
Используйте язык поисковых выражений, чтобы объединить несколько запросов в одно выражение, чтобы создать более гибкий поиск.
Выражения поиска поддерживают следующее:
- запрос:
t:shader - запрос с вложенным выражением:
t:prefab ref={t:texture} - функция:
count{t:shader} - литерал:
3или"это строковый литерал" - селектор свойств:
@path или @mesh(любой идентификатор, начинающийся с@, считается селектором, извлекающим значение из элемента поиска. Селекторы могут находить свойства объекта или использоваться для динамического вычисления результатов)
Все выражения поиска возвращают набор элементов поиска (IEnumerable). Как правило, язык поисковых выражений использует фигурные скобки {} для обозначения набора элементов. Даже буквенные выражения, такие как 3, оцениваются внутри как набор: {3}.
Выражения поиска можно объединять в цепочки для создания более сложных запросов:
t:prefab ref={t:texture}- Часть запроса
t:textureнаходит все текстуры в вашем проекте - Часть запроса
t:prefab ref=выполняет запрос для каждой текстуры, возвращенной в наборе t:texture, чтобы узнать, какая < b>префабыТип ассета, который позволяет хранить GameObject вместе с компонентами и свойствами. Префаб действует как шаблон, из которого вы можете создавать новые экземпляры объектов в сцене. Подробнее
См. в Словарь ссылку на эту текстуру.
- Часть запроса
t:prefab ref={t:texture size>4000}: находит все префабы в проекте с размером текстуры более 4000 байт.
Это эквивалентно:
Запустите
t:texture size>4000, чтобы получить список всех текстур 4K в проекте (например,armor. png,сокровище.png).Выполняется
t:prefab ref=<одна из текстур 4K>(например,t:prefab ref=armor. png, а затемt:prefab ref=treasure.png).Объединение всех результатов и возврат их в виде единого списка элементов поиска.
t:[shader, material, texture]: находит все объекты, типы которых являютсяshader,материалилитекстура. Используя обычный запрос, это можно было бы выразить так:t:shader или t:material или t:texture
Функции
В Unity есть библиотека функций поисковых выражений для управления и преобразования наборов элементов поиска. Каждая из этих функций может принимать несколько аргументов и возвращать набор элементов. Выражения поиска Unity используют фигурные скобки для обозначения вызовов функций.
Полный список всех функций находится здесь.
Пример: функция count подсчитывает элементы каждого набора, переданного в качестве параметров, и возвращает число.
count{t:shader}: возвращает набор, содержащий количество шейдеров в проекте. Пример:{34}.count{t:shader, t:texture}: возвращает набор, содержащий количество шейдеров и текстур в проекте. Пример:{34, 2048}.
Функции могут быть объединены в цепочку, подобно s-expression (откроется другой сайт), используемому в LISP (откроется другой сайт) язык программирования.
Примечание. Может быть только одно корневое выражение.
Пример цепочки оцениваемых функций в порядке их выполнения:
print{"path=@path", first{10, sort{t:texture, @size}}}: напечатать путь к 10 самым большим текстурам в проекте
t:texture: находит все текстуры в проекте, а затем выбирает свойство размера.sort{ t:texture, @size}: сортирует все эти текстуры в соответствии с их свойством размера.first{10: выбирает первые 10 отсортированных текстур.print{ "path=@path": печатает этот список в консоли в соответствии со строкой формата, где Unity Search извлекает свойство пути каждого результирующего элементаpath=@path.
Функции могут иметь несколько сигнатур (имя метода, тип и вид (значение, ссылка или вывод) каждого из его формальных параметров, аналогично C#) и могут поддерживать необязательные (параметры которые не нужно передавать в функцию) и переменные (откроется другой сайт) (параметры, которые могут принимать переменное количество аргументов) параметры.
Литералы в поисковых выражениях
Литералы — это фактические слова или числа, которые вы хотите найти, или числовые значения, которые вы хотите получить, а не строка запроса. Например, t:texture ищет ассеты с текстурой в имени типа (например, Texture2D), но добавляя кавычки, чтобы сделать его буквальным, «t:texture» ищет ассет с именем t:texture.
| Выражение | Описание |
|---|---|
| Number | Aбуквальное число (1,2,3 и т. д.) |
| Set | Квадратные скобки ([ ]) |
| String | Одинарные или двойные кавычки ('' или "") |
Число
Числовые литералы можно использовать в качестве параметров функций (например, first).
first{10, t:shader} -> {первые 10 шейдеров возвращаются по запросу 't:shader'}
Set
Выражайте набор значений с помощью квадратных скобок []. Набор может содержать выражение любого типа, но синтаксический анализатор поискового выражения будет считать, что элементы набора являются литералами, а не поисковым запросом.
Пример:
[t:shader, hello, 3] -> ["t:shader", "hello", 3]
При использовании фигурных скобок ({}) синтаксический анализатор обработает это как три запроса:
{t:shader, hello, 3} -> {<запустить запрос для t:shader>, <запустить запрос для hello>, <запустить запрос для 3>
Строка
Строковые литералы можно использовать в качестве параметров для некоторых функций (например, format). Вы можете указать строковый литерал, используя одинарные или двойные кавычки:
"привет" или "привет"
Функция формата, принимающая строку формата в качестве параметра:
format{t:texture, '@path (@size)'}
Селекторы свойств и значения элементов поиска
Селектор — это идентификатор, обозначаемый префиксом @. Используйте селекторы для доступа к свойству элемента для вычисления, фильтрации или форматирования. Селекторы могут сопоставляться с сериализованными свойствами UnityEngine.Object или с настраиваемой функцией для предоставления доступа к динамическим данным.
Базовые селекторы, которые поддерживаются любыми элементами поиска:
id: уникальный идентификатор этого элемента в соответствии с его поисковой системой.value: внутреннее значение элемента. По умолчанию это его идентификатор, но функции могут переопределять значение элемента.метка: метка элемента, как показано в окне Поиск .
descилиdescription: описание элемента (вторая строка окна Поиск) ли>
Unity также определяет общие селекторы для элемента поиска, например:
@name: UnityEngine.Object.name@size: размер файла на диске для ресурса@path: путь к ресурсу@extension: расширение файла объекта@provider: служба поиска, выдавшая этот элемент
Чтобы получить доступ к определенным свойствам элемента поиска для выполнения операции, используйте селекторы:
count{t={distinct{select{a:assets, @type}}}}a:assets, @typeнаходит все объекты с именемassets, а затем выбираеттипдля этих объектов.distinctвозвращает список всех существующих типов.t={list of types}возвращает несколько списков каждого ресурса каждого типа.countподсчитывает количество ресурсов каждого типа в вашем проекте.
-
среднее{@size,t:shader}t:shader, @size: находит все шейдеры, а затем выбирает свойство размера.avg: вычисляет средний размер для всех шейдеров в вашем проекте.
-
print{@value, count{t:texture, t:material}}
Селектор @# находит сериализованные свойства и свойства материалов:
sort{t:texture, @#height}: сортирует все текстуры в порядке сериализованных свойств их высоты.
Имя поисковых выражений (псевдоним)
Вы можете называть поисковые выражения, чтобы их было легче отображать в окне Поиск.
Например, ввод выражения sort{count{t:audio, t:texture}, @value,desc} в окне Поиск , может быть трудно прочитать, какой счетчик соответствует какому типу:
Использование псевдонима: sort{count{t:audio as Audio, t:texture as Texture}, desc} дает более читаемый результат:
Для динамического создания псевдонимов используйте функцию alias. Например:
псевдоним{[1, 2, 3], 'значение заголовка'}
отображает элементы с этими ярлыками:
{Заголовок 1, Заголовок 2, Заголовок 3}
Оператор раскрытия
Операция расширения ... позволяет сгруппировать набор элементов в несколько наборов элементов вместо одного набора.
...{расширяемое выражение} -> {sub expr 1} {sub expr 2} {sub expr N}
Пример:
Небольшой проект содержит 3 префаба, 4 текстуры и 5 шейдеров. Следующее выражение обеспечивает подсчет для всех:
count{t:[префаб, текстура, шейдер]} -> {12}
Результатом поискового выражения t:[префаб, текстура, шейдер] является унифицированный список из 12 элементов типа префабов, текстур и шейдеров. Это также может быть выражено как: t:prefab или t:texture или t:shader.
Используйте оператор развертывания, чтобы подсчитать количество объектов каждого типа отдельно:
count{...t:[prefab, texture, shaper]} -> count{t:prefab, t:texture, t:shader} -> {3, 4, 5}
Функция groupBy (откроется другой сайт) может использоваться с оператором расширения для возврата наборов элементов. сгруппированы по общему ключу.
Пример:
В проекте есть ресурсы трех типов (префабы, текстуры и шейдеры). Для селектора @type, который возвращает тип элемента поиска, выражение будет расширяться до:
count{t:prefab или t:texture или t:shader}
Вы можете использовать функцию groupBy, чтобы сгруппировать элементы по их типу, а затем подсчитать количество элементов каждого типа:
count{...groupBy{t:prefab или t:texture или t:shader, @type}}
Примеры поисковых выражений
Эти примеры демонстрируют, как можно использовать выражения поиска для сложных запросов в проекте.
Подсчитайте использование готовых элементов в сценах и отсортируйте по наибольшему использованию:
sort{select{p: t:prefab *.prefab, @path, count{t:scene ref:@path} as count}, @count, desc}-
Сортировка и подсчет всех типов объектов
sort{count{...groupby{a:assets, @type}}, @value, desc} Найдите сеткуосновной графический примитив Unity. Меши составляют большую часть ваших 3D-миров. Unity поддерживает триангулированные или четырехугольные полигональные сетки. Поверхности Nurbs, Nurms, Subdiv должны быть преобразованы в полигоны. Подробнее
Поиск в Словарь с наибольшим количеством вершин (при условии, что селектор @vertices доступен в проект).first{sort{t:mesh, @vertices, desc}}-
Сортировка всех мешей по количеству вершин
sort{select{h: t:mesh, @path, @vertices}, @vertices, desc} -
Подсчитать количество вершин для всех сеток
sum{select{h:t:mesh, @vertices}} Найти все ресурсы, ссылающиеся на сетку
ref=select{p:t:mesh, @path}Показать количество ссылок на готовые сцены
выберите{p: *.prefab, @path, count{p: a:sceneIndex ref="@path"} в качестве счетчика}
Оценка выражений
Вычисление выражения поиска основано на шаблоне C# iterator (откроется другой сайт) и использует ключевого слова yield (откроется другой сайт). Это гарантирует, что оценка представляется как полностью асинхронная операция и не блокируется, насколько это возможно. Это позволяет каждому поисковому выражению начать вычисление до того, как начальные наборы элементов поиска будут полностью вычислены.
По умолчанию все вычисления поискового выражения выполняются в рабочем потоке, чтобы не блокировать редактор. Для операций, которые должны полагаться на API-интерфейс Unity без многопоточности (например, некоторые средства доступа к селекторам), у нас есть служебный API-интерфейс для постановки этих операций в очередь в основном потоке и поддержания шаблона выдачи элементов поиска.< /p>
Язык поискового выражения был разработан таким образом, чтобы его можно было настраивать. API для настройки всех частей платформы будут доступны в будущем выпуске.
Обновлено 17 ноября 2026 г.