1. Epic GamesDeveloper
  3. UNavLinkCustomComponent

UNavLinkCustomComponent

Encapsulates NavLinkCustomInterface interface, can be used with Actors not relevant for navigation

API > API/Runtime > API/Runtime/NavigationSystem

Inheritance Hierarchy

References

   
Module NavigationSystem
Header /Engine/Source/Runtime/NavigationSystem/Public/NavLinkCustomComponent.h
Include #include "NavLinkCustomComponent.h"

Syntax

UCLASS (MinimalAPI)  
class UNavLinkCustomComponent :  
    public UNavRelevantComponent ,  
    public INavLinkCustomInterface

Remarks

Encapsulates NavLinkCustomInterface interface, can be used with Actors not relevant for navigation

Additional functionality:

  • can be toggled
  • can create obstacle area for easier/forced separation of link end points
  • can broadcast state changes to nearby agents

Variables

  Type Name Description
Protected variable UProperty FNavLinkAuxiliaryId AuxiliaryCustomLinkId Assigned in the constructor.
Protected variable UProperty Category, EditAnywhere uint32: 1 bCreateBoxObstacle If set, box obstacle area will be added to generation
Protected variable UProperty Category, EditAnywhere uint32: 1 bLinkEnabled Is link currently in enabled state? (area class)
Protected variable UProperty Category, EditAnywhere uint32: 1 bNotifyWhenDisabled Should link notify nearby agents when it changes state to disabled
Protected variable UProperty Category, EditAnywhere uint32: 1 bNotifyWhenEnabled Should link notify nearby agents when it changes state to enabled
Protected variable UProperty Category, EditAnywhere TEnumAsByte< ECollisionChannel > BroadcastChannel Trace channel for state change broadcast
Protected variable UProperty Category, EditAnywhere, Meta float BroadcastInterval Interval for state change broadcast (0 = single broadcast)
Protected variable UProperty Category, EditAnywhere float BroadcastRadius Radius of state change broadcast
Protected variable UProperty FNavLinkId CustomLinkId Link Id assigned by navigation system
Protected variable UProperty Category, EditAnywhere TSubclassOf< UNavArea > DisabledAreaClass Area class to use when link is disabled
Protected variable UProperty Category, EditAnywhere TSubclassOf< UNavArea > EnabledAreaClass Area class to use when link is enabled
Protected variable UProperty Category, EditAnywhere TEnumAsByte< ENavLinkDirection::Type > LinkDirection Direction of link
Protected variable UProperty Category, EditAnywhere FVector LinkRelativeEnd End point, relative to owner
Protected variable UProperty Category, EditAnywhere FVector LinkRelativeStart Start point, relative to owner
Protected variable TArray< TWeakObjectPtr< UObject > > MovingAgents List of agents moving though this link
Protected variable UProperty uint32 NavLinkUserId  
Protected variable UProperty Category, EditAnywhere TSubclassOf< UNavArea > ObstacleAreaClass Area class for simple box obstacle
Protected variable UProperty Category, EditAnywhere FVector ObstacleExtent Extent of simple box obstacle
Protected variable UProperty Category, EditAnywhere FVector ObstacleOffset Offset of simple box obstacle
Protected variable FBroadcastFilter OnBroadcastFilter Delegate to call when link is reached
Protected variable FOnMoveReachedLink OnMoveReachedLink Delegate to call when link is reached
Protected variable FDelegateHandle OnNavAreaRegisteredDelegateHandle  
Protected variable FDelegateHandle OnNavAreaUnregisteredDelegateHandle  
Protected variable UProperty Category, EditAnywhere FNavAgentSelector SupportedAgents Restrict area only to specified agents
Protected variable FTimerHandle TimerHandle_BroadcastStateChange Handle for efficient management of BroadcastStateChange timer

Constructors

  Type Name Description
Public function  

UNavLinkCustomComponent ( const FObjectInitializer& ObjectInitializer
)

  

Functions

  Type Name Description
Public function void

AddNavigationObstacle ( TSubclassOf< UNavArea > AreaClass,
const FVector& BoxExtent,
const FVector& BoxOffset
)

 Add box obstacle during generation of navigation data this can be used to create empty area under doors
Public function void  
Protected function void Notify nearby agents about link changing state
Public function void Removes simple obstacle
Protected function void

CollectNearbyAgents ( TArray< UObject* >& NotifyList
)

 Gather agents to notify about state change
