Loading Sounds
Audio files can be loaded directly onto the SD card. When named correctly they will automatically play when appropriate.
File Extensions
| Extension | Description |
|---|---|
| .wav | Uncompressed wav files |
| .mp3 | |
| .ogg | |
| .m4a | AAC files |
File Names
| Filename | Description | Example |
|---|---|---|
trigger_[1 or 2].[ext] |
Played when the controller is triggered locally. | trigger_1.mp3, trigger_2.wav, trigger_1.ogg, trigger_2.m4a |
network_trigger_[1-4].[ext] |
Played when the controller is triggered remotely over the network | network_trigger_1.mp3, network_trigger_2.wav, network_trigger_3.ogg, network_trigger_4.m4a |
ambient_[0-99].[ext] |
Played automatically in-sequence when no animation is playing | ambient_1.mp3, ambient_2.ogg, ambient_3.m4a, ambient_4.wav |
random_ambient_[1-9].[ext] |
Played when a random ambient animation is triggered. | random_ambient_1.wav, random_ambient_2.mp3 |
Best Practices
Try to keep your audio files the same format and rate to prevent delays from switching encoders. The controller can handle all sorts of different audio formats but will perform best when consistent.
If all audio files are .wav then it will not pause the ambient audio when a trigger is played. This is because the controller has to do much less processing to decompress the file and can therefore handle playing two audio tracks simultaneously.
The first time the controller plays an audio file it may choose the wrong rate, causing it to sound funny for a moment. This is normal and the controller will quickly cache the updated rate information so it doesn't happen again.