开发
API
自2022年9月6日起,本文档站不再更新内容,相关文档已迁移至全新“抖音开放平台”前往

InnerAudioContext

通过 tt.createInnerAudioContext 获取的实例,通过它能够操作音频播放。音频默认遵循系统静音开关,在系统静音情况下,若希望音频播放有声音,可通过 InnerAudioContext.obeyMuteSwitch 属性进行设置。

属性

可设置属性

属性名

类型

默认值

必填

说明

最低支持版本

src

string

''

音频资源地址,仅支持临时路径(如通过下载到本地的音频地址)、网络地址(该地址的域名必须在小程序开发者平台 request 域名白名单中配置),只支持 mp3、wav、m4a、aac 格式。

1.0.0

startTime

number

0

开始播放的位置(单位:s)

1.0.0

autoplay

boolean

false

是否自动播放

1.0.0

loop

boolean

false

是否自动循环

1.0.0

obeyMuteSwitch

boolean

true

是否遵循系统静音开关,当此参数为 false 时,即使用户打开了静音开关,也能继续发出声音

1.0.0

volume

number

1

当前音量,范围 0 ~ 1

1.0.0

playbackRate

number

1

播放速度。范围 0.5 ~ 2.0,默认为 1

2.33.0

referrerPolicy

string

'no-referrer'

origin: 发送完整的 referrer; no-referrer: 不发送。格式固定为 https://tmaservice.developer.toutiao.com/{appid}/{version}/page-frame.html,其中 {appid} 为小程序的 appid,{version} 为小程序的版本号,版本号为 0 表示为开发版、体验版以及审核版本,版本号为 devtools 表示为开发者工具,其余为正式版本

2.33.0

只读属性

属性名

类型

说明

最低支持版本

duration

number

当前音频总时长(单位:s),只有在当前有合法的 src 时返回

1.0.0

currentTime

number

当前音频进度(单位:s)),只有在当前有合法的 src 时返回

1.0.0

paused

boolean

当前音频是否处于暂停状态

1.0.0

buffered

number

当前音频已缓冲部分,单位百分比,仅保证当前播放时间点到此时间点内容已缓冲

1.0.0

方法

方法名

说明

最低支持版本

play

播放音频

1.0.0

pause

暂停播放

1.0.0

stop

停止播放

1.0.0

seek

跳转到指定位置播放

1.0.0

destroy

销毁当前实例。销毁后该实例将不存在,如需播放需要再次创建

1.0.0

onCanplay

监听音频进入可以播放状态,但不保证后面可以流畅播放

1.0.0

onPlay

监听音频播放事件

1.0.0

onPause

监听音频暂停事件

1.0.0

onStop

监听音频停止播放事件

1.0.0

onEnded

监听自然播放结束事件

1.0.0

onTimeUpdate

监听音频进度更新事件

1.0.0

onError

监听音频播放出错事件

1.0.0

onWaiting

监听音频加载中事件,当音频因为数据不足,需要停下来加载时会触发

1.0.0

onSeeking

监听音频开始进行 seek 操作的事件

1.0.0

onSeeked

监听音频完成 seek 操作的事件

1.0.0

offCanplay

取消 onCanplay 监听的事件

1.0.0

offPlay

取消 onPlay 监听的事件

1.0.0

offPause

取消 onPause 监听的事件

1.0.0

offStop

取消 onStop 监听的事件

1.0.0

offEnded

取消 onEnded 监听的事件

1.0.0

offTimeUpdate

取消 onTimeUpdate 监听的事件

1.0.0

offError

取消 onError 监听的事件

1.0.0

offWaiting

取消 onWaiting 监听的事件

1.0.0

offSeeking

取消 onSeeking 监听的事件

1.0.0

offSeeked

取消 onSeeked 监听的事件

1.0.0

点击纠错
该文档是否对你的开发有所帮助?
有帮助
没帮助
该文档是否对你的开发有所帮助?
有帮助
没帮助