Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
Legt die Position im 3D-Raum relativ zum Listener fest, aus dem die ISpatialAudioObjectForHrtf-Audiodaten gerendert werden.
Syntax
HRESULT SetPosition(
[in] float x,
[in] float y,
[in] float z
);
Parameter
[in] x
Die x-Position des Audioobjekts in Metern relativ zum Listener. Positive Werte befinden sich rechts neben dem Listener und negative Werte links.
[in] y
Die y-Position des Audioobjekts in Metern relativ zum Listener. Positive Werte liegen über dem Listener und negative Werte unten.
[in] z
Die z-Position des Audioobjekts in Metern relativ zum Listener. Positive Werte befinden sich hinter dem Listener und negative Werte vorn.
Rückgabewert
Wenn die Methode erfolgreich ist, wird S_OK zurückgegeben. Wenn ein Fehler auftritt, können mögliche Rückgabecodes die in der folgenden Tabelle gezeigten Werte umfassen, sind jedoch nicht darauf beschränkt.
| Rückgabecode | Beschreibung |
|---|---|
|
ISpatialAudioObjectRenderStreamBase::BeginUpdatingAudioObjects wurde vor dem Aufruf von SetPosition nicht aufgerufen. |
|
SetEndOfStream wurde in einem vorherigen Audioverarbeitungsdurchlauf explizit oder implizit aufgerufen. SetEndOfStream wird implizit vom System aufgerufen, wenn GetBuffer nicht innerhalb eines Audioverarbeitungsdurchlaufs aufgerufen wird (zwischen Aufrufen von ISpatialAudioObjectRenderStreamBase::BeginUpdatingAudioObjects und ISpatialAudioObjectRenderStreamBase:EndUpdatingAudioObjects). |
|
ISpatialAudioObjectForHrtf ist nicht vom Typ AudioObjectType_Dynamic. Legen Sie den Typ des Audioobjekts mit dem type-Parameter auf die ISpatialAudioObjectRenderStreamBase::ActivateSpatialAudioObjectForHrtf-Methode fest. |
Hinweise
Diese Methode kann nur für ein ISpatialAudioObjectForHrtf vom Typ AudioObjectType_Dynamic aufgerufen werden. Legen Sie den Typ des Audioobjekts mit dem type-Parameter auf die ISpatialAudioObjectRenderStreamForHrtf::ActivateSpatialAudioObjectForHrtf-Methode fest.
Positionswerte verwenden ein rechtshändiges kartesisches Koordinatensystem, wobei jede Einheit 1 Meter darstellt. Das Koordinatensystem ist relativ zum Listener, bei dem der Ursprung (x=0.0, y=0.0, z=0.0) den Mittelpunkt zwischen den Ohren des Listeners darstellt.
Wenn SetPosition nie aufgerufen wird, wird der Ursprung (x=0.0, y=0.0, z=0.0) als Standardposition verwendet. Nachdem SetPosition aufgerufen wurde, wird die festgelegte Position für das Audioobjekt verwendet, bis die Position mit einem weiteren Aufruf von SetPosition geändert wird.
Anforderungen
| Anforderung | Wert |
|---|---|
| Zielplattform | Windows |
| Kopfzeile | spatialaudiohrtf.h |