跳到主要内容

更新记录 (Changelog)

1.4.3（开发中）​

新增

  • 用户标识 uid —— 三种嵌入地址都可以带 &uid={你平台的用户ID}，带上之后点赞 / 不喜欢与 搜索历史按该用户记录，而不是按浏览器记录。必须与 platform 同时出现才生效；不带时行为与 以前完全一致。⚠️ 该参数为明文、可被改写，不是认证凭据。 详见 概览 · 可选参数 uid。

变更

  • 平台配色项调整：「完整视频页」「单个视频播放页」不再单独配置背景，改为跟随「背景」； 推荐横条新增独立的「标题·内容」颜色，因此横条底色与门户不同时，文字也能各自取色。 由我方在后台配置，你无需改嵌入代码。

1.4.2​

⚠️ 本版改变了已投放嵌入位的行为，请留意第一条。

变更

  • 嵌入的单视频播放器播完不再停止：显示「5 秒后播放下一个」的倒计时，随后自动播放该平台上的 下一个视频，走到最后会回到第一个、循环不停止。倒计时期间可点「取消」停在当前视频。
  • 横条 /strip 与完整视频页 /embed 的行为不变。
  • 自动切换不发送 postMessage 事件 —— 它不是用户点击，沿用 video:click 会让你的平台误判为 用户操作。是否新增专用事件仍在评估中。

新增

  • 推荐横条的长标题可查看完整内容（使用浏览器原生提示，因此不跟随平台配色，但可超出 iframe 范围显示）。

1.4.1​

⚠️ 本版改变了已投放嵌入位的行为。

变更

  • 嵌入的观看页（?full=1）内部会自己跳转：点击页面下方的分类卡片或「更多视频」时，跳转在 iframe 内部完成，同时发出 video:click / more:click 事件。 这些事件是「通知」而不是「请跳转」 —— 若照抄横条 / 视频墙那段监听代码，会跳两次 （框内换了视频，你的页面又开了一个新标签页）。 请用 e.source 区分事件来自哪个 iframe，详见 事件对接 API。

1.1.0​

新增

  • 多语言切换 —— 组件支持 7 种语言（zh-Hans / zh-Hant / en / ms / th / id / vi），界面与内容（标题、简介、分类、品牌，若已配置翻译）一并切换。
    • 初始语言：URL 参数 ?lang=。
    • 运行时切换：父页面 postMessage({source:'vcms-host', type:'setLang', lang})，不重载 iframe。详见 事件对接 API — 语言切换。
  • 组件配色可定制 —— 推荐横条 / 完整页的背景、标题·内容、「更多」颜色可按平台定制（由我方在后台配置）。

1.0.1​

新增

  • 事件对接 (postMessage) —— 组件可把「点视频 / 点更多」交互抛给父页面，由你的平台处理。
    • ?events=1：只发事件，平台自行处理（开新窗口、走自家路由等）。
    • ?events=nav：组件自己跳转，同时发事件（可用于埋点）。
    • 事件：video:click（videoId / title / watchUrl）、more:click（url）。详见 事件对接 API。
  • 视频排序 / 内容描述 —— 视频可配置显示顺序，播放页展示描述。
  • 本对接文档站上线，支持 中文 / English 双语。

优化

  • 播放量统计更准确 —— 仅在视频真正开始播放（点击 / 自动播放）时计数。

1.0.0​

  • 首个版本：三种 iframe 嵌入 —— 推荐横条 /strip、完整页 /embed、单视频 /watch/{id}。