Audio
Audio模块用于提供音频的录制和播放功能，可调用系统的麦克风设备进行录音操作，也可调用系统的扬声器设备播放音频文件。通过plus.audio获取音频管理对象。
常量：
- ROUTE_SPEAKER设备的扬声器音频输出线路
- ROUTE_EARPIECE设备听筒音频输出线路
方法：
- getRecorder获取当前设备的录音对象
- createPlayer创建音频播放对象
对象：
回调方法：
- RecordSuccessCallback录音操作成功回调
- PlaySuccessCallback播放音频文件操作成功回调
- AudioErrorCallback音频操作失败回调
getRecorder
获取当前设备的录音对象
AudioRecorder plus.audio.getRecorder();说明：
获取当前设备的录音对象，进行录音操作，录音对象是设备的独占资源，在同一时间仅可执行一个录音操作，否则可能会导致操作失败。
返回值：
录音对象
平台支持：
Android : 2.2+
支持录制"amr"、"3gp"等格式文件。iOS : 4.3+
支持录制"wav"、"aac"、"amr"等格式文件。WP : 7.5+
示例：
<!DOCTYPE html>
<html>
<head>
<meta charset="utf-8">
<title>Audio Example</title>
<script type="text/javascript">
// 扩展API加载完毕后调用onPlusReady回调函数
document.addEventListener( "plusready", onPlusReady, false );
var r = null;
// 扩展API加载完毕，现在可以正常调用扩展API
function onPlusReady() {
r = plus.audio.getRecorder();
}
function startRecord() {
if ( r == null ) {
alert( "Device not ready!" );
return;
}
r.record( {filename:"_doc/audio/"}, function () {
alert( "Audio record success!" );
}, function ( e ) {
alert( "Audio record failed: " + e.message );
} );
}
function stopRecord() {
r.stop();
}
</script>
</head>
<body>
<input type="button" value="Start Record" onclick="startRecord();"/>
<br/>
<input type="button" value="Stop Record" onclick="stopRecord();"/>
</body>
</html>createPlayer
创建音频播放对象
AudioPlayer plus.audio.createPlayer( path );说明：
创建一个音频文件播放对象，用于打开音频文件并播放。 可通过path参数指定要播放的音频文件。创建后返回播放对象，通过Audio.play方法开始播放。
返回值：
音频播放对象
平台支持：
Android : 2.2+
支持aac、3gp、amr、mp3、mp4、mid、ogg、wav等格式文件。iOS : 4.3+
支持aac、aiff、mp3、mid、wav、amr等格式文件。WP : 7.5+
示例：
<!DOCTYPE html>
<html>
<head>
<meta charset="utf-8">
<title>Audio Example</title>
<script type="text/javascript">
// 扩展API加载完毕后调用onPlusReady回调函数
document.addEventListener( "plusready", onPlusReady, false );
// 扩展API加载完毕，现在可以正常调用扩展API
function onPlusReady() {
}
var p = null;
function startPlay() {
if ( plus.audio == undefined ) {
alert( "Device not ready!" );
}
p = plus.audio.createPlayer( "_Doc/Audio/test.mp3" );
p.play( function () {
alert( "Audio play success!" );
}, function ( e ) {
alert( "Audio play error: " + e.message );
} );
}
function stopPlay() {
p.stop();
}
</script>
</head>
<body>
<input type="button" value="Start Play" onclick="startPlay();"/>
<br/>
<input type="button" value="Stop Play" onclick="stopPlay();"/>
</body>
</html>ROUTE_SPEAKER
设备的扬声器音频输出线路
plus.audio.ROUTE_SPEAKER;说明：
音频输出线路常量，值为0。音频播放时在设备的扬声器输出。
ROUTE_EARPIECE
设备听筒音频输出线路
plus.audio.ROUTE_EARPIECE;说明：
音频输出线路常量，值为1。音频播放时在设备的听筒输出。
RecordOption
JSON对象，调用麦克风设备进行录音的参数
说明：
JSON对象，调用麦克风设备进行录音的参数
属性：
- filename：DOMString，可设置具体文件名，也可只设置路径，如果以“/”结尾则表明是路径，文件名由录音程序自动生成。 如未设置则使用默认目录生成随机文件名称，默认目录为应用%APPID%下的documents目录。
- samplerate：DOMString，需通过supportedSamplerates属性获取设备支持的采样率，若设置无效的值，则使用系统默认的采样率。
- format：DOMString，需通过supportedFormats属性获取设备支持的录音格式，若设置无效的值，则使用系统默认的录音格式。
RecordSuccessCallback
录音操作成功回调
void onSuccess( recordFile ) {
// Get record file code.
}说明：
麦克风录音操作成功的回调函数，在录音操作完成调用stop()方法时调用。
参数：
- recordFile (DOMString) 可选 录音操作保存的音频文件路径
PlaySuccessCallback
播放音频文件操作成功回调
void onCompleted() {
// Play audio file completed code.
}说明：
麦克风录音操作成功的回调函数，在录音操作完成调用stop()方法时调用。
AudioErrorCallback
音频操作失败回调
void onError( error ) {
// Handle audio error
}说明：
音频操作失败回调
参数：
- error (DOMException) 可选 音频操作的错误信息