Auriculares
En esta página se describen los conceptos básicos de programación para auriculares que usan Windows.Gaming.Input.Headset y las API relacionadas para la Plataforma universal de Windows (UWP).
Al leer esta página, aprenderá lo siguiente:
- Cómo acceder a los auriculares conectados a un dispositivo de entrada o navegación
- Cómo detectar que los auriculares se han conectado o desconectado
Introducción a los auriculares
Los auriculares son dispositivos de reproducción y captura de audio que se usan con más frecuencia para comunicarse con otros jugadores en juegos en línea, pero también se pueden usar en el juego o para otros usos creativos. Los auriculares se admiten en aplicaciones para UWP de Windows 10 o Windows 11 y Xbox a través del espacio de nombres Windows.Gaming.Input.
Detección y seguimiento de auriculares
Los auriculares se administran mediante el sistema, por lo que no es necesario crearlos ni inicializarlos. El sistema proporciona acceso a los auriculares, a través del dispositivo de entrada al que están conectados, y a los eventos para notificarle cuando los auriculares están conectados o desconectados.
IGameController.Headset
Todos los dispositivos de entrada del espacio de nombres Windows.Gaming.Input implementan la interfaz IGameController que define la propiedad Headset para que esta sea (represente) los auriculares conectados actualmente al dispositivo.
Conexión y desconexión de auriculares.
Cuando los auriculares se conectan o desconectan, se generan los eventos HeadsetConnected y HeadsetDisconnected. Puede registrar controladores para estos eventos para realizar un seguimiento de si un dispositivo de entrada tiene actualmente auriculares conectados a él.
En el siguiente ejemplo, se muestra cómo registrar un controlador para el evento HeadsetConnected.
auto inputDevice = myGamepads[0]; // or arcade stick, racing wheel
inputDevice.HeadsetConnected += ref new TypedEventHandler<IGameController^, Headset^>(IGameController^ device, Headset^ headset)
{
// enable headset capture and playback on this device
}
En el siguiente ejemplo, se muestra cómo registrar un controlador para el evento HeadsetDisconnected.
auto inputDevice = myGamepads[0]; // or arcade stick, racing wheel
inputDevice.HeadsetDisconnected += ref new TypedEventHandler<IGameController^, Headset^>(IGameController^ device, Headset^ headset)
{
// disable headset capture and playback on this device
}
Uso de los auriculares
La clase Headset se compone de dos cadenas que representan identificadores de punto de conexión XAudio: uno para la captura de audio (grabación desde el micrófono de los auriculares) y otro para la reproducción de audio (reproducción a través de los auriculares).
Los detalles de trabajar con XAudio no se describen aquí. Para obtener más información, consulte la guía de programación XAudio2 y la referencia de la API XAudio2.