@financial-times/o-video

中文文档
9.1.0发布于 2026/09/15MITES Module近 30 天下载 2174

创建视频播放器并附加分析.

中文使用文档
文档目录10 节
  1. 使用量
  2. 标记
  3. 萨斯
  4. Java 脚本
  5. 配置
  6. 有播放列表
  7. 测试
  8. 移徙
  9. 联系人
  10. 许可证

视频 MIT licensed

创建视频播放器并附加分析.

使用量

检查出来 如何将 Origami 组件纳入您的项目 开始 o-video。 。 。 .

标记

<div class="o-video" data-o-component="o-video"></div>

视频可以以"小","中"和"大"等三个不同大小来作样式,这些可以被添加到元素中作为类修饰符,例如.

<div class="o-video o-video--large" data-o-component="o-video"></div>

萨斯

为了输出每个大小和属性 o-video,您需要包括以下内容:

@import "@financial-times/o-video/main";

@include oVideo();

通过使用 $opts 地图。 它接受下列名单:

属性

  • 'info'
  • 'placeholder'

大小

  • 'small'
  • 'medium'
  • 'large'
@import "@financial-times/o-video";

@include oVideo(
    $opts: (
        "sizes": (
            "small",
            "large",
        ),
    )
); // outputs small and large video styles

Java 脚本

选中备忘 o-video,您需要以下内容:

import Video from "@financial-times/o-video";
const opts = {
    id: 4165329773001,
    optimumwidth: 710,
    placeholder: true,
    classes: ["video"],
    systemcode: "my-biz-ops-code",
};
const video = new Video(document.body, opts);

配置

何处 opts 是带有属性的可选对象

  • id [String] 视频的出处(brightcoveId 或者说 uuid(中文(简体) )
  • autorender [Boolean] 是否让视频自动渲染 。 如果 -虚假 * 那你需要打电话 init() 准备好时
  • optimumwidth [Number] 视频占位符图像的最佳宽度
  • optimumvideowidth [Number] 视频本身的最佳宽度,当有多个视频引渡时使用 决定显示哪个( 如果存在, 最小的宽度至少与这个宽度相同)
  • placeholder [Boolean] 只显示海报图像, 点击时加载( 播放) 视频
  • placeholderHint [String] 播放图标旁显示的可选提示( 默认为空)
  • placeholderInfo [Array] 占位符上需要显示的额外信息列表(Available:标题,描述,品牌)
  • playsinline [Boolean] 是否播放 视频内置 在 iOS 小屏幕上( 默认为全屏幕)
  • classes [Array] 添加到视频(和占位符)元素的类
  • showCaptions [Boolean] 是否在视频中添加标题。 默认为 true。 。 。 .
  • data [Object] JSON 代表 a 的物体 来自下一条介质- api 的响应。如果使用,组件将不会呼叫API,而是使用此数据.
  • systemcode [String] 一个有效的 Bizops 系统代码 使用 o-video。 。 。 . 选项,但缺少属性,它将使用 defaultTargeting 对象代替。 以下是目标对象上的每个属性所影响的:
    • site: 是指包含视频创意(部分广告请求)细列项目的广告单位.
    • sizes: 还添加了指定要返回的视频广告大小的代理请求. 订阅级别,分辨率.

配置选项也可以设定为数据属性,以即时宣告模块:

<div
    data-o-component="o-video o-video--large"
    data-o-video-id="4165329773001"
    data-o-video-optimumwidth="710"
></div>

有播放列表

播放列表可能要排队播放视频,然后逐一播放.

import Video from "@financial-times/o-video";

const queue = ["4165329773001", "4907997821001", "4165329773001"];

const player = new Video(document.body, {
    autorender: false,
    systemcode: "my-biz-ops-code",
});
const playlist = new Video.Playlist({ player, queue });

document.querySelector(".next-btn").onclick = () => playlist.next();
document.querySelector(".prev-btn").onclick = () => playlist.prev();

队列是 array 包含 Blightcove 视频标识字符串.

测试

见 折纸制作工具。 。 。 .

$ obt test

需要 Firefox (v38. 0.0 用多填充和镜像 CI 进行测试)

移徙

状态主要版本最后一个小版本移徙指南
维护第8条不详迁移到 v8
已贬值第7条第7.3条迁移到 v7
已贬值6个6.1 请检查date=中的日期值 (帮助)迁移到 v6
已贬值页:15.1 联合国迁移到 v5
已贬值页:14.1 国家迁移到 v4
已贬值3个3.1 国家迁移到 v3
已贬值2个2.5 国家迁移到 v2
已贬值1个1.4 (中文(简体) )- 说吧

联系人

如果您对本部分有任何问题或评论,或需要帮助使用本部分,请 提出问题访问 #origami - 支持 或电子邮件 折纸支持。 。 。 .

许可证

本软件由金融时报根据以下规定出版: 麻省理工学院许可证。 。 。 .

版本与发布记录

@financial-times/o-video 共发布 51 个版本,首次发布于 2019/02/13;过去 12 个月发布了 2 个版本。

版本发布日期距今
9.1.0latest2026/09/151 个月前
9.0.02026/07/273 个月前
8.0.12025/10/291 年前
8.0.02025/02/201.7 年前
7.3.12024/07/262 年前
7.3.02024/06/112 年前

其他发布通道:prerelease → 7.0.0-beta.0,tag--v6.1.4 → 6.1.4。

关于 @financial-times/o-video 的常见问题

@financial-times/o-video 是什么?

创建视频播放器并附加分析.

如何安装 @financial-times/o-video?

在项目目录运行 npm install @financial-times/o-video,或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖:@financial-times/o-loading(^6.0.0)、@financial-times/o-private-foundation(^1.0.0)。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖,Yarn 需要手动安装。

@financial-times/o-video 支持 TypeScript 吗?

该包的 package.json 没有声明类型入口。需要类型提示时,可以在 npm 上查找社区维护的 @types/financial-times__o-video 是否存在。

@financial-times/o-video 支持 ESM 还是 CommonJS?

以 ES Module 形式发布,推荐使用 import 引入。在 CommonJS 项目中,Node.js 20.19+ / 22.12+ 可以直接 require() 不含顶层 await 的 ES Module,更早的版本需要改用动态 import()。

@financial-times/o-video 可以商用吗?

@financial-times/o-video 使用 MIT 许可。宽松许可:允许商业使用、修改和再分发,通常只需在分发时保留原版权与许可声明。以上为概括,不构成法律意见,请以许可原文为准。

@financial-times/o-video 的下载量有多少?

根据 npm 官方下载统计,@financial-times/o-video 在 2026/10/15 – 2026/11/13 这 30 天内被下载 2,174 次,日均约 72 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入,适合横向比较热度,不能直接等同于使用人数。

@financial-times/o-video 还在维护吗?

最新版本 9.1.0 发布于 2026/09/15(1 个月前);至今共发布 51 个版本,其中过去 12 个月发布了 2 个;首次发布于 2019/02/13。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。