宜信同城网交流论坛技术专版技术专区audio 模块用于提供音频的录制和播放功能Audio模块用于提供音频的录制和播放功能，可调用系统的麦克风设备进行录音操作，也可调用系统的扬 ...

admin 发表于 2023-2-16 18:54:55

audio 模块用于提供音频的录制和播放功能

<div id="article_content" class="article_content clearfix">
 <link rel="stylesheet" href="https://csdnimg.cn/release/blogv2/dist/mdeditor/css/editerView/kdoc_html_views-1a98987dfd.css">
 <link rel="stylesheet" href="https://csdnimg.cn/release/blogv2/dist/mdeditor/css/editerView/ck_htmledit_views-6e43165c0a.css">
 <div id="content_views" class="htmledit_views">
 Audio模块用于提供音频的录制和播放功能，可调用系统的麦克风设备进行录音操作，也可调用系统的扬声器设备播放音频文件。通过plus.audio获取音频管理对象。
<h2 style="margin-left:.8em;">常量：</h2>
<ul><li><ahref="https://blog.csdn.net/qq_40575646/article/details/122607074#plus.audio.ROUTE_SPEAKER">ROUTE_SPEAKER</a>: 设备的扬声器音频输出线路</li><li><ahref="https://blog.csdn.net/qq_40575646/article/details/122607074#plus.audio.ROUTE_EARPIECE">ROUTE_EARPIECE</a>: 设备听筒音频输出线路</li></ul>
<h2 style="margin-left:.8em;">方法：</h2>
<ul><li><ahref="https://blog.csdn.net/qq_40575646/article/details/122607074#plus.audio.getRecorder">getRecorder</a>: 获取当前设备的录音对象</li><li><ahref="https://blog.csdn.net/qq_40575646/article/details/122607074#plus.audio.createPlayer">createPlayer</a>: 创建音频播放器对象</li></ul>
<h2 style="margin-left:.8em;">对象：</h2>
<ul><li><ahref="https://www.html5plus.org/doc/zh_cn/audio.html#plus.audio.AudioRecorder">AudioRecorder</a>: 录音对象</li><li><ahref="https://www.html5plus.org/doc/zh_cn/audio.html#plus.audio.AudioPlayer">AudioPlayer</a>: 音频播放对象</li><li><ahref="https://www.html5plus.org/doc/zh_cn/audio.html#plus.audio.AudioPlayerEvent">AudioPlayerEvent</a>: 音频播放控件事件类型</li><li><ahref="https://www.html5plus.org/doc/zh_cn/audio.html#plus.audio.AudioPlayerStyles">AudioPlayerStyles</a>: 音频播放对象的参数</li><li><ahref="https://www.html5plus.org/doc/zh_cn/audio.html#plus.audio.AudioRecorderStyles">AudioRecorderStyles</a>: 音频录制的参数</li></ul>
<h2 style="margin-left:.8em;">回调方法：</h2>
<ul><li><ahref="https://www.html5plus.org/doc/zh_cn/audio.html#plus.audio.RecordSuccessCallback">RecordSuccessCallback</a>: 录音操作成功回调</li><li><ahref="https://www.html5plus.org/doc/zh_cn/audio.html#plus.audio.PlaySuccessCallback">PlaySuccessCallback</a>: 播放音频文件操作成功回调</li><li><ahref="https://www.html5plus.org/doc/zh_cn/audio.html#plus.audio.AudioErrorCallback">AudioErrorCallback</a>: 音频操作失败回调</li></ul>
<h2 style="margin-left:.8em;">权限：</h2>
5+功能模块（permissions）
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
{
// ...
"permissions":{
// ...
"Audio": {
"description": "音频"
}
}
}
</code></code></pre>
<h1 style="margin-left:0;">ROUTE_SPEAKER</h1>
设备的扬声器音频输出线路
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
plus.audio.ROUTE_SPEAKER;
</code></code></pre>
<h2 style="margin-left:.8em;">说明：</h2>
Number 类型
音频输出线路常量，值为0。音频播放时在设备的扬声器输出。
<h1 style="margin-left:0;">ROUTE_EARPIECE</h1>
设备听筒音频输出线路
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
plus.audio.ROUTE_EARPIECE;
</code></code></pre>
<h2 style="margin-left:.8em;">说明：</h2>
Number 类型
音频输出线路常量，值为1。音频播放时在设备的听筒输出。
<h1 style="margin-left:0;">getRecorder</h1>
获取当前设备的录音对象
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
AudioRecorder plus.audio.getRecorder();
</code></code></pre>
<h2 style="margin-left:.8em;">说明：</h2>
获取当前设备的录音对象，进行录音操作，录音对象是设备的独占资源，在同一时间仅可执行一个录音操作，否则可能会导致操作失败。
<h2 style="margin-left:.8em;">参数：</h2>
<h2 style="margin-left:.8em;">返回值：</h2>
<ahref="https://blog.csdn.net/qq_40575646/article/details/122607074#plus.audio.AudioRecorder">AudioRecorder</a> : 录音对象
<h2 style="margin-left:.8em;">平台支持：</h2>
<ul><li>Android - 2.2+ (支持) : 支持录制"amr"、"3gp"、"aac"等格式文件。注：aac格式要求android4.4及以上系统。 </li><li>iOS - 4.3+ (支持) : 支持录制"wav"、"aac"、"amr"、"mp3"等格式文件。 </li></ul>
<h2 style="margin-left:.8em;">示例：</h2>
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
<!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();"/>
 
