Utilisation détaillée

ADS Audio Subsystem

Accès

Dans un Blueprint, utilisez la fonction Get ADS_AudioSubsystem.

Fonctions

Nom	Description
`Ensure Audio Components`	Crée les composants audio persistants utilisés par le système s’ils n’existent pas encore. Cette fonction est appelée automatiquement par les fonctions de lecture : vous n’avez normalement pas besoin de l’appeler.
`Create Persistent Audio Component`	Crée un composant audio 2D persistant. Cette fonction est utilisée automatiquement par le système : vous n’avez normalement pas besoin de l’appeler. Sans son, le système utilise `Cue_Empty`.
`Play Music`	Lance une musique. Vous pouvez indiquer une locale, les durées de fondu sortant et entrant, le volume, le pitch, ainsi que demander le verrouillage ou le déverrouillage de la musique. Renvoie `true` lorsque la musique active change.
`Stop Music`	Arrête la musique actuellement active.
`Pause Music`	Met en pause ou reprend la musique active selon la valeur fournie.
`Adjust Music Volume`	Fait évoluer le volume de la musique active pendant une durée donnée, avec la courbe de fondu choisie.
`Set Music Locked`	Verrouille ou déverrouille les changements de musique au Runtime.
`Is Music Locked`	Renvoie si les changements de musique sont actuellement verrouillés.
`Get Music Component`	Renvoie le composant de musique actif ou inactif et son index dans le système.
`Get Active Music Component`	Renvoie le composant qui joue la musique active.
`Play Sound`	Joue un son 2D persistant. Vous pouvez indiquer une locale, un index de composant, le volume et le pitch. Des index différents permettent de jouer plusieurs sons indépendamment.
`Set Localized Sound Table`	Définit la Data Table de localisation à utiliser pour les musiques et les sons.
`Get Localized Sound Table`	Renvoie la table de localisation actuellement définie ; si aucune n’est définie, le système utilise `DT_LocalizedSound`.
`Resolve Localized Sound`	Renvoie la variante d’un son correspondant à la locale demandée. Si aucune variante n’est trouvée, renvoie le son source.

Dispatchers

Nom	Description
`On Music Changed`	Est déclenché lorsque la musique active change. Il transmet la musique précédente et la nouvelle musique.
`On Music Lock Changed`	Est déclenché lorsque l’état de verrouillage de la musique change. Il transmet le nouvel état de verrouillage.

Audio localisé

Pour utiliser une version localisée d’un son ou d’une musique, ouvrez la Data Table DT_LocalizedSound fournie par le plugin.

Ajoutez une ligne dans la table.
Dans Source Sound, renseignez le son de référence que vous transmettrez à Play Music ou Play Sound.
Dans Localized Sounds, ajoutez une entrée par langue. La clé est un tag IETF de langue, par exemple fr-FR ; la valeur est le son à jouer pour cette langue.
Lors de l’appel à Play Music ou Play Sound, transmettez le son de référence et le même code dans Locale To Play.

Configuration d’un son localisé

Si aucune variante ne correspond au code indiqué, le système joue le son de référence.

AC ADS Audio Parameters

Brancher le component

Ajoutez AC ADS Audio Parameters au Player depuis le panneau Components. Au BeginPlay, il peut lancer automatiquement la musique associée au level courant et appliquer le Sound Mix renseigné.

Ajout de AC ADS Audio Parameters au Player

Paramètres

Nom	Description
`Assign Music Level`	Associe le nom d’un level à une musique. Si le level courant possède une entrée, cette musique est lancée automatiquement au démarrage.
`Sound Mix`	Définit le Sound Mix de base à appliquer au démarrage. Laissez ce paramètre vide si aucun Sound Mix ne doit être appliqué.