Método ISpatialAudioObject::SetPosition (spatialaudioclient.h)
Define a posição no espaço 3D em relação ao ouvinte, do qual os dados de áudio ISpatialAudioObject serão renderizados.
Sintaxe
HRESULT SetPosition(
[in] float x,
[in] float y,
[in] float z
);
Parâmetros
[in] x
A posição x do objeto de áudio, em metros, em relação ao ouvinte. Os valores positivos estão à direita do ouvinte e os valores negativos estão à esquerda.
[in] y
A posição y do objeto de áudio, em metros, em relação ao ouvinte. Os valores positivos estão acima do ouvinte e os valores negativos estão abaixo.
[in] z
A posição z do objeto de áudio, em metros, em relação ao ouvinte. Os valores positivos estão por trás do ouvinte e os valores negativos estão na frente.
Retornar valor
Se o método for bem-sucedido, retornará S_OK. Se falhar, os códigos de retorno possíveis incluem, mas não se limitam a, os valores mostrados na tabela a seguir.
| Código de retorno | Descrição |
|---|---|
|
ISpatialAudioObjectRenderStreamBase::BeginUpdatingAudioObjects não foi chamado antes da chamada para SetPosition. |
|
SetEndOfStream foi chamado explicitamente ou implicitamente em uma passagem de processamento de áudio anterior. SetEndOfStream será chamado implicitamente pelo sistema se GetBuffer não for chamado dentro de uma passagem de processamento de áudio (entre chamadas para ISpatialAudioObjectRenderStreamBase::BeginUpdatingAudioObjects e ISpatialAudioObjectRenderStreamBase::EndUpdatingAudioObjects). |
|
O ISpatialAudioObject não é do tipo AudioObjectType_Dynamic. Defina o tipo do objeto de áudio com o parâmetro type como o método ISpatialAudioObjectRenderStreamBase::ActivateSpatialAudioObject . |
Comentários
Esse método só pode ser chamado em um ISpatialAudioObject do tipo AudioObjectType_Dynamic. Defina o tipo do objeto de áudio com o parâmetro type como o método ISpatialAudioObjectRenderStreamBase::ActivateSpatialAudioObject .
Os valores de posição usam um sistema de coordenadas cartesiano destro, em que cada unidade representa 1 metro. O sistema de coordenadas é relativo ao ouvinte em que a origem (x=0,0, y=0,0, z=0,0) representa o ponto central entre os ouvidos do ouvinte.
Se SetPosition nunca for chamado, a origem (x=0,0, y=0,0, z=0,0) será usada como a posição padrão. Depois que SetPosition for chamado, a posição definida será usada para o objeto de áudio até que a posição seja alterada com outra chamada para SetPosition.
Requisitos
| Requisito | Valor |
|---|---|
| Plataforma de Destino | Windows |
| Cabeçalho | spatialaudioclient.h |