当前位置: 首页 > 工具软件 > Player > 使用案例 >

LivePlayer播放器的基本用法

谷梁存
2023-12-01

LivePlayer安装引入

1.安装

npm install @liveqing/liveplayer

2.在vue.config.js添加配置

const CopyWebpackPlugin = require("copy-webpack-plugin");

configureWebpack: {
    mode: "development",
    //开启源代码调试
    devtool: "source-map",
    plugins: [
      new CopyWebpackPlugin([
        { from: 'node_modules/@liveqing/liveplayer/dist/component/crossdomain.xml'},
        { from: 'node_modules/@liveqing/liveplayer/dist/component/liveplayer.swf'},
        { from: 'node_modules/@liveqing/liveplayer/dist/component/liveplayer-lib.min.js', to: 'js/'},
    ])
    ],
  },

3.在 public/index.html 中引用 liveplayer-lib.min.js

<head>
    <!--引入liveplayer依赖-->
    <script  type="text/javascript" src="<%= BASE_URL %>js/liveplayer-lib.min.js"></script>
    <script  type="text/javascript" src="<%= BASE_URL %>js/liveplayer-component.min.js"></script>

     <!-- 如果没有使用 vue-cli:
          <script src="js/liveplayer-lib.min.js"></script>
     -->
</head>

4.引入并使用组件

import LivePlayer from '@liveqing/liveplayer'

  components: {
    LivePlayer
  }

<LivePlayer :videoUrl="videoUrl" fluent autoplay live stretch></LivePlayer>

LivePlayer基本用法

属性(Property)

video-url视频流地址, String default ''
video-title视频右上角显示的标题, String default ''
poster视频封面图片, String default ''
autoplay自动播放, Boolean default true
controls显示播放器控制栏, Boolean default true
loop是否循环播放, Boolean default false
live是否直播, 标识要不要显示进度条, Boolean default false
alt视频流地址没有指定情况下, 视频所在区域显示的文字, 相当于 html img 标签的 alt 属性, String default '无信号'
muted是否静音, Boolean default true
aspect视频显示区域的宽高比, fullscreen 即是全屏展示, String default '16:9'
loading指示加载状态, 支持 sync 修饰符, Boolean default false
fluent流畅模式, Boolean default true
stretch是否拉伸, Boolean default false
timeoutm3u8 加载超时(秒), Number default 20
show-custom-button是否在工具栏显示自定义按钮(极速/流畅, 拉伸/标准), Boolean default true
hide-big-play-button是否隐藏起播状态下的大播放按钮, Boolean default false
hide-snapshot-button是否隐藏 快照 按钮, Boolean default false
hide-fullscreen-button是否隐藏 全屏 按钮, Boolean default false
hide-fluent-button是否隐藏 极速/流畅 按钮, Boolean default false
hide-stretch-button是否隐藏 拉伸/标准 按钮, Boolean default false

resolution

HLS点播流播放时使用:需已有对应清晰度的HLS流,供选择的清晰度配置, 如 "yh,fhd,hd,sd" (说明:yh:原始分辨率,fhd:超清,hd:高清,sd:标清,不配置则不启用,需要提供多清晰度源,比如原画源是test.m3u8, 则hd源即为test_hd.m3u8), String default ''
resolutiondefaultHLS点播流播放时使用:默认播放的清晰度, String default 'hd'
playback-ratesHLS点播流播放时使用:倍速列表, Array default [0.5, 1, 2, 3]
playback-rateHLS点播流播放时使用:默认倍速, Number default 1

hasaudio

HTTP-FLV播放时使用: 是否有音频,传递该属性用于处理只有音频或只有视频的源, Boolean 默认不配置自动判断
hasvideoHTTP-FLV播放时使用: 是否有视频,传递该属性用于处理只有音频或只有视频的源, Boolean 默认不配置自动判断
custom-buttons自定义工具栏按钮, 配置模板(按钮名称[:class名称]), 多个用英文逗号分隔, 示例:custom-buttons="对讲,配置:vjs-icon-cog", String default ''
autofocus是否自动获取焦点, Boolean default false
dblclick-fullscreen是否双击全屏, Boolean default true
language语言(zh-CN/en), String 默认不配置自动判断

方法(Method)

play播放
pause暂停
paused获取暂停状态
getCurrentTime获取当前播放时间进度, 同步返回播放时间进度数据
setCurrentTime设置当前播放时间进度, 即 seek
snap外部 API 方式获取快照, 快照获取成功后, 触发 snapOutside Event
getMuted获取静音状态
setMuted设置静音状态
isFullscreen获取全屏状态
requestFullscreen触发全屏, 需要放置到交互事件回调中调用

exitFullscreen

退出全屏, 需要放置到交互事件回调中调用
toggleFullscreen触发全屏, 需要放置到交互事件回调中调用, 如果已处在全屏状态, 则退出全屏

getVolume

获取音量
setVolume设置音量, 0~1
getDuration获取点播时长(秒)

 

事件(Event)

messagem3u8 加载失败时触发通知消息, 参数: { type: '', message: ''}
error播放器出错回调, 参数: Error Object
ended播放结束, 参数: 无
timeupdate进度更新, 参数: 当前时间进度
pause暂停, 参数: 当前时间进度
play播放, 参数: 当前时间进度
fullscreen全屏状态改变, 参数:true/false
snapOutside外部快照回调, 参数: 快照 Base64 数据

snapInside

内部快照回调, 由控制栏快照按钮触发, 参数: 快照 Base64 数据

customButtons

自定义按钮点击回调, 参数:名称
 类似资料: