Cette instruction permet de jouer des sons et musiques qui se trouvent dans les ressources du jeu.

PARTIE "Paramètres".
  -- activer l’audio (requis pour que l’audio fonctionne dans votre jeu)
  activer l’audio.
  -- afficher les lieux qui n’ont pas encore été visités
  activer l'affichage des lieux inconnus.
 
PARTIE "Description des lieux".
  Le hall est un lieu.
  Le salon est un lieu au nord du hall.
  La salle d’armes est un lieu au sud du hall.
  Le futur est un lieu à l’est du hall.
 
  -- gérer l’audio quand le joueur se déplace entre les lieux
  règle après aller vers ceci ou commencer le jeu:
    -- salon: jouer de la musique en boucle
    si le joueur se trouve dans le salon:
      jouer la musique musique_classique.mp3 en boucle.
    -- salle d’armes: jouer 1 son à 3 reprises en arrivant
    sinonsi le joueur se trouve dans la salle d’armes:
      jouer le son coup_d_epee.flac 3 fois.
    -- futur: jouer 2 sons différents (à la suite) en arrivant
    sinonsi le joueur se trouve dans le futur:
      jouer le son charge.ogg.
      jouer le son bulle.mp3.
    fin si
 
    -- terminer l’action normalement
    continuer l’action après.
  fin règle
  -- en quittant le salon, baisser la musique et l’arrêter
  règle avant aller vers ceci:
    si le joueur se trouve dans le salon:
       -- enlever le mot clé « progressivement » pour l’arrêter d’un coup
       arrêter la musique progressivement.
    fin si
  fin règle
PARTIE "emplacement des ressources du jeu".
-- Définition du dossier qui contient les ressources du jeu (ici « mon_donjon »):
Les ressources du jeu se trouvent dans le dossier mon_donjon.

tester cet exemple

Afin que l'audio fonctionne pour votre jeu, vous devez l'activer. Cela permet de prévenir le joueur qu'il va y avoir des effets audio dans votre jeu. Il lui sera possible de tester son matériel et de couper le son.

-- mention à placer dans votre scénario
activer l'audio.

Les fichiers repris dans les exemples de cette page sont disponibles de base dans Donjon afin que vous puissiez faire des tests.

Si un fichier est manquant, votre jeu s'exécutera sans souci mais la mention du fichier manquant s'affichera afin de vous prévenir.

Si vous n'activez pas l'audio, votre jeu s'exécutera sans souci mais sans son ni musique.

À priori il s'agit d'effets assez courts qu'on peut jouer lorsque le joueur effectue une action en particulier. Les sons peuvent être joués par dessus une musique. Un seul son peut-être joué à la fois mais on peut en jouer plusieurs à la suite.

jouer le son coup_d_epee.flac.

jouer le son coup_d_epee.flac 3 fois.

jouer le son charge.ogg.
jouer le son bulle.mp3.

Généralement utilisé pour créer une ambiance, les musiques durent plus longtemps que les sons et peuvent être jouées en boucle.

jouer la musique musique_classique.mp3.

Avec cette option, lorsque la musique se termine, elle est jouée à nouveau jusqu'à ce qu'on l'arrête.

jouer la musique musique_classique.mp3 en boucle.

arrêter la musique.

Cet effet diminue le son progressivement avant d'arrêter la musique afin que la coupure soit plus discrète.

arrêter la musique progressivement.

Le nom des fichiers ressources ne peut contenir que des lettres non-accentuées, des chiffres et des tirets.

Par défaut, vous devez placer les ressources du jeu dans le dossier ./assets/ressources :

• ./assets/ressources/sons/test.mp3 (pour jouer le son test.mp3.)
• ./assets/ressources/musiques/test.flac (pour jouer la musique test.flac. )

Si vous mettez plusieurs jeux sur le même site web, vous pouvez définir un dossier spécifique pour chacun des jeux. Un même dossier peut-être réutilisé pour plusieurs jeux.

-- Définition du dossier qui contient les ressources du jeu (ici « mon_donjon »):
Les ressources du jeu se trouvent dans le dossier mon_donjon.

Vous devez alors placer les ressources du jeu dans ce dossier ./assets/ressources/mon_donjon:

• ./assets/ressources/mon_donjon/sons/test.mp3 (pour jouer son test.mp3.)
• ./assets/ressources/mon_donjon/musiques/test.flac (pour jouer musique test.flac.)