vue3+ts 使用vue-video-player 实现音视频播放

本文介绍了在Vue3项目中使用vue-video-player遇到的TypeScript编译问题,通过创建shims-vue.d.ts文件解决了编译错误,并详细配置了视频播放器选项,包括播放速度、自动播放等。

摘要生成于 C知道 ,由 DeepSeek-R1 满血版支持, 前往体验 >

前言 

 在vue3 中尝试了很多插件都不支持,vue3-video-player在ios不兼容,所以最后选择用了vue-video-player,但是在ts中编译不是通用的,所以需要手动修改一下编译方法,最后可以使用了,详情请看下面。 

目录

一、安装npm依赖

二、main.ts引入

三、ts导致的错误解决 

四、视频播放器配置

五、完整代码

六、展示效果


一、安装npm依赖

npm install vue-video-player@5.0.2 --save
npm install video.js --save

二、main.ts引入

import VideoPlayer from 'vue-video-player/src'
import 'video.js/dist/video-js.css' 
import 'vue-video-player/src/custom-theme.css'

三、ts导致的错误解决 

这时候会编译错误

新建一个文件shims-vue.d.ts(与main.ts同级)

/* eslint-disable */
declare module '*.vue' {
  import type { DefineComponent } from 'vue'
  const component: DefineComponent<{}, {}, any>
  export default component
}
declare module 'vue-video-player/src'

四、视频播放器配置

playerOptions: {
          playbackRates: [0.5, 1.0, 1.5, 2.0], // 可选的播放速度
          autoplay: false, // 如果为true,浏览器准备好时开始回放。
          muted: false, // 默认情况下将会消除任何音频。
          loop: false, // 是否视频一结束就重新开始。
          preload: 'auto', // 建议浏览器在<video>加载元素后是否应该开始下载视频数据。auto浏览器选择最佳行为,立即开始加载视频(如果浏览器支持)
          language: 'zh-CN',
          aspectRatio: '4:3', // 将播放器置于流畅模式,并在计算播放器的动态大小时使用该值。值应该代表一个比例 - 用冒号分隔的两个数字(例如"16:9"或"4:3")
          fluid: true, // 当true时,Video.js player将拥有流体大小。换句话说,它将按比例缩放以适应其容器。
          sources: [{
            type: "video/mp4", // 类型
            src: 'https://vd3.bdstatic.com/mda-maunc8q8gpwgjts8/sc/cae_h264_nowatermark/1611907885/mda-maunc8q8gpwgjts8.mp4?v_from_s=hkapp-haokan-hbf&auth_key=1660703434-0-0-645160ca4ccdbc9c0c2088e7d56dd8b9&bcevod_channel=searchbox_feed&pd=1&cd=0&pt=3&logid=0034644783&vid=11220038343555649881&abtest=103890_1-103579_2&klogid=0034644783' // url地址
            // src: props.video // url地址
          }],
          poster: '', // 封面地址
          notSupportedMessage: '此视频暂无法播放,请稍后再试', // 允许覆盖Video.js无法播放媒体源时显示的默认信息。
          controlBar: {
            timeDivider: true, // 当前时间和持续时间的分隔符
            durationDisplay: true, // 显示持续时间
            remainingTimeDisplay: false, // 是否显示剩余时间功能
            fullscreenToggle: true // 是否显示全屏按钮
          }
        }

五、完整代码

<template>
  <div class="video">
    <video-player class="video-player vjs-custom-skin"
            ref="videoPlayer"
            :playsinline="true"
            :options="data.playerOptions">
    </video-player>
  </div>
</template>

<script>
import { reactive } from '@vue/reactivity'

