Что такое isStatic?

Что такое isStatic в Unity?

В контексте разработки в Unity, isStatic — это флаг (boolean свойство) GameObject в редакторе Unity, а также соответствующее свойство в API класса GameObject. Этот флаг определяет, будет ли объект считаться статическим во время различных оптимизационных процессов Unity, таких как компиляция освещения (lightmapping), определение статической коллизии (static collision) и работа системы навигации (navigation baking).

Основное назначение и ключевые сферы влияния

Когда вы устанавливаете флаг isStatic на GameObject, вы сообщаете Unity, что этот объект не будет двигаться, трансформироваться или изменяться во время выполнения игры. Это позволяет Unity выполнить предварительную обработку (препроцессинг или "запекание") данных для этого объекта, что значительно повышает производительность на этапе выполнения. Основные системы, которые используют эту информацию:

• Статическое освещение (Static Lighting / Lightmapping): Unity предварительно вычисляет и "запекает" освещение на поверхности статических объектов, создавая текстуры световых карт (lightmaps). Это позволяет использовать сложное, высококачественное освещение без затратных вычислений в реальном времени.
• Статическая коллизия (Static Colliders): Физический движок Unity может оптимизировать обработку коллизий для статических объектов, так как их положение неизменно. Статические коллидеры обычно объединяются в более крупные, оптимизированные структуры (например, статическое дерево коллизий), что снижает нагрузку на физический движок при проверке столкновений с динамическими объектами.
• Навигационная система (Navigation / Pathfinding): При построении навигационной сетки (NavMesh) учитываются только статические объекты. Агенты AI будут использовать эту предварительно вычисленную сетку для поиска пути, игнорируя динамические объекты как препятствия (если не используются динамические препятствия).
• Окклюзия (Occlusion Culling): Статические объекты могут быть учтены при предварительном вычислении данных для системы удаления невидимых объектов, что повышает эффективность рендеринга.

Как использовать isStatic

В редакторе Unity флаг находится в инспекторе GameObject, в верхней части, рядом с именем объекта.

В коде вы можете управлять этим свойством через API:

// Получение ссылки на GameObject
GameObject myObject = GameObject.Find("MyWall");

// Проверка, является ли объект статическим
bool isCurrentlyStatic = myObject.isStatic;

// Установка объекта как статического
myObject.isStatic = true;

// Снятие статического флага
myObject.isStatic = false;

Ключевые принципы и ограничения использования

• Необратимость в рантайме: Данные для статических систем (световые карты, NavMesh) вычисляются до запуска игры (в редакторе). Если вы измените isStatic или трансформируете (переместите, масштабируете) статический объект во время выполнения игры, предварительно вычисленные данные станут неверными. Это не приведет к автоматическому обновлению световых карт или NavMesh и может вызвать визуальные или логические ошибки.
• Не подходит для динамических объектов: Объекты, которые должны двигаться, вращаться, появляться/исчезать или любым образом трансформироваться в реальном времени, не должны быть помечены как isStatic.
• Влияние на дочерние объекты: Установка флага isStatic на родительский GameObject не автоматически применяется к его дочерним объектам. Каждый дочерний объект имеет свой независимый флаг. Однако при препроцессинге (например, для lightmapping) трансформация дочерних объектов учитывается относительно родителя.

Пример практического использования в коде

Предположим, мы создаем уровень и хотим обеспечить, что все объекты окружающей среды (стены, земля) отмечены как статические для оптимизации, а движущиеся элементы (персонаж, враги) — как динамические.

using UnityEngine;

public class LevelSetup : MonoBehaviour
{
    void Start()
    {
        // Найти все объекты с тегом "Environment" и сделать их статическими
        GameObject[] environmentObjects = GameObject.FindGameObjectsWithTag("Environment");
        foreach (GameObject envObject in environmentObjects)
        {
            envObject.isStatic = true;
        }

        // Объекты с тегом "Dynamic" должны оставаться нестатическими
        GameObject[] dynamicObjects = GameObject.FindGameObjectsWithTag("Dynamic");
        foreach (GameObject dynObject in dynamicObjects)
        {
            dynObject.isStatic = false;
        }

        // Логирование результатов
        Debug.Log($"Статические объекты (Environment): {environmentObjects.Length}");
        Debug.Log($"Динамические объекты (Dynamic): {dynamicObjects.Length}");
    }
}

Итог

isStatic — это мощный инструмент оптимизации в Unity, который позволяет значительно повысить производительность игры за счет предварительного вычисления данных для ключевых систем (рендеринг, физика, AI). Однако его использование требует четкого понимания: статический объект — это объект, который гарантированно не изменит своего положения, вращения или масштаба во время выполнения игры. Правильное применение этого флага на этапе разработки уровня является важной частью процесса оптимизации проекта.