Audio

音频

 控制本地音频音效播放

---

枚举列表

Audio.TARGET_TYPE

• 描述: 目标类型

成员名称	成员说明
Character	角色
Creature	生物
Element	元件

Audio.ATT_MODE

• 描述: 衰减模式

成员名称	成员说明
None	无
Linear	线性
BrickWall	断崖
CloseDrop	近处快速
FarDrop	远处快速

---

函数列表

PlaySFXAudio3DInTarget

• 描述: 播放一个指定音效，音效需挂载在角色，生物，元件对象上。

• 范围: 客户端

参数列表:

参数	类型	说明
AudioId	number	音效Id
TargetType	Audio.TARGET_TYPE	目标类型
TargetId	number	目标id
Distance	number	传播距离
AttenuationMode	Audio.ATT_MODE	衰减模式
Duration	number	播放持续时间，单位s，默认为0。
Volume	number	音量大小，最小值为0，最大值为100，默认为0。
Tune	number	音效变调，最小值为-48，最大值为48，默认为0。

返回字段:

返回字段	字段类型	说明
playId	number	播放音效id，-1表示播放失败

local AudioId = 700001
local TargetType = Audio.TARGET_TYPE.Element
local TargetID = 262
--如果在角色身上播放修改 TargetType = Audio.TARGET_TYPE.Character TargetID = 610140737498231334(玩家id)
local Volume = 100
local Duration = 4
local AttenuationMode = Audio.ATT_MODE.Linear
local Distance = 50
local Tune = 0
local playId = Audio:PlaySFXAudio3DInTarget(AudioId, TargetType, TargetID, Distance, AttenuationMode, Duration, Volume, Tune)

---

PlaySFXAudio2D

• 描述: 播放一个指定2D音效。

• 范围: 客户端

参数列表:

参数	类型	说明
AudioId	number	音效Id
Duration	number	播放持续时间，单位s，默认为0。
Volume	number	音量大小，最小值为0，最大值为100，默认为0。
Tune	number	音效变调，最小值为-48，最大值为48，默认为0。

返回字段:

返回字段	字段类型	说明
playId	number	播放音效id，-1表示播放失败

local AudioId = 700001
local Duration = 4
local Volume = 100
local Tune = 0
local playId = Audio:PlaySFXAudio2D(AudioId, Duration, Volume, Tune)

---

StopSFXAudio

• 描述: 停止播放音效。

• 范围: 客户端

参数列表:

参数	类型	说明
PlayId	number	调用播放接口时返回的Id

Audio:StopSFXAudio(PlayId)

---