VCMS 视频系统 · 对接文档
VCMS 通过 iframe 嵌入到你的平台页面（和嵌入 YouTube 一样）。本文档讲两件事：
- 嵌入 —— 把"推荐横条 / 完整视频页 / 单个视频播放页"放进你的页面。
- 事件对接（postMessage） —— 用户在组件里的交互（点「更多」、点视频）如何通知你的平台，让你的平台来处理（开新窗口、走自家路由、做埋点统计等）。
三种嵌入
| 用途 | 地址 | 说明 |
|---|---|---|
| 推荐横条 | {BASE}/strip?platform={平台ID} | 平台首页的横向推荐条，点「更多」进完整门户 |
| 完整视频页（去 header） | {BASE}/embed | 完整视频网格，去掉顶部导航，整页嵌入 |
| 单个视频播放页 | {BASE}/watch/{视频ID} | 某个视频的播放页（自动播放） |
{BASE}是门户域名（例如https://vcms-qa.acorners.com）。平台 ID 在后台「平台对接」每个平台的「嵌入代码」里获取。
可选参数 · 用户标识 uid
三种嵌入都支持一个可选参数 uid，用来标识你平台上的这个用户：
| 用途 | 带 uid 的地址 |
|---|---|
| 推荐横条 | {BASE}/strip?platform={平台ID}&uid={用户ID} |
| 完整视频页 | {BASE}/embed?platform={平台ID}&uid={用户ID} |
| 单个视频播放页 | {BASE}/watch/{视频ID}?platform={平台ID}&uid={用户ID} |
带上之后，点赞 / 不喜欢、搜索历史与收藏按「平台 + 用户」保存在服务端；同一用户使用同一个
uid，可在其他浏览器恢复这些数据。组件内的「我」入口可查看和播放收藏视频。
访问、搜索、播放、评价变化、收藏变化、分享操作及发起下载的可观测记录，可由有权限的后台账号查看。
几条规 则：
- 必须与
platform同时出现才生效。身份是「平台 + 用户」的组合 —— 不同平台的同名用户是 两个不同的人，只有uid无法构成身份，系统会按未带处理。 - 不带有效
uid时：点赞、搜索历史和收藏按当前浏览器保存，清除浏览器数据后无法恢复；不会归到某个用户的后台行为记录。 - 只能包含 英文字母、数字、
-、_，长度 1–64 字符。&、#、空格、中文等字符在 网址里会把值截断或需要转义，一律不接受。 - 为空、超长或含其他字符时不会报错，自动按未带处理。
- 值由你决定，但建议填你们内部用户 ID 的哈希值（例如
a3f8c91e4b7d2065f1c8e93a4d6b0271）。 不要直接填手机号、邮箱或用户名 ——uid明文出现在网址里，会进浏览器历史与访问日志。 也不要填1001这类连号：别人把网址里的数字改一位，就能顶着另一个用户的身份点赞。 - 同一个用户每次必须填同一个值（换了值，将对应另一份点赞、搜索历史与收藏数据）， 且一个值只能对应一个人。
⚠️
uid是明文参数，可以被任何人在地址栏里改写，因此它不是认证凭据。 请不要用它承载 登录态或任何需要保密的信息。知道或伪造相同平台与uid的人可以读取或改变对应用户的评价、 搜索历史与收藏，并产生归属于该用户的行为记录。
播放页功能
- 分享、下载、收藏、点赞与不喜欢由后台按平台独立开关；关闭后对应入口隐藏，服务端拒绝新的对应操作，既有数据保留。
- PC 下载保存为本地 MP4 文件。手机浏览器下载后，由用户按浏览器提供的方式手动保存至相册；网页不保证直接写入相册。没有可用 MP4 时会提示暂不可下载。
- 「发起下载」记录表示服务端开始提供文件，不代表文件已下载完成或已保存相册；分享记录表示可观测的点击操作，不代表对方已收到。
- 简介可显示后台配置的可点击链接；观看页分隔线颜色可独立设置，PC 与手机均生效。
注意事项
- 防盗链：你的域名需先加入允许 referrer 白名单（请联系我们开通），否则视频会 403。
- 响应式：宽度用
100%自适应容器，高度按需调整；单个视频播放页建议用 16:9 包裹。 - 配色：推荐横条 / 完整页的背景、标题·内容、「更多」颜色可按平台定制（由我方在后台配置，你无需改嵌入代码）。
- 用户标识：如需按你平台的用户区分评价、搜索历史与收藏，在嵌入地址上加
&uid=，见上文。 - 后台「教学」页有所有嵌入方式的实时预览 + 可复制代码（含
uid的模拟输入）。
下一节：事件对接 API →