---
title: "路径 Path"
description: "路径节点 / 路线"
---
---
title: 路径 Path
description: 路径节点 / 路线
---
`sa` · 扩展 `default` · SCM 原生命令
共 20 条。写法见 [Lua](/docs/cleo/syntax) / [Redux](/docs/cleo/syntax-redux)。
## 开车路
开启盒内车道路径。
```text
01E7 SWITCH_ROADS_ON
in: leftBottomX, leftBottomY, leftBottomZ, rightTopX, rightTopY, rightTopZ
```
```lua
switchRoadsOn(leftBottomX, leftBottomY, leftBottomZ, rightTopX, rightTopY, rightTopZ)
```
```js
Path.switchRoadsOn(leftBottomX, leftBottomY, leftBottomZ, rightTopX, rightTopY, rightTopZ)
```
## 关车路
关闭盒内车道路径。
```text
01E8 SWITCH_ROADS_OFF
in: leftBottomX, leftBottomY, leftBottomZ, rightTopX, rightTopY, rightTopZ
```
```lua
switchRoadsOff(leftBottomX, leftBottomY, leftBottomZ, rightTopX, rightTopY, rightTopZ)
```
```js
Path.switchRoadsOff(leftBottomX, leftBottomY, leftBottomZ, rightTopX, rightTopY, rightTopZ)
```
## 开人路
开启盒内行人路径。
```text
022A SWITCH_PED_ROADS_ON
in: leftBottomX, leftBottomY, leftBottomZ, rightTopX, rightTopY, rightTopZ
```
```lua
switchPedRoadsOn(leftBottomX, leftBottomY, leftBottomZ, rightTopX, rightTopY, rightTopZ)
```
```js
Path.switchPedRoadsOn(leftBottomX, leftBottomY, leftBottomZ, rightTopX, rightTopY, rightTopZ)
```
## 关人路
关闭盒内行人路径。
```text
022B SWITCH_PED_ROADS_OFF
in: leftBottomX, leftBottomY, leftBottomZ, rightTopX, rightTopY, rightTopZ
```
```lua
switchPedRoadsOff(leftBottomX, leftBottomY, leftBottomZ, rightTopX, rightTopY, rightTopZ)
```
```js
Path.switchPedRoadsOff(leftBottomX, leftBottomY, leftBottomZ, rightTopX, rightTopY, rightTopZ)
```
## 最近人节点
最近可行人节点坐标。
```text
02C0 GET_CLOSEST_CHAR_NODE
in: x, y, z
out: nodeX, nodeY, nodeZ
```
```lua
local nodeX, nodeY, nodeZ = getClosestCharNode(x, y, z)
```
```js
const { nodeX, nodeY, nodeZ } = Path.getClosestCharNode(x, y, z)
```
## 最近车节点
最近可驶车节点坐标。
```text
02C1 GET_CLOSEST_CAR_NODE
in: x, y, z
out: nodeX, nodeY, nodeZ
```
```lua
local nodeX, nodeY, nodeZ = getClosestCarNode(x, y, z)
```
```js
const { nodeX, nodeY, nodeZ } = Path.getClosestCarNode(x, y, z)
```
## 车节点 + 朝向
最近车节点 + 朝向。
```text
03D3 GET_CLOSEST_CAR_NODE_WITH_HEADING
in: x, y, z
out: nodeX, nodeY, nodeZ, angle
```
```lua
local nodeX, nodeY, nodeZ, angle = getClosestCarNodeWithHeading(x, y, z)
```
```js
const { nodeX, nodeY, nodeZ, angle } = Path.getClosestCarNodeWithHeading(x, y, z)
```
## 最近直线路
距离范围内最近直线路段两端点与朝向。
```text
04B9 GET_CLOSEST_STRAIGHT_ROAD
in: x, y, z, minDist, maxDist
out: node1X, node1Y, node1Z, node2X, node2Y, node2Z, angle
```
```lua
local node1X, node1Y, node1Z, node2X, node2Y, node2Z, angle = getClosestStraightRoad(x, y, z, minDist, maxDist)
```
```js
const { node1X, node1Y, node1Z, node2X, node2Y, node2Z, angle } = Path.getClosestStraightRoad(x, y, z, minDist, maxDist)
```
## 第 n 车节点
第 n 近的车节点。
```text
04D3 GET_NTH_CLOSEST_CAR_NODE
in: fromX, fromY, fromZ, n
out: x, y, z
```
```lua
local x, y, z = getNthClosestCarNode(fromX, fromY, fromZ, n)
```
```js
const { x, y, z } = Path.getNthClosestCarNode(fromX, fromY, fromZ, n)
```
## 清空任务路线
清空任务路线点。
```text
05D6 FLUSH_ROUTE
```
```lua
flushRoute()
```
```js
Path.flushRoute()
```
## 加任务路线点
给任务路线加点。
```text
05D7 EXTEND_ROUTE
in: x, y, z
```
```lua
extendRoute(x, y, z)
```
```js
Path.extendRoute(x, y, z)
```
## 加载区节点
加载区路径节点（脚本车可避此区一类用途）。
```text
0606 LOAD_PATH_NODES_IN_AREA
in: leftBottomX, leftBottomY, rightTopX, rightTopY
```
```lua
loadPathNodesInArea(leftBottomX, leftBottomY, rightTopX, rightTopY)
```
```js
Path.loadPathNodesInArea(leftBottomX, leftBottomY, rightTopX, rightTopY)
```
## 释放节点
释放 `0606` 相关限制 / 节点。
```text
0607 RELEASE_PATH_NODES
```
```lua
releasePathNodes()
```
```js
Path.releaseNodes()
```
## 第 n 车节点 + 朝向
第 n 近车节点 + 朝向。
```text
06F8 GET_NTH_CLOSEST_CAR_NODE_WITH_HEADING
in: xCoord, yCoord, zCoord, nth
out: x, y, z, heading
```
```lua
local x, y, z, heading = getNthClosestCarNodeWithHeading(xCoord, yCoord, zCoord, nth)
```
```js
const { x, y, z, heading } = Path.getNthClosestCarNodeWithHeading(xCoord, yCoord, zCoord, nth)
```
## 清空巡逻
清空巡逻路线，准备 `0755` 重建。
```text
0754 FLUSH_PATROL_ROUTE
```
```lua
flushPatrolRoute()
```
```js
Path.flushPatrolRoute()
```
## 加巡逻点
巡逻路线加点（可带动画）。
```text
0755 EXTEND_PATROL_ROUTE
in: x, y, z, animationName, animationFile
```
```lua
extendPatrolRoute(x, y, z, animationName, animationFile)
```
```js
Path.extendPatrolRoute(x, y, z, animationName, animationFile)
```
## 车路恢复
盒内车路恢复 `01E7` / `01E8` 改动前。
```text
091D SWITCH_ROADS_BACK_TO_ORIGINAL
in: leftBottomX, leftBottomY, leftBottomZ, rightTopX, rightTopY, rightTopZ
```
```lua
switchRoadsBackToOriginal(leftBottomX, leftBottomY, leftBottomZ, rightTopX, rightTopY, rightTopZ)
```
```js
Path.switchRoadsBackToOriginal(leftBottomX, leftBottomY, leftBottomZ, rightTopX, rightTopY, rightTopZ)
```
## 人路恢复
盒内人路恢复 `022A` / `022B` 改动前。
```text
091E SWITCH_PED_ROADS_BACK_TO_ORIGINAL
in: leftBottomX, leftBottomY, leftBottomZ, rightTopX, rightTopY, rightTopZ
```
```lua
switchPedRoadsBackToOriginal(leftBottomX, leftBottomY, leftBottomZ, rightTopX, rightTopY, rightTopZ)
```
```js
Path.switchPedRoadsBackToOriginal(leftBottomX, leftBottomY, leftBottomZ, rightTopX, rightTopY, rightTopZ)
```
## 禁止闲逛节点
标记节点禁止闲逛路过。
```text
0994 MARK_ROAD_NODE_AS_DONT_WANDER
in: x, y, z
```
```lua
markRoadNodeAsDontWander(x, y, z)
```
```js
Path.markRoadNodeAsDontWander(x, y, z)
```
## 清禁止闲逛
清除全部「禁止闲逛」节点标记。
```text
0995 UNMARK_ALL_ROAD_NODES_AS_DONT_WANDER
```
```lua
unmarkAllRoadNodesAsDontWander()
```
```js
Path.unmarkAllRoadNodesAsDontWander()
```