Ok, après pas mal de boulot, je suis enfin prêt a vous montrer comment gérer un Controller de Son dans Unity. La parti deux est presque terminé, il me reste encore quelques bugs à tuer et quelques réglages à peaufiner mais l’ensemble du niveau est fonctionnel.
La théorie d’un Controller de Son dans Unity
Pour la parti théorique, Nous allons créer un script C# qui va contrôler la musique du jeux et les effets sonores rapides qui n’ont pas besoin d’effets de spatialisation 3D (Les canons par exemple ont le son 3D qui diminue plus on est loin de l’objet). Il y aura également les objets qui peuvent jouer du son eux même. On fait donc passer tout ces sons par le AudioMixer et on aura un menu qui va interagir avec ses volumes.
Et apres tout ceci, le son sort enfin sur les enceintes du joueur.
Le détail du fonctionnement
Pour l’utilisation du audioMixer, Unity l’explique très bien (et honnêtement, ce n’est pas très complexe !)
Pour le script c# du Controller de Son dans Unity , je me suis largement inspiré de ce script :
https://unity3d.com/fr/learn/tutorials/projects/2d-roguelike-tutorial/audio-and-sound-manager
j’ai mis un 3eme AudioSource pour pouvoir jouer des sons de test tout en mettant les sons existants en pause. Ceux qui nous donne ceci :
|
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 |
using System.Collections; using System.Collections.Generic; using UnityEngine; using System; using UnityEngine.Audio; public class SoundController : MonoBehaviour { //Controller de Son dans Unity public AudioSource efxSource; //Drag a reference to the audio source which will play the sound effects. public AudioSource musicSource; //Drag a reference to the audio source which will play the music. public AudioSource demoEfxSource; //source for demo sound when setting volumes public static SoundController instance = null; //Allows other scripts to call functions from SoundManager. public float lowPitchRange = .95f; //The lowest a sound effect will be randomly pitched. public float highPitchRange = 1.05f; //The highest a sound effect will be randomly pitched. public AudioClip[] demoEfxSound; //testing out AudioMixers private AudioMixer musicMixer; private AudioMixer efxMixer; private void Awake() { //Check if there is already an instance of SoundManager if (instance == null) //if not, set it to this. instance = this; //If instance already exists: else if (instance != this) //Destroy this, this enforces our singleton pattern so there can only be one instance of SoundManager. Destroy(gameObject); //Set SoundManager to DontDestroyOnLoad so that it won't be destroyed when reloading our scene. //DontDestroyOnLoad(gameObject); } private void Start() { //audioMixers ? musicMixer = musicSource.outputAudioMixerGroup.audioMixer; efxMixer = efxSource.outputAudioMixerGroup.audioMixer; //grabbing the playerPrefs and putting the mixer volumes to the level float[] setVolumes = GetVolumePrefabs(); musicMixer.SetFloat("MusicVolume", setVolumes[0]); efxMixer.SetFloat("EfxVolume", setVolumes[1]); } //Used to play single sound clips. public void PlaySingle(AudioClip clip) { //Set the clip of our efxSource audio source to the clip passed in as a parameter. efxSource.clip = clip; //Play the clip. efxSource.Play(); } //RandomizeSfx chooses randomly between various audio clips and slightly changes their pitch. public void RandomizeSfx(params AudioClip[] clips) { //Generate a random number between 0 and the length of our array of clips passed in. int randomIndex = UnityEngine.Random.Range(0, clips.Length); //Choose a random pitch to play back our clip at between our high and low pitch ranges. float randomPitch = UnityEngine.Random.Range(lowPitchRange, highPitchRange); //Set the pitch of the audio source to the randomly chosen pitch. efxSource.pitch = randomPitch; //Set the clip to the clip at our randomly chosen index. efxSource.clip = clips[randomIndex]; //Play the clip. efxSource.Play(); } public void StartMusic() { musicSource.Play(); } public void StopMusic() { musicSource.Stop(); } public void PauseAllSound() { //musicSource.Pause(); efxSource.Pause(); } public void UnPauseAllSound() { //musicSource.UnPause(); efxSource.UnPause(); } public void SetMusicVolume(Single volume) { musicMixer.SetFloat("MusicVolume", volume); //set as player pref PlayerPrefs.SetFloat("MusicVolume", volume); } public void SetFxVolume(Single volume) { //play the demo sound with random pitch if (!demoEfxSource.isPlaying && GameState.instance.isPaused) { int randomIndex = UnityEngine.Random.Range(0, demoEfxSound.Length); float randomPitch = UnityEngine.Random.Range(lowPitchRange, highPitchRange); //Set the pitch of the audio source to the randomly chosen pitch. demoEfxSource.pitch = randomPitch; //Set the clip to the clip at our randomly chosen index. demoEfxSource.clip = demoEfxSound[randomIndex]; //Play the clip. demoEfxSource.Play(); } efxMixer.SetFloat("EfxVolume", volume); //set as player pref PlayerPrefs.SetFloat("FxVolume", volume); } public float[] GetVolumePrefabs() { float[] volumes = new float[2]; volumes[0] = 0f; volumes[1] = 0f; //grabbing the playerPrefs if (PlayerPrefs.HasKey("MusicVolume")) { volumes[0] = PlayerPrefs.GetFloat("MusicVolume"); } if (PlayerPrefs.HasKey("FxVolume")) { volumes[1] = PlayerPrefs.GetFloat("FxVolume"); } return volumes; } } |
Ne pas oublier le “using UnityEngine.Audio;” au début du script.
Ceux que j’ai ajouté par rapport au script du tuto d’Unity, est la gestion des players prefabs. Pour ceux qui ne conaissent pas ces prefabs, ce sont tout simplement des variables qui sont enregistrer directment sur le PC qui execute le jeu. Il est donc possible de recuperer ces valeurs chaque fois que le joueur lance le jeux. Je m’en sert ici pour stocker les niveaux de son que le joueur a réglé et je les récupère au démarrage du jeux.
On récupère directement les différents audioMixers grâce aux audioSources qui y sont attachés :
L’utilisation du Controller de Son dans Unity
Dans le Audio Mixer, j’ai exposer les valeurs du volume afin de pouvoir les modifier directement par le script du controller :
comme ceci :
|
1 2 3 4 5 6 |
public void SetMusicVolume(Single volume) { musicMixer.SetFloat("MusicVolume", volume); //set as player pref PlayerPrefs.SetFloat("MusicVolume", volume); } |
Le variable “Volume” est de type single afin de pouvoir interagir avec les sliders d’unity. Cela permet d’attacher notre fonction public “SetMusicVolume” au composant du slider. Il sera appelé a chaque changement de valeur du slider et passera la nouvelle valeur au fonction. On remarquera que les valeurs sont limités entre -80 et +10. Ce sont les valeurs possibles de volume dans le AudioMixer.
Enfin, pour pouvoir lancer un son, il suffit d’appeler l’instance de notre script sound controller comme ceci :
|
1 2 3 4 |
public AudioClip startSound; void Start () { SoundController.instance.PlaySingle(startSound); } |
Pas besoin de chercher une référence à un gameobject. Il n’y a qu’un seule instance du soundController grâce a ce bout de code magique :
|
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 |
private void Awake() { //Check if there is already an instance of SoundManager if (instance == null) //if not, set it to this. instance = this; //If instance already exists: else if (instance != this) //Destroy this, this enforces our singleton pattern so there can only be one instance of SoundManager. Destroy(gameObject); //Set SoundManager to DontDestroyOnLoad so that it won't be destroyed when reloading our scene. //DontDestroyOnLoad(gameObject); } |
Pour les plus attentifs. J’ai utiliser le meme principe pour un autre élément qui traque les différents états du jeux, Le GameState.
Pingback: Beta 2.5 dispo | StarbugStone's Dev Blog