UniApp 中的 video-player 组件是用于播放视频的增强组件,支持自定义控制栏、弹幕、倍速播放等功能。以下是基本使用方法:
1. 引入组件
在 pages.json 中配置使用:
{
"usingComponents": {
"video-player": "/path/to/video-player组件路径"
}
}
2. 基础使用示例
<template>
<view>
<video-player
:src="videoSrc"
:danmu-list="danmuList"
@play="onPlay"
@pause="onPause"
></video-player>
</view>
</template>
<script>
export default {
data() {
return {
videoSrc: 'https://example.com/sample.mp4',
danmuList: [{
text: '测试弹幕',
color: '#ff0000',
time: 1
}]
}
},
methods: {
onPlay() {
console.log('开始播放')
},
onPause() {
console.log('暂停播放')
}
}
}
</script>
3. 常用属性说明
src: 视频资源地址(必填)
danmu-list: 弹幕数据数组
autoplay: 是否自动播放
controls: 是否显示控制栏
loop: 是否循环播放
muted: 是否静音
4. 常用方法
通过 ref 调用组件方法:
<video-player ref="videoPlayer"></video-player>
<script>
// 跳转到指定时间
this.$refs.videoPlayer.seek(120)
// 播放/暂停
this.$refs.videoPlayer.play()
this.$refs.videoPlayer.pause()
</script>
注意事项:
- 确保组件路径正确
- 视频格式建议使用 MP4
- 部分功能需要对应平台支持
- 真机调试时注意网络权限
建议查阅官方文档获取最新参数和兼容性说明。