---
title: "音频 Audio"
description: "任务语音 / 电台 / 节拍轨"
---
---
title: 音频 Audio
description: 任务语音 / 电台 / 节拍轨
---
`sa` · 扩展 `default` · SCM 原生命令
共 24 条。写法见 [Lua](/docs/cleo/syntax) / [Redux](/docs/cleo/syntax-redux)。
## 通关曲
播放 Audio 目录下指定 ID 通关曲。
```text
0394 PLAY_MISSION_PASSED_TUNE
in: soundId
```
```lua
playMissionPassedTune(soundId)
```
```js
Audio.playMissionPassedTune(soundId)
```
## 加载任务语音
加载任务语音槽。
```text
03CF LOAD_MISSION_AUDIO
in: slotId, audioId
```
```lua
loadMissionAudio(slotId, audioId)
```
```js
Audio.loadMissionAudio(slotId, audioId)
```
## 语音是否加载完
`03CF` 是否加载完。用在 `if` 里。
```text
03D0 HAS_MISSION_AUDIO_LOADED
in: slotId
```
```lua
if hasMissionAudioLoaded(slotId) then
end
```
```js
if (Audio.hasMissionAudioLoaded(slotId)) {
}
```
## 播放任务语音
播放已加载任务语音。
```text
03D1 PLAY_MISSION_AUDIO
in: slotId
```
```lua
playMissionAudio(slotId)
```
```js
Audio.playMissionAudio(slotId)
```
## 语音是否播完
该槽语音是否播完。用在 `if` 里。
```text
03D2 HAS_MISSION_AUDIO_FINISHED
in: slotId
```
```lua
if hasMissionAudioFinished(slotId) then
end
```
```js
if (Audio.hasMissionAudioFinished(slotId)) {
}
```
## 语音位置
设任务语音听感位置。
```text
03D7 SET_MISSION_AUDIO_POSITION
in: slotId, x, y, z
```
```lua
setMissionAudioPosition(slotId, x, y, z)
```
```js
Audio.setMissionAudioPosition(slotId, x, y, z)
```
## 清语音槽
卸载槽语音，腾内存。
```text
040D CLEAR_MISSION_AUDIO
in: slotId
```
```lua
clearMissionAudio(slotId)
```
```js
Audio.clearMissionAudio(slotId)
```
## 设电台
在车内时设电台。
```text
041E SET_RADIO_CHANNEL
in: channel
```
```lua
setRadioChannel(channel)
```
```js
Audio.setRadioChannel(channel)
```
## 音乐淡入淡出
音乐是否随画面淡入淡出。
```text
043C SET_MUSIC_DOES_FADE
in: state
```
```lua
setMusicDoesFade(state)
```
```js
Audio.setMusicDoesFade(state)
```
## 取电台
当前电台。
```text
051E GET_RADIO_CHANNEL
out: channel
```
```lua
local channel = getRadioChannel()
```
```js
const channel = Audio.getRadioChannel()
```
## 节拍邻近
相对当前节拍轨（`0954`）的拍点信息。
```text
07B1 GET_BEAT_PROXIMITY
in: offset
out: beatTime, beatType, beatIndex
```
```lua
local beatTime, beatType, beatIndex = getBeatProximity(offset)
```
```js
const { beatTime, beatType, beatIndex } = Audio.getBeatProximity(offset)
```
## 语音绑角色
任务语音绑在角色位置。
```text
0949 ATTACH_MISSION_AUDIO_TO_CHAR
in: slotId, handle
```
```lua
attachMissionAudioToChar(slotId, handle)
```
```js
Audio.attachMissionAudioToChar(slotId, handle)
```
## 预载节拍轨
预载 streams/BEATS 里的曲目。
```text
0952 PRELOAD_BEAT_TRACK
in: trackId
```
```lua
preloadBeatTrack(trackId)
```
```js
Audio.preloadBeatTrack(trackId)
```
## 节拍轨状态
当前节拍轨状态。
```text
0953 GET_BEAT_TRACK_STATUS
out: status
```
```lua
local status = getBeatTrackStatus()
```
```js
const status = Audio.getBeatTrackStatus()
```
## 播放节拍轨
播放 `0952` 预载的曲。
```text
0954 PLAY_BEAT_TRACK
```
```lua
playBeatTrack()
```
```js
Audio.playBeatTrack()
```
## 停节拍轨
停当前节拍轨。
```text
0955 STOP_BEAT_TRACK
```
```lua
stopBeatTrack()
```
```js
Audio.stopBeatTrack()
```
## 坐标音频事件
在坐标触发任务音频事件。
```text
097A REPORT_MISSION_AUDIO_EVENT_AT_POSITION
in: x, y, z, soundId
```
```lua
reportMissionAudioEventAtPosition(x, y, z, soundId)
```
```js
Audio.reportMissionAudioEventAtPosition(x, y, z, soundId)
```
## 物体音频事件
在物体处触发任务音频事件。
```text
097B REPORT_MISSION_AUDIO_EVENT_AT_OBJECT
in: handle, soundId
```
```lua
reportMissionAudioEventAtObject(handle, soundId)
```
```js
Audio.reportMissionAudioEventAtObject(handle, soundId)
```
## 语音绑物体
任务语音绑在物体上。
```text
097C ATTACH_MISSION_AUDIO_TO_OBJECT
in: slotId, handle
```
```lua
attachMissionAudioToObject(slotId, handle)
```
```js
Audio.attachMissionAudioToObject(slotId, handle)
```
## 暂停节拍轨
暂停 / 恢复节拍轨。
```text
0991 PAUSE_CURRENT_BEAT_TRACK
in: state
```
```lua
pauseCurrentBeatTrack(state)
```
```js
Audio.pauseCurrentBeatTrack(state)
```
## 角色音频事件
在角色处触发任务音频事件。
```text
09F1 REPORT_MISSION_AUDIO_EVENT_AT_CHAR
in: handle, soundId
```
```lua
reportMissionAudioEventAtChar(handle, soundId)
```
```js
Audio.reportMissionAudioEventAtChar(handle, soundId)
```
## 车音频事件
在车处触发任务音频事件。
```text
09F7 REPORT_MISSION_AUDIO_EVENT_AT_CAR
in: handle, soundId
```
```lua
reportMissionAudioEventAtCar(handle, soundId)
```
```js
Audio.reportMissionAudioEventAtCar(handle, soundId)
```
## 语音绑车
任务语音绑在车上。
```text
0A16 ATTACH_MISSION_AUDIO_TO_CAR
in: slotId, handle
```
```lua
attachMissionAudioToCar(slotId, handle)
```
```js
Audio.attachMissionAudioToCar(slotId, handle)
```
## 最爱电台
当前车电台切到玩家最爱台（统计 326）。
```text
0A26 SET_RADIO_TO_PLAYERS_FAVOURITE_STATION
```
```lua
setRadioToPlayersFavouriteStation()
```
```js
Audio.setRadioToPlayersFavouriteStation()
```