音频 正式版本可用

接口声明

{"name": "system.audio"}

导入模块

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

接口定义

方法

audio.play()

开始播放音频

参数

示例:
audio.play()

audio.pause()

暂停播放音频

参数

示例:
audio.pause()

属性

名称 参数类型 是否可读 是否可写 描述
src   String 播放的音频媒体uri
currentTime   Number 音频的当前进度,单位秒,对值设置可以调整播放进度
duration   Number 音频的播放时长,单位秒,未知返回NaN
autoplay   Boolean 音频是否自动播放,默认false
loop   Boolean 音频是否循环播放,默认false
volume   Number 音频的音量,默认当前系统媒体音量,音量变化范围[0.0,1.0]
muted   Boolean 音频是否静音,默认false

示例:

let currentTime = audio.currentTime
audio.currentTime = 5

事件

名称 描述
play 播放开始,未获取到音频数据时的回调事件
pause 播放暂停时的回调事件
loadeddata 获取到音频数据,开始播放时的回调事件
ended 播放结束时的回调事件
durationchange 播放时长变化时的回调事件
error 播放发生错误时的回调事件
timeupdate 播放进度变化时触发,触发频率4HZ

示例:

audio.ontimeupdate = function () {
  console.log(`audio current time: ${audio.currentTime}`)
}
audio.ontimeupdate = null

条匹配 "" 的结果

    没有搜索到与 "" 相关的内容