Microduino Wikipedia - 用户贡献 [zh-cn]

MCookie-AudioPro Reference

2017-12-14T09:09:48Z

Wasdpkj：

{| style="width: 800px;"
|-
|
|width="65%" valign="top" align="left"|
描述
此页面主要介绍用Microduino/mCookie核心控制[[MCookie-Module AudioPro]]的使用方法

功能里列出了使用AudioPro模块可以调用的一些函数，每一函数里有其具体使用说明与示例
 
 
 

引脚
mCookie AudioPro模块，使用SPI通信协议; 
'''[D13:SCK][D12:MISO][D11:MOSI][A3:CS][A2:DCS][D3:DREQ][D2:MIDI_IN]'''; 
 
 
示例
*[[光弦琴/zh|光弦琴]]
*[[彩虹钢琴/zh|彩虹钢琴]]

|width="35%" valign="top" align="left"|
AudioPro功能
*'''Constructor/结构体'''
**'''[[AudioPro()]]'''
**'''[[AudioPro_FilePlayer()]]'''

*'''Constants/常量'''
**'''[[AudioPro预定义常量]]'''

*'''Functions/函数(通用结构体)'''
**'''[[AudioPro.begin()|begin()]]'''
**'''[[AudioPro.reset()|reset()]]'''
**'''[[AudioPro.end()|end()]]'''
**'''[[AudioPro.useInterrupt()|useInterrupt()]]'''
**'''[[AudioPro.detachInterrupt()|detachInterrupt()]]'''
**'''[[AudioPro.stopped()|stopped()]]'''
**'''[[AudioPro.stopPlaying()|stopPlaying()]]'''
**'''[[AudioPro.paused()|paused()]]'''
**'''[[AudioPro.pausePlaying()|pausePlaying()]]'''
**'''[[AudioPro.volumeUp()|volumeUp()]]'''
**'''[[AudioPro.volumeDown()|volumeDown()]]'''
**'''[[AudioPro.getVolume()|getVolume()]]'''
**'''[[AudioPro.setVolume()|setVolume()]]'''
**'''[[AudioPro.getPlaySpeed()|getPlaySpeed()]]'''
**'''[[AudioPro.setPlaySpeed()|setPlaySpeed()]]'''
**'''[[AudioPro.getAmplifier()|getAmplifier()]]'''
**'''[[AudioPro.setAmplifier()|setAmplifier()]]'''
**'''[[AudioPro.getMonoMode()|getMonoMode()]]'''
**'''[[AudioPro.setMonoMode()|setMonoMode()]]'''
**'''[[AudioPro.decodeTime()|decodeTime()]]'''

*'''Functions/函数(AudioPro结构体)'''
**'''[[midiPlayer.applyPatch()|applyPatch()]]'''
**'''[[midiPlayer.midiSetVolume()|midiSetVolume()]]'''
**'''[[midiPlayer.midiSetBank()|midiSetBank()]]'''
**'''[[midiPlayer.midiSetInstrument()|midiSetInstrument()]]'''
**'''[[midiPlayer.noteOn()|noteOn()]]'''
**'''[[midiPlayer.noteOff()|noteOff()]]'''
**'''[[midiPlayer.playROM()|playROM()]]'''

*'''Functions/函数(AudioPro_FilePlayer结构体)'''
**'''[[musicPlayer.getMusicNum()|getMusicNum()]]'''
**'''[[musicPlayer.getMusicName()|getMusicName()]]'''
**'''[[musicPlayer.playMP3()|playMP3()]]'''
**'''[[musicPlayer.flushCancel()|flushCancel()]]'''

|}

[[MCookie-Module AudioPro|返回mCookie-Module AudioPro界面]]

MCookie-AudioPro Reference

2017-12-14T09:09:04Z

Wasdpkj：

{| style="width: 800px;"
|-
|
|width="65%" valign="top" align="left"|
描述
此页面主要介绍用Microduino/mCookie核心控制[[MCookie-Module AudioPro]]的使用方法

功能里列出了使用AudioPro模块可以调用的一些函数，每一函数里有其具体使用说明与示例
 
 
 

引脚
mCookie AudioPro模块，使用SPI通信协议; 
'''[D13:SCK][D12:MISO][D11:MOSI][A3:CS][A2:DCS][D3:DREQ][D2:MIDI_IN]'''; 
 
 
示例
*[[光弦琴/zh|光弦琴]]
*[[彩虹钢琴/zh|彩虹钢琴]]

|width="35%" valign="top" align="left"|
AudioPro功能
*'''Constructor/结构体'''
**'''[[AudioPro()]]'''
**'''[[AudioPro_FilePlayer()]]'''

*'''Constants/常量'''
**'''[[AudioPro预定义常量]]'''

*'''Functions/函数(适用于所有结构体)'''
**'''[[AudioPro.begin()|begin()]]'''
**'''[[AudioPro.reset()|reset()]]'''
**'''[[AudioPro.end()|end()]]'''
**'''[[AudioPro.useInterrupt()|useInterrupt()]]'''
**'''[[AudioPro.detachInterrupt()|detachInterrupt()]]'''
**'''[[AudioPro.stopped()|stopped()]]'''
**'''[[AudioPro.stopPlaying()|stopPlaying()]]'''
**'''[[AudioPro.paused()|paused()]]'''
**'''[[AudioPro.pausePlaying()|pausePlaying()]]'''
**'''[[AudioPro.volumeUp()|volumeUp()]]'''
**'''[[AudioPro.volumeDown()|volumeDown()]]'''
**'''[[AudioPro.getVolume()|getVolume()]]'''
**'''[[AudioPro.setVolume()|setVolume()]]'''
**'''[[AudioPro.getPlaySpeed()|getPlaySpeed()]]'''
**'''[[AudioPro.setPlaySpeed()|setPlaySpeed()]]'''
**'''[[AudioPro.getAmplifier()|getAmplifier()]]'''
**'''[[AudioPro.setAmplifier()|setAmplifier()]]'''
**'''[[AudioPro.getMonoMode()|getMonoMode()]]'''
**'''[[AudioPro.setMonoMode()|setMonoMode()]]'''
**'''[[AudioPro.decodeTime()|decodeTime()]]'''

*'''Functions/函数(适用于AudioPro结构体)'''
**'''[[midiPlayer.applyPatch()|applyPatch()]]'''
**'''[[midiPlayer.midiSetVolume()|midiSetVolume()]]'''
**'''[[midiPlayer.midiSetBank()|midiSetBank()]]'''
**'''[[midiPlayer.midiSetInstrument()|midiSetInstrument()]]'''
**'''[[midiPlayer.noteOn()|noteOn()]]'''
**'''[[midiPlayer.noteOff()|noteOff()]]'''
**'''[[midiPlayer.playROM()|playROM()]]'''

*'''Functions/函数(适用于AudioPro_FilePlayer结构体)'''
**'''[[musicPlayer.getMusicNum()|getMusicNum()]]'''
**'''[[musicPlayer.getMusicName()|getMusicName()]]'''
**'''[[musicPlayer.playMP3()|playMP3()]]'''
**'''[[musicPlayer.flushCancel()|flushCancel()]]'''

|}

[[MCookie-Module AudioPro|返回mCookie-Module AudioPro界面]]

AudioPro.getPlaySpeed()

2017-12-14T09:08:14Z

Wasdpkj：

'''AudioPro.getPlaySpeed()'''
 

'''作用'''
此函数可获取AudioPro模块的播放速度，范围0到127;

'''参数'''
无

'''返回值'''
音频播放速度倍数，范围0到127;

'''示例'''
无

'''其他'''
*'''[[AudioPro.begin()|begin()]]'''
*'''[[AudioPro.reset()|reset()]]'''
*'''[[AudioPro.end()|end()]]'''
*'''[[AudioPro.useInterrupt()|useInterrupt()]]'''
*'''[[AudioPro.detachInterrupt()|detachInterrupt()]]'''
*'''[[AudioPro.stopped()|stopped()]]'''
*'''[[AudioPro.stopPlaying()|stopPlaying()]]'''
*'''[[AudioPro.paused()|paused()]]'''
*'''[[AudioPro.pausePlaying()|pausePlaying()]]'''
*'''[[AudioPro.volumeUp()|volumeUp()]]'''
*'''[[AudioPro.volumeDown()|volumeDown()]]'''
*'''[[AudioPro.getVolume()|getVolume()]]'''
*'''[[AudioPro.setVolume()|setVolume()]]'''
*'''[[AudioPro.setPlaySpeed()|setPlaySpeed()]]'''
*'''[[AudioPro.getAmplifier()|getAmplifier()]]'''
*'''[[AudioPro.setAmplifier()|setAmplifier()]]'''
*'''[[AudioPro.getMonoMode()|getMonoMode()]]'''
*'''[[AudioPro.setMonoMode()|setMonoMode()]]'''
*'''[[AudioPro.decodeTime()|decodeTime()]]'''

