SpatialAudioParams
- C++
更新时间
配置空间音频参数。
struct SpatialAudioParams {
Optional<double> speaker_azimuth;
Optional<double> speaker_elevation;
Optional<double> speaker_distance;
Optional<int> speaker_orientation;
Optional<bool> enable_blur;
Optional<bool> enable_air_absorb;
Optional<double> speaker_attenuation;
Optional<bool> enable_doppler;
};属性
| 参数名 | 描述 |
|---|---|
speaker_azimuth | 远端用户或媒体播放器相对于本地用户的方位角,单位为度,取值范围为 [0, 360]。
|
speaker_elevation | 远端用户或媒体播放器相对于本地用户的仰角,单位为度,取值范围为 [-90, 90]。
|
speaker_distance | 远端用户或媒体播放器相对于本地用户的距离,单位为米,取值范围为 [1, 50]。默认值为 1 米。 |
speaker_orientation | 远端用户或媒体播放器相对于本地用户的朝向角,单位为度,取值范围为 [0, 180]。
|
enable_blur | 是否开启音频模糊处理:
|
enable_air_absorb | 是否开启空气吸收效果,用于模拟声音在空气中传播时的衰减特性。在一定传播距离下,高频声音衰减较快,低频声音衰减较慢。
|
speaker_attenuation | 远端用户或媒体播放器的声音衰减系数,取值范围为 [0, 1]。
|
enable_doppler | 注: 该参数适用于声源高速移动的场景(例如赛车游戏)。不推荐在常见的音视频互动场景中使用(例如语音聊天、连麦或在线 KTV)。启用该参数后,建议以固定周期(如 30 毫秒)调用 updatePlayerPositionInfo、updateSelfPosition 和 updateRemotePosition 方法,持续更新声源与接收者之间的相对距离。以下因素可能导致多普勒效应不可预测或声音抖动:更新周期过长、更新周期不规律,或因网络丢包或延迟导致距离信息丢失。 是否开启多普勒效应:当声源与接收者之间存在相对位移时,接收者听到的音调会发生变化。
|