接口声明

{"name": "system.audio"}

导入模块

import audio from '@system.audio' 
或 
const audio = require('@system.audio')

接口定义

方法

audio.play()

开始播放音频

参数

无

示例：

audio.play()

audio.pause()

暂停播放音频

参数

无

示例：

audio.pause()

audio.stop() 1030+

停止音频播放，可以通过 play 重新播放音频

参数

无

示例：

audio.stop()

audio.getPlayState(OBJECT) 1050+

获取当前播放状态数据

参数

success 返回值：

示例：

audio.getPlayState({
    success: function(data) {
        console.log(`handling success: state: ${data.state},src:${data.src},currentTime:${data.currentTime},autoplay:${data.autoplay},loop:${data.loop},
            volume: ${data.volume},muted:${data.muted},notificationVisible:${data.notificationVisible}`)
    },
    fail: function(data, code) {
        console.log('handling fail, code=' + code)
    }
})

属性

示例：

let currentTime = audio.currentTime
audio.currentTime = 5

事件

示例：

audio.ontimeupdate = function() {
  console.log(`audio current time: ${audio.currentTime}`)
}
audio.ontimeupdate = null
audio.onprevious = function() {
  audio.src = "uri";
  audio.tilte="上一首歌名";
  audio.play();
};

后台运行限制

manifest 中申请后可用。

后台运行详细用法参见 后台运行脚本。