Méthode ISpatialAudioClient::GetStaticObjectPosition (spatialaudioclient.h)

Article
08/26/2023

Obtient la position dans l’espace 3D du canal audio spatial statique spécifié.

Syntaxe

HRESULT GetStaticObjectPosition(
  [in]  AudioObjectType type,
  [out] float           *x,
  [out] float           *y,
  [out] float           *z
);

Paramètres

[in] type

Valeur indiquant le canal audio spatial statique pour lequel la position est interrogée. Cette méthode retourne E_INVALIDARG si la valeur ne représente pas un canal statique, y compris AudioObjectType_Dynamic et AudioObjectType_None.

[out] x

Coordonnée x du canal audio statique, en mètres, par rapport à l’écouteur. Les valeurs positives se trouvent à droite de l’écouteur et les valeurs négatives se trouvent à gauche.

[out] y

Coordonnée y du canal audio statique, en mètres, par rapport à l’écouteur. Les valeurs positives sont au-dessus de l’écouteur et les valeurs négatives sont inférieures.

[out] z

Coordonnée z du canal audio statique, en mètres, par rapport à l’écouteur. Les valeurs positives se trouvent derrière l’écouteur et les valeurs négatives sont devant.

Valeur retournée

Si la méthode réussit, retourne S_OK. En cas d’échec, les codes de retour possibles incluent, sans s’y limiter, les valeurs indiquées dans le tableau suivant.

Code de retour	Description
E_INVALIDARG	La valeur AudioObjectType fournie ne représente pas un canal statique.

Remarques

Les valeurs de position utilisent un système de coordonnées cartésien droitier, où chaque unité représente 1 mètre. Le système de coordonnées est relatif à l’écouteur où l’origine (x=0,0, y=0,0, z=0,0) représente le point central entre les oreilles de l’écouteur.

Configuration requise


Plateforme cible	Windows
En-tête	spatialaudioclient.h

Voir aussi

ISpatialAudioClient

Partager via