Uso de XAudio2 para reproducir un sonido

Use XAudio2 para cargar y reproducir un archivo .wav en XBOX One. En las secciones siguientes se describe cómo usar XAudio2 para cargar y reproducir un sonido en el Development Kit de XBOX One.

Tipos de datos importantes de XAudio2
Inicialización de XAudio2
Carga de un archivo .wav
Establecimiento de una ruta de acceso a un archivo .wav
Reproducción de un archivo .wav
Finalización de un archivo .wav

Para obtener un ejemplo funcional de XAudio2, descargue el ejemplo SimplePlaySound de los ejemplos del Microsoft Game Development Kit (GDK).

Tipos de datos importantes de XAudio2

XAudio2 proporciona varios tipos de datos para ayudarle a reproducir efectos de sonido en XBOX One. Para reproducir un archivo .wav, necesita al menos los siguientes tipos de datos.

IXAudio2: esta es la interfaz del objeto XAudio2 que administra todos los estados del motor de audio, el subproceso de procesamiento de audio, el grafo de voces y mucho más.
IXAudio2SourceVoice: use una voz de origen para enviar datos de audio a la canalización de procesamiento de XAudio2. Para que se oigan, los datos de voz deben enviarse a una voz de masterización.
IXAudio2MasteringVoice: use este tipo de datos para representar el dispositivo de salida de audio. Los búferes de datos no se pueden enviar directamente a las voces de masterización. Sin embargo, para que se oigan, los datos enviados a otros tipos de voces deben dirigirse a una voz de masterización.

Además, es posible que los siguientes tipos de datos le resulten útiles.

PlaySoundVoiceContext: use este tipo de datos para liberar el búfer de audio después del procesamiento.
IXAudio2VoiceCallback: este tipo de datos contiene métodos que notifican al cliente cuando se producen determinados eventos en una IXAudio2SourceVoice específica.

Inicialización de XAudio2

CoInitializeEx() inicializa el modelo de objetos componentes (COM) para su uso por parte del subproceso actual. Establezca el primer parámetro en NULL. Establezca el segundo parámetro en COINIT_MULTITHREADED. XAudio2Create() crea un nuevo objeto XAudio2 y devuelve un puntero a su interfaz IXAudio2. Asegúrese de que XAUDIO2_PROCESSOR esté establecido en un valor válido. Se recomienda el valor XAUDIO2_USE_DEFAULT_PROCESSOR para permitir que el sistema operativo elija el procesador ideal según la plataforma de hardware. IXAudio2::CreateMasteringVoice() crea y configura una voz de masterización y apunta a ella con el puntero proporcionado por el usuario.

C++

CoInitializeEx( NULL, COINIT_MULTITHREADED );

// Create an XAudio2 device.
DX::ThrowIfFailed( XAudio2Create( &m_pXAudio2, 0, XAUDIO2_USE_DEFAULT_PROCESSOR, NULL ) );

// Create an XAudio2 mastering voice, and store the result.
DX::ThrowIfFailed( m_pXAudio2->CreateMasteringVoice( &m_pMasteringVoice ) );  

Carga de un archivo .wav

Para acceder al archivo de audio, use una instancia de la clase WaveFile. * Para abrir un archivo .wav y recuperar información almacenada en el encabezado del archivo, llame a WaveFile::Open(LPCWSTR strFileName).

Para determinar el formato del archivo .wav, llame a WaveFile::GetFormat().
Para determinar el número de bytes y muestras del archivo .wav, llame a WaveFile::GetDuration().
Para leer los datos de muestra en memoria, llame a WaveFile::ReadSample().

C++

// Read the .wav file.
WaveFile WaveFile;

// Append the file name and location to the end of the installation location.
WCHAR FilenameAndLocation[ 1024 ];
_snwprintf_s( FilenameAndLocation, _countof( FilenameAndLocation ), _TRUNCATE, L"%s%s", g_strCommonFileRoot, szFilename );

DX::ThrowIfFailed( WaveFile.Open( FilenameAndLocation ) );

// Read the format header.
BYTE header[64];
WAVEFORMATEX* pbWfx = reinterpret_cast<WAVEFORMATEX*>(header);

DX::ThrowIfFailed( WaveFile.GetFormat( pbWfx, sizeof(header) ) );

// Calculate the number of bytes and samples in the .wav file. 
DWORD cbWaveSize = WaveFile.GetDuration();

