@antmedia/web_player

中文文档
2.13.2发布于 2026/09/07ISCTypeScriptES Module构建来源已验证近 30 天下载 2964

能播放 WebRTC, HLS, DASH 的蚂蚁媒体服务器播放器

中文使用文档
文档目录9 节
  1. 特征
  2. 安装
  3. 使用量
  4. 基本用途
  5. 高级使用
  6. 配置参数
  7. 支助
  8. 问题
  9. 捐款

蚂蚁媒体服务器的网络播放器

Web Player是Ant Media Server的强大多能的玩家,旨在将流直接嵌入并播放于网络应用中. 它支持包括WebRTC,HLS,DASH,和VR 360在内的各种流类型,确保了广泛的相容性和高性能. 玩家可以通过URL参数或直接在您的代码中进行配置,既提供灵活性,也提供使用方便.

特征

  • 支持WebRTC,HLS,DASH,和VR 360流.
  • 通过 URL 参数或直接在代码中配置 .
  • 支持基于符号的对流访问的安全性.
  • 用于无缝用户体验的自动播放和哑弹选项.
  • 不同流技术和格式的自定义播放顺序和类型.
  • DASH 玩家的可调整目标延迟 .
  • 360度视频回放能力.

安装

使用 npm 安装 Web Player 软件包 :

npm i @antmedia/web_player

使用量

基本用途

要使用"Web Player",导入并初始化它,使用从URL收到的参数. 详见下文配置参数部分.

  1. 在您的网络应用程序中, 创建带有 id 视频 container 的 div 。 这将成为玩家的容器.
<div id="video_container" ></div>
  1. 初始化玩家如下:
import { WebPlayer } from "@antmedia/web_player";

var embeddedPlayer = new WebPlayer(window, document.getElementById("video_container"), null);

embeddedPlayer.initialize().then(() => {
  embeddedPlayer.play();
});

该用法的样本见: 在 StreamApp 中播放.html

高级使用

或者,您可将参数作为对象传递到 WebPlayer 构建器.

  1. 在您的网络应用程序中, 创建带有 id 视频 container 的 div 。 这将成为玩家的容器.
<div id="video_container" ></div>
  1. 初始化玩家如下
var player = new WebPlayer({
  streamId: "myStreamId",
  httpBaseURL: "http://example.antmedia.io:5080/WebRTCAppEE/", //Remember to add trailing slash(/)
}, document.getElementById("video_container"), null);

player.initialize().then(() => {
  player.play();
}).catch((error) => {
  console.error("Error while initializing embedded player: " + error);
});

该用法的样本见: ant-Media-Management-Console中的app.page.组件.ts

配置参数

玩家通过URL或直接在代码中接受多个配置参数:

  1. id (String):要播放的溪流ID. 此参数为强制.
  2. token (String):用于溪流访问的标志. 如果在服务器一侧启用了符号安全,则强制要求.
  3. autoplay (Boolean):如果有的话,自动播放流. 可选的 默认值是 true。 。 。 .
  4. mute (Boolean):如果有流水可用,则开始以哑弹模式播放. 可选的 默认值是 true。 。 。 .
  5. playOrder (平按:取出"活活"作取出"活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活 可选的 默认值是 "webrtc,hls"。可能数值包括: "hls,webrtc", (中文(简体) ), "webrtc", (中文(简体) ), "hls", (中文(简体) ), "vod", (中文(简体) ), "dash"。 。 。 .
  6. playType (平按:作作作作作作作作作作作作作作作作作作作作作作作作作作作作作作作作作作作作作作作作作作作作作作作作作作作作作作作作作作作作作作作作作作作作作作作作作作作作作作作作作作作作作作作作作作作作作作作作作作作作作作作作作作作作作作作作作作作作作作作作作作作作作作作作作作作作作作作作作作作作作作作作作作作作作作作作作作作作作作作作作作作作作作作作作作作作作作作作作作作作作作作作作作作作作作作作作作作作作作作作作作作作作作作作作作作作作作作作作作作作作作作作作作作作作作作作作作作作作作作作作作作作作作作作作作作作 可选的 默认值是 "mp4,webm"。可能数值包括: "webm,mp4", (中文(简体) ), "mp4", (中文(简体) ), "webm", (中文(简体) ), "mov"。 。 。 .
  7. targetLatency (数量):DASH玩家的目标延迟. 可选的 默认值是 3。 。 。 .
  8. is360 (Boolean):以360模式启用回放. 可选的 默认值是 false。 。 。 .

支助

如需协助和进一步查询,请访问 蚂蚁媒体服务器社区。 如果您是企业用户, 您可以通过发送电子邮件获得支持 支持@antmedia.io。 。 。 .

问题

关于报告问题,请在《公约》 蚂蚁-媒体-服务器问题页面。 。 。 .

捐款

捐款受到热烈欢迎。 如果您想帮助改进Web Player,请向寄存器提交拉出请求或报告遇到的任何问题.

享受与蚂蚁媒体服务器的Web Player的流媒体!

版本与发布记录

@antmedia/web_player 共发布 67 个版本,首次发布于 2024/01/22;过去 12 个月发布了 6 个版本。最新版本附带 npm provenance 构建来源证明,可追溯到公开的 CI 构建记录。

版本发布日期距今
2.13.2latest2026/09/072 个月前
2.13.12026/08/272 个月前
3.0.0-SNAPSHOT-2026-May-18-02-44SNAPSHOT2026/05/185 个月前
3.0.0-SNAPSHOT-2026-May-18-08-572026/05/185 个月前
3.0.0-SNAPSHOT-2026-May-18-08-472026/05/185 个月前
3.0.0-SNAPSHOT-2026-Mar-17-01-002026/03/177 个月前

其他发布通道:ALPHA → 2.9.1-ALPHA-15-05-2024,SNAPSHOT → 3.0.0-SNAPSHOT-2026-May-18-02-44。

关于 @antmedia/web_player 的常见问题

@antmedia/web_player 是什么?

能播放 WebRTC, HLS, DASH 的蚂蚁媒体服务器播放器

如何安装 @antmedia/web_player?

在项目目录运行 npm install @antmedia/web_player,或使用 pnpm add / yarn add / bun add。

@antmedia/web_player 支持 TypeScript 吗?

支持。包内自带 TypeScript 类型声明(package.json 声明了 types 入口),安装后即可获得类型提示,无需再安装 @types 包。

@antmedia/web_player 支持 ESM 还是 CommonJS?

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

@antmedia/web_player 可以商用吗?

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

@antmedia/web_player 的下载量有多少?

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

@antmedia/web_player 还在维护吗?

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