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

71 lines
1.9 KiB
Markdown
Raw Permalink Blame History

This file contains ambiguous Unicode characters!

This file contains ambiguous Unicode characters that may be confused with others in your current locale. If your use case is intentional and legitimate, you can safely ignore this warning. Use the Escape button to highlight these characters.

![](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)