NavigationAgent3D

public bool AvoidanceEnabled { get; set; }

Если true, агент регистрируется для обратного вызова избегания RVO на NavigationServer3D. Когда NavigationAgent3D.Velocity задано и обработка завершена, safe_velocity Vector3 принимается с сигнальным соединением на NavigationAgent3D.VelocityComputed. Обработка избегания со многими зарегистрированными агентами имеет значительные затраты производительности и должна быть включена только для агентов, которым это в данный момент требуется.

public uint AvoidanceLayers { get; set; }

Ударное поле, определяющее уровни избегания для этого навигационного агента. NavigationAgent3D.AvoidanceMask избегает этого агента.

public uint AvoidanceMask { get; set; }

Ударное поле, определяющее, какие другие агенты избегают и препятствия этот Навигационный Агент избежит, когда немного совпадет, по крайней мере, один из их NavigationAgent3D.AvoidanceLayers.

public float AvoidancePriority { get; set; }

Агент не корректирует скорость для других агентов, которые соответствуют NavigationAgent3D.AvoidanceMask, но имеют более низкий NavigationAgent3D.AvoidancePriority. Это, в свою очередь, заставляет других агентов с более низким приоритетом корректировать свои скорости еще больше, чтобы избежать столкновения с этим агентом.

public bool DebugEnabled { get; set; }

Если true, отображаются визуальные отладочные данные для этого агента.

public Color DebugPathCustomColor { get; set; }

Если NavigationAgent3D.DebugUseCustom равен true, то этот цвет используется для этого агента вместо глобального цвета.

public float DebugPathCustomPointSize { get; set; }

Если NavigationAgent3D.DebugUseCustom равен true, то для рендеринга точек пути этого агента, вместо глобального размера точки, используется этот растеризованный размер точки.

public bool DebugUseCustom { get; set; }

Если true, то вместо глобального цвета используется определенный NavigationAgent3D.DebugPathCustomColor для этого агента.

public float Height { get; set; }

Высота агента избегания. Агенты будут игнорировать других агентов или препятствия, которые находятся выше или ниже их текущего положения + высота в 2D-избегании. Ничего не делает в 3D-избегании, которое использует только радиусные сферы.

public bool KeepYVelocity { get; set; }

Если true, и агент использует 2D-избегание, он запомнит заданную скорость оси Y и повторно применит ее после шага избегания. В то время как 2D-избегание не имеет оси Y и моделирует на плоской плоскости, эта настройка может помочь смягчить наиболее очевидное отсечение на неровной 3D-геометрии.

public int MaxNeighbors { get; set; }

Максимальное количество соседей, которых может учитывать агент.

public float MaxSpeed { get; set; }

Максимальная скорость, с которой может двигаться агент.

public uint NavigationLayers { get; set; }

Битовое поле, определяющее, какие навигационные слои навигационных регионов этот агент будет использовать для расчета пути. Изменение его во время выполнения очистит текущий навигационный путь и сгенерирует новый, в соответствии с новыми навигационными слоями.

public float NeighborDistance { get; set; }

Расстояние для поиска других агентов.

public float PathDesiredDistance { get; set; }

Допуск подхода родителя к следующей точке. Согласуйте масштаб, скорость и высоту начала координат тела с поверхностью пути; слишком малое значение может мешать продвижению по точкам.

public float PathHeightOffset { get; set; }

Смещение, вычитаемое по Y из точек, возвращаемых GetNextPathPosition и GetFinalPosition. В проверке значение 1 уменьшило высоту конечной точки на 1. Не меняет физический коллайдер и не перезапекает меш.

public float PathMaxDistance { get; set; }

Максимальное расстояние, на которое агент может отойти от идеального пути до конечной позиции. Это может произойти из-за попыток избежать столкновений. При превышении максимального расстояния он пересчитывает идеальный путь.

public NavigationPathQueryParameters3D.PathMetadataFlags PathMetadataFlags { get; set; }

Дополнительная информация для возврата по пути навигации.

public NavigationPathQueryParameters3D.PathPostProcessing PathPostprocessing { get; set; }