[[MCookie-AudioPro Reference |返回mCookie-AudioPro Reference页面]]

AudioPro.decodeTime()

2017-12-14T09:07:44Z

Wasdpkj：

'''AudioPro.decodeTime()'''
 

'''作用'''
此函数可返回AudioPro模块对当前播放音频的解码时间

'''参数'''
无

'''返回值'''
返回对当前播放音频的解码时间

'''示例'''
无

'''其他'''
*'''[[AudioPro.begin()|begin()]]'''
*'''[[AudioPro.reset()|reset()]]'''
*'''[[AudioPro.end()|end()]]'''
*'''[[AudioPro.useInterrupt()|useInterrupt()]]'''
*'''[[AudioPro.detachInterrupt()|detachInterrupt()]]'''
*'''[[AudioPro.stopped()|stopped()]]'''
*'''[[AudioPro.stopPlaying()|stopPlaying()]]'''
*'''[[AudioPro.paused()|paused()]]'''
*'''[[AudioPro.pausePlaying()|pausePlaying()]]'''
*'''[[AudioPro.volumeUp()|volumeUp()]]'''
*'''[[AudioPro.volumeDown()|volumeDown()]]'''
*'''[[AudioPro.getVolume()|getVolume()]]'''
*'''[[AudioPro.setVolume()|setVolume()]]'''
*'''[[AudioPro.getPlaySpeed()|getPlaySpeed()]]'''
*'''[[AudioPro.setPlaySpeed()|setPlaySpeed()]]'''
*'''[[AudioPro.getAmplifier()|getAmplifier()]]'''
*'''[[AudioPro.setAmplifier()|setAmplifier()]]'''
*'''[[AudioPro.getMonoMode()|getMonoMode()]]'''
*'''[[AudioPro.setMonoMode()|setMonoMode()]]'''

[[MCookie-AudioPro Reference |返回mCookie-AudioPro Reference页面]]

AudioPro.setMonoMode()

2017-12-14T09:07:42Z

Wasdpkj：

'''AudioPro.setMonoMode(val)'''
 

'''作用'''
此函数可设置AudioPro模块的立体声开关

'''参数'''
val:1立体声开启,0立体声关闭

'''返回值'''
无

'''示例'''
无

'''其他'''
*'''[[AudioPro.begin()|begin()]]'''
*'''[[AudioPro.reset()|reset()]]'''
*'''[[AudioPro.end()|end()]]'''
*'''[[AudioPro.useInterrupt()|useInterrupt()]]'''
*'''[[AudioPro.detachInterrupt()|detachInterrupt()]]'''
*'''[[AudioPro.stopped()|stopped()]]'''
*'''[[AudioPro.stopPlaying()|stopPlaying()]]'''
*'''[[AudioPro.paused()|paused()]]'''
*'''[[AudioPro.pausePlaying()|pausePlaying()]]'''
*'''[[AudioPro.volumeUp()|volumeUp()]]'''
*'''[[AudioPro.volumeDown()|volumeDown()]]'''
*'''[[AudioPro.getVolume()|getVolume()]]'''
*'''[[AudioPro.setVolume()|setVolume()]]'''
*'''[[AudioPro.getPlaySpeed()|getPlaySpeed()]]'''
*'''[[AudioPro.setPlaySpeed()|setPlaySpeed()]]'''
*'''[[AudioPro.getAmplifier()|getAmplifier()]]'''
*'''[[AudioPro.setAmplifier()|setAmplifier()]]'''
*'''[[AudioPro.getMonoMode()|getMonoMode()]]'''
*'''[[AudioPro.decodeTime()|decodeTime()]]'''

[[MCookie-AudioPro Reference |返回mCookie-AudioPro Reference页面]]

AudioPro.getMonoMode()

2017-12-14T09:07:38Z

Wasdpkj：

'''AudioPro.getMonoMode()'''
 

'''作用'''
此函数可获取AudioPro模块的立体声开关状态

'''参数'''
无

'''返回值'''
返回值为1:立体声开启,返回值为0:立体声关闭

'''示例'''
无

'''其他'''
*'''[[AudioPro.begin()|begin()]]'''
*'''[[AudioPro.reset()|reset()]]'''
*'''[[AudioPro.end()|end()]]'''
*'''[[AudioPro.useInterrupt()|useInterrupt()]]'''
*'''[[AudioPro.detachInterrupt()|detachInterrupt()]]'''
*'''[[AudioPro.stopped()|stopped()]]'''
*'''[[AudioPro.stopPlaying()|stopPlaying()]]'''
*'''[[AudioPro.paused()|paused()]]'''
*'''[[AudioPro.pausePlaying()|pausePlaying()]]'''
*'''[[AudioPro.volumeUp()|volumeUp()]]'''
*'''[[AudioPro.volumeDown()|volumeDown()]]'''
*'''[[AudioPro.getVolume()|getVolume()]]'''
*'''[[AudioPro.setVolume()|setVolume()]]'''
*'''[[AudioPro.getPlaySpeed()|getPlaySpeed()]]'''
*'''[[AudioPro.setPlaySpeed()|setPlaySpeed()]]'''
*'''[[AudioPro.getAmplifier()|getAmplifier()]]'''
*'''[[AudioPro.setAmplifier()|setAmplifier()]]'''
*'''[[AudioPro.setMonoMode()|setMonoMode()]]'''
*'''[[AudioPro.decodeTime()|decodeTime()]]'''

[[MCookie-AudioPro Reference |返回mCookie-AudioPro Reference页面]]

AudioPro.setAmplifier()

2017-12-14T09:07:34Z

Wasdpkj：

'''AudioPro.setAmplifier(val)'''
 

'''作用'''
此函数可通过设置运放开关设置AudioPro模块的喇叭输出状态,不影响耳机口音频输出;关闭喇叭输出可以降低系统功耗

'''参数'''
val:1开启喇叭输出,0关闭喇叭输出

'''返回值'''
无

'''示例'''
无

'''其他'''
*'''[[AudioPro.begin()|begin()]]'''
*'''[[AudioPro.reset()|reset()]]'''
*'''[[AudioPro.end()|end()]]'''
*'''[[AudioPro.useInterrupt()|useInterrupt()]]'''
*'''[[AudioPro.detachInterrupt()|detachInterrupt()]]'''
*'''[[AudioPro.stopped()|stopped()]]'''
*'''[[AudioPro.stopPlaying()|stopPlaying()]]'''
*'''[[AudioPro.paused()|paused()]]'''
*'''[[AudioPro.pausePlaying()|pausePlaying()]]'''
*'''[[AudioPro.volumeUp()|volumeUp()]]'''
*'''[[AudioPro.volumeDown()|volumeDown()]]'''
*'''[[AudioPro.getVolume()|getVolume()]]'''
*'''[[AudioPro.setVolume()|setVolume()]]'''
*'''[[AudioPro.getPlaySpeed()|getPlaySpeed()]]'''
*'''[[AudioPro.setPlaySpeed()|setPlaySpeed()]]'''
*'''[[AudioPro.getAmplifier()|getAmplifier()]]'''
*'''[[AudioPro.getMonoMode()|getMonoMode()]]'''
*'''[[AudioPro.setMonoMode()|setMonoMode()]]'''
*'''[[AudioPro.decodeTime()|decodeTime()]]'''

[[MCookie-AudioPro Reference |返回mCookie-AudioPro Reference页面]]

AudioPro.getAmplifier()

2017-12-14T09:07:27Z

Wasdpkj：

'''AudioPro.getAmplifier()'''
 

'''作用'''
此函数获取AudioPro模块的喇叭输出状态

'''参数'''
无

'''返回值'''
返回喇叭输出状态;1为喇叭开启,0为喇叭关闭

'''示例'''
无

