---
title: "探照灯 Searchlight"
description: "探照灯"
---
---
title: 探照灯 Searchlight
description: 探照灯
---
`sa` · 扩展 `default` · SCM 原生命令
共 13 条。写法见 [Lua](/docs/cleo/syntax) / [Redux](/docs/cleo/syntax-redux)。
## 创建
创建探照灯（源点、指向点、两半径）。
```text
06B1 CREATE_SEARCHLIGHT
in: x, y, z, xPoint, yPoint, zPoint, radius, radiusPoint
out: handle
```
```lua
local handle = createSearchlight(x, y, z, xPoint, yPoint, zPoint, radius, radiusPoint)
```
```js
const handle = Searchlight.create(x, y, z, xPoint, yPoint, zPoint, radius, radiusPoint)
```
## 删除
删除探照灯。
```text
06B2 DELETE_SEARCHLIGHT
in: self
```
```lua
deleteSearchlight(self)
```
```js
Searchlight.delete(self)
```
## 是否存在
handle 是否有效探照灯。用在 `if` 里。
```text
06B3 DOES_SEARCHLIGHT_EXIST
in: handle
```
```lua
if doesSearchlightExist(handle) then
end
```
```js
if (Searchlight.doesExist(handle)) {
}
```
## 两点往返
光束在两点间往返移动。
```text
06B4 MOVE_SEARCHLIGHT_BETWEEN_COORDS
in: self, fromX, fromY, fromZ, toX, toY, toZ, speed
```
```lua
moveSearchlightBetweenCoords(self, fromX, fromY, fromZ, toX, toY, toZ, speed)
```
```js
Searchlight.moveBetweenCoords(self, fromX, fromY, fromZ, toX, toY, toZ, speed)
```
## 指向坐标
光束移向坐标。
```text
06B5 POINT_SEARCHLIGHT_AT_COORD
in: self, x, y, z, speed
```
```lua
pointSearchlightAtCoord(self, x, y, z, speed)
```
```js
Searchlight.pointAtCoord(self, x, y, z, speed)
```
## 指向角色
光束跟随角色。
```text
06B6 POINT_SEARCHLIGHT_AT_CHAR
in: self, handle, speed
```
```lua
pointSearchlightAtChar(self, handle, speed)
```
```js
Searchlight.pointAtChar(self, handle, speed)
```
## 照到角色
是否照到该角色。用在 `if` 里。
```text
06B7 IS_CHAR_IN_SEARCHLIGHT
in: self, handle
```
```lua
if isCharInSearchlight(self, handle) then
end
```
```js
if (Searchlight.isCharIn(self, handle)) {
}
```
## 指向载具
光束跟随载具。
```text
06BF POINT_SEARCHLIGHT_AT_VEHICLE
in: self, handle, speed
```
```lua
pointSearchlightAtVehicle(self, handle, speed)
```
```js
Searchlight.pointAtVehicle(self, handle, speed)
```
## 照到载具
是否照到该载具。用在 `if` 里。
```text
06C0 IS_VEHICLE_IN_SEARCHLIGHT
in: self, handle
```
```lua
if isVehicleInSearchlight(self, handle) then
end
```
```js
if (Searchlight.isVehicleIn(self, handle)) {
}
```
## 车上创建
在车上挂探照锥，指向某点。
```text
06C1 CREATE_SEARCHLIGHT_ON_VEHICLE
in: vehicle, xOffset, yOffset, zOffset, xPoint, yPoint, zPoint, pointRadius, radius
out: handle
```
```lua
local handle = createSearchlightOnVehicle(vehicle, xOffset, yOffset, zOffset, xPoint, yPoint, zPoint, pointRadius, radius)
```
```js
const handle = Searchlight.createOnVehicle(vehicle, xOffset, yOffset, zOffset, xPoint, yPoint, zPoint, pointRadius, radius)
```
## 绑物体
绑到塔 / 罩 / 灯泡物体上。
```text
06CA ATTACH_SEARCHLIGHT_TO_SEARCHLIGHT_OBJECT
in: self, spotTower, spotHousing, spotBulb, xOffset, yOffset, zOffset
```
```lua
attachSearchlightToSearchlightObject(self, spotTower, spotHousing, spotBulb, xOffset, yOffset, zOffset)
```
```js
Searchlight.attachToObject(self, spotTower, spotHousing, spotBulb, xOffset, yOffset, zOffset)
```
## 碰撞裁剪
撞到物体是否裁剪光束。
```text
0941 SET_SEARCHLIGHT_CLIP_IF_COLLIDING
in: self, state
```
```lua
setSearchlightClipIfColliding(self, state)
```
```js
Searchlight.setClipIfColliding(self, state)
```
## 地面阴影
照射面是否显示地面阴影效果。
```text
0A02 SWITCH_ON_GROUND_SEARCHLIGHT
in: self, state
```
```lua
switchOnGroundSearchlight(self, state)
```
```js
Searchlight.switchOnGround(self, state)
```