🎬 Gin Player

一个基于 Gin 框架的现代化视频播放器集合，集成了多种主流流媒体播放技术，为开发者提供完整的 Web 视频播放解决方案。

✨ 特性

• 🎯 多协议支持：支持 HLS、HTTP-FLV、MPEG-TS、RTSP、LAS、WHIP、WHEP 等多种流媒体协议
• 🚀 低延迟播放：专为实时流媒体优化，支持超低延迟播放
• 🎨 现代化界面：美观的响应式设计，支持键盘导航
• 🔧 易于使用：直观的用户界面，无需复杂配置
• 📱 跨平台兼容：支持桌面端和移动端浏览器
• 🛠️ 开发友好：基于 Gin 框架，易于扩展和定制

🎥 支持的播放器

播放器	协议支持	特点	访问地址
FLV.js	HTTP-FLV	基于 HTML5 的 FLV 播放器	/flvjs.html
HLS.js	HLS	HTTP Live Streaming 播放器	/hlsjs.html
dash.js	MPEG-DASH	开源 DASH 协议播放器	/dash/index.html
MPEG-TS	MPEG2-TS/FLV	基于 flv.js 的低延迟播放器	/mpegts.html
Jessibuca	HTTP-FLV	超低延迟视频播放器	/jessibuca.html
Jessibuca Pro	HTTP-FLV/HLS/MP4	专业版低延迟播放器，支持AI检测	/jessibuca-pro/

| LAS | LAS | 轻量级自适应流媒体播放器 | /las.html | | RTSP | RTSP over WebSocket | RTSP 协议播放器 | /rtsp.html | | WHIP | WebRTC | WebRTC-HTTP Ingestion Protocol 发布器 | /whip.html | | WHEP | WebRTC | WebRTC-HTTP Egress Protocol 播放器 | /whep.html |

dash.js 播放器

• 协议支持：MPEG-DASH
• 特性：开源、支持自适应码率、丰富的播放和调试功能
• 访问方式：
  • 主页卡片点击 dash.js
  • 直接访问：http://localhost:8080/dash/index.html
• 依赖说明：所有依赖静态资源均已放置在 dash 目录下，无需额外配置

🚀 快速开始

1. 克隆项目

git clone https://github.com/your-username/gin-player.git
cd gin-player

2. 安装依赖

go mod tidy

3. 运行项目

go run main.go

4. 访问首页

打开浏览器访问：http://localhost:8080/index.html

🐳 Docker 运行

构建镜像

docker build -t gin-player:latest .

运行容器

docker run -it -p 8087:8087 gin-player:latest

📱 使用指南

首页导航

访问 http://localhost:8080/index.html 可以看到所有播放器的卡片界面：

• 支持键盘导航（方向键、回车键）
• 响应式设计，适配不同屏幕尺寸
• 点击任意卡片即可跳转到对应播放器

WHIP 发布器

WHIP (WebRTC-HTTP Ingestion Protocol) 用于发布/推流：

1. 直接访问：http://localhost:8080/whip.html
   • 输入 WHIP 服务器地址（默认：http://127.0.0.1:8080/live/test110.whip）
   • 点击"Start Publishing"按钮开始推流
   • 支持本地摄像头和麦克风预览
   • 实时音频可视化

WHEP 播放器

WHEP (WebRTC-HTTP Egress Protocol) 用于播放/拉流：

1. 直接访问：http://localhost:8080/whep.html
   • 输入 WHEP 服务器地址（默认：http://127.0.0.1:8080/live/test110.whep）
   • 点击"Start Subscribing"按钮开始播放
   • 支持实时音频可视化

Jessibuca Pro 播放器

Jessibuca Pro 是专业版低延迟播放器，提供以下高级功能：

• 多协议支持：HTTP-FLV、HLS、MP4 等多种格式
• AI 检测功能：人脸检测、物体检测、遮挡检测等
• 录制功能：支持 MP4 录制和截图
• 多画面布局：支持 2x2、3x3、4x4、5x5、6x6、6x7 等多种布局
• 加密支持：支持多种加密方式（M7S、SM4、XOR等）
• 弹幕功能：支持实时弹幕显示
• PTZ 控制：支持云台控制功能

访问 /jessibuca-pro/ 查看所有演示页面。

其他播放器

所有播放器都提供了直观的界面，支持：

• URL 输入和配置
• 播放控制（开始、停止、暂停等）
• 实时状态显示
• 错误处理和提示

🔧 技术架构

后端

• 框架：Gin (Go)
• 模板引擎：Go HTML Template
• 静态文件服务：内置静态文件服务器

前端

• 播放器库：
  • flv.js - HTTP-FLV 播放
  • hls.js - HLS 播放
  • dash.js - MPEG-DASH 播放
  • mpegts.js - MPEG-TS 播放
  • jessibuca - 低延迟播放
  • jessibuca-pro - 专业版低延迟播放器，支持AI检测
  • LAS - 自适应流媒体