<input type="button" value="Stop Record" onclick="stopRecord();"/>
</body>
</html>
</code></code></pre>
<ahref="https://uniapp.dcloud.io/use-html5plus">uni-app使用plus注意事项</a>
<h1 style="margin-left:0;">createPlayer</h1>
创建音频播放器对象
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
AudioPlayer plus.audio.createPlayer(styles);
AudioPlayer plus.audio.createPlayer(path);
</code></code></pre>
<h2 style="margin-left:.8em;">说明：</h2>
用于播放音频文件，可以直接传入音频文件地址或音频播放参数对象AudioPlayerStyles。返回播放对象，可调用其play方法开始播放。
<h2 style="margin-left:.8em;">参数：</h2>
<ul><li>styles: ( <ahref="https://www.html5plus.org/doc/zh_cn/audio.html#plus.audio.AudioPlayerStyles">AudioPlayerStyles</a> | String ) 必选 音频播放参数 字符串（String）类型表示音频文件路径； JSON对象则表示音频播放参数对象AudioPlayerStyles，HBuilderX1.9.0及以上版本支持。 </li></ul>
<h2 style="margin-left:.8em;">返回值：</h2>
<ahref="https://blog.csdn.net/qq_40575646/article/details/122607074#plus.audio.AudioPlayer">AudioPlayer</a> : 音频播放对象
<h2 style="margin-left:.8em;">平台支持：</h2>
<ul><li>Android - 2.2+ (支持) : 支持"aac"、"3gp"、"amr"、"mp3"、"mp4"、"mid"、"ogg"、"wav"等格式文件。支持播放网络路径音频，以http/https开头，如“http://demo.dcloud.net.cn/test/audio/apple.mp3”。 </li><li>iOS - 4.3+ (支持) : 支持"aac"、"aiff"、"mp3"、"mid"、"wav"、"amr"等格式文件。支持播放网络路径音频，以http/https开头，如“http://demo.dcloud.net.cn/test/audio/apple.mp3”。 </li></ul>
<h2 style="margin-left:.8em;">示例：</h2>
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
<!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();"/>
 
