meta data for this page
  •  

📚 差别

这里会显示出您选择的修订版和当前版本之间的差别。

到此差别页面的链接

两侧同时换到之前的修订记录前一修订版
后一修订版		前一修订版
scripting:client:audio [2025/08/02 23:22] – bibiboxsscripting:client:audio [2026/04/19 18:24] (当前版本) – bibiboxs
行 27: 行 27:
 ## World Audio ## World Audio
  
-为了丰富World端的开发实用性，[World/Player](scripting/world/player)增加了类似`player.PlaySound()`等方法映射*（为某个联机玩家单独播放声音\音乐等）*，这些方法的参数及用法与本文档内容基本一致，唯一的区别是可以从World脚本直接为某个玩家播放\停止声音。+为了丰富World端的开发实用性，[World/Player](scripting/world/player)增加了类似`player.PlaySound()`等方法映射*（为联机玩家单独播放声音\音乐等）*，这些方法的参数及用法与本文档内容基本一致，唯一的区别是可以从World脚本直接为某个玩家播放\停止声音。
  
 需要注意的是，由于World端的服务器同步性，绝大多数**World端**下的音频控制并不能取得返回数据，这就导致World端音频控制更多只能【播放、暂停、继续、停止】（而不能直接：获取音量、检查声音是否正在播放等），从而并不能完全使用`Client/Audio`下的所有功能。 需要注意的是，由于World端的服务器同步性，绝大多数**World端**下的音频控制并不能取得返回数据，这就导致World端音频控制更多只能【播放、暂停、继续、停止】（而不能直接：获取音量、检查声音是否正在播放等），从而并不能完全使用`Client/Audio`下的所有功能。
行 34: 行 34:
  
 如有实际的更多特殊需求，可以考虑使用【自定义函数\数据传输】的方式来扩展。 如有实际的更多特殊需求，可以考虑使用【自定义函数\数据传输】的方式来扩展。
 +
 +
 +
 +## Property
 +
 +### Audio.Volume
 +
 +> 获取（只读）游戏**全局音量**（`0~100`）。
 +>
 +> **==游戏音量数值是不允许通过代码修改的（只读），游戏音量完全遵循【玩家设置界面】的设定数值。==**
 +
 +```javascript
 +Audio.Volume: int
 +```
 +
 +
 +### Audio.SoundVolume
 +
 +> 获取（只读）游戏**音效类音量**（`0~100`）。
 +
 +```javascript
 +Audio.SoundVolume: int
 +```
 +
 +
 +
 +### Audio.MusicVolume
 +
 +> 获取（只读）游戏**音乐音量**（`0~100`）。
 +
 +```javascript
 +Audio.MusicVolume: int
 +```
 +
 +
 +
 +### Audio.NaturalVolume
 +
 +> 获取（只读）游戏**自然类音量**（`0~100`）。
 +
 +```javascript
 +Audio.NaturalVolume: int
 +```
 +
 +
 +
 +### Audio.ReverbInternal
 +
 +> 设置游戏**声音混响效果**（建筑内部），默认为`3`（房间）。
 +>
 +> 枚举索引参考[《AudioReverbPreset》](https://docs.unity.cn/cn/current/ScriptReference/AudioReverbPreset.html "《AudioReverbPreset》")。
 +
 +```javascript
 +Audio.ReverbInternal = 3;
 +```
 +
 +
 +
 +### Audio.ReverbExternal
 +
 +> 设置游戏**声音混响效果**（建筑外部），默认为`16`（森林）。
 +>
 +> 枚举索引参考[《AudioReverbPreset》](https://docs.unity.cn/cn/current/ScriptReference/AudioReverbPreset.html "《AudioReverbPreset》")。
 +
 +```javascript
 +Audio.ReverbExternal = 16；
 +```
 +
 +
 +
 +### Audio.DryLevel
 +
 +> 设置游戏**干声等级**，范围限制`-10000.0~0.0`，默认为`0.0`。
 +>
 +> 此数值设置越低，可听到的细节越模糊（类似水下效果，但水下时不会受到此值影响）。
 +
 +```javascript
 +Audio.DryLevel = 0；
 +```
  
  
行 326: 行 405:
 ``` ```
  
- 
- 
-### Audio.GetTotalVolume() 
- 
-> 获取全局游戏音量`1~100`（只读）。 
-> 
-> **==游戏音量数值是不允许通过代码修改的（只读），游戏音量完全遵循【玩家设置界面】的设定数值。==** 
- 
-```javascript 
-function Audio.GetTotalVolume(): int 
-``` 
- 
- 
- 
-### Audio.GetSoundVolume() 
- 
-> 获取游戏音效音量（通过`PlaySound`）`1~100`（只读）。 
- 
-```javascript 
-function Audio.GetSoundVolume(): int 
-``` 
- 
- 
- 
-### Audio.GetMusicVolume() 
- 
-> 获取游戏音乐音量（通过`PlayMusic`）`1~100`（只读）。 
- 
-```javascript 
-function Audio.GetMusicVolume(): int 
-``` 
- 
- 
- 
-### Audio.GetNaturalVolume() 
- 
-> 获取游戏音效（通过`PlayNatural`）音量`1~100`（只读）。 
- 
-```javascript 
-function Audio.GetNaturalVolume(): int 
-``` 
- 
- 
- 
-### Audio.SetAudioReverbInternal() 
- 
-> 设置游戏**声音混响效果**（建筑内部）。 
- 
-```javascript 
-function Audio.SetAudioReverbInternal( type: int ) 
-``` 
- 
- 
- 
-### Audio.GetAudioReverbInternal() 
- 
-> 设置游戏**声音混响效果**（建筑内部）。 
- 
-```javascript 
-function Audio.GetAudioReverbInternal(): int 
-``` 
- 
- 
- 
-### Audio.SetAudioReverbExternal() 
- 
-> 设置游戏**声音混响效果**（建筑外部）。 
- 
-```javascript 
-function Audio.SetAudioReverbExternal( type: int ) 
-``` 
- 
- 
- 
-### Audio.GetAudioReverbExternal() 
- 
-> 设置游戏**声音混响效果**（建筑外部）。 
- 
-```javascript 
-function Audio.GetAudioReverbExternal(): int 
-```