'''其他'''
*'''[[AudioPro.begin()|begin()]]'''
*'''[[AudioPro.reset()|reset()]]'''
*'''[[AudioPro.end()|end()]]'''
*'''[[AudioPro.useInterrupt()|useInterrupt()]]'''
*'''[[AudioPro.detachInterrupt()|detachInterrupt()]]'''
*'''[[AudioPro.stopped()|stopped()]]'''
*'''[[AudioPro.stopPlaying()|stopPlaying()]]'''
*'''[[AudioPro.paused()|paused()]]'''
*'''[[AudioPro.pausePlaying()|pausePlaying()]]'''
*'''[[AudioPro.volumeUp()|volumeUp()]]'''
*'''[[AudioPro.volumeDown()|volumeDown()]]'''
*'''[[AudioPro.getVolume()|getVolume()]]'''
*'''[[AudioPro.setVolume()|setVolume()]]'''
*'''[[AudioPro.getPlaySpeed()|getPlaySpeed()]]'''
*'''[[AudioPro.setPlaySpeed()|setPlaySpeed()]]'''
*'''[[AudioPro.setAmplifier()|setAmplifier()]]'''
*'''[[AudioPro.getMonoMode()|getMonoMode()]]'''
*'''[[AudioPro.setMonoMode()|setMonoMode()]]'''
*'''[[AudioPro.decodeTime()|decodeTime()]]'''

[[MCookie-AudioPro Reference |返回mCookie-AudioPro Reference页面]]

AudioPro.setPlaySpeed()

2017-12-14T09:07:18Z

Wasdpkj：

'''AudioPro.setPlaySpeed(val)'''
 

'''作用'''
此函数可设置AudioPro模块的播放速度，但实际播放速度与音频比特率以及MCU性能有关，如果速度设置太快超过MCU计算能力，程序将会卡死

'''参数'''
val:音频播放速度倍数，范围0到127; 
播放MP3时建议不超过2; 
播放MIDI时建议不超过8; 

'''返回值'''
无

'''示例'''
无

'''其他'''
*'''[[AudioPro.begin()|begin()]]'''
*'''[[AudioPro.reset()|reset()]]'''
*'''[[AudioPro.end()|end()]]'''
*'''[[AudioPro.useInterrupt()|useInterrupt()]]'''
*'''[[AudioPro.detachInterrupt()|detachInterrupt()]]'''
*'''[[AudioPro.stopped()|stopped()]]'''
*'''[[AudioPro.stopPlaying()|stopPlaying()]]'''
*'''[[AudioPro.paused()|paused()]]'''
*'''[[AudioPro.pausePlaying()|pausePlaying()]]'''
*'''[[AudioPro.volumeUp()|volumeUp()]]'''
*'''[[AudioPro.volumeDown()|volumeDown()]]'''
*'''[[AudioPro.getVolume()|getVolume()]]'''
*'''[[AudioPro.setVolume()|setVolume()]]'''
*'''[[AudioPro.getPlaySpeed()|getPlaySpeed()]]'''
*'''[[AudioPro.getAmplifier()|getAmplifier()]]'''
*'''[[AudioPro.setAmplifier()|setAmplifier()]]'''
*'''[[AudioPro.getMonoMode()|getMonoMode()]]'''
*'''[[AudioPro.setMonoMode()|setMonoMode()]]'''
*'''[[AudioPro.decodeTime()|decodeTime()]]'''

[[MCookie-AudioPro Reference |返回mCookie-AudioPro Reference页面]]

AudioPro.getPlaySpeed()

2017-12-14T09:07:13Z

Wasdpkj：

AudioPro.setVolume()

2017-12-14T09:07:09Z

Wasdpkj：

'''AudioPro.setVolume(val)'''
 

'''作用'''
此函数可设置AudioPro模块的音量值

'''参数'''
val:模块音量，范围0到127

'''返回值'''
无

'''示例'''
无

'''其他'''
*'''[[AudioPro.begin()|begin()]]'''
*'''[[AudioPro.reset()|reset()]]'''
*'''[[AudioPro.end()|end()]]'''
*'''[[AudioPro.useInterrupt()|useInterrupt()]]'''
*'''[[AudioPro.detachInterrupt()|detachInterrupt()]]'''
*'''[[AudioPro.stopped()|stopped()]]'''
*'''[[AudioPro.stopPlaying()|stopPlaying()]]'''
*'''[[AudioPro.paused()|paused()]]'''
*'''[[AudioPro.pausePlaying()|pausePlaying()]]'''
*'''[[AudioPro.volumeUp()|volumeUp()]]'''
*'''[[AudioPro.volumeDown()|volumeDown()]]'''
*'''[[AudioPro.getVolume()|getVolume()]]'''
*'''[[AudioPro.getPlaySpeed()|getPlaySpeed()]]'''
*'''[[AudioPro.setPlaySpeed()|setPlaySpeed()]]'''
*'''[[AudioPro.getAmplifier()|getAmplifier()]]'''
*'''[[AudioPro.setAmplifier()|setAmplifier()]]'''
*'''[[AudioPro.getMonoMode()|getMonoMode()]]'''
*'''[[AudioPro.setMonoMode()|setMonoMode()]]'''
*'''[[AudioPro.decodeTime()|decodeTime()]]'''

[[MCookie-AudioPro Reference |返回mCookie-AudioPro Reference页面]]

AudioPro.getVolume()

2017-12-14T09:07:05Z

Wasdpkj：

'''AudioPro.getVolume()'''
 

'''作用'''
此函数可返回AudioPro模块实际音量值

'''参数'''
无

'''返回值'''
返回模块实际音量，范围0到127

'''示例'''
无

'''其他'''
*'''[[AudioPro.begin()|begin()]]'''
*'''[[AudioPro.reset()|reset()]]'''
*'''[[AudioPro.end()|end()]]'''
*'''[[AudioPro.useInterrupt()|useInterrupt()]]'''
*'''[[AudioPro.detachInterrupt()|detachInterrupt()]]'''
*'''[[AudioPro.stopped()|stopped()]]'''
*'''[[AudioPro.stopPlaying()|stopPlaying()]]'''
*'''[[AudioPro.paused()|paused()]]'''
*'''[[AudioPro.pausePlaying()|pausePlaying()]]'''
*'''[[AudioPro.volumeUp()|volumeUp()]]'''
*'''[[AudioPro.volumeDown()|volumeDown()]]'''
*'''[[AudioPro.setVolume()|setVolume()]]'''
*'''[[AudioPro.getPlaySpeed()|getPlaySpeed()]]'''
*'''[[AudioPro.setPlaySpeed()|setPlaySpeed()]]'''
*'''[[AudioPro.getAmplifier()|getAmplifier()]]'''
*'''[[AudioPro.setAmplifier()|setAmplifier()]]'''
*'''[[AudioPro.getMonoMode()|getMonoMode()]]'''
*'''[[AudioPro.setMonoMode()|setMonoMode()]]'''
*'''[[AudioPro.decodeTime()|decodeTime()]]'''

[[MCookie-AudioPro Reference |返回mCookie-AudioPro Reference页面]]

AudioPro.volumeDown()

2017-12-14T09:07:02Z

Wasdpkj：

'''AudioPro.volumeDown()'''
 

'''作用'''
此函数可控制AudioPro模块音量的减少，并返回实际音量值

'''参数'''
无

'''返回值'''
返回模块实际音量，范围0到127

'''示例'''
无

'''其他'''
*'''[[AudioPro.begin()|begin()]]'''
*'''[[AudioPro.reset()|reset()]]'''
*'''[[AudioPro.end()|end()]]'''
*'''[[AudioPro.useInterrupt()|useInterrupt()]]'''
*'''[[AudioPro.detachInterrupt()|detachInterrupt()]]'''
*'''[[AudioPro.stopped()|stopped()]]'''
*'''[[AudioPro.stopPlaying()|stopPlaying()]]'''
*'''[[AudioPro.paused()|paused()]]'''
*'''[[AudioPro.pausePlaying()|pausePlaying()]]'''
*'''[[AudioPro.volumeUp()|volumeUp()]]'''
*'''[[AudioPro.getVolume()|getVolume()]]'''
*'''[[AudioPro.setVolume()|setVolume()]]'''
*'''[[AudioPro.getPlaySpeed()|getPlaySpeed()]]'''
*'''[[AudioPro.setPlaySpeed()|setPlaySpeed()]]'''
*'''[[AudioPro.getAmplifier()|getAmplifier()]]'''
*'''[[AudioPro.setAmplifier()|setAmplifier()]]'''
*'''[[AudioPro.getMonoMode()|getMonoMode()]]'''
*'''[[AudioPro.setMonoMode()|setMonoMode()]]'''
*'''[[AudioPro.decodeTime()|decodeTime()]]'''

