Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.
Navigation
Open 3D Engine (O3DE), el sucesor de Lumberyard, ya está disponible en Developer Preview. Descargar O3DE |
LaAeronavegaciónproporciona funcionalidad de búsqueda de rutas y seguimiento de rutas para el movimiento de IA, normalmente en una malla de navegación.

Temas
Propiedades del componente Navigation
El componente Navigation incluye las siguientes propiedades:

- Agent Type (Tipo de agente)
-
Especifica el tipo de entidad de esta IA para fines de navegación. Si se define el tipo de agente se determina qué área de navegación sigue la entidad en una situación en la que existen diferentes mallas de navegación para vehículos más grandes y bots humanoides más pequeños. Estos tipos de agentes se definen en el archivo
.lumberyard_version
\dev\your_project_name
\Scripts\AI\Navigation.xmlPara definir un tipo de agente en el área de navegación, consulte el componente Área de navegación.
- Agent Speed (Velocidad de agente)
-
Establece la velocidad del agente durante la navegación cuando utiliza los métodos de movimiento Transform o Física.
Valor predeterminado:
1
- Agent Radius (Radio del agente)
-
Especifica el radio de la entidad para fines de navegación. Con independencia de la física o de otras consideraciones sobre colisiones, el localizador de rutas utiliza este valor para desplazarse por una zona con obstáculos de la forma más sencilla.
Valor predeterminado:
4
- Arrival Distance Threshold
-
Establece la distancia mínima desde un punto final cuando se detiene el movimiento de una entidad y dicho movimiento se considera completo.
Valor predeterminado:
0.25
- Repath Threshold
-
Establece la distancia mínima desde la ubicación previa conocida antes de que la nueva ruta de una entidad se calcule.
Valor predeterminado:
1
- Método Movement
-
Establece el método de movimiento que se utilizará al seguir un trazado. Esto puede ser Transformar, Física o Personalizado.
Valor predeterminado:
Transform
-
Transformación— Mueva la entidad en la que se encuentra este componente mediante el bus Transform. Este método ignora toda la física para que el objeto pueda atravesar paredes y terrenos.
-
Física— Mueva la entidad mediante física si la entidad tiene un componente PhysX Rigid Body, PhysX Character Controller, Rigid Body Physics o Character Física. Si la entidad no tiene uno de estos componentes físicos válidos, no se moverá.
-
Personalizado— Proporciona actualizaciones de ruta y deja que la lógica del juego mueva la entidad como deseen. Este método resulta útil cuando desea mover una entidad animada que utiliza movimiento raíz. Escuchando el
OnTraversalPathUpdate
, puede mover su entidad hacia el siguiente punto de una ruta. Una vez que la entidad se encuentre dentro del umbral de distancia de llegada, otroOnTraversalPathUpdate
se proporcionará una notificación con la siguiente posición de ruta, etc. hasta que se llegue al final de la ruta.
-
- Permitir navegación vertical
-
Establezca en true si desea permitir que el agente de navegación incluya la velocidad vertical al navegar por un trayecto, o false si solo desea que la velocidad se limite al plano X e Y (2D). La navegación vertical se puede utilizar para entidades o entidades voladoras que se mueven con el método Transform pero deben moverse verticalmente. Habilitar esta propiedad también puede ayudar a evitar el «escalón de escalera» para las entidades que se mueven por rampas o en terrenos empinados.
Valor predeterminado:
false
Interfaz EBus NavigationComponentRequestBus
Utilice las siguientes funciones de solicitud con la interfaz de bus de eventos (EBus) NavigationComponentRequestBus
para comunicarse con otros componentes del juego.
Para obtener más información acerca del uso de la interfaz de bus de eventos (EBus), consulte Trabajo con el sistema de bus de eventos (EBus).
FindPath
Localiza una configuración de ruta solicitada.
- Parámetros
-
request
: permite al emisor de la solicitud anular uno, todos o ninguno de los valores predeterminados de la configuración de localización de ruta para esta entidad. - Return
-
Identificador exclusivo de esta solicitud de localización de ruta.
- Capacidad de ejecución de script
-
No
FindPathToEntity
Crea una solicitud de localización de ruta para navegar hacia la entidad especificada.
- Parámetros
-
EntityId
: ID de la entidad hacia la que se desea navegar. - Return
-
Un identificador exclusivo para esta solicitud de localización de ruta.
- Capacidad de ejecución de script
-
Sí
FindPathToPosition
Crea una solicitud de localización de ruta para navegar hacia la posición mundial especificada. Tenga en cuenta que, si bien esto puede parecer la opción simple y obvia para la ruta, a menudo es más útil usar FindPathtoEntity con una entidad ficticia, ya que la ruta se actualizará automáticamente si mueve la entidad ficticia a una nueva ubicación antes de que se complete la ruta.
- Parámetros
-
Destination
— Posición mundial a la que desea navegar. - Return
-
Un identificador exclusivo para esta solicitud de localización de ruta.
- Capacidad de ejecución de script
-
Sí
Stop
Detiene todas las operaciones de localización de ruta del requestId
proporcionado. Utilice el ID para garantizar que la solicitud que quiere cancelar sea la solicitud que se está procesando actualmente. Si el especificadorequestId
es diferente del ID de la solicitud actual y, a continuación, se pasa por alto el comando Stop.
- Parámetros
-
requestId
— ID de la solicitud de cancelación. - Return
-
Ninguno
- Capacidad de ejecución de script
-
Sí
GetAgentSpeed
Devuelve la velocidad del agente de IA actual.
- Parámetros
-
Ninguno
- Return
-
Devuelve la velocidad del agente actual como flotante.
- Capacidad de ejecución de script
-
Sí
SetAgentSpeed
Actualiza la velocidad del agente de IA.
- Parámetros
-
agentSpeed
: especifica la nueva velocidad del agente como flotante. - Return
-
Ninguno
- Capacidad de ejecución de script
-
Sí
GetAgentMovementMethod
Devuelve el método de movimiento actual del agente de IA.
- Parámetros
-
Ninguno
- Return
-
Devuelve el método de movimiento del agente actual.
- Capacidad de ejecución de script
-
Sí
SetAgentMovementMethod
Actualiza el método de movimiento del agente de IA.
- Parámetros
-
movementMethod
: especifica el nuevo método de movimiento del agente (Transformar, Física o Personalizado). - Return
-
Ninguno
- Capacidad de ejecución de script
-
Sí
Interfaz EBus NavigationComponentNotificationBus
Utilice las siguientes funciones de notificación con la interfaz de bus de eventos (EBus) NavigationComponentNotificationBus
para comunicarse con otros componentes del juego.
Para obtener más información acerca del uso de la interfaz de bus de eventos (EBus), consulte Trabajo con el sistema de bus de eventos (EBus).
OnSearchingForPath
Indica que la solicitud de localización de ruta se ha enviado al sistema de navegación.
- Parámetros
-
requestId
: ID de la solicitud en la que se está realizando búsquedas en la ruta de acceso. - Return
-
Ninguno
- Capacidad de ejecución de script
-
Sí
OnPathFound
Indica que se ha encontrado una ruta para la solicitud indicada.
- Parámetros
-
requestID
: ID de la solicitud para la que se ha encontrado la ruta.currentPath
— La ruta que ha calculado el localizador de rutas. - Return
-
Devuelve un valor booleano que indica si se va a recorrer esta ruta.
- Capacidad de ejecución de script
-
No
OnTraversalStarted
Indica que se ha iniciado el recorrido para la solicitud indicada.
- Parámetros
-
requestId
— ID de la solicitud para la que ha comenzado el recorrido. - Return
-
Ninguno
- Capacidad de ejecución de script
-
Sí
OnTraversalInProgress
Indica que el recorrido de la solicitud indicada está en curso.
- Parámetros
-
requestId
— ID de la solicitud para la que el recorrido está en progreso.distanceRemaining
— Distancia restante en este camino. - Return
-
Ninguno
- Capacidad de ejecución de script
-
Sí
OnTraversalPathUpdate
Indica que se ha actualizado la ruta del recorrido. Si el archivo denextPathPosition
yinflectionPosition
son iguales, representan el final de la ruta.
- Parámetros
-
requestId
— ID de la solicitud para la que el recorrido está en progreso.nextPathPosition
— El punto más alejado del camino al que podemos movernos sin chocar con nada.inflectionPosition
— Siguiente punto en el camino más allánextPathPosition
que se desvía de un trazado en línea recta. - Return
-
Ninguno
- Capacidad de ejecución de script
-
Sí
OnTraversalComplete
Indica que se ha completado correctamente el recorrido de la solicitud indicada.
- Parámetros
-
requestId
— ID de la solicitud para la que ha finalizado el recorrido. - Return
-
Ninguno
- Capacidad de ejecución de script
-
Sí
OnTraversalCancelled
Indica que el recorrido de la solicitud indicada se ha cancelado antes de completarse correctamente. Es posible que se cancele una solicitud de ruta si no se encuentra ninguna ruta o si el juego detuvo la solicitud.
- Parámetros
-
requestId
— ID de la solicitud para la que se ha cancelado el recorrido. - Return
-
Ninguno
- Capacidad de ejecución de script
-
Sí
Cavares de trayectorias de navegación
- ai_DrawPathFollower
-
Habilita el dibujo de depuración de PathFollower, mostrar rutas de agente y destino de seguimiento seguro.
0
— Desactivado1
— En