SpatialSound QML Type

Un objet sonore dans l'espace 3D. Plus d'informations...

• Liste de tous les membres, y compris les membres hérités

Propriétés

• autoPlay : bool
• directivity : real
• directivityOrder : real
• distanceCutoff : real
• distanceModel : enumeration
• loops : int
• manualAttenuation : real
• nearFieldGain : real
• occlusionIntensity : real
• size : real
• source : url
• volume : real

Méthodes

• void pause()
• void play()
• void stop()

Description détaillée

Un SpatialSound représente un objet audible dans l'espace 3D. Vous pouvez définir sa position et son orientation dans l'espace, définir le son qu'il joue et définir un volume pour l'objet.

L'objet peut avoir différents comportements d'atténuation, émettre le son principalement dans une direction ou de manière sphérique, et se comporter comme s'il était occulté par un autre objet.

Documentation sur les propriétés

autoPlay : bool

Détermine si le son doit automatiquement commencer à jouer lorsqu'une source est spécifiée.

La valeur par défaut est true.

directivity : real

Définit la directivité de la source sonore. Une valeur de 0 signifie que le son est émis de manière égale dans toutes les directions, tandis qu'une valeur de 1 signifie que la source émet principalement le son dans la direction avant.

Les valeurs valides sont comprises entre 0 et 1, la valeur par défaut étant 0.

directivityOrder : real

Définit l'ordre de directivité de la source sonore. Un ordre plus élevé implique une localisation plus nette du cône sonore.

La valeur minimale et par défaut de cette propriété est 1.

distanceCutoff : real

Définit une distance au-delà de laquelle le son provenant de la source sera coupé. Si l'auditeur est plus éloigné de l'objet sonore que la distance de coupure, le son ne sera plus audible.

distanceModel : enumeration

Définit la manière dont le volume du son varie en fonction de la distance de l'auditeur. Le volume commence à diminuer de size à distanceCutoff. Le volume est constant pour les distances inférieures à la taille et nul pour les distances supérieures à la distance de coupure.

loops : int

Détermine combien de fois le son est joué avant que le lecteur ne s'arrête. Si la valeur est SpatialSound::Infinite, le son actuel est joué en boucle pour toujours.

La valeur par défaut est 1.

manualAttenuation : real

Définit un facteur d'atténuation manuel si distanceModel est défini sur SpatialSound.ManualAttenuation.

nearFieldGain : real

Définit le gain de champ proche pour la source sonore. Les valeurs valides sont comprises entre 0 et 1. Un gain de champ proche de 1 augmentera le volume du signal sonore d'environ 20 dB pour des distances très proches de l'auditeur.

occlusionIntensity : real

Définit le degré d'occultation de l'objet. 0 signifie que l'objet n'est pas du tout occulté, tandis qu'un grand nombre implique une grande occultation.

La valeur par défaut est 0.

size : real

Définit la taille de la source sonore. Si l'auditeur est plus proche de l'objet sonore que la taille, le volume restera constant. La taille est également utilisée pour les calculs d'occlusion, lorsque de grandes sources peuvent être partiellement occultées par un mur.

source : url

Le fichier source du son à jouer.

volume : real

Définit un volume global pour cette source sonore.

Les valeurs comprises entre 0 et 1 atténuent le son, tandis que les valeurs supérieures à 1 augmentent le gain.

Documentation de la méthode

void pause()

Interrompt la lecture du son à la position actuelle. L'appel de play() permet de poursuivre la lecture.

void play()

Lance la lecture du son. Ne fait rien si le son est déjà en cours de lecture.

void stop()

Arrête la lecture du son et remet la position actuelle et le nombre de boucles à 0. L'appel de play() commencera la lecture au début du fichier son.