@detail api
@author luomingkang.264
@brief Turn off the effect of the orientation of the local user as the sound source.
After the effect is off, all the other users in the room listen to the local user as if the local user is in right front of each of them.
@note
- After the orientation effect as the sound source is disabled, you cannot enable it during the lifetime of the SpatialAudio instance.
- Calling this API does not affect the orientation effect of the local user as a listener. See updateSelfPosition{@link #ISpatialAudio#updateSelfPosition} and updateRemotePosition{@link #ISpatialAudio#updateRemotePosition}.
@detail api
@author majun.lvhiei
@brief Enable/disable spatial audio function.
@param enable Whether to enable spatial audio function:
- true：Enable
- false：Disable(Default setting)
@note You need to call updateSelfPosition{@link #ISpatialAudio#updateSelfPosition} as well to really enjoy the spatial audio effect.
@valid since 3.52
@detail api
@author wangjunzheng
@brief Disables all spatial audio effects set by calling updateRemotePosition{@link #ISpatialAudio#updateRemotePosition} for all remote users.
@return
- 0: Success.
- <0: Failure.
@valid since 3.52
@detail api
@author wangjunzheng
@brief Disables all spatial audio effects set by calling updateRemotePosition{@link #ISpatialAudio#updateRemotePosition} for a certain remote user.
@param uid User ID of the remote user.
@return
- 0: Success.
- <0: Failure.
@valid since 3.52
@detail api
@author wangjunzheng
@brief Sets the coordinate and orientation of the remote user as a speaker in the rectangular coordinate system of the local user. In this case, the local user hears from the remote user with the expected spatial audio effects.
@param uid User ID
@param positionInfo Information on the remote user's position. Refer to PositionInfo{@link #PositionInfo} for details.
@return
- 0: Success.
- <0: Failure.
- -2: Failure. The reason is that any two of the 3D coordinate vectors of the position of the remote user are not perpendicular to each other.
@note
- You must call this API after creating the room.
- The settings made locally will not influence other users' spatial audio experience.
@valid since 3.52
@detail api
@author wangjunzheng
@brief Sets the coordinate and orientation of the local user as a listener in the rectangular coordinate system the local user built to achieve expected spatial audio effects.
@param positionInfo Information on the local user's position. Refer to PositionInfo{@link #PositionInfo} for details.
@return
- 0: Success.
- <0: Failure.
- -2: Failure. The reason is that any two of the 3D coordinate vectors of your position are not perpendicular to each other.
@note
- You need to call this API after joining the room.
- Before calling this API, you should call enableSpatialAudio{@link #ISpatialAudio#enableSpatialAudio} first to enable the spatial audio function.
- The settings made locally will not influence other users' spatial audio experience.
