SoundUnit

3D 空间音效。可通过 World:CreateUnit("SoundUnit", {...}) 创建，字段属性可直接读写。

概览

声音播放单位，在地图中负责播放音频资源。通过 SoundId 指定要播放的声音，并可调整音量、播放速率、循环方式与衰减距离。支持自动播放（Playing）与手动控制播放状态，是场景内音效与背景音乐的基本载体。

继承自 Unit；可通过 World:CreateUnit("SoundUnit", ...) 创建；返回单位数组

属性

名称	类型	默认值	说明
SoundId	String	-	指定该音效所使用的音效资源标识，通过资源标识确定实际播放的音频内容。
Speed	Float	-	表示音效的播放速率，用于调整音效播放的快慢。
Volume	Float	-	表示音效的音量大小，用于控制声音的强弱。
Duration	Float	-	表示音效的持续时间，单位为秒，用于控制该音效从开始到结束的播放时长。
FadeDistance	Float	-	表示音效的衰减距离，用于描述音效在空间中传播时的可听范围边界。
Playing	Bool	-	表示音效是否自动播放，为布尔类型。
Looped	Bool	-	控制音效是否循环播放，为布尔类型。