Navigation

Open 3D Engine (O3DE), el sucesor de Lumberyard, ya está disponible en Developer Preview. Descargar O3DEo visite elBlog de AWS Game Techpara obtener más información.

LaAeronavegaciónproporciona funcionalidad de búsqueda de rutas y seguimiento de rutas para el movimiento de IA, normalmente en una malla de navegación.

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.xml.

Para 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 elOnTraversalPathUpdate, 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, otroOnTraversalPathUpdatese 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 especificadorequestIdes 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 denextPathPositionyinflectionPositionson 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ánextPathPositionque 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— Desactivado

1— En