export default {
  name: 'Video',
  props:['video','cover'],
  setup(props){
    let data = reactive({
         playerOptions: {
          playbackRates: [0.5, 1.0, 1.5, 2.0], // 可选的播放速度
          autoplay: false, // 如果为true,浏览器准备好时开始回放。
          muted: false, // 默认情况下将会消除任何音频。
          loop: false, // 是否视频一结束就重新开始。
          preload: 'auto', // 建议浏览器在<video>加载元素后是否应该开始下载视频数据。auto浏览器选择最佳行为,立即开始加载视频(如果浏览器支持)
          language: 'zh-CN',
          aspectRatio: '4:3', // 将播放器置于流畅模式,并在计算播放器的动态大小时使用该值。值应该代表一个比例 - 用冒号分隔的两个数字(例如"16:9"或"4:3")
          fluid: true, // 当true时,Video.js player将拥有流体大小。换句话说,它将按比例缩放以适应其容器。
          sources: [{
            type: "video/mp4", // 类型
            src: 'https://vd3.bdstatic.com/mda-maunc8q8gpwgjts8/sc/cae_h264_nowatermark/1611907885/mda-maunc8q8gpwgjts8.mp4?v_from_s=hkapp-haokan-hbf&auth_key=1660703434-0-0-645160ca4ccdbc9c0c2088e7d56dd8b9&bcevod_channel=searchbox_feed&pd=1&cd=0&pt=3&logid=0034644783&vid=11220038343555649881&abtest=103890_1-103579_2&klogid=0034644783' // url地址
            // src: props.video // url地址
          }],
          poster: props.cover, // 封面地址
          notSupportedMessage: '此视频暂无法播放,请稍后再试', // 允许覆盖Video.js无法播放媒体源时显示的默认信息。
          controlBar: {
            timeDivider: true, // 当前时间和持续时间的分隔符
            durationDisplay: true, // 显示持续时间
            remainingTimeDisplay: false, // 是否显示剩余时间功能
            fullscreenToggle: true // 是否显示全屏按钮
          }
        }
    })
    return {
      data
    }
  }
  
}
</script>

<style scoped>
  .video{
    width: 100%;
    height: 100%;
    margin: auto;
  }
</style>
<style>
.video .vjs_video_3-dimensions.vjs-fluid {
  padding-top: 57%;
}
.video .vjs-custom-skin > .video-js .vjs-big-play-button {
    /* background-color: rgba(0,0,0,0.45); */
    font-size: 3.5em;
    border-radius: 50%;
    height: 2em !important;
    width: 2em !important;
    line-height: 2em !important;
    margin-top: -1em !important;
    margin-left: -1em
}
.video .vjs-poster{
background-position:center
}
</style>

六、展示效果

 

