手册版本 V5.0
组件名称
gui-audio-player : /graceUI/组件目录/gui-audio-player
功能介绍
基于背景音乐api封装的音乐播放器,提供音乐播放、暂停、进度展示、进度选择、列表播放、单曲循环等常用的音乐播放功能;
请使用真机调试体验效果~
兼容平台
组件属性
属性名称 | 类型 | 默认值 | 作用 |
color | String | #FFFFFF | 音乐标题颜色 |
list | Array | [] | 音乐列表数据,格式请参考演示代码 |
listBg | String | #292E35 | 音乐列表背景颜色 |
listHeight | String | 880rpx | 音乐列表高度 |
autoplay 2021.05.21 增
| Boolesn | true | 是否自动播放 |
兼容性说明
01. 因 H5 端不支持背景音乐 api,故本组件不支持 h5 端;
02. 因 nvue 端不支持音乐文件长度获取,故本组件暂不发布 weex 版本( weex 项目请使用 .vue 完成此功能);
权限说明
请仔细阅读权限相关要求,被在对应平台完成配置工作 :
01. uni-app 资料 https://uniapp.dcloud.io/api/media/background-audio-manager?id=getbackgroundaudiomanager
02. 微信小程序资料 https://developers.weixin.qq.com/miniprogram/dev/reference/configuration/app.html#requiredBackgroundModes
微信小程序权限添加示例
/* manifest.json 源码视图 */
/* 小程序特有相关 */
"mp-weixin" : {
"appid" : "wxbb7f9f1f2c6f4f33",
"setting" : {
"urlCheck" : false
},
"usingComponents" : true,
"requiredBackgroundModes": ["audio", "location"]
},
扩展说明
播放器组件涉及的样式较多,且不同项目要求不一样,我们无法把他们都封装为属性。所以我们为您提供了完善的基础功能,我们建议您自己根据项目要求对组件进行二次开发!
开发流程 : 01 复制 gui-audio-player 组件文件 > 02 改成自己的文件 > 03 改进组件 > 04 调用自己修改过的组件;
演示代码
登录并购买 GraceUI 后可以查阅完整手册内容 。
登录并购买 GraceUI 后可以查阅完整手册内容 。
登录并购买 GraceUI 后可以查阅完整手册内容 。