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 对象属性说明
属性 | 类型 | 缺省值 | 必填 | 说明 |
---|---|---|---|---|
icon | string | 是 | Logo 图片 URL,支持 PNG、JPG、GIF、SVG 格式,建议使用带透明通道的 PNG 或 SVG 图片 | |
dock | string | right | 否 | Logo 停靠区域,可选值:left (左侧)、right (右侧) |
x , y | string | 5% | 否 | Logo 位置坐标,相对于播放器。当 dock 为 left 时相对于左上角,为 right 时相对于右上角。支持像素值(如 60px )或百分比(如 5% ) |
width , height | string | 5% | 否 | Logo 尺寸,支持像素值或百分比(相对于播放器尺寸) |
opacity | number | 50 | 否 | 透明度,取值范围 0-100(0:完全透明,100:完全不透明),推荐值:30-70,此属性可将播放器logo融入视频画面 |
3. 使用建议
图片制作
建议使用较大尺寸的源图片(如 256×256 像素)
优先选择 PNG 或 SVG 格式,确保背景透明
尺寸与位置
推荐使用百分比值,这样 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 效果
目录导航