====== music.h ======
===== Functions =====
==== init_music ====
<code C>
void init_music();
</code>
This should only need to be called once, after ''init_audio_coprocessor()'' and before doing any music or sound effects.
==== play_song ====
<code C>
void play_song(const unsigned char* song, char bank_num, char loop);
</code>
''song'' and ''bank_num'' can be given at once by using a [[development:csdk:2.0:genmacros|generated asset macro]].

''loop'' should be one of:
  * ''REPEAT_NONE'' - Plays the song once and stops
  * ''REPEAT_LOOP'' - Replays the song continuously
  * ''REPEAT_RESUME'' - Play the song once, then resume the previous song.
==== tick_music ====
<code C>
char tick_music();
</code>
Call this once per frame, ideally shortly after ''await_vsync()''
==== play_sound_effect ====
<code C>
void play_sound_effect(char sfx_id, char channel);
</code>
''sfx_id'' is an index into the table of all assets with .sfx extensions. See the [[development:csdk:2.0:genmacros|Generated Asset Macros]] page to get the ID for a sound effect.

''channel'' gives the channel number to play the sound effect on, but also the priority.
The channel used is the lower two bytes of ''channel'' while the priority used is given by the upper four bytes of ''channel''.
==== stop_music ====
<code C>
void stop_music();
</code>
==== pause_music ====
<code C>
void pause_music();
</code>
==== unpause_music ====
<code C>
void unpause_music();
</code>