Antarmuka ISpatialAudioClient (spatialaudioclient.h)
Antarmuka ISpatialAudioClient memungkinkan klien untuk membuat aliran audio yang memancarkan audio dari posisi di ruang 3D. Antarmuka ini adalah bagian dari Windows Sonic, platform audio Microsoft untuk audio yang lebih imersif yang mencakup suara spasial terintegrasi pada Xbox dan Windows.
Warisan
Antarmuka ISpatialAudioClient mewarisi dari antarmuka IUnknown . ISpatialAudioClient juga memiliki jenis anggota ini:
Metode
Antarmuka ISpatialAudioClient memiliki metode ini.
ISpatialAudioClient::ActivateSpatialAudioStream Mengaktifkan dan menginisialisasi aliran audio spasial menggunakan salah satu struktur aktivasi aliran audio spasial. |
ISpatialAudioClient::GetMaxDynamicObjectCount Mendapatkan jumlah maksimum objek audio dinamis untuk klien audio spasial. |
ISpatialAudioClient::GetMaxFrameCount Mendapatkan jumlah bingkai maksimum yang mungkin per lulus pemrosesan. Metode ini dapat digunakan untuk menentukan ukuran buffer sumber yang harus dialokasikan untuk menyampaikan data audio untuk setiap pass pemrosesan. |
ISpatialAudioClient::GetNativeStaticObjectTypeMask Mendapatkan masker saluran yang mewakili subset saluran tempat tidur speaker statis asli ke mesin penyajian saat ini. |
ISpatialAudioClient::GetStaticObjectPosition Mendapatkan posisi dalam ruang 3D dari saluran audio spasial statis yang ditentukan. |
ISpatialAudioClient::GetSupportedAudioObjectFormatEnumerator Mendapatkan IAudioFormatEnumerator yang berisi semua format audio yang didukung untuk objek audio spasial, item pertama dalam daftar mewakili format yang paling disukai. |
ISpatialAudioClient::IsAudioObjectFormatSupported Mendapatkan nilai yang menunjukkan apakah ISpatialAudioObjectRenderStream mendukung format yang ditentukan. |
ISpatialAudioClient::IsSpatialAudioStreamAvailable Jika berhasil, mendapatkan nilai yang menunjukkan apakah mesin penyajian spasial yang saat ini aktif mendukung aliran render audio spasial yang ditentukan. |
Keterangan
Contoh kode berikut menggambarkan cara menginisialisasi antarmuka ini menggunakan IMMDevice.
HRESULT hr;
Microsoft::WRL::ComPtr<IMMDeviceEnumerator> deviceEnum;
Microsoft::WRL::ComPtr<IMMDevice> defaultDevice;
hr = CoCreateInstance(__uuidof(MMDeviceEnumerator), nullptr, CLSCTX_ALL, __uuidof(IMMDeviceEnumerator), (void**)&deviceEnum);
hr = deviceEnum->GetDefaultAudioEndpoint(EDataFlow::eRender, eMultimedia, &defaultDevice);
Microsoft::WRL::ComPtr<ISpatialAudioClient> spatialAudioClient;
hr = defaultDevice->Activate(__uuidof(ISpatialAudioClient), CLSCTX_INPROC_SERVER, nullptr, (void**)&spatialAudioClient);
Untuk aplikasi UWP yang tidak memiliki akses ke IMMDevice, Anda harus mendapatkan instans ISpatialAudioClient dengan memanggil ActivateAudioInterfaceAsync. Misalnya, lihat sampel WindowsAudioSession.
Persyaratan
Persyaratan | Nilai |
---|---|
Klien minimum yang didukung | Windows 10, versi 1703 [hanya aplikasi desktop] |
Server minimum yang didukung | Windows Server 2016 [hanya aplikasi desktop] |
Target Platform | Windows |
Header | spatialaudioclient.h |