• WebRTC：WHIP/WHEP 协议支持，支持推流和拉流
• 样式：现代化 CSS3 + 响应式设计

📋 各播放器访问地址

播放器	访问地址	说明
首页	http://localhost:8080/index.html	播放器导航首页
FLV.js	http://localhost:8080/flvjs.html	HTTP-FLV 播放器
HLS.js	http://localhost:8080/hlsjs.html	HLS 播放器
MPEG-TS	http://localhost:8080/mpegts.html	MPEG2-TS/FLV 播放器
Jessibuca	http://localhost:8080/jessibuca.html	低延迟播放器
Jessibuca Pro	http://localhost:8080/jessibuca-pro/	专业版低延迟播放器
dash.js	http://localhost:8080/dash/index.html	MPEG-DASH 协议播放器

| LAS | http://localhost:8080/las.html | 自适应流媒体播放器 | | RTSP | http://localhost:8080/rtsp.html | RTSP over WebSocket | | WHIP | http://localhost:8080/whip.html | WebRTC 推流发布器 | | WHEP | http://localhost:8080/whep.html | WebRTC 拉流播放器 |

🌐 WHIP/WHEP 架构说明

系统架构

本项目采用分离式架构设计：

• 8087端口服务器（当前项目）：提供播放器界面和静态资源
• 8080端口服务器（远端服务器）：处理WHIP/WHEP协议和媒体流

WHIP 推流流程

1. 用户访问 http://localhost:8080/whip.html
2. 输入WHIP服务器地址（如：http://127.0.0.1:8080/live/test110.whip）
3. 浏览器获取本地摄像头和麦克风权限
4. 建立WebRTC连接，向远端服务器推送音视频流
5. 支持实时预览和音频可视化

WHEP 拉流流程

1. 用户访问 http://localhost:8080/whep.html
2. 输入WHEP服务器地址（如：http://127.0.0.1:8080/live/test110.whep）
3. 建立WebRTC连接，从远端服务器拉取音视频流
4. 支持实时播放和音频可视化

技术特点

• 低延迟：基于WebRTC技术，实现毫秒级延迟
• 跨平台：支持所有现代浏览器
• 实时性：支持实时音视频传输
• 易用性：简洁的界面，无需复杂配置

📄 LAS 协议配置示例

LAS 播放器支持多分辨率自适应播放，以下是 manifest.json 配置示例：

{
    "version": "1.0.0",
    "adaptationSet": [
        {
            "duration": 1000,
            "id": 1,
            "representation": [
                {
                    "id": 1,
                    "codec": "avc1.64001e,mp4a.40.5",
                    "url": "https://las-tech.org.cn/kwai/las-test_ld500d.flv",
                    "backupUrl": [],
                    "host": "las-tech.org.cn",
                    "maxBitrate": 700,
                    "width": 640,
                    "height": 360,
                    "frameRate": 25,
                    "qualityType": "SMOOTH",
                    "qualityTypeName": "流畅",
                    "hidden": false,
                    "disabledFromAdaptive": false,
                    "defaultSelected": true
                },
                {
                    "id": 2,
                    "codec": "avc1.64001f,mp4a.40.5",
                    "url": "https://las-tech.org.cn/kwai/las-test_sd1000d.flv",
                    "backupUrl": [],
                    "host": "las-tech.org.cn",
                    "maxBitrate": 1300,
                    "width": 960,
                    "height": 540,
                    "frameRate": 25,
                    "qualityType": "STANDARD",
                    "qualityTypeName": "标清",
                    "hidden": false,
                    "disabledFromAdaptive": false,
                    "defaultSelected": false
                },
                {
                    "id": 3,
                    "codec": "avc1.64001f,mp4a.40.5",
                    "url": "https://las-tech.org.cn/kwai/las-test.flv",
                    "backupUrl": [],
                    "host": "las-tech.org.cn",
                    "maxBitrate": 2300,
                    "width": 1280,
                    "height": 720,
                    "frameRate": 30,
                    "qualityType": "HIGH",
                    "qualityTypeName": "高清",
                    "hidden": false,
                    "disabledFromAdaptive": false,
                    "defaultSelected": false
                }
            ]
        }
    ]
}

🤝 贡献

欢迎提交 Issue 和 Pull Request！

📄 许可证

本项目采用 MIT 许可证，详见 LICENSE 文件。

🙏 致谢

感谢以下开源项目的支持：

• Gin - Go Web 框架
• flv.js - HTTP-FLV 播放器
• hls.js - HLS 播放器
• mpegts.js - MPEG-TS 播放器
• jessibuca - 低延迟播放器
• jessibuca-pro - 专业版低延迟播放器
• LAS - 自适应流媒体
• WebRTC - 实时通信技术
• WHIP/WHEP - WebRTC-HTTP协议
• 以及其他所有贡献者