bytedance /xgplayer

A HTML5 video player with a parser that saves traffic

★ 9,310⑂ 948👁 116⑃ 735● 1,184▤ 29
JavaScriptMITCreated 2018-05-16h5player.bytedance.com/
下载:v3.0.27v3.0.27 ↓3.0.272026-10-29
+0
日增长
+1
周增长
+5
月增长
9,310
stars
948
forks
116
watchers
735
prs
1,184
issues
29
releases

README

xgplayer

xgplayer 为 Web 应用提供灵活、插件化的媒体播放器。UI 组件、加载策略和媒体格式能力
均可按需组合。

文档

 安装

bash
npm install xgplayer


 使用

html



js
import Player from 'xgplayer'
import 'xgplayer/dist/index.min.css'

const player = new Player({
  id: 'player',
  url: 'https://s2.pstatp.com/cdn/expire-1-M/byted-player-videos/1.0.0/xgplayer-demo.mp4'
})


更多播放器选项参见配置文档。

 插件

xgplayer 提供内置 UI 插件以及可选的流媒体和功能包。可用能力参见
插件文档。

 开发调试

仓库使用 Yarn 1.x。以下命令用于启动各格式的本地示例:

bash
yarn
yarn dev:xgplayer


bash
yarn dev:hls
yarn dev:flv
yarn dev:mp4


 发布流程

稳定版本、预发布版本及发版命令参见发布指南。

 使用协议

使用 xgplayer 即表示同意以下条款:

1. 本项目基于 MIT License 发布。
2. 您授权 xgplayer 项目在官网展示使用 xgplayer 的业务 Logo。

Top issues

Discussions

Latest release

v3.0.27 v3.0.27 2026-10-29
3.0.27 (2026-10-28)

 Features

- mp3: Add standalone MP3 MSE playback with Range seek and native fallback. (65f8649)
- mp4: xgplayer-mp4 can now play on MSE/ManagedMediaSource (iOS 17.1+) via preferMMS, instead of always degrading to native video. (322888e), closes 1932
- range请求,增加 数据范围是否匹配检测 (03a109c)
- support dynamic-timeout timeoutRatio, xhr fix endless request because of unpected net response (2c89a2c)
- 优化range请求时,返回200状态码问题 (e43c93b)

 Bug Fixes

- dash: parse MPD durations with any combination of H, M and S (f9c8ad2)
- hls: preserve playlist path for query-only URIs (5af9e7d)
- hls: 

Snapshot: 2026-11-16T09:23:14Z · Data license Apache-2.0 · JSON