logo设置

zwplayer 支持在视频画面上叠加自定义 Logo,可通过配置参数实现灵活的 Logo 显示效果。

1. 配置方式

1.1 简单配置(字符串格式)

直接将 logo 参数设置为 Logo 图片的 URL 地址:

logo: 'http://example.com/vod/logo.png'

默认显示效果:

  • 位置:播放器右上角(上边距 5%,右边距 5%)

  • 尺寸:播放器宽度的 5%

  • 透明度:50%(半透明效果)

1.2 高级配置(对象格式)

通过 JavaScript 对象进行详细配置:

logo: {
    icon: 'http://example.com/vod/logo.png',
    dock: 'left',
    x: '5%',
    y: '5%',
    width: '20%',
    height: '20%',
    opacity: 70
}

2. Logo 对象属性说明

属性类型缺省值必填说明
iconstring Logo 图片 URL,支持 PNG、JPG、GIF、SVG 格式,建议使用带透明通道的 PNG 或 SVG 图片
dockstringrightLogo 停靠区域,可选值:left(左侧)、right(右侧)
x, ystring5%Logo 位置坐标,相对于播放器。当 dockleft 时相对于左上角,为 right 时相对于右上角。支持像素值(如 60px)或百分比(如 5%
width, heightstring5%Logo 尺寸,支持像素值或百分比(相对于播放器尺寸)
opacitynumber50透明度,取值范围 0-100(0:完全透明,100:完全不透明),推荐值:30-70,此属性可将播放器logo融入视频画面

3. 使用建议

  1. 图片制作

    • 建议使用较大尺寸的源图片(如 256×256 像素)

    • 优先选择 PNG 或 SVG 格式,确保背景透明

  2. 尺寸与位置

    • 推荐使用百分比值,这样 Logo 能自适应播放器缩放

    • 先在基准尺寸下调试好位置,再应用相对尺寸,这样播放器在后续缩放与全屏幕时logo能够自行缩放位置与尺寸,会比较协调。

4. 完整示例

<script language="javascript">
   window.mainplayer = new ZWPlayer({
      url: 'http://example.com/vod/movie.mp4',
      playerElm: '#player-holder',
      controlbar: true,
      logo: {
         icon: 'http://example.com/vod/cctv-3-logo.png',
         dock: 'right',
         opacity: 70,
         x: '5%',
         y: '2%',
         width: '15%',
         height: '15%',
      }
   });
</script>

5. 效果展示

Logo 设置 效果示例

图示:在播放器右上角显示的 Logo 效果

 

目录导航