Постобработка пути, примененная к необработанному коридору пути, найденному NavigationAgent3D.PathfindingAlgorithm.

public float PathReturnMaxLength { get; set; }

Максимально допустимая длина возвращаемого пути в мировых единицах. При превышении этой длины путь будет обрезан.

public float PathReturnMaxRadius { get; set; }

Максимально допустимый радиус возвращаемого пути от начала пути в мировых единицах. При превышении этого радиуса путь будет обрезан. По сравнению с NavigationAgent3D.PathReturnMaxLength, это позволяет агенту пройти значительно больше, если ему потребуется обойти угол. Примечание: При этом будет выполнено обрезание сферы с учётом только фактических точек пути навигационной сетки, при этом первая точка пути будет находиться в центре сферы.

public float PathSearchMaxDistance { get; set; }

Максимальное расстояние, на которое может отдалиться искомый полигон от начального полигона, прежде чем поиск пути отменит поиск пути к целевому полигону (возможно, недостижимому или очень удалённому). В этом случае поиск пути сбрасывается и строит путь от начального полигона до полигона, который был найден ближайшим к целевой позиции. Значение 0 или ниже считается неограниченным. В случае неограниченного значения поиск пути будет искать все полигоны, соединённые с начальным полигоном, пока не будет найден целевой полигон или пока не будут исчерпаны все доступные варианты поиска полигонов.

public int PathSearchMaxPolygons { get; set; }

Максимальное количество полигонов, которые будут просмотрены до того, как поиск пути отменит поиск пути к целевому полигону (возможно, недостижимому или очень удалённому). В этом случае поиск пути сбрасывается и строит путь от начального полигона до полигона, который был найден ближайшим к целевой позиции. Значение 0 или меньше считается неограниченным. В случае неограниченного поиска пути поиск пути будет искать все полигоны, соединённые с начальным полигоном, пока не будет найден целевой полигон или пока не будут исчерпаны все доступные варианты поиска полигонов.

public NavigationPathQueryParameters3D.PathfindingAlgorithmEnum PathfindingAlgorithm { get; set; }

Алгоритм поиска пути, используемый в запросе пути.

Радиус

public float Radius { get; set; }

Радиус агента избегания. Это «тело» агента избегания, а не начальный радиус маневра избегания (который контролируется NavigationAgent3D.NeighborDistance). Не влияет на обычный поиск пути. Чтобы изменить радиус поиска пути актера, запеките ресурсы NavigationMesh с другим свойством NavigationMesh.AgentRadius и используйте разные навигационные карты для каждого размера актера.

public float SimplifyEpsilon { get; set; }

Упрощение пути в мировых единицах.

public bool SimplifyPath { get; set; }

Если true, будет возвращена упрощенная версия пути с удаленными менее критическими точками пути. Степень упрощения контролируется NavigationAgent3D.SimplifyEpsilon. Упрощение использует вариант алгоритма Ramer-Douglas-Peucker для прореживания точек кривой. Упрощение пути может быть полезно для смягчения различных проблем следования по пути, которые могут возникнуть с определенными типами агентов и поведением сценария. Например, «рулевое управление» или избегание в «открытых полях».

public float TargetDesiredDistance { get; set; }

Допуск достижения исходной цели. Проверка использует расстояние в 3D: вертикальное смещение начала координат тела также важно.

public Vector3 TargetPosition { get; set; }

Глобальная цель агента 3D. Присваивание запрашивает новый путь даже для той же позиции; не повторяйте его каждый кадр без необходимости. Сам агент не выполняет движение тела.

public float TimeHorizonAgents { get; set; }

Минимальное количество времени, в течение которого скорость этого агента, рассчитанная с помощью алгоритма предотвращения столкновения, безопасна по отношению к другим агентам. Чем больше число, тем быстрее агент будет реагировать на другие агенты, но меньше свободы в выборе скорости. Слишком высокое значение значительно замедляет движение агента. Должно быть положительным.

public float TimeHorizonObstacles { get; set; }

