VCMS 视频系统 · 对接文档
VCMS 通过 iframe 嵌入到你的平台页面(和嵌入 YouTube 一样)。本文档讲两件事:
- 嵌入 —— 把"推荐横条 / 完整视频页 / 单个视频播放页"放进你的页面。
- 事件对接(postMessage) —— 用户在组件里的交互(点「更多」、点视频)如何通知你的平台,让你的平台来处理(开新窗口、走自家路由、做埋点统计等)。
三种嵌入
| 用途 | 地址 | 说明 |
|---|---|---|
| 推荐横条 | {BASE}/strip?platform={平台ID} | 平台首页的横向推荐条,点「更多」进完整门户 |
| 完整视频页(去 header) | {BASE}/embed | 完整视频网格,去掉顶部导航,整页嵌入 |
| 单个视频播放页 | {BASE}/watch/{视频ID} | 某个视频的播放页(自动播放) |
{BASE}是门户域名(例如https://vcms-qa.acorners.com)。平台 ID 在后台「平台对接」每个平台的「嵌入代码」里获取。
注意事项
- 防盗链:你的域名需先加入允许 referrer 白名单(请联系我们开通),否则视频会 403。
- 响应式:宽度用
100%自适应容器,高度按需调整;单个视频播放页建议用 16:9 包裹。 - 后台「教学」页有所有嵌入方式的实时预览 + 可复制代码。
下一节:事件对接 API →