// Read the sample data into memory.
BYTE* pbWaveData = new BYTE[ cbWaveSize ];
DX::ThrowIfFailed( WaveFile.ReadSample( 0, pbWaveData, cbWaveSize, &cbWaveSize ) );  

Establecimiento de una ruta de acceso a un archivo .wav

Para cargar y usar archivos de audio, use el código siguiente para encontrar la ubicación de instalación de su proyecto en el dispositivo local. Almacene la ubicación de instalación en una cadena. Anexe la ubicación del archivo de audio al final de la cadena de la ubicación de instalación.

C++

std::wstring installFolder = Windows::ApplicationModel::Package::Current->InstalledLocation->Path->Data();  

Reproducción de un archivo .wav

Cree una clase IXAudio2::CreateSourceVoice() y, a continuación, úsela para enviar datos de audio a la canalización de procesamiento de XAudio2. Para que los datos de voz se oigan, debe enviarlos a una voz de masterización directamente o a través de voces de submezcla intermedias. Para almacenar los detalles del archivo de audio, cree un XAUDIO2_BUFFER. Después de crear e inicializar el búfer de XAudio2 y la voz de origen, llame a IXAudio2SourceVoice::SubmitSourceBuffer() para agregar el búfer de audio a la cola de entrada de la voz. Tenga en cuenta que los datos de audio a los que apunta XAUDIO2_BUFFER::pAudioData deben seguir siendo válidos hasta que XAudio2 haya terminado de reproducir el contenido del búfer. Una vez rellenada la cola de entrada de la voz, llame a IXAudio2SourceVoice::Start() para reproducir el siguiente sonido de la cola.

C++

// Play the .wav file by using a new XAudio2SourceVoice.
// Create the source voice.
DX::ThrowIfFailed( pXaudio2->CreateSourceVoice( &m_pSourceVoice, pbWfx, 0, XAUDIO2_DEFAULT_FREQ_RATIO, &m_VoiceContext ) );

// Submit the .wav sample data by using an XAUDIO2_BUFFER structure.
XAUDIO2_BUFFER buffer = {0};
buffer.pAudioData     = pbWaveData;
buffer.Flags          = XAUDIO2_END_OF_STREAM;
buffer.AudioBytes     = cbWaveSize;
buffer.pContext       = pbWaveData;

// Add the audio buffer to the voice input queue.
DX::ThrowIfFailed( m_pSourceVoice->SubmitSourceBuffer( &buffer ) );

// Play the next audio buffer in the queue.
DX::ThrowIfFailed( m_pSourceVoice->Start( 0 ) );  

Finalización de un archivo .wav

Para determinar si un archivo .wav se ha reproducido por completo, necesitará el estado actual de la voz de origen. Cree una estructura XAUDIO2_VOICE_STATE y, a continuación, llame a IXAudio2SourceVoice::GetState(). Si el audio se ha reproducido por completo, llame a IXAudio2SourceVoice::DestroyVoice().

C++

// Determine whether the sound effect has been played to completion, and handle an appropriate termination.
XAUDIO2_VOICE_STATE state;
m_pSourceVoice->GetState( &state, XAUDIO2_VOICE_NOSAMPLESPLAYED );
if( state.BuffersQueued == 0 )
{
  // Destroy the current sound effect.
  m_pSourceVoice->DestroyVoice();
}  

Consulte también

Información general sobre XAudio2 Información general sobre ADPCM Codificador de línea de comandos ADPCM

GDK and Game Engines Integration

Steam porting guide

Game Principles

Core Features

Console Features

Tipos de datos importantes de XAudio2

Inicialización de XAudio2

C++

Carga de un archivo .wav

C++

Establecimiento de una ruta de acceso a un archivo .wav

C++

Reproducción de un archivo .wav

C++

Finalización de un archivo .wav

C++

Consulte también

​Tipos de datos importantes de XAudio2

​Inicialización de XAudio2

​C++

​Carga de un archivo .wav

​C++

​Establecimiento de una ruta de acceso a un archivo .wav

​C++

​Reproducción de un archivo .wav

​C++

​Finalización de un archivo .wav

​C++

​Consulte también

Tipos de datos importantes de XAudio2

Inicialización de XAudio2

C++

Carga de un archivo .wav

C++

Establecimiento de una ruta de acceso a un archivo .wav

C++

Reproducción de un archivo .wav

C++

Finalización de un archivo .wav

C++

Consulte también