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 效果
目录导航