WoW:API PlayMusic: Difference between revisions

From AddOn Studio
Jump to navigation Jump to search
(You can play MP3 after reload UI, checked it yesterday)
m (Move page script moved page API PlayMusic to API PlayMusic without leaving a redirect)
 
(3 intermediate revisions by 3 users not shown)
Line 16: Line 16:
*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 reload the UI.
*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

WoW API < PlayMusic

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.