Минимальное количество времени, в течение которого скорость этого агента, рассчитанная с помощью алгоритма предотвращения столкновения, безопасна с точки зрения статических препятствий. Чем больше число, тем быстрее агент будет реагировать на статические преграды, но меньше свободы в выборе скорости. Слишком высокое значение значительно замедляет движение агента. Должно быть положительным.

public bool Use3DAvoidance { get; set; }

Если true, агент вычисляет скорости избегания в 3D всенаправленно, например, для игр, которые происходят в воздухе, под водой или в космосе. Агенты, использующие 3D-избегание, избегают только других агентов, использующих 3D-избегание, и реагируют на препятствия избегания на основе радиуса. Они игнорируют любые препятствия на основе вершин. Если false, агент вычисляет скорости избегания в 2D вдоль осей x и z, игнорируя ось y. Агенты, использующие 2D-избегание, избегают только других агентов, использующих 2D-избегание, и реагируют на препятствия избегания на основе радиуса или препятствия избегания на основе вершин. Другие агенты, использующие 2D-избегание, которые находятся ниже или выше их текущего положения, включая NavigationAgent3D.Height, игнорируются.

public Vector3 Velocity { get; set; }

Устанавливает новую желаемую скорость для агента. Симуляция избегания попытается достичь этой скорости, если это возможно, но изменит ее, чтобы избежать столкновения с другими агентами и препятствиями. Когда агент телепортируется в новое положение, используйте также NavigationAgent3D.SetVelocityForced для сброса внутренней скорости симуляции.

public float DistanceToTarget();

Возвращает расстояние до целевой позиции, используя глобальную позицию агента. Пользователь должен установить NavigationAgent3D.TargetPosition, чтобы это было точным.

public bool GetAvoidanceLayerValue(int layerNumber);

Возвращается ли указанный слой NavigationAgent3D.AvoidanceLayers Включена битмаска, при условии a layer_number от 1 до 32 лет.

public bool GetAvoidanceMaskValue(int maskNumber);

Возвращается ли указанная маска NavigationAgent3D.AvoidanceMask Включена битмаска, при условии a mask_number от 1 до 32 лет.

public Vector3[] GetCurrentNavigationPath();

Читает текущие точки пути, а не двигает родителя. Для готового физического примера геометрия карты и пола проверяются отдельно.

public int GetCurrentNavigationPathIndex();

Возвращает индекс, по которому в данный момент находится агент в массиве Vector3[] пути навигации.

public NavigationPathQueryResult3D GetCurrentNavigationResult();

Возвращает результат запроса пути, по которому в данный момент следует агент.

public Vector3 GetFinalPosition();

Обновляет навигацию и читает конец текущего пути. При недостижимой цели он может остаться на доступной границе.

public bool GetNavigationLayerValue(int layerNumber);

Возвращает, включен ли указанный слой битовой маски NavigationAgent3D.NavigationLayers, учитывая layer_number от 1 до 32.

public Rid GetNavigationMap();

Читает назначенную карту агента, а без явного назначения — карту мира корректного родителя. Не является проверкой готовности полигонов.

public Vector3 GetNextPathPosition();

Обновляет навигацию и возвращает очередную точку для вашего кода движения. Пока маршрут не завершён, используйте в цикле физики; это не команда перемещения тела.

public float GetPathLength();

Возвращает длину текущего вычисленного пути. Возвращаемое значение — 0.0, если путь всё ещё вычисляется или вычисление ещё не было запрошено.

public Rid GetRid();

Возвращает Rid этого агента на NavigationServer3D.

public bool IsNavigationFinished();

Обновляет состояние и проверяет завершение текущего маршрута. Это не то же, что достижение исходной цели: проверенный частичный путь завершился без IsTargetReached.

public bool IsTargetReachable();

Обновляет навигацию и сравнивает её конечную точку с целью по TargetDesiredDistance. Не проверяет физический проход сквозь стены.

public bool IsTargetReached();

Читает сохранённое состояние достижения исходной цели. Оно выставляется при обновлении следования с учётом TargetDesiredDistance.

public void SetAvoidanceLayerValue(int layerNumber, bool value);