[[MCookie-AudioPro Reference |返回mCookie-AudioPro Reference页面]]

AudioPro.volumeUp()

2017-12-14T09:07:00Z

Wasdpkj：

'''AudioPro.volumeUp()'''
 

'''作用'''
此函数可控制AudioPro模块音量的增加，并返回实际音量值

'''参数'''
无

'''返回值'''
返回模块实际音量，范围0到127

'''示例'''
无

'''其他'''
*'''[[AudioPro.begin()|begin()]]'''
*'''[[AudioPro.reset()|reset()]]'''
*'''[[AudioPro.end()|end()]]'''
*'''[[AudioPro.useInterrupt()|useInterrupt()]]'''
*'''[[AudioPro.detachInterrupt()|detachInterrupt()]]'''
*'''[[AudioPro.stopped()|stopped()]]'''
*'''[[AudioPro.stopPlaying()|stopPlaying()]]'''
*'''[[AudioPro.paused()|paused()]]'''
*'''[[AudioPro.pausePlaying()|pausePlaying()]]'''
*'''[[AudioPro.volumeDown()|volumeDown()]]'''
*'''[[AudioPro.getVolume()|getVolume()]]'''
*'''[[AudioPro.setVolume()|setVolume()]]'''
*'''[[AudioPro.getPlaySpeed()|getPlaySpeed()]]'''
*'''[[AudioPro.setPlaySpeed()|setPlaySpeed()]]'''
*'''[[AudioPro.getAmplifier()|getAmplifier()]]'''
*'''[[AudioPro.setAmplifier()|setAmplifier()]]'''
*'''[[AudioPro.getMonoMode()|getMonoMode()]]'''
*'''[[AudioPro.setMonoMode()|setMonoMode()]]'''
*'''[[AudioPro.decodeTime()|decodeTime()]]'''

[[MCookie-AudioPro Reference |返回mCookie-AudioPro Reference页面]]

AudioPro.pausePlaying()

2017-12-14T09:06:58Z

Wasdpkj：

'''AudioPro.pausePlaying(val)'''
 

'''作用'''
此函数可设置AudioPro模块的暂停播放状态

'''参数'''
val:1为暂停播放,0为取消暂停

'''返回值'''
无

'''示例'''
无

'''其他'''
*'''[[AudioPro.begin()|begin()]]'''
*'''[[AudioPro.reset()|reset()]]'''
*'''[[AudioPro.end()|end()]]'''
*'''[[AudioPro.useInterrupt()|useInterrupt()]]'''
*'''[[AudioPro.detachInterrupt()|detachInterrupt()]]'''
*'''[[AudioPro.stopped()|stopped()]]'''
*'''[[AudioPro.stopPlaying()|stopPlaying()]]'''
*'''[[AudioPro.paused()|paused()]]'''
*'''[[AudioPro.volumeUp()|volumeUp()]]'''
*'''[[AudioPro.volumeDown()|volumeDown()]]'''
*'''[[AudioPro.getVolume()|getVolume()]]'''
*'''[[AudioPro.setVolume()|setVolume()]]'''
*'''[[AudioPro.getPlaySpeed()|getPlaySpeed()]]'''
*'''[[AudioPro.setPlaySpeed()|setPlaySpeed()]]'''
*'''[[AudioPro.getAmplifier()|getAmplifier()]]'''
*'''[[AudioPro.setAmplifier()|setAmplifier()]]'''
*'''[[AudioPro.getMonoMode()|getMonoMode()]]'''
*'''[[AudioPro.setMonoMode()|setMonoMode()]]'''
*'''[[AudioPro.decodeTime()|decodeTime()]]'''

[[MCookie-AudioPro Reference |返回mCookie-AudioPro Reference页面]]

AudioPro.paused()

2017-12-14T09:06:56Z

Wasdpkj：

'''AudioPro.paused()'''
 

'''作用'''
此函数可以查询AudioPro模块是否已暂停播放

'''参数'''
无

'''返回值'''
若模块已暂停播放则返回1，还没停止播放则返回0

'''示例'''
无

'''其他'''
*'''[[AudioPro.begin()|begin()]]'''
*'''[[AudioPro.reset()|reset()]]'''
*'''[[AudioPro.end()|end()]]'''
*'''[[AudioPro.useInterrupt()|useInterrupt()]]'''
*'''[[AudioPro.detachInterrupt()|detachInterrupt()]]'''
*'''[[AudioPro.stopped()|stopped()]]'''
*'''[[AudioPro.stopPlaying()|stopPlaying()]]'''
*'''[[AudioPro.pausePlaying()|pausePlaying()]]'''
*'''[[AudioPro.volumeUp()|volumeUp()]]'''
*'''[[AudioPro.volumeDown()|volumeDown()]]'''
*'''[[AudioPro.getVolume()|getVolume()]]'''
*'''[[AudioPro.setVolume()|setVolume()]]'''
*'''[[AudioPro.getPlaySpeed()|getPlaySpeed()]]'''
*'''[[AudioPro.setPlaySpeed()|setPlaySpeed()]]'''
*'''[[AudioPro.getAmplifier()|getAmplifier()]]'''
*'''[[AudioPro.setAmplifier()|setAmplifier()]]'''
*'''[[AudioPro.getMonoMode()|getMonoMode()]]'''
*'''[[AudioPro.setMonoMode()|setMonoMode()]]'''
*'''[[AudioPro.decodeTime()|decodeTime()]]'''

[[MCookie-AudioPro Reference |返回mCookie-AudioPro Reference页面]]

AudioPro.stopPlaying()

2017-12-14T09:06:23Z

Wasdpkj：

'''AudioPro.stopPlaying()'''
 

'''作用'''
此函数可将AudioPro模块的状态设置为停止播放

'''参数'''
无

'''返回值'''
无

'''示例'''
无

'''其他'''
*'''[[AudioPro.begin()|begin()]]'''
*'''[[AudioPro.reset()|reset()]]'''
*'''[[AudioPro.end()|end()]]'''
*'''[[AudioPro.useInterrupt()|useInterrupt()]]'''
*'''[[AudioPro.detachInterrupt()|detachInterrupt()]]'''
*'''[[AudioPro.stopped()|stopped()]]'''
*'''[[AudioPro.paused()|paused()]]'''
*'''[[AudioPro.pausePlaying()|pausePlaying()]]'''
*'''[[AudioPro.volumeUp()|volumeUp()]]'''
*'''[[AudioPro.volumeDown()|volumeDown()]]'''
*'''[[AudioPro.getVolume()|getVolume()]]'''
*'''[[AudioPro.setVolume()|setVolume()]]'''
*'''[[AudioPro.getPlaySpeed()|getPlaySpeed()]]'''
*'''[[AudioPro.setPlaySpeed()|setPlaySpeed()]]'''
*'''[[AudioPro.getAmplifier()|getAmplifier()]]'''
*'''[[AudioPro.setAmplifier()|setAmplifier()]]'''
*'''[[AudioPro.getMonoMode()|getMonoMode()]]'''
*'''[[AudioPro.setMonoMode()|setMonoMode()]]'''
*'''[[AudioPro.decodeTime()|decodeTime()]]'''

[[MCookie-AudioPro Reference |返回mCookie-AudioPro Reference页面]]

AudioPro.stopped()

2017-12-14T09:06:10Z

Wasdpkj：

'''AudioPro.stopped()'''
 

'''作用'''
此函数可以查询AudioPro模块是否已停止播放

'''参数'''
无

'''返回值'''
若模块已停止播放则返回1，还没停止播放则返回0

'''示例'''
无

'''其他'''
*'''[[AudioPro.begin()|begin()]]'''
*'''[[AudioPro.reset()|reset()]]'''
*'''[[AudioPro.end()|end()]]'''
*'''[[AudioPro.useInterrupt()|useInterrupt()]]'''
*'''[[AudioPro.detachInterrupt()|detachInterrupt()]]'''
*'''[[AudioPro.stopPlaying()|stopPlaying()]]'''
*'''[[AudioPro.paused()|paused()]]'''
*'''[[AudioPro.pausePlaying()|pausePlaying()]]'''
*'''[[AudioPro.volumeUp()|volumeUp()]]'''
*'''[[AudioPro.volumeDown()|volumeDown()]]'''
*'''[[AudioPro.getVolume()|getVolume()]]'''
*'''[[AudioPro.setVolume()|setVolume()]]'''
*'''[[AudioPro.getPlaySpeed()|getPlaySpeed()]]'''
*'''[[AudioPro.setPlaySpeed()|setPlaySpeed()]]'''
*'''[[AudioPro.getAmplifier()|getAmplifier()]]'''
*'''[[AudioPro.setAmplifier()|setAmplifier()]]'''
*'''[[AudioPro.getMonoMode()|getMonoMode()]]'''
*'''[[AudioPro.setMonoMode()|setMonoMode()]]'''
*'''[[AudioPro.decodeTime()|decodeTime()]]'''

