1.2.0 • Published 2 years ago
taro-background-audio v1.2.0
代码借鉴 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 | 无 | 否 |