---
title: "过场 Cutscene"
description: "过场加载 / 播放 / 偏移"
---
---
title: 过场 Cutscene
description: 过场加载 / 播放 / 偏移
---
`sa` · 扩展 `default` · SCM 原生命令
共 10 条。写法见 [Lua](/docs/cleo/syntax) / [Redux](/docs/cleo/syntax-redux)。
## 设偏移
设过场偏移原点。
```text
0244 SET_CUTSCENE_OFFSET
in: x, y, z
```
```lua
setCutsceneOffset(x, y, z)
```
```js
Cutscene.setOffset(x, y, z)
```
## 加载
加载指定过场数据。
```text
02E4 LOAD_CUTSCENE
in: name
```
```lua
loadCutscene(name)
```
```js
Cutscene.load(name)
```
## 开始
开始播放已加载过场（`02E4`）。
```text
02E7 START_CUTSCENE
```
```lua
startCutscene()
```
```js
Cutscene.start()
```
## 播放时间
过场开始后经过的毫秒数。
```text
02E8 GET_CUTSCENE_TIME
out: time
```
```lua
local t = getCutsceneTime()
```
```js
const time = Cutscene.getTime()
```
## 是否播完
过场是否播完。用在 `if` 里。
```text
02E9 HAS_CUTSCENE_FINISHED
```
```lua
if hasCutsceneFinished() then
end
```
```js
if (Cutscene.hasFinished()) {
}
```
## 清除
结束当前过场并释放内存。
```text
02EA CLEAR_CUTSCENE
```
```lua
clearCutscene()
```
```js
Cutscene.clear()
```
## 是否跳过
玩家是否跳过了过场。用在 `if` 里。
```text
056A WAS_CUTSCENE_SKIPPED
```
```lua
if wasCutsceneSkipped() then
end
```
```js
if (Cutscene.wasSkipped()) {
}
```
## 是否加载完
过场数据是否加载完成。用在 `if` 里。
```text
06B9 HAS_CUTSCENE_LOADED
```
```lua
if hasCutsceneLoaded() then
end
```
```js
if (Cutscene.hasLoaded()) {
}
```
## 取偏移
取当前已加载过场的偏移。
```text
08D1 GET_CUTSCENE_OFFSET
out: xOffset, yOffset, zOffset
```
```lua
local x, y, z = getCutsceneOffset()
```
```js
const { xOffset, yOffset, zOffset } = Cutscene.getOffset()
```
## 追加到下一过场
把物体名 / 动画名追加到下一过场。
```text
08F0 APPEND_TO_NEXT_CUTSCENE
in: objectName, animName
```
```lua
appendToNextCutscene(objectName, animName)
```
```js
Cutscene.appendToNext(objectName, animName)
```