eBay商品页必须用video+source嵌入视频,因其HTML过滤器仅允许白名单内的video标签,且需HTTPS、controls、poster、muted、playsinline与webkit-playsinline共存,MP4用H.264编码,WebM用VP9编码,并通过ffmpeg faststart优化首帧加载。

video 标签是唯一推荐的嵌入方式,eBay、Shopify、WooCommerce 等主流平台都只接受它——iframe(如 YouTube)会被过滤或直接屏蔽,object 和 embed 已被弃用且不兼容现代 CSP 策略。
为什么 eBay 商品页必须用 video + source?
eBay 的 HTML 过滤器会剥离所有非白名单属性和标签。实测发现:iframe 中的 src 会被清空,autoplay、mute 等属性若未配合用户手势将被忽略,而 video 标签本身在白名单内,只要结构干净就能通过审核。
- 必须使用 HTTPS 协议的视频 URL,HTTP 地址会被浏览器阻止加载
-
controls属性不能省略,否则 eBay 编辑器可能自动移除整个video块 - 禁止内联 JavaScript 或事件监听器(如
onclick="this.play()"),会被当作 XSS 风险过滤 - poster 图片建议提供,否则首帧空白期过长,影响买家第一印象
source 多格式写法及常见报错
只写一个 src 在 Safari 上大概率失败,因为 Safari 对 WebM 支持极差,而部分 Android 浏览器又对 MP4 的 H.265 编码不识别。正确做法是按兼容性优先级排列 source:
<video controls width="100%" poster="https://example.com/poster.jpg"><source src="https://example.com/video.mp4" type="video/mp4"><source src="https://example.com/video.webm" type="video/webm"> 您的浏览器不支持视频播放。 </source></source></video>
- MP4 必须用 H.264 编码(不是 H.265),否则 iOS 设备无法解码
- WebM 推荐 VP9 编码,体积比 MP4 小 30%~40%,但上传前需确认托管服务支持流式分片(如 Cloudflare R2、AWS S3 + CloudFront)
- 错误信息
Failed to load resource: net::ERR_BLOCKED_BY_CLIENT通常是广告拦截插件或浏览器隐私模式阻断了非主域视频请求,应确保视频与页面同源或已配置 CORS
移动端全屏与 playsinline 的坑
iOS Safari 默认强制横屏全屏,用户点播放后跳转到原生播放器界面,离开后再也回不到商品页——这直接导致跳出率飙升。解决方法只有一个:playsinline + webkit-playsinline 必须同时存在:
<video controls playsinline webkit-playsinline ...></video>
- 仅加
playsinline不生效:iOS 10+ 要求两个属性共存 - 必须搭配
muted才能触发自动播放(哪怕只是首帧),否则 iOS 会静音并暂停 - Android Chrome 无需
playsinline,但部分定制 ROM(如华为 EMUI)会忽略该属性,需测试真机 - 宽度设为
100%并用 CSS 控制最大高度(如max-height: 50vh),避免竖屏下视频溢出容器
最易被忽略的是视频文件的元数据(moov atom)位置:如果它在文件末尾,浏览器必须下载整个视频才能开始播放。上传前务必用 ffmpeg -i input.mp4 -c copy -movflags +faststart output.mp4 重写索引,否则首帧延迟可能超过 8 秒——买家等不到画面就划走了。
前端入门到VUE实战笔记:立即使用
在学习笔记中,你将探索 前端 的入门与实战技巧!











