taro-background-audio
v1.2.0
Published
基于taro开发的背景音频播放组件,有问题联系[email protected]。
Downloads
2
Readme
代码借鉴 taro-audio
开发的背景播放版本!!!
若需要小程序在退到后台后继续播放音频,你需要在 app.json 中配置 requiredBackgroundModes 属性,详见:微信小程序官方文档
。
代码演示
引入
import TaroBackgroundAudio from 'taro-background-audio';
基础用法
通过src
属性设置音频资源的地址
<TaroBackgroundAudio src={'你的路径'}/>
显示音频名称
通过title
属性显示音频名称
<TaroBackgroundAudio src={'你的路径'} title='泡沫'/>
显示作者
通过singer
属性显示音频作者
<TaroBackgroundAudio src={'你的路径'} title='泡沫' singer='邓紫棋'/>
进度条是否可拖拽
通过draggable
设置
<TaroBackgroundAudio src={'你的路径'} title='泡沫' singer='邓紫棋' draggable={false}/>
设置海报
通过coverImgUrl
设置
<TaroBackgroundAudio src={'你的路径'} title='泡沫' singer='邓紫棋' draggable coverImgUrl={'你的路径'}/>
Props
| 参数 | 说明 | 类型 | 默认值 | 是否必须 |
|------|------|------|------|------|
| src | 音频资源的地址 | string
| 无 | 是 |
| title | 音频名称 | string
| 未知 | 否 |
| singer | 音频作者 | string
| 未知 | 否 |
| coverImgUrl | 音频海报 | string
| 无 | 否 |
| autoPlay | 是否自动播放 | boolean
| true | 否 |
| loopPlay | 是否循环播放 | boolean
| false | 否 |
| draggable | 是否可以拖动进度条 | boolean
| true | 否 |
| onPlay | 当开始/继续播放时触发play事件 | eventHandle
| 无 | 否
| onPause | 当暂停播放时触发 pause 事件 | eventHandle
| 无 | 否
| onEnded | 当播放到末尾时触发 ended 事件 | eventHandle
| 无 | 否
| onTimeUpdate | 当播放进度改变时触发 timeupdate 事件,detail = {currentTime, duration} | eventHandle
| 无 | 否
| onError | 当发生错误时触发 error 事件,detail = {errMsg} | eventHandle
| 无 | 否