更新记录
1.0.1(2025-03-02) 下载此版本
更新使用文档
1.0(2025-02-26) 下载此版本
1.0版本
平台兼容性
Vue2 | Vue3 |
---|---|
× | √ |
App | 快应用 | 微信小程序 | 支付宝小程序 | 百度小程序 | 字节小程序 | QQ小程序 |
---|---|---|---|---|---|---|
HBuilderX 3.1.0 | × | √ | × | × | × | × |
钉钉小程序 | 快手小程序 | 飞书小程序 | 京东小程序 | 鸿蒙元服务 |
---|---|---|---|---|
× | × | × | × | × |
H5-Safari | Android Browser | 微信浏览器(Android) | QQ浏览器(Android) | Chrome | IE | Edge | Firefox | PC-Safari |
---|---|---|---|---|---|---|---|---|
× | × | × | × | × | × | × | × | × |
z-player 微信小程序自定义视频播放器
简介
z-player 是一款专为微信小程序开发的自定义视频播放器组件,提供了丰富的功能和良好的用户体验。该组件完全自定义了播放器界面,支持全屏播放、倍速播放、进度条控制等多种功能,适用于需要在微信小程序中展示视频内容的场景。
特点
- 仅支持微信小程序:专为微信小程序环境优化设计
- 完全自定义界面:美观的播放器界面,可自定义宽高
- 丰富的播放控制:
- 播放/暂停控制
- 全屏/退出全屏切换
- 进度条拖拽控制
- 倍速播放(支持0.5x、1.0x、1.5x、2.0x等自定义倍速)
- 锁屏功能
- 视频列表播放:支持多个视频连续播放,可自动播放下一节
- 播放完成提示:视频播放完成后显示自定义提示,支持重播和播放下一节
- 时间显示:显示当前播放时间和总时长
安装方法
- 在 uni-app 项目中,从插件市场导入 z-player 组件
- 在需要使用的页面引入组件
使用方法
基本用法
<template>
<view>
<z-player
:width="750"
:height="400"
:videoList="videoList"
></z-player>
</view>
</template>
<script>
export default {
data() {
return {
videoList: [
{
url: "https://example.com/video1.mp4",
title: "视频1"
},
{
url: "https://example.com/video2.mp4",
title: "视频2"
}
]
}
}
}
</script>
属性说明
属性名 | 类型 | 默认值 | 说明 |
---|---|---|---|
width | Number | 400 | 播放器宽度(单位:rpx) |
height | Number | 300 | 播放器高度(单位:rpx) |
videoList | Array | [] | 视频列表,每项包含url(视频地址)和title(视频标题) |
startIndex | Number | 0 | 起始播放的视频索引 |
startTime | Number | 0 | 视频开始播放的时间点(单位:秒) |
betList | Array | [0.5, 1.0, 1.5, 2.0] | 倍速选项列表 |
endmsg | String | "视频播放完成" | 视频播放完成后显示的提示文本 |
注意事项
- 该组件仅支持微信小程序,不支持H5、App等其他平台
- 使用时需确保视频资源可以正常访问
- 视频列表中的url必须是有效的视频地址
示例效果
播放器提供了美观的界面和流畅的交互体验:
- 普通模式下显示基础控制按钮和进度条
- 全屏模式下提供更完整的控制界面
- 视频播放完成后显示重播和播放下一节的选项
版本信息
当前版本:1.0.0 发布日期:2025-02-26