Qt Spatial Audio API 提供了允许创建 3D 声音场景的许多类。它由位于 3D 空间中发出声音的对象，和可以使用一个或多个房间建模的环绕几何体定义。最后，可以将收听者放置在此声场的特定位置和特定取向。
可以使用 C++ 和 QML API 两者。
To create the sound scene, one first instantiates a QAudioEngine . This engine processes input sound data and geometries to create a realistic representation of the sound scene as it would be experienced by a person placed at a specific location inside the scene.
The QAudioEngine::OutputMode property can be used to optimize the output either for headphones using binaural (virtual 3D) rendering or for a stereo or surround speaker configuration.
The output device can be selected using QAudioEngine::outputDevice 特性。
Once the engine is set up, we can place various sound objects into the scene by creating QSpatialSound objects and specifying a url to a sound file using the QSpatialSound::source 特性。
QAudioListener can be used to define the position and orientation of a person listening to the sound scene. At max one listener per engine can be used. If no listener is specified, the engine assumes that the listener is at the origin of the coordinate system facing into a positive z direction, with positive y pointing upwards.
In addition to sound sources and a listener, you can define a geometry that influences how the sound is being experienced by the listener through a set of QAudioRoom objects. Rooms are rectangular and support a wide variety of materials for each wall giving a different experience with different sound reflections and reverb. Room effects will get applied if the listener is located inside one of the rooms. If he is inside multiple rooms, the room with the smallest geometrical volume will take precedence.
If you need some stereo overlay that is independent of the position and orientation of the listener (such as background music or a voice-over), you can use QAmbientSound to create the sound overlay.
For a small QWidget based example showcasing one audio source that can be moved around in a room, have a look at the 空间音频平移范例 .
| QAmbientSound | 立体声叠加声音 |
| QAudioEngine | 管理 3D 声场 |
| QAudioListener | 定义由 QAudioEngine 定义声场的收听人的位置和取向 |
| QAudioRoom | |
| QSpatialSound | 3D 空间中的声音对象 |
| AmbientSound | 立体声叠加声音 |
| AudioEngine | 管理 3D 场景中的声音对象 |
| AudioListener | 定义由 AudioEngine 定义声场的收听人的位置和取向 |
| AudioRoom | |
| SpatialSound | 3D 空间中的声音对象 |