<think>我们正在处理一个关于在Vue3项目中使用TypeScript实现视频播放功能的问题。根据提供的引用,有两种方式可以实现:一种是直接使用video.js,另一种是使用@videojs-player/vue组件。 引用[1]展示了在Vue3的setup语法糖中使用video.js的方法: 1. 安装video.js和相应的类型声明(如果需要的话,因为使用TypeScript)。 2. 在组件中引入video.js及其样式。 3. 在模板中放置video元素,并设置ref和类名(如video-js)。 4. 在onMounted生命周期钩子中初始化video.js播放器。 引用[2]则介绍了使用@videojs-player/vue这个封装好的Vue组件: 1. 安装video.js和@videojs-player/vue。 2. 在main.ts中全局引入VueVideoPlayervideo.js的样式。 3. 在组件中直接使用<video-player>标签。 由于用户要求使用TypeScript,我们需要注意类型声明。对于第一种方式,我们需要安装video.js的类型声明包(@types/video.js)。但是,请注意,video.js本身可能已经包含了类型声明,所以我们可以先尝试安装video.js,如果类型不存在再安装@types/video.js。 但是,根据引用[2]的方式,使用@videojs-player/vue,它可能已经自带了类型声明,因为它是为Vue3设计的。 考虑到用户的需求,我们将提供两种实现方式,并说明步骤。 方式一:直接使用video.js 步骤: 1. 安装依赖:video.js 和 它的类型声明(如果必要) 2.Vue组件中,使用setup语法糖(<script setup lang="ts">)编写代码 3. 模板中放置video元素,并设置ref 4. 在onMounted中初始化播放器,并传入配置项 方式二:使用@videojs-player/vue组件 步骤: 1. 安装依赖:@videojs-player/vuevideo.js 2. 在main.ts中全局注册(或者也可以在组件中局部注册) 3. 在组件中直接使用<video-player>组件,并传入配置 由于用户没有特别指定使用哪种方式,我们可以都介绍一下,让用户选择。 但是,注意引用[2]中提到了全局引入,而引用[1]是局部引入。我们也可以根据用户的偏好来提供。 下面我们分别给出两种方式的代码示例。 方式一:直接使用video.js(局部引入) 首先,安装video.js```bash npm install video.js ``` 如果video.js没有自带类型,那么需要安装类型声明(一般情况下,video.js从7.6.6版本开始自带类型,所以可能不需要): ```bash npm install @types/video.js --save-dev ``` 然后,在组件中: 注意:在模板中,我们使用ref来获取DOM元素,但要注意,在setup中我们使用ref来绑定。 方式二:使用@videojs-player/vue 首先,安装: ```bash npm install video.js @videojs-player/vue ``` 然后,在main.ts中全局注册: 或者,也可以在组件中局部注册。 由于用户要求使用TypeScript,我们将使用TypeScript语法。 下面分别给出两种方式的详细代码。 方式一示例代码(直接使用video.js):</think>在 Vue3 项目中结合 TypeScript 实现视频播放功能,推荐使用成熟的视频播放库如 `video.js` 或专用 Vue 组件 `@videojs-player/vue`。以下是两种实现方案: ### 方案一:使用原生 video.js (推荐) ```bash npm install video.js @types/video.js ``` ```vue <template> <div> <video ref="videoPlayer" class="video-js vjs-default-skin" controls preload="auto" width="600"> <source :src="videoUrl" type="video/mp4" /> </video> </div> </template> <script setup lang="ts"> import { onMounted, ref, onBeforeUnmount } from &#39;vue&#39;; import videojs, { VideoJsPlayer, VideoJsPlayerOptions } from &#39;video.js&#39;; import &#39;video.js/dist/video-js.css&#39;; const videoUrl = ref(&#39;https://example.com/sample.mp4&#39;); // 替换为实际视频URL const videoPlayer = ref<HTMLVideoElement | null>(null); let player: VideoJsPlayer | null = null; const options: VideoJsPlayerOptions = { controls: true, autoplay: false, playbackRates: [0.5, 1, 1.5, 2], responsive: true, fluid: true, sources: [{ src: videoUrl.value, type: &#39;video/mp4&#39; }] }; onMounted(() => { if (videoPlayer.value) { player = videojs(videoPlayer.value, options, () => { console.log(&#39;播放器已初始化&#39;); }); } }); onBeforeUnmount(() => { player?.dispose(); // 销毁播放器防止内存泄漏 }); </script> ``` ### 方案二:使用 Vue 专用组件 `@videojs-player/vue` ```bash npm install video.js @videojs-player/vue ``` ```vue <template> <video-player src="https://example.com/sample.mp4" :options="playerOptions" @ready="onPlayerReady" /> </template> <script setup lang="ts"> import { ref } from &#39;vue&#39;; import type { VideoJsPlayer } from &#39;video.js&#39;; const playerOptions = ref({ autoplay: false, controls: true, responsive: true, playbackRates: [0.5, 1, 1.5, 2], sources: [{ src: &#39;https://example.com/sample.mp4&#39;, type: &#39;video/mp4&#39; }] }); const onPlayerReady = (player: VideoJsPlayer) => { console.log(&#39;播放器就绪&#39;, player); }; </script> ``` ### 关键配置说明 1. **视频源配置**: - 支持多种格式:`MP4`/`WebM`/`HLS`/`DASH` - 多源备用方案: ```ts sources: [ { src: &#39;hd-video.mp4&#39;, type: &#39;video/mp4&#39;, label: &#39;HD&#39; }, { src: &#39;sd-video.mp4&#39;, type: &#39;video/mp4&#39;, label: &#39;SD&#39; } ] ``` 2. **常用功能**: ```ts const options = { controls: true, // 显示控制条 autoplay: &#39;muted&#39;, // 静音自动播放(符合浏览器策略) loop: true, // 循环播放 muted: true, // 默认静音 preload: &#39;auto&#39;, // 预加载策略 poster: &#39;thumbnail.jpg&#39; // 视频封面 } ``` 3. **事件监听**: ```ts player.on(&#39;play&#39;, () => console.log(&#39;开始播放&#39;)); player.on(&#39;ended&#39;, () => console.log(&#39;播放结束&#39;)); player.on(&#39;error&#39;, (err) => console.error(&#39;播放错误&#39;, err)); ``` ### 注意事项 1. **跨域问题**:若视频源在外部域,需确保服务器配置`CORS`头 2. **类型支持**:安装 `@types/video.js` 获得完整 TS 类型提示 3. **响应式布局**:使用 `fluid: true` 使播放器自适应容器 4. **移动端适配**:添加 `<meta name="viewport">` 标签 > 提示:对于直播流(HLS/DASH),需额外安装 `videojs-contrib-hls``videojs-http-streaming` 插件[^1]
评论 27
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值