Public function Virtual Const TStructOnScope< FActorComponentInstanceData >  
Public function Const TSubclassOf< UNavArea >  
Public function Const TSubclassOf< UNavArea >  
Public function Const FVector Get link end point in world space
Public function Virtual Const FNavigationLink  
Public function Virtual Const void

GetNavigationData ( FNavigationRelevantData& Data
)

  
Public function Const TSubclassOf< UNavArea >  
Public function Const FVector Get link start point in world space
Public function Const FNavAgentSelector  
Public function Const bool Check is any agent is currently moving though this link
Public function Const bool  
Protected function void

OnNavAreaRegistered ( const UWorld& World,
const UClass* NavAreaClass
)

  
Protected function void

OnNavAreaUnregistered ( const UWorld& World,
const UClass* NavAreaClass
)

  
Public function Virtual void  
Public function Virtual void  
Public function void

SendBroadcastWhenDisabled ( bool bEnabled
)

  
Public function void

SendBroadcastWhenEnabled ( bool bEnabled
)

  
Public function Virtual void

Serialize ( FArchive& Ar
)

  
Public function void

SetBroadcastData ( float Radius,
ECollisionChannel TraceChannel,
float Interval
)

 Set properties of trigger around link entry point(s), that will notify nearby agents about link state change
Public function void

SetBroadcastFilter ( UserClass* TargetOb,
typename FBroadcastFilter::TConstMethodPtr< UserClass > InFunc
)

  
Public function void

SetBroadcastFilter ( UserClass* TargetOb,
typename FBroadcastFilter::TMethodPtr< UserClass > InFunc
)

  
Public function void

SetBroadcastFilter ( FBroadcastFilter const& InDelegate
)

 Set delegate to filter
Public function void

SetDisabledArea ( TSubclassOf< UNavArea > AreaClass
)

 Set area class to use when link is disabled
Public function void

SetEnabled ( bool bNewEnabled
)

 Change state of smart link (used area class)
Public function void

SetEnabledArea ( TSubclassOf< UNavArea > AreaClass
)

 Set area class to use when link is enabled
Public function void

SetLinkData ( const FVector& RelativeStart,
const FVector& RelativeEnd,
ENavLinkDirection::Type Direction
)

 Set basic link data: end points and direction
Public function void

SetMoveReachedLink ( FOnMoveReachedLink const& InDelegate
)

 Set delegate to notify about reaching this link during path following
Public function void

SetMoveReachedLink ( UserClass* TargetOb,
typename FOnMoveReachedLink::TMethodPtr< UserClass > InFunc
)

  
Public function void

SetMoveReachedLink ( UserClass* TargetOb,
typename FOnMoveReachedLink::TConstMethodPtr< UserClass > InFunc
)

  
Public function void

SetSupportedAgents ( const FNavAgentSelector& InSupportedAgents
)

  

Overridden from UNavRelevantComponent

  Type Name Description
Public function Virtual Const void  
Public function Virtual void  
Public function Virtual void  

Overridden from INavLinkCustomInterface

  Type Name Description
Public function Virtual Const FNavLinkAuxiliaryId  
Public function Virtual Const FNavLinkId

GetId ()

 Get unique ID number for custom link Owner should get its unique ID by calling INavLinkCustomInterface::GetUniqueId() and store it
Public function Virtual Const TSubclassOf< UNavArea > Get basic link data: area class (null = default walkable)
Public function Virtual Const void

GetLinkData ( FVector& LeftPt,
FVector& RightPt,
ENavLinkDirection::Type& Direction
)

 Get basic link data: two points (relative to owner) and direction
Public function Virtual Const void

GetSupportedAgents ( FNavAgentSelector& OutSupportedAgents
)

 Get agents supported by this link
Public function Virtual Const bool

IsLinkPathfindingAllowed ( const UObject* Querier
)

 Check if link allows path finding Querier is usually an AIController trying to find path
Public function Virtual void

OnLinkMoveFinished ( UObject* PathComp
)

 Notify called when agent finishes using this link for movement
Public function Virtual bool

OnLinkMoveStarted ( UObject* PathComp,
const FVector& DestPoint
)

 Notify called when agent starts using this link for movement.
Public function Virtual void

UpdateLinkId ( FNavLinkId NewUniqueId
)

 Update unique ID number for custom link by navigation system.

Typedefs

Name Description
FBroadcastFilter  
FOnMoveReachedLink  

Ask questions and help your peers Developer Forums

Write your own tutorials or read those from others Learning Library

On this page