Les AudioClips sont créés lorsque vous importez des fichiers dans l’Éditeur d'AGS. Les commandes dans cette section vous permettent de les jouer.

(Anciennement PlayAmbientSound, désormais obsolète)
(Anciennement PlayMP3File, désormais obsolète)
(Anciennement PlayMusic, désormais obsolète)
(Anciennement PlaySound, désormais obsolète)
(Anciennement PlaySoundEx, désormais obsolète)
(Anciennement SetMusicRepeat, désormais obsolète)

AudioChannel* AudioClip.Play(optional AudioPriority, optional RepeatStyle)

Joue la séquence audio.

Facultativement, vous pouvez passer un paramètre de priorité et de répétition ; si vous n'en passez pas, les paramètres définis par défauts dans l'éditeur pour la séquence audio seront utilisés.

Cette commande scrute tous les canaux audio libres afin d'en trouver un disponible pour ce type d'audio. Si aucun canal n'est libre, elle en cherchera un qui joue une séquence de priorité inférieure ou égale et l’interrompra pour la remplacer par la nouvelle.

Si tous les canaux jouent des séquences d'une priorité supérieure, alors votre séquence ne sera pas jouée.

Cette commande retourne l'objet AudioChannel sur lequel est joué le son, ou null s'il n'a pas été joué pour une quelconque raison.

NOTE : AGS ne peut jouer qu'un seul fichier MIDI à la fois.

Exemple :

aExplosion.Play();

joue la séquence audio aExplosion.

Compatibilité : Supporté par AGS 3.2.0 et versions plus récentes.

Voir aussi : AudioClip.PlayFrom, AudioClip.PlayQueued, AudioClip.Stop

AudioChannel* AudioClip.PlayFrom(int position, optional AudioPriority, 
                                 optional RepeatStyle)

Joue la séquence audio en démarrant depuis la position spécifiée. Consultez l'aide de AudioChannel.Seek pour le fonctionnement de la position.

À part cela, cette commande fonctionne de la même façon que AudioClip.Play. Consultez l'aide de cette commande pour plus d'informations.

Exemple :

aExplosion.PlayFrom(1000);

joue la séquence audio aExplosion en commençant avec un décalage de 1 seconde (pour un format OGG/MP3).

Compatibilité : Supporté par AGS 3.2.0 et versions plus récentes.

Voir aussi : AudioClip.Play

(Anciennement PlayMusicQueued, désormais obsolète)

AudioChannel* AudioClip.PlayQueued(optional AudioPriority, optional RepeatStyle)

Joue la séquence audio, ou la met à la file afin qu'elle soit jouée plus tard si ce n'est pas possible actuellement.

Cette commande se comporte comme AudioClip.Play, à part que s'il n'y a pas de canal audio de libre, la séquence est mise en attente pour être jouée lorsqu'un canal se libère.

De plus, contrairement à la commande Play, utiliser PlayQueued n'interrompra aucune séquence audio en cours d'un niveau de priorité égal ; elle n'imterrompra que des séquences de priorité inférieure.

Vous pouvez mettre jusqu'à 10 morceaux à la file. Notez que si vous placez des séquences dans la file après une séquence qui boucle, elles ne seront jamais jouées.

Exemple :

aExplosion.Play();
aAftermath.PlayQueued();

joue la séquence audio aExplosion et place le son aAftermath dans la file pour qu'il soit joué juste après.

Compatibilité : Supporté par AGS 3.2.0 et versions plus récentes.

Voir aussi : AudioClip.Play

AudioClip.Stop()

Coupe toutes les diffusions en cours de cette séquence audio.

Exemple :

aExplosion.Play();
Wait(40);
aExplosion.Stop();

joue la séquence aExplosion, attend 1 seconde puis la stoppe.

Compatibilité : Supporté par AGS 3.2.0 et versions plus récentes.

Voir aussi : AudioClip.Play

readonly AudioFileType AudioClip.FileType;

Retourne le type de fichier de la séquence audio. Utilisez cette fonction avec PlayFrom et Seek pour déterminer ce que représente la position.

Exemple :

if (aExplosion.FileType == eAudioFileMIDI)
{
  Display("Explosion est un fichier MIDI !");
}

affiche un message si aExplosion est un fichier MIDI.

Compatibilité : Supporté par AGS 3.2.0 et versions plus récentes.

Voir aussi : AudioChannel.Seek, AudioChannel.Position, AudioClip.PlayFrom

(Anciennement IsMusicVoxAvailable, désormais obsolète)

readonly bool AudioClip.IsAvailable;

Retourne si la séquence audio est disponible sur l'ordinateur du joueur.

En général, cela retournera true, à moins que la séquence ne soit contenue dans un fichier AUDIO.VOX externe et que le joueur ne l'ait pas sur son ordinateur.

Vous n'aurez normalement pas besoin d'utiliser cette propriété, puisque la commande Play échouera silencieusement si elle ne trouve pas la séquence.

Exemple :

if (aExplosion.IsAvailable)
{
  aExplosion.Play();
}

vérifie si la séquence audio aExplosion est disponible, et la joue le cas échéant.

Compatibilité : Supporté par AGS 3.2.0 et versions plus récentes.

Voir aussi : AudioClip.Play

readonly AudioType AudioClip.Type;

Retourne le type de la séquence audio, telle que définie dans l'éditeur.

Les types AudioType vous permettent de trier les séquences en Sons et Musiques par exemple.

Exemple :

if (aExplosion.Type == eAudioTypeMusic)
{
  Display("La séquence Explosion est une musique !");
}

affiche un message si aExplosion est une musique.

Compatibilité : Supporté par AGS 3.2.0 et versions plus récentes.

//Voir aussi :// AudioClip.Play, Game.IsAudioPlaying