[[MCookie-AudioPro Reference |返回mCookie-AudioPro Reference页面]]

AudioPro.detachInterrupt()

2017-12-14T09:05:53Z

Wasdpkj：

'''AudioPro.detachInterrupt(val)'''
 

'''作用'''
此函数可以关闭AudioPro模块的中断功能

'''参数'''
val:中断引脚,留空则默认调用D3

'''返回值'''
是否设置成功，成功返回1，失败返回0

'''示例'''
无

'''其他'''
*'''[[AudioPro.begin()|begin()]]'''
*'''[[AudioPro.reset()|reset()]]'''
*'''[[AudioPro.end()|end()]]'''
*'''[[AudioPro.useInterrupt()|useInterrupt()]]'''
*'''[[AudioPro.stopped()|stopped()]]'''
*'''[[AudioPro.stopPlaying()|stopPlaying()]]'''
*'''[[AudioPro.paused()|paused()]]'''
*'''[[AudioPro.pausePlaying()|pausePlaying()]]'''
*'''[[AudioPro.volumeUp()|volumeUp()]]'''
*'''[[AudioPro.volumeDown()|volumeDown()]]'''
*'''[[AudioPro.getVolume()|getVolume()]]'''
*'''[[AudioPro.setVolume()|setVolume()]]'''
*'''[[AudioPro.getPlaySpeed()|getPlaySpeed()]]'''
*'''[[AudioPro.setPlaySpeed()|setPlaySpeed()]]'''
*'''[[AudioPro.getAmplifier()|getAmplifier()]]'''
*'''[[AudioPro.setAmplifier()|setAmplifier()]]'''
*'''[[AudioPro.getMonoMode()|getMonoMode()]]'''
*'''[[AudioPro.setMonoMode()|setMonoMode()]]'''
*'''[[AudioPro.decodeTime()|decodeTime()]]'''

[[MCookie-AudioPro Reference |返回mCookie-AudioPro Reference页面]]

AudioPro.detachInterrupt()

2017-12-14T09:05:21Z

Wasdpkj：

'''AudioPro.detachInterrupt(val)'''
 

'''作用'''
此函数可以关闭AudioPro模块的中断功能

'''参数'''
val:中断引脚,留空则默认调用D3

'''返回值'''
是否设置成功，成功返回1，失败返回0

'''其他'''
*'''[[AudioPro.begin()|begin()]]'''
*'''[[AudioPro.reset()|reset()]]'''
*'''[[AudioPro.end()|end()]]'''
*'''[[AudioPro.useInterrupt()|useInterrupt()]]'''
*'''[[AudioPro.stopped()|stopped()]]'''
*'''[[AudioPro.stopPlaying()|stopPlaying()]]'''
*'''[[AudioPro.paused()|paused()]]'''
*'''[[AudioPro.pausePlaying()|pausePlaying()]]'''
*'''[[AudioPro.volumeUp()|volumeUp()]]'''
*'''[[AudioPro.volumeDown()|volumeDown()]]'''
*'''[[AudioPro.getVolume()|getVolume()]]'''
*'''[[AudioPro.setVolume()|setVolume()]]'''
*'''[[AudioPro.getPlaySpeed()|getPlaySpeed()]]'''
*'''[[AudioPro.setPlaySpeed()|setPlaySpeed()]]'''
*'''[[AudioPro.getAmplifier()|getAmplifier()]]'''
*'''[[AudioPro.setAmplifier()|setAmplifier()]]'''
*'''[[AudioPro.getMonoMode()|getMonoMode()]]'''
*'''[[AudioPro.setMonoMode()|setMonoMode()]]'''
*'''[[AudioPro.decodeTime()|decodeTime()]]'''

[[MCookie-AudioPro Reference |返回mCookie-AudioPro Reference页面]]

AudioPro.useInterrupt()

2017-12-14T09:05:07Z

Wasdpkj：

'''AudioPro.useInterrupt(val)'''
 

'''作用'''
此函数可以开启AudioPro模块的中断功能

'''参数'''
val:中断引脚,留空则默认调用D3

'''返回值'''
是否设置成功，成功返回1，失败返回0

'''示例'''
无

'''其他'''
*'''[[AudioPro.begin()|begin()]]'''
*'''[[AudioPro.reset()|reset()]]'''
*'''[[AudioPro.end()|end()]]'''
*'''[[AudioPro.detachInterrupt()|detachInterrupt()]]'''
*'''[[AudioPro.stopped()|stopped()]]'''
*'''[[AudioPro.stopPlaying()|stopPlaying()]]'''
*'''[[AudioPro.paused()|paused()]]'''
*'''[[AudioPro.pausePlaying()|pausePlaying()]]'''
*'''[[AudioPro.volumeUp()|volumeUp()]]'''
*'''[[AudioPro.volumeDown()|volumeDown()]]'''
*'''[[AudioPro.getVolume()|getVolume()]]'''
*'''[[AudioPro.setVolume()|setVolume()]]'''
*'''[[AudioPro.getPlaySpeed()|getPlaySpeed()]]'''
*'''[[AudioPro.setPlaySpeed()|setPlaySpeed()]]'''
*'''[[AudioPro.getAmplifier()|getAmplifier()]]'''
*'''[[AudioPro.setAmplifier()|setAmplifier()]]'''
*'''[[AudioPro.getMonoMode()|getMonoMode()]]'''
*'''[[AudioPro.setMonoMode()|setMonoMode()]]'''
*'''[[AudioPro.decodeTime()|decodeTime()]]'''

[[MCookie-AudioPro Reference |返回mCookie-AudioPro Reference页面]]

AudioPro.end()

2017-12-14T09:04:58Z

Wasdpkj：

'''AudioPro.end()'''
 

'''作用'''
此函数可以对AudioPro模块进行使能挂起（既软件关闭模块）

'''参数'''
无

'''返回值'''
无

'''示例'''
无

'''其他'''
*'''[[AudioPro.begin()|begin()]]'''
*'''[[AudioPro.reset()|reset()]]'''
*'''[[AudioPro.useInterrupt()|useInterrupt()]]'''
*'''[[AudioPro.detachInterrupt()|detachInterrupt()]]'''
*'''[[AudioPro.stopped()|stopped()]]'''
*'''[[AudioPro.stopPlaying()|stopPlaying()]]'''
*'''[[AudioPro.paused()|paused()]]'''
*'''[[AudioPro.pausePlaying()|pausePlaying()]]'''
*'''[[AudioPro.volumeUp()|volumeUp()]]'''
*'''[[AudioPro.volumeDown()|volumeDown()]]'''
*'''[[AudioPro.getVolume()|getVolume()]]'''
*'''[[AudioPro.setVolume()|setVolume()]]'''
*'''[[AudioPro.getPlaySpeed()|getPlaySpeed()]]'''
*'''[[AudioPro.setPlaySpeed()|setPlaySpeed()]]'''
*'''[[AudioPro.getAmplifier()|getAmplifier()]]'''
*'''[[AudioPro.setAmplifier()|setAmplifier()]]'''
*'''[[AudioPro.getMonoMode()|getMonoMode()]]'''
*'''[[AudioPro.setMonoMode()|setMonoMode()]]'''
*'''[[AudioPro.decodeTime()|decodeTime()]]'''

[[MCookie-AudioPro Reference |返回mCookie-AudioPro Reference页面]]

AudioPro预定义常量

2017-12-14T09:04:16Z

Wasdpkj：

#define VS1053_DEFAULT_VOLUME 96
*'''默认声音大小''': 
VS1053_DEFAULT_VOLUME：8位数据，用于初始化时设置模块默认音量 
例：musicPlayer.setVolume(96); //left & right 0-127 

#define VS1053_BANK_DEFAULT 0x00
#define VS1053_BANK_DRUMS1 0x78
#define VS1053_BANK_DRUMS2 0x7F
#define VS1053_BANK_MELODY 0x79
*'''bank模式设置''': 
具体见:'''[[midiPlayer.midiSetBank()|midiSetBank()]]''' 
例：midiPlayer.midiSetBank(0, VS1053_BANK_MELODY); 

