文章分类 Classification
Audio
稿件来源: 互联网 撰稿作者: 匿名 发表日期: 2015-03-23 阅读次数: 103 查看权限: 游客查看
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
ROUTE_SPEAKER
设备的扬声器音频输出线路
plus.audio.ROUTE_SPEAKER;
说明：
说明：
音频输出线路常量，值为0。音频播放时在设备的扬声器输出。
ROUTE_EARPIECE
ROUTE_EARPIECE
设备听筒音频输出线路
plus.audio.ROUTE_EARPIECE;
说明：
说明：
音频输出线路常量，值为1。音频播放时在设备的听筒输出。
RecordOption
RecordOption
JSON对象，调用麦克风设备进行录音的参数
说明：
说明：
JSON对象，调用麦克风设备进行录音的参数
属性：
属性：-
filename：DOMString，可设置具体文件名，也可只设置路径，如果以“/”结尾则表明是路径，文件名由录音程序自动生成。 如未设置则使用默认目录生成随机文件名称，默认目录为应用%APPID%下的documents目录。 -
samplerate：DOMString，需通过supportedSamplerates属性获取设备支持的采样率，若设置无效的值，则使用系统默认的采样率。 -
format：DOMString，需通过supportedFormats属性获取设备支持的录音格式，若设置无效的值，则使用系统默认的录音格式。
RecordSuccessCallback
RecordSuccessCallback
录音操作成功回调
void onSuccess( recordFile ) {
// Get record file code.
}
说明：
说明：
麦克风录音操作成功的回调函数，在录音操作完成调用stop()方法时调用。
参数：
参数：-
recordFile (DOMString) 可选 录音操作保存的音频文件路径
PlaySuccessCallback
PlaySuccessCallback
播放音频文件操作成功回调
void onCompleted() {
// Play audio file completed code.
}
说明：
说明：
麦克风录音操作成功的回调函数，在录音操作完成调用stop()方法时调用。
AudioErrorCallback
AudioErrorCallback
音频操作失败回调
void onError( error ) {
// Handle audio error
}
说明：
说明：
音频操作失败回调
参数：
参数：-
error (DOMException) 可选 音频操作的错误信息
关键词: html5puls,io,Audio 编辑时间: 2015-03-23 22:15:53
0
高兴
0
支持
0
搞笑
0
不解
0
谎言
0
枪稿
0
震惊
0
无奈
0
无聊
0
反对
0
愤怒
100%(1)
0%(0)
中搜索：
中搜索：
- 暂无评论
文章图片 article Pictrue
网友评论