<input type="button" value="Stop Play" onclick="stopPlay();"/>
</body>
</html>
</code></code></pre>
<ahref="https://uniapp.dcloud.io/use-html5plus">uni-app使用plus注意事项</a>
<h1 style="margin-left:0;">AudioRecorder</h1>
录音对象
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
interface AudioRecorder {
readonly attribute String[] supportedSamplerates;
readonly attribute String[] supportedFormats;
function record( option, successCB, errorCB );
function stop();
}
</code></code></pre>
<h2 style="margin-left:.8em;">属性：</h2>
<ul><li><ahref="https://blog.csdn.net/qq_40575646/article/details/122607074#plus.audio.AudioRecorder.supportedSamplerates">supportedSamplerates</a>: 数组，设备录音支持的采样率</li><li><ahref="https://blog.csdn.net/qq_40575646/article/details/122607074#plus.audio.AudioRecorder.supportedFormats">supportedFormats</a>: 数组，设备录音支持的文件格式</li></ul>
<h2 style="margin-left:.8em;">方法：</h2>
<ul><li><ahref="https://blog.csdn.net/qq_40575646/article/details/122607074#plus.audio.AudioRecorder.record">record</a>: 调用设备麦克风进行录音操作</li><li><ahref="https://blog.csdn.net/qq_40575646/article/details/122607074#plus.audio.AudioRecorder.stop">stop</a>: 结束录音操作</li></ul>
<h1 style="margin-left:0;">supportedSamplerates</h1>
数组，设备录音支持的采样率
<h2 style="margin-left:.8em;">说明：</h2>
String 类型只读属性
属性类型为Array(String)，若不支持此属性则返回空数组对象。支持的录音采样率，字符串格式为“采样频率”，如“8000”；其单位为Hz。
<h1 style="margin-left:0;">supportedFormats</h1>
数组，设备录音支持的文件格式
<h2 style="margin-left:.8em;">说明：</h2>
String 类型只读属性
属性类型为Array(String)，若不支持此属性则返回空数组对象。支持的录音文件的格式，字符串格式为文件格式后缀名，如"mp3"、"aac"、"wav"等。
<h2 style="margin-left:.8em;">平台支持：</h2>
<ul><li>Android - 2.2+ (支持) : Android平台支持"amr"、"3gp"格式，默认为"amr"。 </li><li>iOS - 4.5+ (支持) : iOS平台支持"aac"、"wav"、"amr"格式，默认为"wav"。 </li></ul>
<h1 style="margin-left:0;">record</h1>
调用设备麦克风进行录音操作
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
void recorder.record( option, successCB, errorCB );
</code></code></pre>
<h2 style="margin-left:.8em;">说明：</h2>
调用设备麦克风开始录音操作，录音完成需调用stop方法停止。录音完成后将通过successCB回调返回录音后的文件数据。
<h2 style="margin-left:.8em;">参数：</h2>
<ul><li>styles: ( <ahref="https://blog.csdn.net/qq_40575646/article/details/122607074#plus.audio.AudioRecorderStyles">AudioRecorderStyles</a> ) 必选 设置录音的参数 </li><li>successCB: ( <ahref="https://blog.csdn.net/qq_40575646/article/details/122607074#plus.audio.RecordSuccessCallback">RecordSuccessCallback</a> ) 必选 录音操作成功回调函数 </li><li>errorCB: ( <ahref="https://www.html5plus.org/doc/zh_cn/audio.html#plus.audio.AudioErrorCallback">AudioErrorCallback</a> ) 可选 录音操作错误回调函数 </li></ul>
<h2 style="margin-left:.8em;">返回值：</h2>
void : 无
<h2 style="margin-left:.8em;">示例：</h2>
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
// 录音操作
var r = plus.audio.getRecorder();
r.record( {filename:"_doc/audio/"}, function () {
alert( "Audio record success!" );
}, function ( e ) {
alert( "Audio record failed: " + e.message );
} );
</code></code></pre>
<ahref="https://uniapp.dcloud.io/use-html5plus">uni-app使用plus注意事项</a>
<h1 style="margin-left:0;">stop</h1>
结束录音操作
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
void recorder.stop();
</code></code></pre>
<h2 style="margin-left:.8em;">说明：</h2>
结束录音操作，通知设备完成录音操作。录音完成后将调用record方法中传入的successCB回调返回录音文件。
<h2 style="margin-left:.8em;">参数：</h2>
无
<h2 style="margin-left:.8em;">返回值：</h2>
void : 无
<h2 style="margin-left:.8em;">示例：</h2>
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
// 录音操作
var r = plus.audio.getRecorder();
r.record( {filename:"_doc/audio/"}, function () {
alert( "Audio record success!" );
}, function ( e ) {
alert( "Audio record failed: " + e.message );
} );

