Les Sons

Odyc.js utilise PFXR, une petite bibliothèque JavaScript conçue spécialement pour générer des effets sonores de manière procédurale. Elle permet de créer, personnaliser et jouer des sons très légers.

Définir un son dans un template

Un son peut être associé à un élément de la carte via la clé sound. Il sera joué automatiquement lorsque le joueur entre en contact avec cet élément.

templates: {
  E: {
    sprite: 3,
    sound: "HIT"
  }
}

Formats acceptés

La clé sound accepte plusieurs formats:

Un nom de preset

sound: 'FALL'

Voici la liste des presets disponibles. Cliquez sur un nom pour entendre le type de son correspondant. Chaque clic génère une variation aléatoire du son.

Attention à RANDOM, baissez le volume avant de cliquer dessus.

Un tableau `[preset, seed]`

Pour que le son soit toujours le même, vous pouvez préciser un nombre (seed):

sound: ['LASER', 12345]

L’outil Son du playground peut vous aider à trouver le son qui convient.

Une URL PFXR

Vous pouvez utiliser l’interface de Pfxr pour créer un son personnalisé, puis coller l’URL générée:

sound: 'https://achtaitaipai.github.io/pfxr/?fx=1,0.3,...'

Note

Odyc.js ne se connecte pas au site: toutes les informations sont directement lues dans l’URL. Aucun accès internet n’est requis au moment de jouer le son.

Un objet de configuration

Pour un contrôle total, utilisez un objet décrivant les paramètres du son:

sound: {
  waveForm: 2,
  frequency: 440,
  sustainTime: 0.2,
  decayTime: 0.5
}

La liste complète des paramètres est disponible ici.

🔊 Volume global

Le volume des sons peut être ajusté dans la configuration initiale du jeu avec la clé volume:

createGame({
	volume: 0.8
})

Valeur par défaut : 0.5