egret-docs-master/Lakeshore/manual/module/sound/README.md

71 lines
1.9 KiB
Markdown
Raw Permalink Normal View History

2024-06-19 13:32:32 +08:00
![](564af1ef17212.png)
声音组件用来给游戏中添加声音效果。
### 特有属性
![](564af1eecf6a9.png)
- 文件路径:指定声音文件所在位置。
- 循环次数设置声音的循环次数。默认为1次。设置为0的话表示无限次循环。
- 音量设置声音音量。默认为1表示100%。
*注:声音组件除“名称”外,不支持基本属性,不支持碰撞,添加后也不会在游戏运行场景中产生可见实例。
------------
### 声音条件
声音组件只支持其特有条件,不支持通用条件。
![](564af1eee846a.png)
#### 当静音时
当处于静音状态时。【持续性触发】
此条件无属性设置窗口。
#### 当有声音播放
当有任意声音处于播放状态时。【持续性触发】
此条件无属性设置窗口。
#### 当指定声音播放时
当指定的声音正在播放时。【持续性触发】
在文件地址输入框设置指定声音的位置。
![](564af1ef06d2f.png)
#### 当声音放完
当声音播放完毕时。【一次性触发】
此条件无属性设置窗口。
------------
### 声音动作
声音组件只支持其特有动作,不支持通用动作。
![](564af1ee25028.png)
#### 播放
播放指定声音。
- 文件路径:指定要播放的文件的路径。
- 循环次数设置循环次数。默认为0表示无限次循环。
- 音量大小设置音量大小。默认为1表示100%。
![](564af1ee4db9a.png)
#### 停止指定声音
停止指定声音的播放。
![](564af1ee7497d.png)
#### 停止所有声音
停止所有声音的播放。
此动作无属性设置窗口。
#### 循环
设置指定声音是否循环播放。
![](564af1ee84f3e.png)
#### 主音量
设置整体音量。
![](564af1eeb692a.png)
#### 指定声音音量
设置指定声音的音量。
![](564af1eea5afe.png)
#### 静音
设置指定声音为静音。
![](564af1ee66b4f.png)
#### 暂停
暂停播放指定声音。
![](564af1ee98d40.png)