# sys.audioVolume.session 库模块帮助文档

## sys.audioVolume 成员列表 <a id="sys.audioVolume" href="#sys.audioVolume">&#x23;</a>

### sys.audioVolume.session <a id="sys.audioVolume.session" href="#sys.audioVolume.session">&#x23;</a>
本进程在默认播放设备上的音频会话（Windows 音量合成器中的应用音量）。  
控制当前进程的应用音量请改用 sys.audioVolume.session  
waveOut、BASS 等本进程的声音输出都经过这个会话。

### sys.audioVolume.session() <a id="sys.audioVolume.session" href="#sys.audioVolume.session">&#x23;</a>
[返回对象:sysAudioVolumeSessionObject](#sysAudioVolumeSessionObject)

### sys.audioVolume.session(volume,mute) <a id="sys.audioVolume.session" href="#sys.audioVolume.session">&#x23;</a>
读取或设置本进程的音频会话。  
无参数仅读取；参数 @1 指定 0..1 的音量，参数 @2 指定是否静音，null 表示不修改。  
成功返回 { volume=0..1; mute=布尔; audible=未静音且音量大于 0 }，失败返回 null,错误信息。  
注意：Windows 按 EXE 路径记住应用音量；WMPlayer.OCX 的 settings.volume / settings.mute 直接写入本会话并被记住，  
之后所有同路径进程内的声音输出都会受影响。修改前请确认这是用户的意图。

## sysAudioVolumeSessionObject 成员列表 <a id="sysAudioVolumeSessionObject" href="#sysAudioVolumeSessionObject">&#x23;</a>

### sysAudioVolumeSessionObject.audible <a id="sysAudioVolumeSessionObject.audible" href="#sysAudioVolumeSessionObject.audible">&#x23;</a>
未静音且音量大于 0

### sysAudioVolumeSessionObject.mute <a id="sysAudioVolumeSessionObject.mute" href="#sysAudioVolumeSessionObject.mute">&#x23;</a>
本进程音频会话是否静音

### sysAudioVolumeSessionObject.volume <a id="sysAudioVolumeSessionObject.volume" href="#sysAudioVolumeSessionObject.volume">&#x23;</a>
本进程音频会话音量，0..1