// ...... 
// 停止录音
r.stop();
</code></code></pre>
<ahref="https://uniapp.dcloud.io/use-html5plus">uni-app使用plus注意事项</a>
<h1 style="margin-left:0;">AudioPlayer</h1>
音频播放对象
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
interface AudioPlayer {
function void close();
function Boolean isPaused();
function void play(successCB, errorCB);
function void pause();
function void resume();
function void stop();
function void seekTo(position);
function Number getBuffered();
function Number getDuration();
function Number getPosition();
function void setRoute(route);
function void setSessionCategory(category);
}
</code></code></pre>
<h2 style="margin-left:.8em;">说明：</h2>
音频播放对象，用于音频文件的播放。不能通过new方法直接创建，只能通过audio.createPlayer方法创建。
<h2 style="margin-left:.8em;">方法：</h2>
<ul><li><ahref="https://blog.csdn.net/qq_40575646/article/details/122607074#plus.audio.AudioPlayer.addEventListener">addEventListener</a>: 添加事件监听器</li><li><ahref="https://blog.csdn.net/qq_40575646/article/details/122607074#plus.audio.AudioPlayer.close">close</a>: 关闭音频播放对象</li><li><ahref="https://blog.csdn.net/qq_40575646/article/details/122607074#plus.audio.AudioPlayer.getBuffered">getBuffered</a>: 音频缓冲的时间点</li><li><ahref="https://blog.csdn.net/qq_40575646/article/details/122607074#plus.audio.AudioPlayer.getDuration">getDuration</a>: 获取音频的总长度</li><li><ahref="https://blog.csdn.net/qq_40575646/article/details/122607074#plus.audio.AudioPlayer.getPosition">getPosition</a>: 获取音频的当前播放位置</li><li><ahref="https://blog.csdn.net/qq_40575646/article/details/122607074#plus.audio.AudioPlayer.getStyles">getStyles</a>: 音频播放的参数</li><li><ahref="https://blog.csdn.net/qq_40575646/article/details/122607074#plus.audio.AudioPlayer.isPaused">isPaused</a>: 当前是否暂停或停止状态</li><li><ahref="https://blog.csdn.net/qq_40575646/article/details/122607074#plus.audio.AudioPlayer.play">play</a>: 播放音频</li><li><ahref="https://blog.csdn.net/qq_40575646/article/details/122607074#plus.audio.AudioPlayer.pause">pause</a>: 暂停播放</li><li><ahref="https://blog.csdn.net/qq_40575646/article/details/122607074#plus.audio.AudioPlayer.removeEventListener">removeEventListener</a>: 移除事件监听器</li><li><ahref="https://blog.csdn.net/qq_40575646/article/details/122607074#plus.audio.AudioPlayer.resume">resume</a>: 恢复播放</li><li><ahref="https://blog.csdn.net/qq_40575646/article/details/122607074#plus.audio.AudioPlayer.seekTo">seekTo</a>: 跳到指定位置</li><li><ahref="https://blog.csdn.net/qq_40575646/article/details/122607074#plus.audio.AudioPlayer.stop">stop</a>: 停止播放</li><li><ahref="https://blog.csdn.net/qq_40575646/article/details/122607074#plus.audio.AudioPlayer.setRoute">setRoute</a>: 音频输出线路</li><li><ahref="https://blog.csdn.net/qq_40575646/article/details/122607074#plus.audio.AudioPlayer.setSessionCategory">setSessionCategory</a>: 设置音频播放模式</li><li><ahref="https://blog.csdn.net/qq_40575646/article/details/122607074#plus.audio.AudioPlayer.setStyles">setStyles</a>: 设置音频播放的参数</li></ul>
<h1 style="margin-left:0;">addEventListener</h1>
添加事件监听器
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
void player.addEventListener(event, listener, capture);
</code></code></pre>
<h2 style="margin-left:.8em;">说明：</h2>
向音频播放对象添加事件监听器，当指定的事件发生时，将触发listener函数的执行。可多次调用此方法添加多个监听器，当监听的事件发生时，将按照添加的先后顺序执行。
<h2 style="margin-left:.8em;">参数：</h2>
<ul><li>event: ( <ahref="https://www.html5plus.org/doc/zh_cn/audio.html#plus.audio.AudioPlayerEvent">AudioPlayerEvent</a> ) 必选 音频播放事件类型 </li><li>listener: ( <ahref="https://www.html5plus.org/doc/zh_cn/audio.html#plus.audio.EventCallback">EventCallback</a> ) 必选 监听事件发生时执行的回调函数 </li><li>capture: ( Boolean ) 可选 捕获事件流顺序，暂无效果 </li></ul>
<h2 style="margin-left:.8em;">返回值：</h2>
void : 无
<h1 style="margin-left:0;">close</h1>
关闭音频播放对象
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
void player.close();
</code></code></pre>
<h2 style="margin-left:.8em;">说明：</h2>
关闭操作将释放音频播放对象所占用的资源，关闭后不再可用。
<h2 style="margin-left:.8em;">参数：</h2>
无
<h2 style="margin-left:.8em;">返回值：</h2>
void : 无
<h1 style="margin-left:0;">getBuffered</h1>
音频缓冲的时间点
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
Number player.getBuffered();
</code></code></pre>
<h2 style="margin-left:.8em;">说明：</h2>
表示当前播放时间点到此时间点内容已缓冲。单位为秒（s），，返回值可能是小数。
<h2 style="margin-left:.8em;">参数：</h2>
无
<h2 style="margin-left:.8em;">返回值：</h2>
Number : 音频缓冲的时间点
<h1 style="margin-left:0;">getDuration</h1>
获取音频的总长度
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
Number player.getDuration();
</code></code></pre>
<h2 style="margin-left:.8em;">说明：</h2>
单位为秒（s），返回值可能是小数，若长度未知则返回-1。如果还未获取到音频流信息则返回NaN，此时需要延迟获取。
<h2 style="margin-left:.8em;">参数：</h2>
无
<h2 style="margin-left:.8em;">返回值：</h2>
Number : 音频的总长度
<h1 style="margin-left:0;">getPosition</h1>
获取音频的当前播放位置
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
Number player.getPosition();
</code></code></pre>
<h2 style="margin-left:.8em;">说明：</h2>
获取音频流当前播放的位置（已播放的长度），单位为秒（s），返回值可能是小数。如果当前还未开始播放则返回0。
<h2 style="margin-left:.8em;">参数：</h2>
无
<h2 style="margin-left:.8em;">返回值：</h2>
Number : 当前音频播放位置
<h1 style="margin-left:0;">getStyles</h1>
音频播放的参数
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
var player.setStyles(key);
</code></code></pre>
<h2 style="margin-left:.8em;">说明：</h2>
获取指定key的参数值，key取值范围为<ahref="https://www.html5plus.org/doc/zh_cn/audio.html#plus.audio.AudioPlayerStyles">AudioPlayerStyles</a>的所有参数。如果未设置key的参数，参数有默认值则返回默认，无默认值则返回undefined。
<h2 style="margin-left:.8em;">参数：</h2>
<ul><li>key: ( String ) 可选 获取参数的key名称 如果不传入参数key，则获取所有参数信息。 </li></ul>
<h2 style="margin-left:.8em;">返回值：</h2>
var : 由传入的key决定返回类型，如果不设置key，则返回json格式数据。
<h1 style="margin-left:0;">isPaused</h1>
当前是否暂停或停止状态
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
Boolean player.isPaused();
</code></code></pre>
<h2 style="margin-left:.8em;">说明：</h2>
当前音频为暂停或停止状态则返回true，否则返回false。
<h2 style="margin-left:.8em;">参数：</h2>
无
<h2 style="margin-left:.8em;">返回值：</h2>
Boolean : true表示当前为暂停或停止状态，false则表示当前为播放状态。
<h1 style="margin-left:0;">play</h1>
播放音频
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
void player.play(successCB, errorCB);
</code></code></pre>
<h2 style="margin-left:.8em;">参数：</h2>
<ul><li>successCB: ( <ahref="https://blog.csdn.net/qq_40575646/article/details/122607074#plus.audio.PlaySuccessCallback">PlaySuccessCallback</a> ) 可选 播放音频操作成功回调函数 当音频文件播放完成时回调。 </li><li>errorCB: ( <ahref="https://blog.csdn.net/qq_40575646/article/details/122607074#plus.audio.AudioErrorCallback">AudioErrorCallback</a> ) 可选 播放音频操作错误回调函数 当音频文件播放发生错误时回调。 </li></ul>
<h2 style="margin-left:.8em;">返回值：</h2>
void : 无
<h2 style="margin-left:.8em;">示例：</h2>
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
// 播放操作
var p = plus.audio.createPlayer();
p.play( function () {
alert( "Audio play success!" );
}, function ( e ) {
alert( "Audio play failed: " + e.message );
} );
</code></code></pre>
<ahref="https://uniapp.dcloud.io/use-html5plus">uni-app使用plus注意事项</a>
<h1 style="margin-left:0;">pause</h1>
暂停播放
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
void player.pause();
</code></code></pre>
<h2 style="margin-left:.8em;">说明：</h2>
当前处于播放状态才能暂停，否则调用此方法无任何作用。
<h2 style="margin-left:.8em;">参数：</h2>
无
<h2 style="margin-left:.8em;">返回值：</h2>
void : 无
<h2 style="margin-left:.8em;">示例：</h2>
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
// 播放操作
var p = plus.audio.createPlayer();
p.play( function () {
alert( "Audio play success!" );
}, function ( e ) {
alert( "Audio play failed: " + e.message );
} );
// ......
// 暂停播放
p.pause();
</code></code></pre>
<ahref="https://uniapp.dcloud.io/use-html5plus">uni-app使用plus注意事项</a>
<h1 style="margin-left:0;">removeEventListener</h1>
移除事件监听器
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
void player.removeEventListener(event, listener);
</code></code></pre>
<h2 style="margin-left:.8em;">说明：</h2>
从音频播放对象中移除通过addEventListener方法添加的事件监听器，若没有查找到对应的事件监听器，则无任何作用。
<h2 style="margin-left:.8em;">参数：</h2>
<ul><li>event: ( <ahref="https://blog.csdn.net/qq_40575646/article/details/122607074#plus.audio.AudioPlayerEvent">AudioPlayerEvent</a> ) 必选 音频播放事件类型 </li><li>listener: ( <ahref="https://www.html5plus.org/doc/zh_cn/audio.html#plus.audio.EventCallback">EventCallback</a> ) 必选 要移除监听函数对象 </li></ul>
<h2 style="margin-left:.8em;">返回值：</h2>
void : 无
<h1 style="margin-left:0;">resume</h1>
恢复播放
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
void player.resume();
</code></code></pre>
<h2 style="margin-left:.8em;">说明：</h2>
当前处于暂停状态从暂停处开始恢复播放，非暂停状态调用此方法无任何作用。
<h2 style="margin-left:.8em;">参数：</h2>
无
<h2 style="margin-left:.8em;">返回值：</h2>
void : 无
<h2 style="margin-left:.8em;">示例：</h2>
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
// 播放操作
var p = plus.audio.createPlayer();
p.play( function () {
alert( "Audio play success!" );
}, function ( e ) {
alert( "Audio play failed: " + e.message );
} );
// ......
// 暂停播放
p.pause();
// ......
// 恢复播放
p.resume();
</code></code></pre>
<ahref="https://uniapp.dcloud.io/use-html5plus">uni-app使用plus注意事项</a>
<h1 style="margin-left:0;">seekTo</h1>
跳到指定位置
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
void player.seekTo(position);
</code></code></pre>
<h2 style="margin-left:.8em;">说明：</h2>
当前处于播放或暂停状态才能跳到指定播放位置，否则调用此方法无任何作用。
<h2 style="margin-left:.8em;">参数：</h2>
<ul><li>position: ( Number ) 必选 要跳到的位置 单位为秒（s），精确到小数点后3位。 </li></ul>
<h2 style="margin-left:.8em;">返回值：</h2>
void : 无
<h1 style="margin-left:0;">stop</h1>
停止播放
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
void player.stop();
</code></code></pre>
<h2 style="margin-left:.8em;">说明：</h2>
当前处于播放或暂停状态才能停止播放，否则调用此方法无任何作用。停止的音频再播放会从头开始播放。
<h2 style="margin-left:.8em;">参数：</h2>
无
<h2 style="margin-left:.8em;">返回值：</h2>
void : 无
<h2 style="margin-left:.8em;">示例：</h2>
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
// 播放操作
var p = plus.audio.createPlayer();
p.play( function () {
alert( "Audio play success!" );
}, function ( e ) {
alert( "Audio play failed: " + e.message );
} );
// ......
// 停止播放
p.stop();
</code></code></pre>
<ahref="https://uniapp.dcloud.io/use-html5plus">uni-app使用plus注意事项</a>
<h1 style="margin-left:0;">setRoute</h1>
音频输出线路
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
void player.setRoute(route);
</code></code></pre>
<h2 style="margin-left:.8em;">说明：</h2>
可取值： plus.audio.ROUTE_SPEAKER - 使用设备的扬声器输出； plus.audio.ROUTE_EARPIECE - 使用设备的听筒输出。默认值为plus.audio.ROUTE_SPEAKER。可在音频文件开始播放前或播放过程中改变音频输出线路。
<h2 style="margin-left:.8em;">参数：</h2>
<ul><li>route: ( Number ) 必选 音频播放时输出线路 </li></ul>
<h2 style="margin-left:.8em;">返回值：</h2>
void : 无
<h2 style="margin-left:.8em;">示例：</h2>
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
// 播放操作
var p = plus.audio.createPlayer();
// 切换到听筒线路
p.setRoute( plus.audio.ROUTE_EARPIECE );
p.play( function () {
alert( "Audio play success!" );
}, function ( e ) {
alert( "Audio play failed: " + e.message );
} );
//...
// 切换到扬声器线路
p.setRoute( plus.audio.ROUTE_SPEAKER );
</code></code></pre>
<ahref="https://uniapp.dcloud.io/use-html5plus">uni-app使用plus注意事项</a>
<h1 style="margin-left:0;">setSessionCategory</h1>
设置音频播放模式
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
void player.setSessionCategory(category);
</code></code></pre>
<h2 style="margin-left:.8em;">说明：</h2>
可设置是否和其它音频同时输出。注意：必须在调用play方法前设置才生效。
<h2 style="margin-left:.8em;">参数：</h2>
<ul><li>category: ( String ) 必选 音频播放模式 可取值： "ambient" - 不中止其他声音播放，不能后台播放，静音后无声音； "soloAmbient" - 中止其他声音播放，不能后台播放，静音后无声音； "playback" - 中止其他声音，可以后台播放，静音后有声音。默认值为"playback"。 </li></ul>
<h2 style="margin-left:.8em;">返回值：</h2>
void : 无
<h2 style="margin-left:.8em;">平台支持：</h2>
<ul><li>Android (支持) : HBuilderX2.7.14+版本开始支持"ambient"，不支持"soloAmbient"和"playback"，默认终止其它声音播放，可后台播放。 </li><li>iOS - ALL (支持)</li></ul>
<h1 style="margin-left:0;">setStyles</h1>
设置音频播放的参数
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
void player.setStyles(styles);
</code></code></pre>
<h2 style="margin-left:.8em;">说明：</h2>
用于动态更新音频播放的参数。 ·
<h2 style="margin-left:.8em;">参数：</h2>
<ul><li>styles: ( <ahref="https://blog.csdn.net/qq_40575646/article/details/122607074#plus.audio.AudioPlayerStyles">AudioPlayerStyles</a> ) 必选 音频播放参数 </li></ul>
<h2 style="margin-left:.8em;">返回值：</h2>
void : 无
<h1 style="margin-left:0;">AudioPlayerEvent</h1>
音频播放控件事件类型
<h2 style="margin-left:.8em;">常量：</h2>
<ul><li>"canplay": (String 类型 )音频可以播放事件</li><li>"play": (String 类型 )音频播放事件</li><li>"pause": (String 类型 )音频暂停事件</li><li>"stop": (String 类型 )音频停止事件</li><li>"ended": (String 类型 )音频自然播放结束事件</li><li>"error": (String 类型 )音频播放错误事件</li><li>"waiting": (String 类型 )音频加载中事件</li><li>"seeking": (String 类型 )音频进行seek操作事件</li><li>"seeked": (String 类型 )音频完成seek操作事件</li><li>"prev": (String 类型 )上一曲操作事件 用户在后台播放控制器上点击上一曲按钮时触发，未开启后台控制器则不触发此事件。 </li><li>"next": (String 类型 )下一曲操作事件 用户在后台播放控制器上点击下一曲按钮时触发，未开启后台控制器则不触发此事件。 </li></ul>
<h1 style="margin-left:0;">AudioPlayerStyles</h1>
音频播放对象的参数
<h2 style="margin-left:.8em;">属性：</h2>
<ul><li>autoplay: (Boolean 类型 )是否自动开始播放 true - 自动开始播放； false - 不自动开始播放。默认值为false。 </li><li>backgroundControl: (Boolean 类型 )是否开启后台控制器 开启后应用切换到后台可继续播放音频。 iOS平台在系统锁屏界面显示播放控件；Android平台暂不支持。 </li><li>coverImgUrl: (String 类型 )封面图地址 在后台播放控制器上显示，未开启后台控制器则不显示。 </li><li>epname: (String 类型 )专辑名 在后台播放控制器上显示，未开启后台控制器则不显示。 </li><li>loop: (Boolean 类型 )是否循环播放 true - 循环播放； false - 不循环播放。默认值为false。 </li><li>singer: (String 类型 )歌手名 在后台播放控制器上显示，未开启后台控制器则不显示。 </li><li>src: (String 类型 )音频资源的地址 支持本地路径和网络路径。 </li><li>startTime: (Number 类型 )开始播放的位置 单位为秒（s），默认值为0。 </li><li>title: (String 类型 )音频标题 在后台播放控制器上显示，未开启后台控制器则不显示。 </li><li>volume: (Number 类型 )音量 取值范围为0-1，默认值为1。 </li></ul>
<h1 style="margin-left:0;">AudioRecorderStyles</h1>
音频录制的参数
<h2 style="margin-left:.8em;">属性：</h2>
<ul><li>channels: (String 类型 )录音声道 可取值： "mono" - 单声道录音； "stereo" - 立体声道录音。默认值为"mono"。 <h3 style="margin-left:0;">平台支持</h3>
<ul style="margin-left:2em;"><li>Android - ALL (不支持) : 暂不支持，仅支持单通道录音。 </li><li>iOS - 7.0+ (支持)</li></ul></li><li>filename: (String 类型 )保存录音文件的路径 可设置具体文件名，也可只设置路径，如果以“/”结尾则表明是路径，文件名由录音程序自动生成。如未设置则使用默认目录生成随机文件名称，默认目录为应用%APPID%下的documents目录。 </li><li>samplerate: (String 类型 )录音文件的采样率 需通过supportedSamplerates属性获取设备支持的采样率，若设置无效的值，则使用系统默认的采样率。 </li><li>format: (String 类型 )录音文件的格式 需通过supportedFormats属性获取设备支持的录音格式，若设置无效的值，则使用系统默认的录音格式。 <h3 style="margin-left:0;">平台支持</h3>
<ul style="margin-left:2em;"><li>Android - 2.2+ (支持) : Android平台支持"amr"、"3gp"格式，默认为"amr"。 </li><li>iOS - 4.5+ (支持) : iOS平台支持"wav"、"aac"、"amr"格式，默认为"wav"。 </li></ul></li></ul>
<h1 style="margin-left:0;">RecordSuccessCallback</h1>
录音操作成功回调
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
void onSuccess( recordFile ) {
// Get record file code.
}
</code></code></pre>
<h2 style="margin-left:.8em;">说明：</h2>
麦克风录音操作成功的回调函数，在录音操作完成调用stop()方法时调用。
<h2 style="margin-left:.8em;">参数：</h2>
<ul><li>recordFile: ( String ) 必选 录音操作保存的音频文件路径 </li></ul>
<h2 style="margin-left:.8em;">返回值：</h2>
void : 无
<h1 style="margin-left:0;">PlaySuccessCallback</h1>
播放音频文件操作成功回调
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
void onCompleted() {
// Play audio file completed code.
}
</code></code></pre>
<h2 style="margin-left:.8em;">说明：</h2>
音频播放操作成功的回调函数，在音频播放完成或调用stop()方法时触发。
<h2 style="margin-left:.8em;">参数：</h2>
无
<h2 style="margin-left:.8em;">返回值：</h2>
void : 无
<h1 style="margin-left:0;">AudioErrorCallback</h1>
音频操作失败回调
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
void onError( error ) {
// Handle audio error
}
</code></code></pre>
<h2 style="margin-left:.8em;">参数：</h2>
<ul><li>error: ( Exception ) 必选 音频操作的错误信息 </li></ul>
<h2 style="margin-left:.8em;">返回值：</h2>
void : 无
 </div>
 </div>
 <div id="treeSkill"></div>

页: [1]

宜信同城网交流论坛's Archiver

audio 模块用于提供音频的录制和播放功能