#define VS1053_GM1_ACOUSTIC_GRAND_PIANO 0
#define VS1053_GM1_PIANO 1
#define VS1053_GM1_ELECTRIC_GRAND_PIANO 2
#define VS1053_GM1_HONKY_TONK_PIANO 3
#define VS1053_GM1_RHODES_PIANO 4
#define VS1053_GM1_CHORUSED_PIANO 5
#define VS1053_GM1_OCARINA 30
#define VS1053_GM1_OCARINB 31
#define VS1053_GM1_OCARINC 32
*'''乐器类型设置''': 
具体见:'''[[midiPlayer.midiSetInstrument()|midiSetInstrument()]]''' 
例：midiPlayer.midiSetInstrument(0, VS1053_GM1_PIANO); 

[[MCookie-AudioPro Reference |返回mCookie-AudioPro Reference页面]]

MusicPlayer.flushCancel()

2017-12-14T09:03:23Z

Wasdpkj：

'''AudioPro.flushCancel(val)'''
 

'''作用'''
此函数可清除AudioPro模块的缓存，播放MIDI等格式文件时必要执行

'''参数'''
val:post/pre/both/none可选，一般用both，详细作用见Datasheet的9.5.2

'''返回值'''
无

'''示例'''
见example目录'''_05_m_Module_AudioPro'''下的示例:'''FilePlayer_Joystick'''或'''FilePlayer'''

'''其他'''
*'''[[musicPlayer.getMusicNum()|getMusicNum()]]'''
*'''[[musicPlayer.getMusicName()|getMusicName()]]'''
*'''[[musicPlayer.playMP3()|playMP3()]]'''

[[MCookie-AudioPro Reference |返回mCookie-AudioPro Reference页面]]

MusicPlayer.flushCancel()

2017-12-14T09:02:49Z

Wasdpkj：

'''AudioPro.flushCancel(val)'''
 

'''作用'''
此函数可清除AudioPro模块的缓存，播放MIDI等格式文件时必要执行（见example目录'''_05_m_Module_AudioPro'''下的示例:'''FilePlayer_Joystick'''或'''FilePlayer'''）

'''参数'''
val:post/pre/both/none可选，一般用both，详细作用见Datasheet的9.5.2

'''返回值'''
无

'''示例'''
见example目录'''_05_m_Module_AudioPro'''下的示例:'''FilePlayer_Joystick'''或'''FilePlayer'''

'''其他'''
*'''[[musicPlayer.getMusicNum()|getMusicNum()]]'''
*'''[[musicPlayer.getMusicName()|getMusicName()]]'''
*'''[[musicPlayer.playMP3()|playMP3()]]'''

[[MCookie-AudioPro Reference |返回mCookie-AudioPro Reference页面]]

MusicPlayer.playMP3()

2017-12-14T09:02:39Z

Wasdpkj：

'''AudioPro.playMP3(val)'''
 

'''作用'''
此函数可播放SD卡内对应文件名的音频

具体支持格式见:'''[https://wiki.microduino.cn/index.php?title=MCookie-Module_AudioPro#.E8.A7.84.E6.A0.BC AudioPro支持格式]'''

'''参数'''
val:音频文件名

'''返回值'''
返回播放是否成功状态,1为成功,0为失败

'''示例'''
见example目录'''_05_m_Module_AudioPro'''下的示例:'''FilePlayer_Joystick'''或'''FilePlayer'''

'''其他'''
*'''[[musicPlayer.getMusicNum()|getMusicNum()]]'''
*'''[[musicPlayer.getMusicName()|getMusicName()]]'''
*'''[[musicPlayer.flushCancel()|flushCancel()]]'''

[[MCookie-AudioPro Reference |返回mCookie-AudioPro Reference页面]]

MusicPlayer.getMusicName()

2017-12-14T09:02:28Z

Wasdpkj：

'''AudioPro.getMusicName(val)'''
 

'''作用'''
此函数可返回SD卡内对应序号音频文件的文件名

'''参数'''
val:音频文件序号

'''返回值'''
返回SD卡内对应序号音频文件的文件名

'''示例'''
<source lang="cpp">

#include <Microduino_AudioPro.h>
#include <SD.h>

AudioPro_FilePlayer musicPlayer = AudioPro_FilePlayer(SD);

uint8_t fileNum = 0; //文件数量

void setup() {
Serial.begin(115200);
Serial.println(F("AudioPro(VS1053) Simple Test"));
pinMode(SD_PIN_SEL, OUTPUT); //先初始化AudioPro，所以先使能SD卡
digitalWrite(SD_PIN_SEL, HIGH);
delay(500);

if (! musicPlayer.begin()) { // initialise the music player
Serial.println(F("Couldn't find VS1053, do you have the right pins defined?"));
while (1);
}
Serial.println(F("VS1053 found"));

if (!SD.begin(SD_PIN_SEL)) {
Serial.println(F("initialization failed!"));
return;
}
Serial.println(F("initialization done."));

musicPlayer.setVolume(96); //left & right 0-127

Serial.println(F("Enter Index of File to play"));
fileNum = musicPlayer.getMusicNum(); //可以获取SD卡中曲目列表以及数量
Serial.print(F("Music Files : "));
Serial.println(fileNum);
for (uint8_t a = 0; a < fileNum; a++) {
Serial.print(F("\t File["));
Serial.print(a);
Serial.print(F("]: "));
Serial.println(musicPlayer.getMusicName(a)); //在此获取对应序号歌曲的文件名
}

// If DREQ is on an interrupt pin, we can do background
musicPlayer.useInterrupt(VS1053_PIN_DREQ); // DREQ int
}

void loop() {
}

</source>

'''其他'''
*'''[[musicPlayer.getMusicNum()|getMusicNum()]]'''
*'''[[musicPlayer.playMP3()|playMP3()]]'''
*'''[[musicPlayer.flushCancel()|flushCancel()]]'''

[[MCookie-AudioPro Reference |返回mCookie-AudioPro Reference页面]]

MusicPlayer.getMusicNum()

2017-12-14T09:02:17Z

Wasdpkj：

'''AudioPro.getMusicNum()'''
 

'''作用'''
此函数可返回SD卡内对应音频文件的数目;同时作为一个音频文件名索引作用

'''参数'''
无

'''返回值'''
返回SD卡内对应音频文件的数目

'''示例'''
<source lang="cpp">

#include <Microduino_AudioPro.h>
#include <SD.h>

AudioPro_FilePlayer musicPlayer = AudioPro_FilePlayer(SD);

uint8_t fileNum = 0; //文件数量

void setup() {
Serial.begin(115200);
Serial.println(F("AudioPro(VS1053) Simple Test"));
pinMode(SD_PIN_SEL, OUTPUT); //先初始化AudioPro，所以先使能SD卡
digitalWrite(SD_PIN_SEL, HIGH);
delay(500);

if (! musicPlayer.begin()) { // initialise the music player
Serial.println(F("Couldn't find VS1053, do you have the right pins defined?"));
while (1);
}
Serial.println(F("VS1053 found"));

if (!SD.begin(SD_PIN_SEL)) {
Serial.println(F("initialization failed!"));
return;
}
Serial.println(F("initialization done."));

musicPlayer.setVolume(96); //left & right 0-127

Serial.println(F("Enter Index of File to play"));
fileNum = musicPlayer.getMusicNum(); //可以获取SD卡中曲目列表以及数量
Serial.print(F("Music Files : "));
Serial.println(fileNum);
for (uint8_t a = 0; a < fileNum; a++) {
Serial.print(F("\t File["));
Serial.print(a);
Serial.print(F("]: "));
Serial.println(musicPlayer.getMusicName(a)); //在此获取对应序号歌曲的文件名
}

// If DREQ is on an interrupt pin, we can do background
musicPlayer.useInterrupt(VS1053_PIN_DREQ); // DREQ int
}

void loop() {
}

</source>

'''其他'''
*'''[[musicPlayer.getMusicName()|getMusicName()]]'''
*'''[[musicPlayer.playMP3()|playMP3()]]'''
*'''[[musicPlayer.flushCancel()|flushCancel()]]'''

[[MCookie-AudioPro Reference |返回mCookie-AudioPro Reference页面]]

MusicPlayer.getMusicNum()

2017-12-14T09:02:05Z

Wasdpkj：

MidiPlayer.noteOff()

2017-12-14T09:01:12Z

Wasdpkj：

