๊ฒ์์์ง/Unity
[Unity3D] NavMeshAgent Document ๊ณต๋ถ
KiTFOx
2023. 8. 8. 12:10
728x90
NavMeshAgent Documentation ์๊ธ : https://docs.unity3d.com/ScriptReference/AI.NavMeshAgent.html
์์ด ๊ทธ๋๋ก ์ง๋ ์งํดํ๋ฉด ์ข๊ฒ ์ง๋ง.. ์ต์ํด์ง๊ธฐ ์ ์๋ ์ฎ๊ฒจ๋ด์ผ๋ฉด์ ํ์ ํ๋ ค๊ณ ํ๋ค..
Properties
acceleration | ๊ฐ์๋ | ๊ฒฝ๋ก๋ฅผ ๋ฐ๋ฅด๋ ์์ด์ ํธ์ ์ต๋ ๊ฐ์๋(๋จ์/sec^2). |
agentTypeID | Type ID | ์์ด์ ํธ์ Type ID |
angularSpeed | ํ์ ์๋ | ๊ฒฝ๋ก๋ฅผ ๋ฐ๋ฅด๋ ๋์ ์ต๋ ํ์ ์๋(deg/s) |
areaMask | ์์ญ ๋ง์คํฌ | ํต๊ณผ ๊ฐ๋ฅํ NavMesh ์์ญ์ ์ง์ ํฉ๋๋ค. ์์ญ ๋ง์คํฌ๋ฅผ ๋ณ๊ฒฝํ๋ฉด ๊ฒฝ๋ก๊ฐ ์ ์ฒด๋ฉ๋๋ค.(isPathStale ์ฐธ์กฐ) |
autoBraking | ์๋ ๋ธ๋ ์ดํฌ | ์์ด์ ํธ๊ฐ ๋ชฉ์ ์ง ์ง์ ์ ์ค๋ฒ์ํ ํ์ง ์๋๋ก ์๋์ผ๋ก ๋ธ๋ ์ดํฌ๋ฅผ ๋ฐ์์ผ ํฉ๋๊น? |
autoRepath | ์๋ ๊ฒฝ๋ก์ฌํ์ | ๊ธฐ์กด ๊ฒฝ๋ก๊ฐ ์ ํจํ์ง ์์ ๊ฒฝ์ฐ ์์ด์ ํธ๊ฐ ์ ๊ฒฝ๋ก๋ฅผ ํ๋ํ๋ ค๊ณ ์๋ํด์ผ ํฉ๋๊น? |
autoTraverseOffMeshLink | ์๋ OffMeshLinks ์ด๋ | ์์ด์ ํธ๊ฐ OffMeshLinks ๊ฐ์ ์๋์ผ๋ก ์ด๋ํด์ผ ํฉ๋๊น? |
avoidancePriority | ํํผ ์ฐ์ ์์ | ํํผ ์ฐ์ ์์ ์์ค |
baseoffset | ์์ ํ๊ณ ์๋ GameObject์ ์๋์ ์ธ ์์ง ๋ณ์ | |
currentOffMeshLinkData | ํ์ฌ OffMeshLink ๋ฐ์ดํฐ | |
desiredVelocity | ์ํ๋ ์๋ | ํํผ๋ก ์ธํ ์ ์ฌ์ ๊ธฐ์ฌ๋ฅผ ํฌํจํ ์์ด์ ํธ์ ์ํ๋ ์๋(์ฝ๊ธฐ ์ ์ฉ) |
destination | ๋ชฉ์ ์ง | ์ธ๊ณ ๊ณต๊ฐ ๋จ์๋ก ์์ด์ ํธ์ ๋์์ ๊ฐ์ ธ์ค๊ฑฐ๋ ์ค์ ํ๋ ค๊ณ ์๋ํฉ๋๋ค. |
hasPath | ๊ฒฝ๋ก ์ ๋ฌด | ์์ด์ ํธ์ ํ์ฌ ๊ฒฝ๋ก๊ฐ ์์ต๋๊น?(์ฝ๊ธฐ ์ ์ฉ) |
height | ์์ด์ ํธ ๋์ด | ์ฅ์ ๋ฌผ์ ํต๊ณผํ ๋ชฉ์ ์ผ๋ก ํ๋ ์์ด์ ํธ์ ๋์ด ๋ฑ. |
isOnNavMesh | ๋ฐ์ธ๋ฉ ์ ๋ฌด | ์์ด์ ํธ๊ฐ ํ์ฌ navmesh์ ๋ฐ์ธ๋ฉ๋์ด ์์ต๋๊น?(์ฝ๊ธฐ ์ ์ฉ) |
isOnOffMeshLink | ์์น ์ ๋ฌด | ์์ด์ ํธ๊ฐ ํ์ฌ OffMeshLink์ ์์นํ๊ณ ์์ต๋๊น?(์ฝ๊ธฐ ์ ์ฉ) |
isPathState | ํ์ฌ ๊ฒฝ๋ก๊ฐ ์ค๋๋์์ต๋๋ค.(์ฝ๊ธฐ ์ ์ฉ) | |
isStopped | ๋ฉ์ถค ์ ๋ฌด | ์ด ์์ฑ์ NavMesh ์์ด์ ํธ์ ์ค์ง ๋๋ ์ ๊ฐ ์กฐ๊ฑด์ ์ ์งํฉ๋๋ค. |
navMeshOwner | ์์ด์ ํธ๊ฐ ํ์ฌ ์์นํ NavMesh์ ์์ ๊ฐ์ฒด๋ฅผ ๋ฐํํฉ๋๋ค(์ฝ๊ธฐ ์ ์ฉ). | |
nextOffMeshLinkData | ํ์ฌ ๊ฒฝ๋ก์ ๋ค์ OffMeshLink ๋ฐ์ดํฐ์ ๋๋ค. | |
nextPosition | ๋ค์ ์์น | navmesh ์์ด์ ํธ์ ์๋ฎฌ๋ ์ด์ ์์น๋ฅผ ๊ฐ์ ธ์ค๊ฑฐ๋ ์ค์ ํฉ๋๋ค. |
obstacleAvoidanceType | ์ฅ์ ๋ฌผ ํํผ ์ ํ | ํํผ ํ์ง ์์ค |
path | ๊ฒฝ๋ก | ํ์ฌ ๊ฒฝ๋ก๋ฅผ ๊ฐ์ ธ์ค๊ณ ์ค์ ํ ์์ฑ์ ๋๋ค. |
pathPending | ๊ฒฝ๋ก ๋ณด๋ฅ ์ค | ๊ณ์ฐ ์ค์ด์ง๋ง ์์ง ์ค๋น๋์ง ์์ ๊ฒฝ๋ก์ ๋๊น?(์ฝ๊ธฐ ์ ์ฉ) |
pathStatus | ๊ฒฝ๋ก ์ํ | ํ์ฌ ๊ฒฝ๋ก์ ์ํ(์ ์ฒด, ๋ถ๋ถ ๋๋ ์ ํจํ์ง ์์)์ ๋๋ค. |
radius | ์์ด์ ํธ ํํผ ๋ฐ๊ฒฝ | ์์ด์ ํธ์ ํํผ ๋ฐ๊ฒฝ์ ๋๋ค. |
remainingDistance | ๋จ์ ๊ฑฐ๋ฆฌ | ํ์ฌ ๊ฒฝ๋ก์์ ์์ด์ ํธ ์์น์ ๋์ ์ฌ์ด์ ๊ฑฐ๋ฆฌ(์ฝ๊ธฐ ์ ์ฉ) |
speed | ์ต๋ ์๋ | ๊ฒฝ๋ก๋ฅผ ๋ฐ๋ฅผ ๋์ ์ต๋ ์ด๋ ์๋ |
steeringTarget | ๋์๊ฐ๋ ๋ชฉํ | ๊ฒฝ๋ก๋ฅผ ๋ฐ๋ผ ํ์ฌ ๋์๊ฐ๋ ๋ชฉํ๋ฅผ ๊ฐ์ ธ์ต๋๋ค.(์ฝ๊ธฐ ์ ์ฉ) |
stoppingDistance | ๋ชฉํ์์ ์์ ๊ฑฐ๋ฆฌ | ๋ชฉํ ์์น์์ ์ด ๊ฑฐ๋ฆฌ ๋ด์์ ์ ์งํฉ๋๋ค. |
updatePosition | ๋ณํ ์์น๊ฐ ์๋ฎฌ๋ ์ด์ ๋ ์์ด์ ํธ ์์น์ ๋๊ธฐํ๋๋์ง ์ฌ๋ถ๋ฅผ ๊ฐ์ ธ์ค๊ฑฐ๋ ์ค์ ํฉ๋๋ค. ๊ธฐ๋ณธ๊ฐ์ True์ ๋๋ค. | |
updateRotation | ์์ด์ ํธ๊ฐ ๋ณํ ๋ฐฉํฅ์ ์ ๋ฐ์ดํธํด์ผ ํฉ๋๊น? | |
updateUpAxis | ์์ด์ ํธ๋ฅผ NavMesh์ ์์ชฝ ์ถ์ ์ ๋ ฌํ ์ง ๋๋ ์์ด์ ํธ๊ฐ ๋ฐฐ์น๋ ๋งํฌ์ ์ ๋ ฌํ ์ง ์ง์ ํ ์ ์์ต๋๋ค. | |
velocity | ์๋ | NavMeshAgent ๊ตฌ์ฑ ์์์ ํ์ฌ ์๋์ ์ก์ธ์คํ๊ฑฐ๋ ์์ด์ ํธ๋ฅผ ์๋์ผ๋ก ์ ์ดํ ์๋๋ฅผ ์ค์ ํฉ๋๋ค. |
Public Methods
ActivateCurrentOffMeshLink | ํ์ฌ OffMeshLink๋ฅผ ํ์ฑํํ๊ฑฐ๋ ๋นํ์ฑํํฉ๋๋ค. | |
CalculatePath | ์ง์ ๋ ์ ์ ๋ํ ๊ฒฝ๋ก๋ฅผ ๊ณ์ฐํ๊ณ ๊ฒฐ๊ณผ ๊ฒฝ๋ก๋ฅผ ์ ์ฅํฉ๋๋ค. | |
CompleteOffMeshLink | ํ์ฌ OffMeshLink์์ ์ด๋์ ์๋ฃํฉ๋๋ค. | |
FindClosestEdge | ๊ฐ์ฅ ๊ฐ๊น์ด NavMesh ๊ฐ์ฅ์๋ฆฌ๋ฅผ ์ฐพ์ต๋๋ค. | |
GetAreaCost | ๊ฒฝ๋ก ๋น์ฉ | ํน์ ์ ํ์ ์์ญ์ ํก๋จํ ๋ ๊ฒฝ๋ก ๊ณ์ฐ์ ์ํ ๋น์ฉ์ ๊ฐ์ ธ์ต๋๋ค. |
Move | ํ์ฌ ์์น์ ์๋ ์ด๋์ ์ ์ฉํฉ๋๋ค. | |
Raycast | ์์ด์ ํธ๋ฅผ ์ด๋ํ์ง ์๊ณ NavMesh์ ๋ชฉํ ์์น๋ฅผ ํฅํด ์ง์ ๊ฒฝ๋ก๋ฅผ ์ถ์ ํฉ๋๋ค. | |
ResetPath | ํ์ฌ ๊ฒฝ๋ก๋ฅผ ์ง์๋๋ค. | |
SamplePathPosition | ํ์ฌ ๊ฒฝ๋ก๋ฅผ ๋ฐ๋ผ ์์น๋ฅผ ์ํ๋งํฉ๋๋ค. | |
SetAreaCost | ์์ญ ๋น์ฉ ์ค์ | ์์ญ ์ ํ์ ๋ฐ๋ฅธ ์์ญ์ ํก๋จํ๋ ๋น์ฉ์ ์ค์ ํฉ๋๋ค. |
SetDestination | ๋ชฉํ ์ค์ | ๋์์ ์ค์ ํ๊ฑฐ๋ ์ ๋ฐ์ดํธํ์ฌ ์ ๊ฒฝ๋ก์ ๋ํ ๊ณ์ฐ์ ์ํฉ๋๋ค. |
SetPath | ๊ฒฝ๋ก ํ ๋น | ์ด ์์ด์ ํธ์ ์ ๊ฒฝ๋ก๋ฅผ ํ ๋นํฉ๋๋ค. |
Warp | ์ ๊ณต๋ ์์น๋ก ์์ด์ ํธ๋ฅผ ์ํํฉ๋๋ค. |
Inherited Members(์์ ๋ฉค๋ฒ)
Properties
enabled | ํ์ฑํ๋ ๋์์ ์ ๋ฐ์ดํธ๋๊ณ ๋นํ์ฑํ๋ ๋์์ ์ ๋ฐ์ดํธ๋์ง ์์ต๋๋ค. | |
isActiveAndEnabled | GameObject์ ๊ด๋ จ ๋์์ด ํ์ฑํ๋์ด ์๊ณ ํ์ฑํ๋์ด ์๋์ง ์ฌ๋ถ๋ฅผ ๋ณด๊ณ ํฉ๋๋ค. | |
gameObject | ์ด ๊ตฌ์ฑ ์์๊ฐ ์ฐ๊ฒฐ๋ ๊ฒ์ ๊ฐ์ฒด์ ๋๋ค. ๊ตฌ์ฑ ์์๋ ํญ์ ๊ฒ์ ๊ฐ์ฒด์ ์ฐ๊ฒฐ๋ฉ๋๋ค. | |
tag | ํ๊ทธ | ์ด ๊ฒ์ ๊ฐ์ฒด์ ํ๊ทธ์ ๋๋ค. |
transform | ์ด ๊ฒ์ ๊ฐ์ฒด์ ๊ฒฌ๊ฒฐ๋ ๋ณํ์ ๋๋ค. | |
hideFlags | ๊ฐ์ฒด๋ฅผ ์จ๊ธฐ๊ฑฐ๋ ์ฅ๋ฉด์ผ๋ก ์ ์ฅํ๊ฑฐ๋ ์ฌ์ฉ์๊ฐ ์์ ํ ์ ์์ด์ผ ํฉ๋๊น? | |
name | ์ด๋ฆ | ๊ฐ์ฒด ์ด๋ฆ์ ๋๋ค. |
Public Methods
BroadcastMessage | ์ด ๊ฒ์ ๊ฐ์ฒด ๋๋ ํด๋น ํ์ ๊ฐ์ฒด์ ๋ชจ๋ MonoBehavior์์ methodName์ด๋ผ๋ ๋ฉ์๋๋ฅผ ํธ์ถํฉ๋๋ค. | |
CompareTag | ์ ์๋ ํ๊ทธ์ ๋ํด GameObject์ ํ๊ทธ๋ฅผ ํ์ธํฉ๋๋ค. | |
GetComponent | ์ง์ ํ ๊ตฌ์ฑ ์์์ ๋์ผํ GameObject์ Tํ ๊ตฌ์ฑ ์์์ ๋ํ ์ฐธ์กฐ๋ฅผ ๊ฐ์ ธ์ต๋๋ค. | |
GetComponentInChildren | ์ง์ ๋ ๊ตฌ์ฑ ์์์ ๋์ผํ GameObject์ Tํ ๊ตฌ์ฑ ์์ ๋๋ GameObject์ ์์์ ๋ํ ์ฐธ์กฐ๋ฅผ ๊ฐ์ ธ์ต๋๋ค. | |
GetComponentInParent | ์ง์ ๋ ๊ตฌ์ฑ ์์์ ๋์ผํ GameObject ๋๋ GameObject์ ์์ ๊ตฌ์ฑ ์์์ ๋ํ ์ฐธ์กฐ๋ฅผ ๊ฐ์ ธ์ต๋๋ค. | |
GetComponents | ์ง์ ๋ ๊ตฌ์ฑ ์์์ ๋์ผํ GameObject์์ T ์ ํ์ ๋ชจ๋ ๊ตฌ์ฑ ์์์ ๋ํ ์ฐธ์กฐ๋ฅผ ๊ฐ์ ธ์ต๋๋ค. | |
GetComponentsInChildren | ์ง์ ๋ ๊ตฌ์ฑ ์์์ ๋์ผํ GameObject์ ์๋ T ํ์์ ๋ชจ๋ ๊ตฌ์ฑ ์์ ๋ฐ GameObject์ ์์์ ๋ํ ์ฐธ์กฐ๋ฅผ ๊ฐ์ ธ์ต๋๋ค. | |
GetComponentsInParent | ์ง์ ๋ ๊ตฌ์ฑ ์์์ ๋์ผํ GameObject์ ๋ชจ๋ ๊ตฌ์ฑ ์์ ๋ฐ GameObject์ ๋ชจ๋ ๋ถ๋ชจ์ ๋ํ ์ฐธ์กฐ๋ฅผ ๊ฐ์ ธ์ต๋๋ค. | |
SendMessage | ์ด ๊ฒ์ ๊ฐ์ฒด์ ๋ชจ๋ MonoBehavior์์ methodName์ด๋ผ๋ ๋ฉ์๋๋ฅผ ํธ์ถํฉ๋๋ค. | |
SendMessageUpwards | ์ด ๊ฒ์ ๊ฐ์ฒด์ ๋ชจ๋ MonoBehavior์ ๋ชจ๋ ๋์์ ์กฐ์์ ๋ํด methodName์ด๋ผ๋ ๋ฉ์๋๋ฅผ ํธ์ถํฉ๋๋ค. | |
TryGetComponent | ์ง์ ํ ์ ํ์ ๊ตฌ์ฑ ์์(์กด์ฌํ๋ ๊ฒฝ์ฐ)๋ฅผ ๊ฐ์ ธ์ต๋๋ค. | |
GetInstanceID | ๊ฐ์ฒด์ ์ธ์คํด์ค ID๋ฅผ ๊ฐ์ ธ์ต๋๋ค. | |
ToString | ๊ฐ์ฒด์ ์ด๋ฆ์ ๋ฐํํฉ๋๋ค. |
Static Methods
Destroy | ๊ฒ์ ๊ฐ์ฒด, ๊ตฌ์ฑ ์์ ๋๋ ์์ฐ์ ์ ๊ฑฐํฉ๋๋ค. | |
DestroyImmediate | ๊ฐ์ฒด๋ฅผ ์ฆ์ ํ๊ดดํฉ๋๋ค. ๋์ Destroy ํจ์๋ฅผ ์ฌ์ฉํ๋ ๊ฒ์ ๊ฐํ๊ฒ ๊ถ๊ณ ํฉ๋๋ค. | |
DontDestroyOnLoad | ์ ์ฅ๋ฉด์ ๋ก๋ํ ๋ ๋์ ๊ฐ์ฒด๋ฅผ ํ๊ดดํ์ง ๋ง์ญ์์ค. | |
FindAnyObjectByType | Type ์ ํ์ ํ์ฑ ๋ก๋๋ ๊ฐ์ฒด๋ฅผ ๊ฒ์ํฉ๋๋ค. | |
FindFirstObjectByType | Type ์ ํ์ ์ฒซ ๋ฒ์งธ ํ์ฑ ๋ก๋๋ ๊ฐ์ฒด๋ฅผ ๊ฒ์ํฉ๋๋ค. | |
FindobjectOfType | Type ์ ํ์ ์ฒซ ๋ฒ์งธ ํ์ฑ ๋ก๋๋ ๊ฐ์ฒด๋ฅผ ๋ฐํํฉ๋๋ค. | |
FindObjectsByType | Type ์ ํ์ ๋ก๋๋ ๋ชจ๋ ๊ฐ์ฒด ๋ชฉ๋ก์ ๊ฒ์ํฉ๋๋ค. | |
FindObjectsOfType | Type ์ ํ์ ๋ก๋๋ ๋ชจ๋ ๊ฐ์ฒด์ ๋ชฉ๋ก์ ๊ฐ์ ธ์ต๋๋ค. | |
Instantiate | ๊ฐ์ฒด ์๋ณธ์ ๋ณต์ ํ๊ณ ๋ณต์ ๋ฅผ ๋ฐํํฉ๋๋ค. |
Operators
bool | ๊ฐ์ฒด๊ฐ ์กด์ฌํฉ๋๊น? | |
operator != | ๋ ๊ฐ์ฒด๊ฐ ๋ค๋ฅธ ๊ฐ์ฒด๋ฅผ ์ฐธ์กฐํ๋์ง ๋น๊ตํฉ๋๋ค. | |
operator == | ๋ ๊ฐ์ฒด ์ฐธ์กฐ๋ฅผ ๋น๊ตํ์ฌ ๋์ผํ ๊ฐ์ฒด๋ฅผ ์ฐธ์กฐํ๋์ง ํ์ธํฉ๋๋ค. |
๋ฐ์ํ