mediocreBoys/vue3-video-play

基于vue3开发的视频播放器插件，配置丰富，界面还算好看

在使用的时候遇到任何问题 欢迎各位大佬提issue或者扫码加我微信我拉你入群

必须使用 vue@3.2.4及以上版本

示例 主页

https://xdlumia.github.io

即将支持 🎉

• 支持 hls 直播视频
• 支持弹幕

近期更新 v1.2.52 (2021-08-27) 🎉

• 新增: 右键菜单功能，右键菜单包涵，视频滤镜调节、快捷键说明、复制当前视频网址
• 新增: mirrorChange loopChange lightOffChange 事件
• 新增: 倍速播放默认配置,增加0.5倍速播放
• 新增: 资源播放失败错误状态
• 新增: 非循环播放状态下播放结束增加重新播放按钮
• 新增: 增加空格快捷键 播放/暂停 的操作
• 优化: 如果音量为 0 关闭静音按钮 音量设置为 5

使用指南

安装

npm 安装：

npm i vue3-video-play --save

yarn 安装：

yarn add vue3-video-play --save

开始使用

全局使用

import { createApp } from "vue";
import App from "./App.vue";
let app = createApp(App);

import vue3videoPlay from "vue3-video-play"; // 引入组件
import "vue3-video-play/dist/style.css"; // 引入css
app.use(vue3videoPlay);

app.mount("#app");

组件内使用

// require style
import "vue3-video-play/dist/style.css";
import { videoPlay } from "vue-video-player";
export default {
  components: {
    videoPlay,
  },
};

小试牛刀

:::demo 自定义配置 比如自定义 poster。

<template>
  <div>
    <vue3VideoPlay
      v-bind="options"
      poster="https://xdlumia.oss-cn-beijing.aliyuncs.com/videos/02.jpg"
    />
  </div>
</template>

<script setup lang="ts">
import { reactive } from "vue";

const options = reactive({
  width: "800px", //播放器高度
  height: "450px", //播放器高度
  color: "#409eff", //主题色
  title: "", //视频名称
  src: "https://xdlumia.oss-cn-beijing.aliyuncs.com/videos/IronMan.mp4", //视频源
  speed: true, //是否支持快进快退
  muted: false, //静音
  webFullScreen: false,
  speedRate: ["0.75", "1.0", "1.25", "1.5", "2.0"], //播放倍速
  autoPlay: false, //自动播放
  loop: false, //循环播放
  mirror: false, //镜像画面
  ligthOff: false, //关灯模式
  volume: 0.3, //默认音量大小
  control: true, //是否显示控制器
});
</script>

<style scoped></style>

:::

事件示例

:::demo vue3-video-play 支持原生video所有事件。

<template>
  <div>
    <vue3VideoPlay
      width="800px"
      title="钢铁侠"
      :src="options.src"
      :poster="options.poster"
      @play="onPlay"
      @pause="onPause"
      @timeupdate="onTimeupdate"
      @canplay="onCanplay"
    />
  </div>
</template>

<script setup lang="ts">
import { reactive } from "vue";

const options = reactive({
  src: "https://xdlumia.oss-cn-beijing.aliyuncs.com/videos/IronMan.mp4", //视频源
  poster: "", //封面
});
const onPlay = (ev) => {
  console.log("播放");
};
const onPause = (ev) => {
  console.log(ev, "暂停");
};

const onTimeupdate = (ev) => {
  console.log(ev, "时间更新");
};
const onCanplay = (ev) => {
  console.log(ev, "可以播放");
};
</script>

<style scoped></style>

:::

Props

vue3-video-play 支持 video 原生所有 Attributes video 原生属性 使用方式和 props 属性使用一致

名称	说明	类型	可选值	默认值
width	播放器宽度	string	-	800px
height	播放器高度	string	-	450px
title	视频名称	string	-	-
src	视频资源	string	-	-
color	播放器主色调	string	-	#409eff
webFullScreen	网页全屏	boolean	-	false
speed	是否支持快进快退	boolean	-	true
speedRate	倍速配置	array	-	["0.75", "1.0", "1.25", "1.5", "2.0"]
mirror	镜像画面	boolean	-	false
ligthOff	关灯模式	boolean	-	false
muted	静音	boolean	-	false
autoPlay	自动播放	boolean	-	false,为 true 时会自动静音
loop	循环播放	boolean	-	false
volume	默认音量	0.3	0-1	0.3
poster	视频封面	string	-	视频第一帧

Events

vue3-video-play 支持 video 原生所有事件 video 默认事件

事件名称	说明	回调
mirrorChange	镜像翻转事件	val
loopChange	循环播放开关事件	val
lightOffChange	关灯模式事件	val
loadstart	客户端开始请求数据	event
progress	客户端正在请求数据	event
error	请求数据时遇到错误	event
stalled	网速失速	event
play	开始播放时触发	event
pause	暂停时触发	event
loadedmetadata	成功获取资源长度	event
loadeddata	缓冲中	event
waiting	等待数据，并非错误	event
playing	开始回放	event
canplay	暂停状态下可以播放	event
canplaythrough	可以持续播放	event
timeupdate	更新播放时间	event
ended	播放结束	event
ratechange	播放速率改变	event
durationchange	资源长度改变	event
volumechange	音量改变	event

快捷键说明

支持快捷键操作

键名	说明
Space	暂停/播放
方向右键 →	单次快进 10s，长按 5 倍速播放
方向左键 ←	快退 10s
方向上键 ↑	音量+10%
方向下键 ↓	音量-10%
Esc	退出全屏/退出网页全屏
F	全屏/退出全屏

Author

xdlumia

点个 start

vue3-video-play