Sonido y música

#Formatos compatibles e importación

PyBlocks reproduce archivos WAV, MP3 y OGG. Los efectos cortos (saltos, monedas, golpes) andan mejor en WAV u OGG; los temas de música largos, en OGG o MP3.

1. Abrí el panel Project (en el workspace Scene, o con Window → Panels → Project & Console).
2. Hacé clic derecho en la carpeta donde van los archivos, por ejemplo assets/audio, y elegí Import Files.
3. Elegí uno o varios archivos de audio. Se copian al proyecto; tus originales quedan donde estaban.

Cualquier archivo .wav, .mp3 u .ogg dentro de la carpeta del proyecto queda disponible para los bloques de audio, esté en la subcarpeta que esté.

#Efectos de sonido

Play Sound reproduce un archivo una vez. Elegilo en la lista Sound, que muestra todos los archivos de audio del proyecto por su ruta (por ejemplo assets/audio/coin.wav), y ajustá At Volume de 0 a 1.

• El mismo sonido puede sonar varias veces a la vez, así que los efectos rápidos y repetidos se superponen con naturalidad.
• Stop Sound frena todas las copias de un sonido que estén sonando; Stop All Sounds frena todos los efectos.

Un uso típico: un script On Collision Enter en una moneda que reproduce coin.wav y después destruye la moneda.

#Música

Play Music arranca un tema de fondo que se repite hasta que lo pares. Suena un solo tema a la vez: si reproducís otro, reemplaza al actual.

• Stop Music frena el tema.
• Is Music Playing? te dice si hay música sonando.

Un buen lugar para Play Music es un script When Scene Starts en un objeto de cada escena, así cada nivel puede tener su propio tema.

#Volumen

• Cada Play Sound y Play Music tiene su propio At Volume, de 0 (silencio) a 1 (máximo).
• Set Volume define el volumen general, también de 0 a 1. Lo que escuchás es el At Volume del bloque multiplicado por el volumen general, así que Set Volume 0,5 baja todo a la mitad.
• Set AudioClip Volume cambia el volumen de las copias de un efecto de sonido que ya están sonando.

#Para tener en cuenta

• Todos los sonidos y la música se frenan cuando apretás Stop, y cuando se carga una escena mientras el juego corre.
• Si un archivo no se encuentra o no se puede cargar, el bloque no hace nada y el juego sigue. Revisá el nombre del archivo en la lista del bloque si moviste o renombraste archivos.
• Cada proyecto de ejemplo trae sus propios efectos de sonido en assets/audio, que podés reutilizar. Mirá Ejemplos.

La lista completa de bloques de audio está en la referencia de bloques de Audio.