音频 audio 1000+

接口声明

{ "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 中申请后可用。
后台运行详细用法参见后台运行 脚本。