Método ISpatialAudioObject::SetPosition (spatialaudioclient.h)
Establece la posición en el espacio 3D, en relación con el agente de escucha, desde el que se representarán los datos de audio ISpatialAudioObject .
Sintaxis
HRESULT SetPosition(
[in] float x,
[in] float y,
[in] float z
);
Parámetros
[in] x
Posición x del objeto de audio, en metros, en relación con el agente de escucha. Los valores positivos están a la derecha del agente de escucha y los valores negativos están a la izquierda.
[in] y
Posición y del objeto de audio, en metros, en relación con el agente de escucha. Los valores positivos están por encima del agente de escucha y los valores negativos se encuentran a continuación.
[in] z
Posición z del objeto de audio, en metros, en relación con el agente de escucha. Los valores positivos están detrás del agente de escucha y los valores negativos están delante.
Valor devuelto
Si el método se realiza correctamente, devuelve S_OK. Si se produce un error, los posibles códigos de retorno incluyen, pero no están limitados a, los valores que se muestran en la tabla siguiente.
| Código devuelto | Descripción |
|---|---|
|
No se llamó a ISpatialAudioObjectRenderStreamBase::BeginUpdatingAudioObjects antes de la llamada a SetPosition. |
|
Se llamó a SetEndOfStream de forma explícita o implícita en un paso de procesamiento de audio anterior. El sistema llama implícitamente a SetEndOfStream si no se llama a GetBuffer dentro de un paso de procesamiento de audio (entre llamadas a ISpatialAudioObjectRenderStreamBase::BeginUpdatingAudioObjects e ISpatialAudioObjectRenderStreamBase::EndUpdatingAudioObjects). |
|
ISpatialAudioObject no es de tipo AudioObjectType_Dynamic. Establezca el tipo del objeto de audio con el parámetro type en el método ISpatialAudioObjectRenderStreamBase::ActivateSpatialAudioObject . |
Comentarios
Solo se puede llamar a este método en un ISpatialAudioObject de tipo AudioObjectType_Dynamic. Establezca el tipo del objeto de audio con el parámetro type en el método ISpatialAudioObjectRenderStreamBase::ActivateSpatialAudioObject .
Los valores de posición usan un sistema de coordenadas cartesiano a la derecha, donde cada unidad representa 1 metro. El sistema de coordenadas es relativo al agente de escucha donde el origen (x=0.0, y=0.0, z=0.0) representa el punto central entre los oídos del agente de escucha.
Si nunca se llama a SetPosition , el origen (x=0.0, y=0.0, z=0.0) se usa como posición predeterminada. Después de llamar a SetPosition , la posición que se establece se usará para el objeto de audio hasta que la posición se cambie con otra llamada a SetPosition.
Requisitos
| Requisito | Value |
|---|---|
| Plataforma de destino | Windows |
| Encabezado | spatialaudioclient.h |