Audio模块用于提供音频的录制和播放功能，可调用系统的麦克风设备进行录音操作，也可调用系统的扬声器设备播放音频文件。通过plus.audio获取音频管理对象。
常量：
方法：
对象：
回调方法：
权限：
5+功能模块（permissions）
ROUTE_SPEAKER
设备的扬声器音频输出线路
说明：
Number 类型
音频输出线路常量，值为0。音频播放时在设备的扬声器输出。
ROUTE_EARPIECE
设备听筒音频输出线路
说明：
Number 类型
音频输出线路常量，值为1。音频播放时在设备的听筒输出。
getRecorder
获取当前设备的录音对象
说明：
获取当前设备的录音对象，进行录音操作，录音对象是设备的独占资源，在同一时间仅可执行一个录音操作，否则可能会导致操作失败。
参数：
返回值：
AudioRecorder : 录音对象
平台支持：
示例：
uni-app使用plus注意事项
createPlayer
创建音频播放器对象
说明：
用于播放音频文件，可以直接传入音频文件地址或音频播放参数对象AudioPlayerStyles。 返回播放对象，可调用其play方法开始播放。
参数：
返回值：
AudioPlayer : 音频播放对象
平台支持：
- Android - 2.2+ (支持) :
支持"aac"、"3gp"、"amr"、"mp3"、"mp4"、"mid"、"ogg"、"wav"等格式文件。 支持播放网络路径音频，以http/https开头，如“http://demo.dcloud.net.cn/test/audio/apple.mp3”。
- iOS - 4.3+ (支持) :
支持"aac"、"aiff"、"mp3"、"mid"、"wav"、"amr"等格式文件。 支持播放网络路径音频，以http/https开头，如“http://demo.dcloud.net.cn/test/audio/apple.mp3”。
示例：
uni-app使用plus注意事项
AudioRecorder
录音对象
属性：
方法：
supportedSamplerates
数组，设备录音支持的采样率
说明：
String 类型 只读属性
属性类型为Array(String)，若不支持此属性则返回空数组对象。支持的录音采样率，字符串格式为“采样频率”，如“8000”；其单位为Hz。
supportedFormats
数组，设备录音支持的文件格式
说明：
String 类型 只读属性
属性类型为Array(String)，若不支持此属性则返回空数组对象。支持的录音文件的格式，字符串格式为文件格式后缀名，如"mp3"、"aac"、"wav"等。
平台支持：
record
调用设备麦克风进行录音操作
说明：
调用设备麦克风开始录音操作，录音完成需调用stop方法停止。录音完成后将通过successCB回调返回录音后的文件数据。
参数：
返回值：
void : 无
示例：
uni-app使用plus注意事项
stop
结束录音操作
说明：
结束录音操作，通知设备完成录音操作。录音完成后将调用record方法中传入的successCB回调返回录音文件。
参数：
无
返回值：
void : 无
示例：
uni-app使用plus注意事项
AudioPlayer
音频播放对象
说明：
音频播放对象，用于音频文件的播放。不能通过new方法直接创建，只能通过audio.createPlayer方法创建。
方法：
addEventListener
添加事件监听器
说明：
向音频播放对象添加事件监听器，当指定的事件发生时，将触发listener函数的执行。 可多次调用此方法添加多个监听器，当监听的事件发生时，将按照添加的先后顺序执行。
参数：
返回值：
void : 无
close
关闭音频播放对象
说明：
关闭操作将释放音频播放对象所占用的资源，关闭后不再可用。
参数：
无
返回值：
void : 无
getBuffered
音频缓冲的时间点
说明：
表示当前播放时间点到此时间点内容已缓冲。 单位为秒（s），，返回值可能是小数。
参数：
无
返回值：
Number : 音频缓冲的时间点
getDuration
获取音频的总长度
说明：
单位为秒（s），返回值可能是小数，若长度未知则返回-1。 如果还未获取到音频流信息则返回NaN，此时需要延迟获取。
参数：
无
返回值：
Number : 音频的总长度
getPosition
获取音频的当前播放位置
说明：
获取音频流当前播放的位置（已播放的长度），单位为秒（s），返回值可能是小数。 如果当前还未开始播放则返回0。
参数：
无
返回值：
Number : 当前音频播放位置
getStyles
音频播放的参数
说明：
获取指定key的参数值，key取值范围为AudioPlayerStyles的所有参数。 如果未设置key的参数，参数有默认值则返回默认，无默认值则返回undefined。
参数：
- key: ( String ) 可选 获取参数的key名称
如果不传入参数key，则获取所有参数信息。
返回值：
var : 由传入的key决定返回类型，如果不设置key，则返回json格式数据。
isPaused
当前是否暂停或停止状态
说明：
当前音频为暂停或停止状态则返回true，否则返回false。
参数：
无
返回值：
Boolean : true表示当前为暂停或停止状态，false则表示当前为播放状态。
play
播放音频
参数：
返回值：
void : 无
示例：
uni-app使用plus注意事项
pause
暂停播放
说明：
当前处于播放状态才能暂停，否则调用此方法无任何作用。
参数：
无
返回值：
void : 无
示例：
uni-app使用plus注意事项
removeEventListener
移除事件监听器
说明：
从音频播放对象中移除通过addEventListener方法添加的事件监听器，若没有查找到对应的事件监听器，则无任何作用。
参数：
返回值：
void : 无
resume
恢复播放
说明：
当前处于暂停状态从暂停处开始恢复播放，非暂停状态调用此方法无任何作用。
参数：
无
返回值：
void : 无
示例：
uni-app使用plus注意事项
seekTo
跳到指定位置
说明：
当前处于播放或暂停状态才能跳到指定播放位置，否则调用此方法无任何作用。
参数：
- position: ( Number ) 必选 要跳到的位置
单位为秒（s），精确到小数点后3位。
返回值：
void : 无
stop
停止播放
说明：
当前处于播放或暂停状态才能停止播放，否则调用此方法无任何作用。 停止的音频再播放会从头开始播放。
参数：
无
返回值：
void : 无
示例：
uni-app使用plus注意事项
setRoute
音频输出线路
说明：
可取值： plus.audio.ROUTE_SPEAKER - 使用设备的扬声器输出； plus.audio.ROUTE_EARPIECE - 使用设备的听筒输出。 默认值为plus.audio.ROUTE_SPEAKER。 可在音频文件开始播放前或播放过程中改变音频输出线路。
参数：
- route: ( Number ) 必选 音频播放时输出线路
返回值：
void : 无
示例：
uni-app使用plus注意事项
setSessionCategory
设置音频播放模式
说明：
可设置是否和其它音频同时输出。 注意：必须在调用play方法前设置才生效。
参数：
返回值：
void : 无
平台支持：
setStyles
设置音频播放的参数
说明：
用于动态更新音频播放的参数。 ·
参数：
返回值：
void : 无
AudioPlayerEvent
音频播放控件事件类型
常量：
AudioPlayerStyles
音频播放对象的参数
属性：
- autoplay: (Boolean 类型 )是否自动开始播放
true - 自动开始播放； false - 不自动开始播放。 默认值为false。
- backgroundControl: (Boolean 类型 )是否开启后台控制器
开启后应用切换到后台可继续播放音频。 iOS平台在系统锁屏界面显示播放控件；Android平台暂不支持。
- coverImgUrl: (String 类型 )封面图地址
在后台播放控制器上显示，未开启后台控制器则不显示。
- epname: (String 类型 )专辑名
在后台播放控制器上显示，未开启后台控制器则不显示。
- loop: (Boolean 类型 )是否循环播放
true - 循环播放； false - 不循环播放。 默认值为false。
- singer: (String 类型 )歌手名
在后台播放控制器上显示，未开启后台控制器则不显示。
- src: (String 类型 )音频资源的地址
支持本地路径和网络路径。
- startTime: (Number 类型 )开始播放的位置
单位为秒（s），默认值为0。
- title: (String 类型 )音频标题
在后台播放控制器上显示，未开启后台控制器则不显示。
- volume: (Number 类型 )音量
取值范围为0-1，默认值为1。
AudioRecorderStyles
音频录制的参数
属性：
- channels: (String 类型 )录音声道
可取值： "mono" - 单声道录音； "stereo" - 立体声道录音。 默认值为"mono"。
平台支持
- Android - ALL (不支持) :
暂不支持，仅支持单通道录音。
- iOS - 7.0+ (支持)
- filename: (String 类型 )保存录音文件的路径
可设置具体文件名，也可只设置路径，如果以“/”结尾则表明是路径，文件名由录音程序自动生成。 如未设置则使用默认目录生成随机文件名称，默认目录为应用%APPID%下的documents目录。
- samplerate: (String 类型 )录音文件的采样率
需通过supportedSamplerates属性获取设备支持的采样率，若设置无效的值，则使用系统默认的采样率。
- format: (String 类型 )录音文件的格式
需通过supportedFormats属性获取设备支持的录音格式，若设置无效的值，则使用系统默认的录音格式。
平台支持
RecordSuccessCallback
录音操作成功回调
说明：
麦克风录音操作成功的回调函数，在录音操作完成调用stop()方法时调用。
参数：
- recordFile: ( String ) 必选 录音操作保存的音频文件路径
返回值：
void : 无
PlaySuccessCallback
播放音频文件操作成功回调
说明：
音频播放操作成功的回调函数，在音频播放完成或调用stop()方法时触发。
参数：
无
返回值：
void : 无
AudioErrorCallback
音频操作失败回调
参数：
- error: ( Exception ) 必选 音频操作的错误信息
返回值：
void : 无
发表于 2023-2-16 18:54:55
提升卡
置顶卡
沉默卡
喧嚣卡
变色卡
千斤顶
照妖镜
