Auf Englisch lesen

Freigeben über


Headset

In diesem Dokument wird die grundlegende Programmierung für Headsets unter Verwendung von Windows.Gaming.Input.Headset und zugehöriger APIs für die universelle Windows-Plattform (UWP) beschrieben.

Auf dieser Seite erhalten Sie Informationen zu folgenden Vorgängen:

  • Zugreifen Sie auf ein Headset, das mit einem Eingabe- oder Navigationsgerät verbunden ist
  • Erkennen, dass ein Headset angeschlossen oder getrennt wurde

Headset-Übersicht

Headsets sind Audioaufnahme- und Wiedergabegeräte, die am häufigsten für die Kommunikation mit anderen Spielern in Onlinespielen verwendet werden, können aber auch für Gameplay oder für andere kreative Zwecke verwendet werden. Headsets werden in Windows 10- oder Windows 11- und Xbox-UWP-Apps über den Windows.Gaming.Input-Namespace unterstützt.

Erkennen und Nachverfolgen von Headsets

Headsets werden vom System verwaltet, daher müssen Sie sie nicht erstellen oder initialisieren. Das System bietet Zugriff auf ein Headset über das Eingabegerät, das mit ihm verbunden ist, und Ereignisse, um Sie darüber zu informieren, wenn ein Headset angeschlossen oder getrennt wird.

IGameController.Headset

Alle Eingabegeräte im Windows.Gaming.Input-Namespace implementieren die IGameController-Schnittstelle, die die Eigenschaft Headset definiert, um das Headset zu sein, das derzeit mit dem Gerät verbunden ist.

Verbinden und Trennen von Headsets.

Wenn ein Headset verbunden oder getrennt wird, werden die Ereignisse HeadsetConnected und HeadsetDisconnected ausgelöst. Sie können Handler für diese Ereignisse registrieren, um nachzuverfolgen, ob ein Eingabegerät derzeit mit einem Headset verbunden ist.

Das folgende Beispiel zeigt, wie ein Handler für das HeadsetConnected-Ereignis registriert wird.

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
}

Das folgende Beispiel zeigt, wie ein Handler für das HeadsetDisconnected-Ereignis registriert wird.

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
}

Verwenden des Headsets

Die Headset-Klasse besteht aus zwei Zeichenfolgen, die XAudio-Endpunkt-IDs darstellen, eine für die Audioaufnahme (Aufzeichnung vom Headsetmikrofon) und eine für das Audiorendering (Wiedergabe über das Headset-Ohrstück).

Details zum Arbeiten mit XAudio werden hier nicht erläutert. Eeitere Informationen finden Sie im XAudio2-Programmierhandbuch und in der XAudio2-API-Referenz.