WoW:API PlayMusic: Difference between revisions
Jump to navigation
Jump to search
(→Notes: .ogg can be played using this API. .mp2 and .wav files should be able to be played with the API as well.) |
m (Move page script moved page API PlayMusic to API PlayMusic without leaving a redirect) |
||
| (4 intermediate revisions by 4 users not shown) | |||
| Line 15: | Line 15: | ||
==Notes== | ==Notes== | ||
*You cannot pause the playback, but you can stop it with [[API_StopMusic|StopMusic()]]. | *You cannot pause the playback, but you can stop it with [[API_StopMusic|StopMusic()]]. | ||
*You cannot use this function to play custom MP3 files located outside an addon's directory. | *You cannot use this function to play custom MP3 files located outside an addon's directory. | ||
*To play MP3 files that were added to an addon's directory after WoW has been launched you will first have to restart the game client. | |||
*If any of the built-in music is playing when you call this function (e.g. Stormwind background music), it will fade out. | *If any of the built-in music is playing when you call this function (e.g. Stormwind background music), it will fade out. | ||
*(Verified): since World of Warcraft uses the FMOD sound engine, it is very likely that other file formats than mp3 are supported. For example OggVorbis (.ogg). | *(Verified): since World of Warcraft uses the FMOD sound engine, it is very likely that other file formats than mp3 are supported. For example OggVorbis (.ogg). | ||
*The playback loops until it is stopped with [[API_StopMusic|StopMusic()]]. | |||
*For some reason, during most (but not all) raid encounters the music played will suddenly stop. | |||
Latest revision as of 04:47, 15 August 2023
Plays the given mp3 file.
PlayMusic(soundFile);
Parameters[edit]
Arguments[edit]
- soundFile
- String - path to a MP3 file. You can refer to both files in WoW's MPQs, or your own music files in your addon's directory.
Example[edit]
PlayMusic("Sound\\Music\\GlueScreenMusic\\wow_main_theme.mp3");
PlayMusic("Interface\\AddOns\\Foo\\bar.mp3");
Result[edit]
Current music fades out, login or custom music plays.
Notes[edit]
- You cannot pause the playback, but you can stop it with StopMusic().
- You cannot use this function to play custom MP3 files located outside an addon's directory.
- To play MP3 files that were added to an addon's directory after WoW has been launched you will first have to restart the game client.
- If any of the built-in music is playing when you call this function (e.g. Stormwind background music), it will fade out.
- (Verified): since World of Warcraft uses the FMOD sound engine, it is very likely that other file formats than mp3 are supported. For example OggVorbis (.ogg).
- The playback loops until it is stopped with StopMusic().
- For some reason, during most (but not all) raid encounters the music played will suddenly stop.