html5+ audio 音频录制/播放

audio 音频录制/播放

Audio模块用于提供音频的录制和播放功能,可调用系统的麦克风设备进行录音操作,也可调用系统的扬声器设备播放音频文件。通过plus.audio获取音频管理对象。

常量:

  • ROUTE_SPEAKER: 设备的扬声器音频输出线路
  • ROUTE_EARPIECE: 设备听筒音频输出线路

方法:

  • getRecorder: 获取当前设备的录音对象
  • createPlayer: 创建音频播放对象

对象:

  • AudioRecorder: 录音对象
  • AudioPlayer: 音频播放对象
  • RecordOption: JSON对象,调用麦克风设备进行录音的参数

回调方法:

  • RecordSuccessCallback: 录音操作成功回调
  • PlaySuccessCallback: 播放音频文件操作成功回调
  • AudioErrorCallback: 音频操作失败回调

权限:

5+功能模块(permissions)

{
// ...
"permissions":{
	// ...
	"Audio": {
		"description": "音频"
	}
}
}

AudioRecorder

录音对象

interface AudioRecorder {
	readonly attribute String\[\] supportedSamplerates;
	readonly attribute String\[\] supportedFormats;
	function record( option, successCB, errorCB );
	function stop();
}

属性:

  • supportedSamplerates: 数组,设备录音支持的采用率
  • supportedFormats: 数组,设备录音支持的文件格式

方法:

  • record: 调用设备麦克风进行录音操作
  • stop: 结束录音操作

AudioPlayer

音频播放对象

interface AudioPlayer {
	function void play( successCB, errorCB );
	function void pause();
	function void resume();
	function void stop();
	function void seekTo( position );
	function Number getDuration();
	function Number getPosition();
	function void setRoute( route );
}

说明:

音频播放对象,用于音频文件的播放。不能通过new方法直接创建,只能通过audio.createPlayer方法创建。

方法:

  • play: 开始播放音频
  • pause: 暂停播放音频
  • resume: 恢复播放音频
  • stop: 停止播放音频
  • seekTo: 跳到指定位置播放音频
  • getDuration: 获取音频流的总长度
  • getPosition: 获取音频流当前播放的位置
  • setRoute: 设置音频输出线路

RecordOption

JSON对象,调用麦克风设备进行录音的参数

属性:

  • filename: _(String 类型 )_保存录音文件的路径

    可设置具体文件名,也可只设置路径,如果以“/”结尾则表明是路径,文件名由录音程序自动生成。 如未设置则使用默认目录生成随机文件名称,默认目录为应用%APPID%下的documents目录。

  • samplerate: _(String 类型 )_录音文件的采样率

    需通过supportedSamplerates属性获取设备支持的采样率,若设置无效的值,则使用系统默认的采样率。

  • format: _(String 类型 )_录音文件的格式

    需通过supportedFormats属性获取设备支持的录音格式,若设置无效的值,则使用系统默认的录音格式。

RecordSuccessCallback

录音操作成功回调

void onSuccess( recordFile ) {
	// Get record file code.
}

说明:

麦克风录音操作成功的回调函数,在录音操作完成调用stop()方法时调用。

参数:

  • recordFile: ( String ) 必选 录音操作保存的音频文件路径

返回值:

void : 无

PlaySuccessCallback

播放音频文件操作成功回调

void onCompleted() {
	// Play audio file completed code.
}

说明:

音频播放操作成功的回调函数,在音频播放完成或调用stop()方法时触发。

参数:

返回值:

void : 无

AudioErrorCallback

音频操作失败回调

void onError( error ) {
	// Handle audio error
}

参数:

  • error: ( DOMException ) 必选 音频操作的错误信息

返回值:

void : 无

你可能感兴趣的:(html5+)