'''AudioPro.noteOff(chan,data,val)'''
 

'''作用'''
此函数可设置AudioPro模块在midi模式下,控制对应midi音符的关闭

'''参数'''
chan:midi通道，范围0到15

data:midi通道所对应音符，范围0到127

val:midi通道所对应音量，范围0到127

'''返回值'''
无

'''示例'''
见example目录'''_05_m_Module_AudioPro'''下的示例:'''midiPlayer'''

'''其他'''
*'''[[midiPlayer.applyPatch()|applyPatch()]]'''
*'''[[midiPlayer.midiSetVolume()|midiSetVolume()]]'''
*'''[[midiPlayer.midiSetBank()|midiSetBank()]]'''
*'''[[midiPlayer.midiSetInstrument()|midiSetInstrument()]]'''
*'''[[midiPlayer.noteOn()|noteOn()]]'''
*'''[[midiPlayer.playROM()|playROM()]]'''

[[MCookie-AudioPro Reference |返回mCookie-AudioPro Reference页面]]

MidiPlayer.noteOn()

2017-12-14T09:00:59Z

Wasdpkj：

'''AudioPro.noteOn(chan,data,val)'''
 

'''作用'''
此函数可设置AudioPro模块在midi模式下,控制对应midi音符的开启

'''参数'''
chan:midi通道，范围0到15

data:midi通道所对应音符，范围0到127

val:midi通道所对应音量，范围0到127

'''返回值'''
无

'''示例'''
见example目录'''_05_m_Module_AudioPro'''下的示例:'''midiPlayer'''

'''其他'''
*'''[[midiPlayer.applyPatch()|applyPatch()]]'''
*'''[[midiPlayer.midiSetVolume()|midiSetVolume()]]'''
*'''[[midiPlayer.midiSetBank()|midiSetBank()]]'''
*'''[[midiPlayer.midiSetInstrument()|midiSetInstrument()]]'''
*'''[[midiPlayer.noteOff()|noteOff()]]'''
*'''[[midiPlayer.playROM()|playROM()]]'''

[[MCookie-AudioPro Reference |返回mCookie-AudioPro Reference页面]]

MidiPlayer.noteOn()

2017-12-14T09:00:51Z

Wasdpkj：

MidiPlayer.midiSetInstrument()

2017-12-14T09:00:38Z

Wasdpkj：

'''AudioPro.midiSetInstrument(chan,val)'''
 

'''作用'''
此函数可设置AudioPro模块在midi模式下,其所对应midi通道的乐器类型

'''参数'''
chan:midi通道，范围0到15

val:midi的乐器类型
*具体乐器类型和bank模式有关:'''[[MidiPlayer.midiSetBank()|midiSetBank()]]'''
*具体乐器类型见:'''[https://wiki.microduino.cn/index.php?title=MCookie-Module_AudioPro#MIDI.E6.97.8B.E5.BE.8B.E4.B9.90.E5.99.A8.E7.BB.84.28GM1.29 乐器类型]'''

'''返回值'''
无

'''示例'''
见example目录'''_05_m_Module_AudioPro'''下的示例:'''midiPlayer'''

'''其他'''
*'''[[midiPlayer.applyPatch()|applyPatch()]]'''
*'''[[midiPlayer.midiSetVolume()|midiSetVolume()]]'''
*'''[[midiPlayer.midiSetBank()|midiSetBank()]]'''
*'''[[midiPlayer.noteOn()|noteOn()]]'''
*'''[[midiPlayer.noteOff()|noteOff()]]'''
*'''[[midiPlayer.playROM()|playROM()]]'''

[[MCookie-AudioPro Reference |返回mCookie-AudioPro Reference页面]]

MidiPlayer.midiSetBank()

2017-12-14T09:00:19Z

Wasdpkj：

'''AudioPro.midiSetBank(chan,val)'''
 

'''作用'''
此函数可设置AudioPro模块在midi模式下,其所对应midi通道的bank模式

'''参数'''
chan:midi通道，范围0到15

val:midi的bank模式;
*[VS1053_BANK_DEFAULT]
*[VS1053_BANK_MELODY,GM1+GM2]
*[VS1053_BANK_DRUMS1,GM1]
*[VS1053_BANK_DRUMS2,GM2]

'''返回值'''
无

'''示例'''
见example目录'''_05_m_Module_AudioPro'''下的示例:'''midiPlayer'''

'''其他'''
*'''[[midiPlayer.applyPatch()|applyPatch()]]'''
*'''[[midiPlayer.midiSetVolume()|midiSetVolume()]]'''
*'''[[midiPlayer.midiSetInstrument()|midiSetInstrument()]]'''
*'''[[midiPlayer.noteOn()|noteOn()]]'''
*'''[[midiPlayer.noteOff()|noteOff()]]'''
*'''[[midiPlayer.playROM()|playROM()]]'''

[[MCookie-AudioPro Reference |返回mCookie-AudioPro Reference页面]]

MidiPlayer.midiSetVolume()

2017-12-14T09:00:00Z

Wasdpkj：

'''AudioPro.midiSetVolume(chan,val)'''
 

'''作用'''
此函数可设置AudioPro模块在midi模式下,其所对应midi通道的音量值

'''参数'''
chan:midi通道，范围0到15

val:midi通道所对应音量，范围0到127

'''返回值'''
无

