文档中心

实时音视频

请输入

音频管理

空间音频

空间音频是一种能模拟声音方位感的技术。在游戏或虚拟会议中，启用此功能能让用户通过声音判断其他成员的方位。开启前，所有声音都像在耳边；开启后，用户能清晰分辨出声音来自左前方还是右后方，实现 “听声辨位” 的沉浸感。

适用场景

空间音频适用于需要听声辨位场景，例如：

实现方式

前提条件

启用空间音频

在音视频通信中，各端需协同调用接口以实时更新位置信息。

说明

若配合范围语音功能使用，请确保空间音频与范围语音传入的坐标信息一致。

调用 updateRemotePosition 设置房间内某一远端用户在本地用户自建的空间音频坐标系中的发声位置和发声朝向。你可以多次调用此接口，实时更新位置和朝向。

（可选）若只需要感知发言人的距离，不需要感知朝向（如会议场景中），可调用 disableRemoteOrientation 关闭本地用户朝向对本地用户发声效果的影响。同一房间中，各用户的这项设置通常应保持一致。

API 参考

功能	Android	iOS	macOS	Windows
获取空间音频接口实例	getSpatialAudio	getSpatialAudio	getSpatialAudio	getSpatialAudio
开启/关闭空间音频功能	enableSpatialAudio	enableSpatialAudio	enableSpatialAudio	enableSpatialAudio
设置本地用户在自建空间直角坐标系中的坐标和朝向	updateSelfPosition	updateSelfPosition	updateSelfPosition	updateSelfPosition
设置房间内某一远端用户在本地用户自建的空间音频坐标系中的发声位置和发声朝向	updateRemotePosition	updateRemotePosition	updateRemotePosition	updateRemotePosition
移除为某一远端用户设置的空间音频效果	removeRemotePosition	removeRemotePosition	removeRemotePosition	removeRemotePosition
移除为所有远端用户设置的空间音频效果	removeAllRemotePosition	removeAllRemotePosition	removeAllRemotePosition	removeAllRemotePosition
关闭本地用户朝向对本地用户发声效果的影响	disableRemoteOrientation	disableRemoteOrientation	disableRemoteOrientation	disableRemoteOrientation

功能变更日志

变更详情	功能模块	变动前方法	变动后方法
合并	高级功能	updatePosition updateSelfOrientation	updateSelfPosition
合并	高级功能			updateListenerPosition updateListenerOrientation	updateRemotePosition

最近更新时间：2026.09.21 16:24:28

这个页面对您有帮助吗？

有用

无用