教程 其他 框架 组件 接口

音频 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()

属性

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

示例:

let currentTime = audio.currentTime
audio.currentTime = 5

事件

名称描述
play在调用 play 方法后或者 autoplay 为 true 时的回调事件
pause在调用 pause 方法后的回调事件
stop 1030+在调用 stop 方法后的回调事件
loadeddata第一次获取到音频数据的回调事件
ended播放结束时的回调事件
durationchange播放时长变化时的回调事件
error播放发生错误时的回调事件
timeupdate播放进度变化时触发,触发频率 4HZ

示例:

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

条匹配 "" 的结果

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