Cuffie

Questa pagina descrive le nozioni di base della programmazione per i cuffie che usano Windows.Gaming.Input.Headset e le API correlate per la piattaforma UWP (Universal Windows Platform).

Leggendo questa pagina, si apprenderà quanto segue:

• Come accedere a una cuffia connessa a un dispositivo di input o di spostamento
• Come rilevare che una cuffia è stata connessa o disconnessa

Panoramica sulle cuffie

Le cuffie sono dispositivi di acquisizione e riproduzione audio solitamente usati per comunicare con altri giocatori nei giochi online e utili nel gioco stesso o per altri usi creativi. Le cuffie sono supportate nelle app UWP di Windows 10 o Windows 11 e Xbox tramite lo spazio dei nomi Windows.Gaming.Input.

Rilevare e tenere traccia delle cuffie

Le cuffie vengono gestite dal sistema, pertanto non è necessario crearle o inizializzarle. Il sistema fornisce l'accesso a una cuffia tramite il dispositivo di input connesso e tramite eventi per notificare quando la cuffia è connessa o disconnessa.

IGameController.Headset

Tutti i dispositivi di input nello spazio dei nomi Windows.Gaming.Input implementano l'interfaccia IGameController che definisce la proprietà Headset come cuffia attualmente connessa al dispositivo.

Connessione e disconnessione delle cuffie.

Quando una cuffia è connessa o disconnessa, vengono generati gli eventi HeadsetConnected e HeadsetDisconnected. È possibile registrare i gestori per questi eventi per tenere traccia del fatto che un dispositivo di input abbia attualmente una cuffia connessa.

Nell'esempio di codice seguente viene illustrato come registrare un gestore eventi per l'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
}

Nell'esempio di codice seguente viene illustrato come registrare un gestore eventi per l'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 della cuffia

La classe Headset è costituita da due stringhe che rappresentano gli ID endpoint XAudio, una per l'acquisizione audio (registrazione dal microfono) e una per il rendering audio (riproduzione tramite il microfono).

I dettagli sull'uso di XAudio non vengono descritti qui. Per maggiori informazioni, vedere la guida alla programmazione XAudio2 e le informazioni di riferimento sulle API XAudio2.