'''示例'''
见example目录'''_05_m_Module_AudioPro'''下的示例:'''midiPlayer''

'''其他'''
*'''[[midiPlayer.applyPatch()|applyPatch()]]'''
*'''[[midiPlayer.midiSetBank()|midiSetBank()]]'''
*'''[[midiPlayer.midiSetInstrument()|midiSetInstrument()]]'''
*'''[[midiPlayer.noteOn()|noteOn()]]'''
*'''[[midiPlayer.noteOff()|noteOff()]]'''
*'''[[midiPlayer.playROM()|playROM()]]'''

[[MCookie-AudioPro Reference |返回mCookie-AudioPro Reference页面]]

MidiPlayer.applyPatch()

2017-12-14T08:59:37Z

Wasdpkj：

'''MidiPlayer.applyPatch(val,size)'''
 

'''作用'''
此函数可以给AudioPro模块加载补丁，从而实现一些额外功能

'''参数'''
val:补丁包名称

size:补丁包大小

'''返回值'''
无

'''示例'''
见example目录'''_05_m_Module_AudioPro'''下的示例:'''midiPlayer'''

'''其他'''
*'''[[midiPlayer.midiSetVolume()|midiSetVolume()]]'''
*'''[[midiPlayer.midiSetBank()|midiSetBank()]]'''
*'''[[midiPlayer.midiSetInstrument()|midiSetInstrument()]]'''
*'''[[midiPlayer.noteOn()|noteOn()]]'''
*'''[[midiPlayer.noteOff()|noteOff()]]'''
*'''[[midiPlayer.playROM()|playROM()]]'''

[[MCookie-AudioPro Reference |返回mCookie-AudioPro Reference页面]]

MidiPlayer.playROM()

2017-12-14T08:59:03Z

Wasdpkj：

'''AudioPro.playROM(val,size)'''
 

'''作用'''
此函数可使AudioPro模块播放MCU的ROM中的音频文件

因MCU资源有限,推荐存在ROM中的为midi格式音频

音频文件转16进制工具:'''[[File:DataToHex.zip]]'''

具体支持格式见:'''[https://wiki.microduino.cn/index.php?title=MCookie-Module_AudioPro#.E8.A7.84.E6.A0.BC AudioPro支持格式]'''

'''参数'''
val:音频文件变量名称

size:音频文件大小

'''返回值'''
返回播放是否成功状态,1为成功,0为失败

'''示例'''
见example目录'''_05_m_Module_AudioPro'''下的示例:'''midiROM'''

'''其他'''
*'''[[midiPlayer.applyPatch()|applyPatch()]]'''
*'''[[midiPlayer.midiSetVolume()|midiSetVolume()]]'''
*'''[[midiPlayer.midiSetBank()|midiSetBank()]]'''
*'''[[midiPlayer.midiSetInstrument()|midiSetInstrument()]]'''
*'''[[midiPlayer.noteOn()|noteOn()]]'''
*'''[[midiPlayer.noteOff()|noteOff()]]'''

[[MCookie-AudioPro Reference |返回mCookie-AudioPro Reference页面]]

MidiPlayer.playROM()

2017-12-14T08:58:41Z

Wasdpkj：

'''AudioPro.playROM(val,size)'''
 

'''作用'''
此函数可使AudioPro模块播放MCU的ROM中的音频文件

因MCU资源有限,推荐存在ROM中的为midi格式音频

音频文件转16进制工具:'''[[File:DataToHex.zip]]'''

具体支持格式见:'''[https://wiki.microduino.cn/index.php?title=MCookie-Module_AudioPro#.E8.A7.84.E6.A0.BC AudioPro支持格式]'''

'''参数'''
val:音频文件变量名称

size:音频文件大小

'''返回值'''
返回播放是否成功状态,1为成功,0为失败

'''示例'''
见example目录'''_05_m_Module_AudioPro'''下的示例:'''midiROM'''

'''示例'''
见example目录'''_05_m_Module_AudioPro'''下的示例:'''midiPlayer'''

'''其他'''
*'''[[midiPlayer.applyPatch()|applyPatch()]]'''
*'''[[midiPlayer.midiSetVolume()|midiSetVolume()]]'''
*'''[[midiPlayer.midiSetBank()|midiSetBank()]]'''
*'''[[midiPlayer.midiSetInstrument()|midiSetInstrument()]]'''
*'''[[midiPlayer.noteOn()|noteOn()]]'''
*'''[[midiPlayer.noteOff()|noteOff()]]'''

[[MCookie-AudioPro Reference |返回mCookie-AudioPro Reference页面]]

MidiPlayer.noteOff()

2017-12-14T08:58:32Z

Wasdpkj：

'''AudioPro.noteOff(chan,data,val)'''
 

'''作用'''
此函数可设置AudioPro模块在midi模式下,控制对应midi音符的关闭

'''参数'''
chan:midi通道，范围0到15

data:midi通道所对应音符，范围0到127

val:midi通道所对应音量，范围0到127

'''返回值'''
无

'''示例'''
见example目录'''_05_m_Module_AudioPro'''下的示例:'''midiPlayer'''

'''示例'''
见example目录'''_05_m_Module_AudioPro'''下的示例:'''midiPlayer'''

'''其他'''
*'''[[midiPlayer.applyPatch()|applyPatch()]]'''
*'''[[midiPlayer.midiSetVolume()|midiSetVolume()]]'''
*'''[[midiPlayer.midiSetBank()|midiSetBank()]]'''
*'''[[midiPlayer.midiSetInstrument()|midiSetInstrument()]]'''
*'''[[midiPlayer.noteOn()|noteOn()]]'''
*'''[[midiPlayer.playROM()|playROM()]]'''

[[MCookie-AudioPro Reference |返回mCookie-AudioPro Reference页面]]

MidiPlayer.noteOn()

2017-12-14T08:58:22Z

Wasdpkj：

'''AudioPro.noteOn(chan,data,val)'''
 

'''作用'''
此函数可设置AudioPro模块在midi模式下,控制对应midi音符的开启

'''参数'''
chan:midi通道，范围0到15

data:midi通道所对应音符，范围0到127

val:midi通道所对应音量，范围0到127

'''返回值'''
无

'''示例'''
见example目录'''_05_m_Module_AudioPro'''下的示例:'''midiPlayer'''

'''示例'''
见example目录'''_05_m_Module_AudioPro'''下的示例:'''midiPlayer'''

'''其他'''
*'''[[midiPlayer.applyPatch()|applyPatch()]]'''
*'''[[midiPlayer.midiSetVolume()|midiSetVolume()]]'''
*'''[[midiPlayer.midiSetBank()|midiSetBank()]]'''
*'''[[midiPlayer.midiSetInstrument()|midiSetInstrument()]]'''
*'''[[midiPlayer.noteOff()|noteOff()]]'''
*'''[[midiPlayer.playROM()|playROM()]]'''

[[MCookie-AudioPro Reference |返回mCookie-AudioPro Reference页面]]

MidiPlayer.midiSetInstrument()

2017-12-14T08:58:11Z

Wasdpkj：

'''AudioPro.midiSetInstrument(chan,val)'''
 

'''作用'''
此函数可设置AudioPro模块在midi模式下,其所对应midi通道的乐器类型

'''参数'''
chan:midi通道，范围0到15

val:midi的乐器类型
*具体乐器类型和bank模式有关:'''[[MidiPlayer.midiSetBank()|midiSetBank()]]'''
*具体乐器类型见:'''[https://wiki.microduino.cn/index.php?title=MCookie-Module_AudioPro#MIDI.E6.97.8B.E5.BE.8B.E4.B9.90.E5.99.A8.E7.BB.84.28GM1.29 乐器类型]'''

'''返回值'''
无

'''示例'''
见example目录'''_05_m_Module_AudioPro'''下的示例:'''midiPlayer'''

'''示例'''
见example目录'''_05_m_Module_AudioPro'''下的示例:'''midiPlayer'''

'''其他'''
*'''[[midiPlayer.applyPatch()|applyPatch()]]'''
*'''[[midiPlayer.midiSetVolume()|midiSetVolume()]]'''
*'''[[midiPlayer.midiSetBank()|midiSetBank()]]'''
*'''[[midiPlayer.noteOn()|noteOn()]]'''
*'''[[midiPlayer.noteOff()|noteOff()]]'''
*'''[[midiPlayer.playROM()|playROM()]]'''

[[MCookie-AudioPro Reference |返回mCookie-AudioPro Reference页面]]

MidiPlayer.midiSetBank()

2017-12-14T08:58:00Z

Wasdpkj：

'''AudioPro.midiSetBank(chan,val)'''
 

'''作用'''
此函数可设置AudioPro模块在midi模式下,其所对应midi通道的bank模式

'''参数'''
chan:midi通道，范围0到15

val:midi的bank模式;
*[VS1053_BANK_DEFAULT]
*[VS1053_BANK_MELODY,GM1+GM2]
*[VS1053_BANK_DRUMS1,GM1]
*[VS1053_BANK_DRUMS2,GM2]

'''返回值'''
无

'''示例'''
见example目录'''_05_m_Module_AudioPro'''下的示例:'''midiPlayer'''

'''示例'''
见example目录'''_05_m_Module_AudioPro'''下的示例:'''midiPlayer'''

'''其他'''
*'''[[midiPlayer.applyPatch()|applyPatch()]]'''
*'''[[midiPlayer.midiSetVolume()|midiSetVolume()]]'''
*'''[[midiPlayer.midiSetInstrument()|midiSetInstrument()]]'''
*'''[[midiPlayer.noteOn()|noteOn()]]'''
*'''[[midiPlayer.noteOff()|noteOff()]]'''
*'''[[midiPlayer.playROM()|playROM()]]'''

[[MCookie-AudioPro Reference |返回mCookie-AudioPro Reference页面]]

MidiPlayer.midiSetVolume()

2017-12-14T08:57:49Z

Wasdpkj：

'''AudioPro.midiSetVolume(chan,val)'''
 

'''作用'''
此函数可设置AudioPro模块在midi模式下,其所对应midi通道的音量值

'''参数'''
chan:midi通道，范围0到15

val:midi通道所对应音量，范围0到127

'''返回值'''
无

'''示例'''
见example目录'''_05_m_Module_AudioPro'''下的示例:'''midiPlayer'''

'''示例'''
见example目录'''_05_m_Module_AudioPro'''下的示例:'''midiPlayer'''

'''其他'''
*'''[[midiPlayer.applyPatch()|applyPatch()]]'''
*'''[[midiPlayer.midiSetBank()|midiSetBank()]]'''
*'''[[midiPlayer.midiSetInstrument()|midiSetInstrument()]]'''
*'''[[midiPlayer.noteOn()|noteOn()]]'''
*'''[[midiPlayer.noteOff()|noteOff()]]'''
*'''[[midiPlayer.playROM()|playROM()]]'''

[[MCookie-AudioPro Reference |返回mCookie-AudioPro Reference页面]]

MidiPlayer.applyPatch()

2017-12-14T08:57:15Z

Wasdpkj：

AudioPro.decodeTime()

2017-12-14T08:56:17Z

Wasdpkj：

AudioPro.setMonoMode()

2017-12-14T08:56:08Z

Wasdpkj：

AudioPro.getMonoMode()

2017-12-14T08:55:59Z

Wasdpkj：

AudioPro.setAmplifier()

2017-12-14T08:55:41Z

Wasdpkj：

AudioPro.getAmplifier()

2017-12-14T08:55:26Z

Wasdpkj：

AudioPro.setPlaySpeed()

2017-12-14T08:55:11Z

Wasdpkj：