媒体

音频

    AudioEngine

是单例对象,是属于 runtime 对象的子对象。主要用来播放音频,播放的时候会返回一个 audioID,之后都可以通过这个 audioID 来操作这个音频对象。

方法

    number AudioEngine.play(string filePath, boolean loop, number volume)

播放音频

参数

  • string filePath

音频文件路径

  • boolean loop [可选]

是否循环播放,默认 false

  • number volume [可选]

声音大小,默认1

返回值

  • number

播放音频的ID

    setLoop(number audioID, boolean loop)

设置音频是否循环。

参数

  • number audioID

播放的音频ID

  • boolean loop

是否循环

    boolean isLoop(number audioID)

获取音频的循环状态。

参数

  • number audioID

播放的音频ID

返回值

  • boolean

    当前音频是否循环播放

    AudioEngine.setVolume(number audioID, number volume)

设置音量

参数

  • number audioID

播放的音频ID

  • number volume

音量大小 0.0~1.0

    number AudioEngine.getVolume(number audioID)

获取音量

参数

  • number audioID

播放的音频ID

返回值

  • number

音频的音量 0.0~1.0

    boolean AudioEngine.setCurrentTime(number audioID, number sec)

设置当前的音频时间。

参数

  • number audioID

播放的音频ID

  • number sec

要设置的当前播放时间

返回值

  • boolean

设置是否成功

    number AudioEngine.getCurrentTime(number audioID)

获取当前的音频播放时间。

参数

  • number audioID

播放的音频ID

返回值

  • number

音频的当前播放时间

    number AudioEngine.getDuration(number audioID)

获取音频总时长。

参数

  • number audioID

播放的音频ID

返回值

  • number

音频的总播放时间

    audioEngine.AudioState AudioEngine.getState(number audioID)

获取音频状态。

返回值

  • audioEngine.AudioState

详见AudioState

    AudioEngine.setFinishCallback(number audioID, Function callback)

设置一个音频结束后的回调

参数

  • number audioID

播放的音频ID

  • Function callback

播放结束后的回调函数

    AudioEngine.pause(number audioID)

暂停正在播放音频。

参数

  • number audioID

播放的音频ID

    AudioEngine.pauseAll()

暂停现在正在播放的所有音频。

    AudioEngine.resume(number audioID)

恢复播放指定的音频。

参数

  • number audioID

播放的音频ID

    AudioEngine.resumeAll()

恢复播放所有之前暂停的所有音频。

    AudioEngine.stop(number audioID)

停止播放指定音频。

参数

  • number audioID

播放的音频ID

    AudioEngine.stopAll()

停止正在播放的所有音频。

    AudioEngine.setMaxAudioInstance(number num)

设置一个音频可以设置几个实例

参数

  • number num

一个音频可创建的实例个数

    number AudioEngine.getMaxAudioInstance()

获取一个音频可以设置几个实例

    AudioEngine.uncache(string filePath)

卸载预加载的音频。

参数

  • string filePath

预加载的音频路径

    AudioEngine.uncacheAll()

卸载所有音频。

    AudioEngine.preload(string filePath, Function callback)

预加载一个音频

参数

  • string filePath

音频文件路径

  • Function callback

音频加载完成后的回调函数。该回调函数带有两个参数,第一个参数为isSucceed代表是否加载预加载成功,第二个参数为duration代表所加载音频的长度,只有isSucceed为true的时候duration才有效,否则duration的值为-1。

    AudioEngine.setWaitingCallback(number audioID, Function callback)

支持版本: (core 版本 >= 1.1.0)

监听音频加载中事件。当音频因为数据不足时,会调用对应的 callback。

参数

  • number audioID

播放的音频ID

  • Function callback

音频加载中事件的回调函数

    AudioEngine.setErrorCallback(number audioID, Function callback)

支持版本: (core 版本 >= 1.1.0)

监听音频播放错误事件

参数

  • number audioID

播放的音频ID

  • Function callback

音频播放错误事件的回调函数

    AudioEngine.setCanPlayCallback(number audioID, Function callback)

支持版本: (core 版本 >= 1.2.2)

监听音频即将播放事件。调用AudioEngine.play方法后,音频可能因为缓存等原因还没有开始播放,此时音频信息无法获取正确值,如音频的duration。通过此接口设置回调函数后,当收到回调时,此时音频数据已经准备好,可以正确获取音频信息。

参数

  • number audioID

播放的音频ID

  • Function callback

音频加载中事件的回调函数

图片

    chooseImage(Object object)

从本地相册选择图片或使用相机拍照。

参数

  • Object object

属性

键值类型

是否必填

说明

支持版本

count

number

需要选择的数量

sourceType

Array.

选择图片的来源</br>默认值为:['album', 'camera']

core 版本 >= 1.0.2

success

function

接口调用成功的回调函数

fail

function

接口调用失败的回调函数

complete

function

接口调用结束的回调函数

  • success 回调函数

参数

  • Object res

属性

键值类型

说明

tempFilePaths

Array[string]

图片的本地文件路径列表

tempFiles

Array[ImageFile]

图片的本地文件列表,每一项是一个 File 对象

    previewImage(Object object)

预览图片

参数

  • Object object

属性

键值类型

是否必填

说明

current

string

当前显示图片的链接,默认 urls 的第一张

urls

Array[string]

需要预览的图片链接列表

success

function

接口调用成功的回调函数

fail

function

接口调用失败的回调函数

complete

function

接口调用结束的回调函数

    saveImageToPhotosAlbum(Object object)

保存图片到系统相册。需要用户授权 scope.writePhotosAlbum

参数

  • Object object

属性

键值类型

是否必填

说明

filePath

string

图片文件路径

success

function

接口调用成功的回调函数

fail

function

接口调用失败的回调函数

complete

function

接口调用结束的回调函数

    ImageFile

属性

  • string path

本地文件路径

  • number size

本地文件大小,单位 B

    saveImageTemp(Object object)

异步将二进制图像数据保存为本地临时图片文件。

参数

  • Object object

属性

键值类型

是否必填

说明

支持版本

data

Uint8Array

像素数据,数据类型为 RGBA8888 格式的 Uint8Array 数组

width

number

写入图片的宽度,最大宽度为 4096

height

number

写入图片的高度,最大高度为 4096

fileType

string

写入图片的格式,支持的类形为 jpg、png

reverse

boolean

是否需要将写入的数据按 y 轴反转,默认为 false

core 版本 >= 1.0.1

success

function

接口调用成功的回调函数

fail

function

接口调用失败的回调函数

complete

function

接口调用结束的回调函数

  • success 回调函数

参数

  • Object res

属性

键值类型

说明

tempFilePath

string

保存完成后,本地临时文件路径

errMsg

string

错误信息

    string saveImageTempSync(Object object)

同步将二进制图像数据保存为本地临时图片文件。

参数

  • Object object

属性

键值类型

是否必填

说明

支持版本

data

Uint8Array

像素数据,数据类型为 RGBA8888 格式的 Uint8Array 数组

width

number

写入图片的宽度,最大宽度为 4096

height

number

写入图片的高度,最大高度为 4096

fileType

string

写入图片的格式,支持的类行为 jpg、png

reverse

boolean

是否需要将写入的数据按 y 轴反转,默认为 false

core 版本 >= 1.0.1

返回值

  • string

保存完成后,本地临时文件路径

Last updated