GameMaker8.0 :新手教程 Part 21 -外置音频：SS与MM-
SuperSound下载
MaizeMusic下载（本教程第一章所提供的GM8汉化版自带MaizeMusic）
下载之后，里面会有多个文件，一般来讲至少会有xxx.dll，xxx.gml，xxx.gex这三个文件，使用dll+gml等效于使用gex，大佬们通常比较喜欢使用dll+gml，不过为了方便，本教程此处一律使用gex。（如果有心情我会专门开一章来讲dll）
导入GM的方法和十九章导入FoxWriting插件是一样的，因此不再复述。
注：本教程只讲常用函数，那些比较深层或者不常用的内容不会出现在本教程中。
SuperSound只支持wav和ogg是它的一大缺陷，但也可以说是一大优点，因为ogg格式的音频文件比mp3要小很多，音质却完全不输于mp3，有助于减小游戏整体的大小。
①转换格式
下载并打开GoldWava，将音频文件拖入其中，GoldWave会显示它的频率波形图：
点击左上角的File，选择Save As...
下拉“保存类型”，选择ogg格式，保存。
这样音频文件就成功转换为了ogg格式。
将所有转换完的ogg音频文件全部放到.gmk所在的文件夹，不过个人更喜欢放在DataMusic下，如下图所示，"Best bye to 2016"是游戏的.gmk所在的文件夹。
②载入音频
SS_LoadSound(path, stream) 该函数载入一个外置音频，并且返回该音频的索引。参数path填写文件路径，比如上图中，我要载入Bad Apple!! piano ver.ogg，那么参数path就应该填写working_directory+"DataMusicBad Apple!! piano ver.ogg"。参数stream填写true或false，表示是否流式读取音频，由于SuperSound对流式音频处理十分烂，所以建议填写false。这个函数的返回值需要用在播放音乐当中，所以需要用一个全局变量去接收，因此它的完整调用形式是：
global.BGM_BadApple = SS_LoadSound(working_directory+"DataMusicBad Apple!! piano ver.ogg", true);
建议新建一个脚本（假设叫musicInit），将所有载入音乐全部放在这个脚本里，然后在游戏最开始调用一次musicInit();，比如在第十四章中所讲的对象world的create事件。
注意，当音乐文件成功读取时，该函数会返回一个很大整数，如果读取失败，则会返回字符串"No"，因此可以通过if(is_real(global.BGM_BadApple))来判断是否读取成功。
③释放音频
SS_FreeSound(snd) 当不需要一个音频时，应当释放它的内存。参数填写需要释放的音频的索引，即SS_LoadSound的返回值。
④播放与停止
SS_PlaySound(snd) 播放指定的音频，只播放一次，参数snd填写音频索引。
SS_LoopSound(snd) 循环播放指定的音频。
SS_StopSound(snd) 停止播放指定的音频。
SS_PauseSound(snd) 暂停播放指定的音频。
SS_ResumeSound(snd) 从暂停处继续播放指定的音频。
⑤调整音量
SS_SetSoundVol(snd, volumn) 设置某个音频的播放音量。参数snd为音频索引。参数volumn为音量，可取值为0~10000，但是实际上在5000左右的时候就基本上没有声音了，因此，如果假设一个变量global.volumn控制音量在0~100之间，那么最好将5000 + 50 * global.volumn传递给函数SS_SetSoundVol，为了保险起见，在if(global.volumn == 0)时传递0给SS_SetSoundVol。
SS_GetSoundVol(snd) 获取指定音频的音量。
⑥判断状态
SS_IsSoundPlaying(snd) 返回指定音频是否处于播放状态。
SS_IsSoundLooping(snd) 返回指定音频是否处于循环播放状态。
SS_IsSoundPaused(snd) 返回指定音频是否处于暂停状态。
⑦控制播放位置
如果你在SS_LoadSound中使用了流式音频，则以下函数全部报废。
SS_GetSoundLength(snd) 返回指定音频的长度。注意，返回的长度单位是byte。
SS_GetSoundPosition(snd) 返回指定音频播放到的位置。与上面相同，返回的长度单位是byte。
SS_SetSoundPosition(snd, pos) 设置音频从pos处开始播放。注意，SS_SetSoundPosition不会主动播放音频，所以这个音频应当正处于播放状态。参数pos的单位也是byte。
举个例子，上述的global.BGM_BadApple长度为219秒，我要让它从第46秒开始播放，那么代码就是：
SS_PlaySound(global.BGM_BadApple);
SS_SetSoundPosition(global.BGM_BadApple, (46 / 219) * SS_GetSoundLength(global.BGM_BadApple));
因为音频长度是以byte来计数的，所以你可以精确到毫秒来控制播放位置。
mm_music_load(path, loop) 载入音频。参数path请参考SuperSound中的SS_LoadSound(path, stream)。参数loop指定该音频是否需要循环播放。该函数返回音频的索引，请用全局变量储存，参考SuperSound中的SS_LoadSound(path, stream)。读取音乐文件失败时返回0。
mm_music_load_url(url) 载入网络音频。参数url为字符串，填写网络音频的直接文件地址（不是音频的播放页面）。返回值为音频的索引。
②释放音乐
mm_music_free(snd) 当不需要某个音频时，应当释放它的内存。参数snd填写音频索引，即mm_music_load的返回值。
③播放与停止
mm_play(snd) 播放指定的音频，参数snd填写音频索引。
mm_stop(snd) 停止播放指定的音频。
mm_stop_all() 停止播放所有的音频。
mm_pause(snd) 暂停播放指定的音频。
mm_resume(snd) 从暂停处继续播放指定的音频。
④调整音量
mm_set_volume(snd, volumn) 设置指定音频的音量，参数volumn范围为0~1。
mm_slider_volume(snd, volumn, time) 缓动指定音频的音量。有些时候，你需要让音量渐渐增大，或者渐渐减小，而不是突兀地变化，此时你需要mm_slider_volume，相比于上一个函数多了参数time，单位为步（或帧），控制音频经过多少时间变化到volumn。
mm_set_global_volume(volumn) 设置操作系统（即windows）的音量，参数volumn范围为0~1。
mm_get_volume(snd) 获取指定音频的音量
mm_get_global_volume() 获取操作系统的音量。
⑤播放速度
mm_set_speed(snd, spd) 设置指定音频的播放速度，参数spd为播放速度，1表示常速。
⑥循环片段
mm_set_music_loop_section(snd, begin, end) 设置指定音频的循环片段，begin和end单位为秒，可以使用小数，用来指定循环片段的首尾。
mm_remove_music_loop_section(snd) 取消指定音频的循环片段。
⑦获取状态
mm_get_active(snd) 返回指定音频的状态。返回0为停止，1为正在播放，2为正在缓冲，3为暂停。
⑧音效
mm_effect_set(snd, effect) 设置指定音频的音效。音效可以叠加。
effect的可选值为：
se_chorus 合唱
se_echo 回声
se_flanger 降噪、镶边
se_gargle 漱口声
se_reverb 混响
se_compressor 压缩器
se_equalizer 均衡器
mm_effect_remove(snd, effect) 去除指定音频的指定音效。
mm_effect_reset(snd) 去除指定音频的所有音效。
⑨控制播放位置
mm_get_length(snd) 返回指定音频的长度，单位为秒。
mm_get_position(snd) 返回指定音频播放到的位置，单位为秒。
mm_set_position(snd, pos) 设置指定音频从pos出开始播放。注意mm_set_position不会主动播放音频，所以音频应当处于播放状态。pos单位为秒，支持小数。
举个例子，上述的global.BGM_BadApple，要让它从第46秒开始播放，那么代码就是：
mm_play(global.BGM_BadApple);
mm_set_position(global.BGM_BadApple, 46);
显然，MM在控制音频播放位置方面远比SS方便。
⑩录音
mm_record_start() 开始录音。返回值为本次录音的音频索引，可以用在mm_play等函数中。
mm_record_stop() 停止录音。
mm_record_set_input(enable, volumn) 设置输入设备的状态，通常指麦克风。enable表示开启(true)或关闭(false)输入设备，volumn设置输入设备的音量。
mm_record_get_volume() 获取输入设备的音量，通常指麦克风。
1、概述
GM8的音频系统可以说一团糟糕，因此，GMer多是选择使用音频插件来播放、控制音频。在此介绍两个常用又容易上手的插件：SuperSound（作者为tsg1zzn）与MaizeMusic（作者为Mage松仁玉米），任选其一即可。SuperSound下载
MaizeMusic下载（本教程第一章所提供的GM8汉化版自带MaizeMusic）
下载之后，里面会有多个文件，一般来讲至少会有xxx.dll，xxx.gml，xxx.gex这三个文件，使用dll+gml等效于使用gex，大佬们通常比较喜欢使用dll+gml，不过为了方便，本教程此处一律使用gex。（如果有心情我会专门开一章来讲dll）
导入GM的方法和十九章导入FoxWriting插件是一样的，因此不再复述。
注：本教程只讲常用函数，那些比较深层或者不常用的内容不会出现在本教程中。
2、SS vs MM
SuperSound只支持wav和ogg的音频格式，而MaizeMusic支持mp3，wav，ogg，ma，m4a，ot，mod等等多格式，且功能也比SuperSound更加全面（虽然基本上用不上），但是目前在国外GM圈要么就是用SuperSound要么就是用FMOD，几乎不见使用MaizeMusic（我怀疑是因为玉米懒得写英文文档），因此如果你有需要与国外大佬合作的话，建议使用SuperSound或者更为复杂的FMOD，否则建议使用MaizeMusic。3、SuperSound
在使用SuperSound之前，你需要准备一个GoldWava来转换音频格式为ogg。SuperSound只支持wav和ogg是它的一大缺陷，但也可以说是一大优点，因为ogg格式的音频文件比mp3要小很多，音质却完全不输于mp3，有助于减小游戏整体的大小。
①转换格式
下载并打开GoldWava，将音频文件拖入其中，GoldWave会显示它的频率波形图：
点击左上角的File，选择Save As...
下拉“保存类型”，选择ogg格式，保存。
这样音频文件就成功转换为了ogg格式。
将所有转换完的ogg音频文件全部放到.gmk所在的文件夹，不过个人更喜欢放在DataMusic下，如下图所示，"Best bye to 2016"是游戏的.gmk所在的文件夹。
②载入音频
SS_LoadSound(path, stream) 该函数载入一个外置音频，并且返回该音频的索引。参数path填写文件路径，比如上图中，我要载入Bad Apple!! piano ver.ogg，那么参数path就应该填写working_directory+"DataMusicBad Apple!! piano ver.ogg"。参数stream填写true或false，表示是否流式读取音频，由于SuperSound对流式音频处理十分烂，所以建议填写false。这个函数的返回值需要用在播放音乐当中，所以需要用一个全局变量去接收，因此它的完整调用形式是：
global.BGM_BadApple = SS_LoadSound(working_directory+"DataMusicBad Apple!! piano ver.ogg", true);
建议新建一个脚本（假设叫musicInit），将所有载入音乐全部放在这个脚本里，然后在游戏最开始调用一次musicInit();，比如在第十四章中所讲的对象world的create事件。
注意，当音乐文件成功读取时，该函数会返回一个很大整数，如果读取失败，则会返回字符串"No"，因此可以通过if(is_real(global.BGM_BadApple))来判断是否读取成功。
③释放音频
SS_FreeSound(snd) 当不需要一个音频时，应当释放它的内存。参数填写需要释放的音频的索引，即SS_LoadSound的返回值。
④播放与停止
SS_PlaySound(snd) 播放指定的音频，只播放一次，参数snd填写音频索引。
SS_LoopSound(snd) 循环播放指定的音频。
SS_StopSound(snd) 停止播放指定的音频。
SS_PauseSound(snd) 暂停播放指定的音频。
SS_ResumeSound(snd) 从暂停处继续播放指定的音频。
⑤调整音量
SS_SetSoundVol(snd, volumn) 设置某个音频的播放音量。参数snd为音频索引。参数volumn为音量，可取值为0~10000，但是实际上在5000左右的时候就基本上没有声音了，因此，如果假设一个变量global.volumn控制音量在0~100之间，那么最好将5000 + 50 * global.volumn传递给函数SS_SetSoundVol，为了保险起见，在if(global.volumn == 0)时传递0给SS_SetSoundVol。
SS_GetSoundVol(snd) 获取指定音频的音量。
⑥判断状态
SS_IsSoundPlaying(snd) 返回指定音频是否处于播放状态。
SS_IsSoundLooping(snd) 返回指定音频是否处于循环播放状态。
SS_IsSoundPaused(snd) 返回指定音频是否处于暂停状态。
⑦控制播放位置
如果你在SS_LoadSound中使用了流式音频，则以下函数全部报废。
SS_GetSoundLength(snd) 返回指定音频的长度。注意，返回的长度单位是byte。
SS_GetSoundPosition(snd) 返回指定音频播放到的位置。与上面相同，返回的长度单位是byte。
SS_SetSoundPosition(snd, pos) 设置音频从pos处开始播放。注意，SS_SetSoundPosition不会主动播放音频，所以这个音频应当正处于播放状态。参数pos的单位也是byte。
举个例子，上述的global.BGM_BadApple长度为219秒，我要让它从第46秒开始播放，那么代码就是：
SS_PlaySound(global.BGM_BadApple);
SS_SetSoundPosition(global.BGM_BadApple, (46 / 219) * SS_GetSoundLength(global.BGM_BadApple));
因为音频长度是以byte来计数的，所以你可以精确到毫秒来控制播放位置。
4、MaizeMusic
①载入音频mm_music_load(path, loop) 载入音频。参数path请参考SuperSound中的SS_LoadSound(path, stream)。参数loop指定该音频是否需要循环播放。该函数返回音频的索引，请用全局变量储存，参考SuperSound中的SS_LoadSound(path, stream)。读取音乐文件失败时返回0。
mm_music_load_url(url) 载入网络音频。参数url为字符串，填写网络音频的直接文件地址（不是音频的播放页面）。返回值为音频的索引。
②释放音乐
mm_music_free(snd) 当不需要某个音频时，应当释放它的内存。参数snd填写音频索引，即mm_music_load的返回值。
③播放与停止
mm_play(snd) 播放指定的音频，参数snd填写音频索引。
mm_stop(snd) 停止播放指定的音频。
mm_stop_all() 停止播放所有的音频。
mm_pause(snd) 暂停播放指定的音频。
mm_resume(snd) 从暂停处继续播放指定的音频。
④调整音量
mm_set_volume(snd, volumn) 设置指定音频的音量，参数volumn范围为0~1。
mm_slider_volume(snd, volumn, time) 缓动指定音频的音量。有些时候，你需要让音量渐渐增大，或者渐渐减小，而不是突兀地变化，此时你需要mm_slider_volume，相比于上一个函数多了参数time，单位为步（或帧），控制音频经过多少时间变化到volumn。
mm_set_global_volume(volumn) 设置操作系统（即windows）的音量，参数volumn范围为0~1。
mm_get_volume(snd) 获取指定音频的音量
mm_get_global_volume() 获取操作系统的音量。
⑤播放速度
mm_set_speed(snd, spd) 设置指定音频的播放速度，参数spd为播放速度，1表示常速。
⑥循环片段
mm_set_music_loop_section(snd, begin, end) 设置指定音频的循环片段，begin和end单位为秒，可以使用小数，用来指定循环片段的首尾。
mm_remove_music_loop_section(snd) 取消指定音频的循环片段。
⑦获取状态
mm_get_active(snd) 返回指定音频的状态。返回0为停止，1为正在播放，2为正在缓冲，3为暂停。
⑧音效
mm_effect_set(snd, effect) 设置指定音频的音效。音效可以叠加。
effect的可选值为：
se_chorus 合唱
se_echo 回声
se_flanger 降噪、镶边
se_gargle 漱口声
se_reverb 混响
se_compressor 压缩器
se_equalizer 均衡器
mm_effect_remove(snd, effect) 去除指定音频的指定音效。
mm_effect_reset(snd) 去除指定音频的所有音效。
⑨控制播放位置
mm_get_length(snd) 返回指定音频的长度，单位为秒。
mm_get_position(snd) 返回指定音频播放到的位置，单位为秒。
mm_set_position(snd, pos) 设置指定音频从pos出开始播放。注意mm_set_position不会主动播放音频，所以音频应当处于播放状态。pos单位为秒，支持小数。
举个例子，上述的global.BGM_BadApple，要让它从第46秒开始播放，那么代码就是：
mm_play(global.BGM_BadApple);
mm_set_position(global.BGM_BadApple, 46);
显然，MM在控制音频播放位置方面远比SS方便。
⑩录音
mm_record_start() 开始录音。返回值为本次录音的音频索引，可以用在mm_play等函数中。
mm_record_stop() 停止录音。
mm_record_set_input(enable, volumn) 设置输入设备的状态，通常指麦克风。enable表示开启(true)或关闭(false)输入设备，volumn设置输入设备的音量。
mm_record_get_volume() 获取输入设备的音量，通常指麦克风。