На основе value включает или отключает указанный слой в битовой маске NavigationAgent3D.AvoidanceLayers, учитывая layer_number от 1 до 32.

public void SetAvoidanceMaskValue(int maskNumber, bool value);

На основе value включает или отключает указанную маску в битовой маске NavigationAgent3D.AvoidanceMask, учитывая mask_number от 1 до 32.

public void SetNavigationLayerValue(int layerNumber, bool value);

На основе value включает или отключает указанный слой в битовой маске NavigationAgent3D.NavigationLayers, учитывая layer_number от 1 до 32.

public void SetNavigationMap(Rid navigationMap);

Задаёт явную карту для запросов Entity и отправляет назначение серверному агенту. При активной цели запрашивает новый маршрут; дождитесь обработки серверного изменения.

public void SetVelocityForced(Vector3 velocity);

Заменяет внутреннюю скорость в моделировании избегания столкновений на NavigationAgent3D.Velocity. Когда агент телепортируется в новое положение, эта функция должна использоваться в том же кадре. При частом вызове эта функция может привести к застреванию агентов.

public event NavigationAgent3D.LinkReachedEventHandler LinkReached;

Сигнализирует, что агент достиг навигационной ссылки. Выдается, когда агент перемещается в пределах NavigationAgent3D.PathDesiredDistance от следующей позиции пути, когда эта позиция является навигационной ссылкой. Словарь сведений может содержать следующие ключи в зависимости от значения NavigationAgent3D.PathMetadataFlags:

• position: начальная позиция достигнутой ссылки.
• type: всегда NavigationPathQueryResult3D.PathSegmentType.Link.
• rid: Rid ссылки.
• owner: объект, управляющий ссылкой (обычно NavigationLink3D).
• link_entry_position: Если доступен owner и владелец — NavigationLink3D, он будет содержать глобальную позицию точки ссылки, в которую входит агент.
• link_exit_position: Если доступен owner и владелец — NavigationLink3D, он будет содержать глобальную позицию точки ссылки, из которой выходит агент.

public event Action NavigationFinished;

Сигнализирует о том, что навигация агента завершена. Если цель достижима, навигация заканчивается, когда цель достигнута. Если цель недостижима, навигация заканчивается, когда достигнута последняя точка маршрута. Этот сигнал выдается только один раз на загруженный путь. Этот сигнал будет выдан сразу после NavigationAgent3D.TargetReached, когда цель достижима.

public event Action PathChanged;

Выдается, когда агенту необходимо обновить загруженный путь:

• потому что путь ранее был пуст.
• потому что карта навигации изменилась.
• потому что агент оттолкнулся от текущего сегмента пути дальше, чем NavigationAgent3D.PathMaxDistance.

public event Action TargetReached;

Сигнализирует о том, что агент достиг цели, т. е. агент переместился в пределах NavigationAgent3D.TargetDesiredDistance от NavigationAgent3D.TargetPosition. Этот сигнал посылается только один раз на загруженный путь. Этот сигнал будет посылаться непосредственно перед NavigationAgent3D.NavigationFinished, когда цель достижима. Не всегда возможно достичь цели, но всегда должно быть возможно достичь конечной позиции. См. NavigationAgent3D.GetFinalPosition.

public event NavigationAgent3D.VelocityComputedEventHandler VelocityComputed;

Уведомляет, когда вычисляется скорость избегания столкновений. Выпускается каждое обновление, пока NavigationAgent3D.AvoidanceEnabled имеет значение true и у агента есть навигационная карта.

public event NavigationAgent3D.WaypointReachedEventHandler WaypointReached;

Сигнализирует о том, что агент достиг путевой точки. Выдается, когда агент перемещается в пределах NavigationAgent3D.PathDesiredDistance от следующей позиции пути. Словарь сведений может содержать следующие ключи в зависимости от значения NavigationAgent3D.PathMetadataFlags:

• position: позиция путевой точки, которая была достигнута.
• type: тип навигационного примитива (регион или ссылка), который содержит эту путевую точку.
• rid: Rid содержащего навигационного примитива (регион или ссылка).
• owner: объект, который управляет содержащим навигационным примитивом (регион или ссылка).