<span style="color:#cb3837"> 必须使用 vue@3.2.2及以上版本</span>

Vue3-video-play

适用于 Vue3 的 hls.js 播放器组件 | 同时支持 MP4/WebM/Ogg 格式配置强大，界面美观

功能概览

支持快捷键操作
支持倍速播放设置
支持镜像画面设置
支持关灯模式设置
支持画中画模式播放
支持全屏/网页全屏播放
支持从指定时间开始播放
支持移动端，自动调用原生视频播放器
支持 hls 视频流播放，支持直播
hls 播放支持清晰度切换

演示主页

https://codelife.cc/vue3-video-play/

使用指南

安装

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");

组件内使用

// 引入样式
import "vue3-video-play/dist/style.css";
import { videoPlay } from "vue3-video-play";
export default {
  components: {
    videoPlay,
  },
};

基本示例

提供了丰富的配置功能 :::demo 自定义配置例如自定义 poster。

<template>
  <div>
    <vue3VideoPlay
      v-bind="options"
      poster="https://cdn.jsdelivr.net/gh/xdlumia/files/video-play/ironMan.jpg"
    />
  </div>
</template>

<script setup lang="ts">
import { reactive } from "vue";
const options = reactive({
width: "800px", // 播放器宽度
height: "450px", // 播放器高度
color: "#409eff", // 主题色
title: "", // 视频名称
src: "https://cdn.jsdelivr.net/gh/xdlumia/files/video-play/IronMan.mp4", // 视频源
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, // 是否显示控制
controlBtns: [
  "audioTrack",
  "quality",
  "speedRate",
  "volume",
  "setting",
  "pip",
  "pageFullScreen",
  "fullScreen",
], // 显示所有按钮,
});
</script>

<style scoped></style>

可以通过props的speed开启或关闭进度条功能，并且通过currentTime属性控制从60秒开始播放

通过speed关闭进度条拖动功能。并且通过currentTime属性控制从60秒开始播放

<template>
  <div>
    <vue3VideoPlay
      v-bind="options"
      poster="https://cdn.jsdelivr.net/gh/xdlumia/files/video-play/ironMan.jpg"
    />
  </div>
</template>

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

const options = reactive({
  width: "500px", // 播放器高度
  height: "260px", // 播放器高度
  color: "#409eff", // 主题色
  currentTime: 60,
  speed: false, // 关闭进度条拖动
  title: "", // 视频名称
  src: "https://cdn.jsdelivr.net/gh/xdlumia/files/video-play/IronMan.mp4", // 视频源
});
</script>

<style scoped></style>

还可以通过props的control属性来控制是否显示控制器

通过control来控制是否显示控制器

<template>
  <div>
    <vue3VideoPlay
      v-bind="options"
      poster="https://cdn.jsdelivr.net/gh/xdlumia/files/video-play/ironMan.jpg"
    />
  </div>
</template>

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

const options = reactive({
  width: "500px", // 播放器高度
  height: "260px", // 播放器高度
  color: "#409eff", // 主题色
  control: false, // 是否显示控制器
  title: "", // 视频名称
  src: "https://cdn.jsdelivr.net/gh/xdlumia/files/video-play/IronMan.mp4", // 视频源
});
</script>

<style scoped></style>

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://cdn.jsdelivr.net/gh/xdlumia/files/video-play/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>

vue3-video-play支持m3u8(hls)播放

<template>
  <div>
    <vue3VideoPlay
      width="800px"
      title="冰河世纪"
      :src="options.src"
      :type="options.type"
      :autoPlay="false"
    />
  </div>
</template>
<script setup lang="ts">
import { reactive } from "vue";
const options = reactive({
  src: "https://test-streams.mux.dev/x36xhzz/x36xhzz.m3u8", //视频源
  type: "m3u8", //视频类型
});
</script>

<style scoped></style>

:::

属性

vue3-video-play 支持所有原生 video 标签属性 video 原生属性，使用方式与 props 属性相同

名称	说明	类型	可选值	默认值
width	播放器宽度	string	-	800px
height	播放器高度	string	-	450px
color	播放器主色调	string	-	#409eff
src	视频资源	string	-	-
title	视频名称	string	-	-
type	视频类型	string	-	video/mp4
poster	视频封面	string	-	视频第一帧
webFullScreen	网页全屏	boolean	-	false
speed	是否支持快进快退	boolean	-	true
currentTime	跳转到固定播放时间(秒)	number	-	0
playsinline	iOS点击屏幕是否全屏	boolean	-	false
muted	静音	boolean	-	false
speedRate	倍速配置	array	-	["2.0", "1.0", "1.5", "1.25", "0.75", "0.5"]
autoPlay	自动播放	boolean	-	false,为 true 时会自动静音
loop	循环播放	boolean	-	false
mirror	镜像画面	boolean	-	false
ligthOff	关灯模式	boolean	-	false
volume	默认音量	number	0-1	0.3
control	是否显示控制器	boolean	-	true
controlBtns	控制器显示的按钮	array	['audioTrack', 'quality', 'speedRate', 'volume', 'setting', 'pip', 'pageFullScreen', 'fullScreen']	['audioTrack', 'quality', 'speedRate', 'volume', 'setting', 'pip', 'pageFullScreen', 'fullScreen']
preload	预加载	string	meta/auto/none	auto

`props`属性 `controlBtns` 按钮说明

名称	说明
audioTrack	音轨切换按钮
quality	视频质量切换按钮
speedRate	速率切换按钮
volume	音量
setting	设置
pip	画中画按钮
pageFullScreen	网页全屏按钮
fullScreen	全屏按钮

事件

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	播放速率变化	事件
durationchange	资源时长变化	事件
volumechange	音量变化	事件

快捷键说明

支持快捷键操作

键名	说明
空格键	暂停/播放
右方向键 →	单次快进 10 秒，长按 5 倍速播放
左方向键 ←	快退 10 秒
上方向键 ↑	音量增加 10%
下方向键 ↓	音量减少 10%
Esc 键	退出全屏/退出网页全屏
F 键	全屏/退出全屏