# chorme-plugin

**Repository Path**: joy_lei/chorme-plugin

## Basic Information

- **Project Name**: chorme-plugin
- **Description**: chrome的在线视频播放器插件，支持视频下载
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-03-20
- **Last Updated**: 2026-03-20

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# FunPlayer - Chrome M3U8视频播放器插件

![FunPlayer Logo](icons/icon128.png)

## 项目简介

FunPlayer 是一款功能强大的 Chrome 浏览器扩展，专为解决网页中 M3U8（HLS）视频流播放问题而设计。它能够自动识别页面中的 M3U8 链接，并提供统一、流畅的视频播放体验，让您无需依赖网站自带的播放器即可享受高质量的视频内容。

## 功能特性

### 核心功能
- 🎯 **自动识别 M3U8 链接**：智能扫描页面中的 M3U8 链接，支持多种元素类型
- 🔄 **多链接管理**：支持检测和切换页面中的多个 M3U8 链接
- 🔒 **加密流支持**：支持符合 HLS 规范的 AES-128 加密流
- 📱 **画中画模式**：支持视频小窗口悬浮播放，不影响浏览其他内容

### 播放器控制
- ▶️ **播放/暂停控制**：支持点击播放器区域或控制按钮进行播放/暂停
- 🔊 **音量调节**：支持拖拽调节音量和静音功能
- 📶 **清晰度选择**：自动检测多码率流并提供清晰度切换
- ⏱️ **倍速播放**：支持 0.5x 到 2.0x 的播放速度调节
- 🎬 **全屏模式**：支持进入全屏观看，控制栏自动隐藏
- 📏 **进度条控制**：支持拖拽和点击调整播放进度
- 📋 **链接复制**：一键复制当前播放的 M3U8 链接

### 用户体验
- 🎨 **现代界面**：简洁美观的播放器界面，支持深色模式
- ⚡ **流畅播放**：基于 hls.js 的高效视频流处理
- 🔄 **错误处理**：完善的错误处理和重试机制
- 📱 **响应式设计**：适配不同屏幕尺寸

## 安装方法

### 从源码安装
1. 克隆本项目到本地：
   ```bash
   git clone https://github.com/yourusername/funplayer.git
   ```
2. 打开 Chrome 浏览器，进入 `chrome://extensions/`
3. 开启「开发者模式」（右上角开关）
4. 点击「加载已解压的扩展程序」，选择本项目文件夹
5. 插件安装完成，会在浏览器工具栏中显示插件图标

### 从 Chrome 应用商店安装
（未来将在 Chrome 应用商店上线）

## 使用说明

1. **打开网页**：访问包含 M3U8 链接的网页
2. **启动插件**：点击浏览器工具栏中的 FunPlayer 图标
3. **选择链接**：插件会自动检测页面中的 M3U8 链接，在弹出的面板中选择要播放的链接
4. **开始播放**：点击播放器中央的播放按钮或控制栏中的播放按钮开始播放
5. **控制播放**：使用播放器控制栏进行音量、进度、清晰度等调节
6. **全屏模式**：点击全屏按钮进入全屏观看，鼠标移动到边缘可显示控制栏

## 技术实现

- **Manifest V3**：使用 Chrome 扩展现行规范，确保安全性和性能
- **hls.js**：用于解析和播放 M3U8 视频流，支持加密流和多码率
- **Content Script**：在页面中检测 M3U8 链接并注入播放器
- **Service Worker**：处理插件后台逻辑和消息传递
- **原生 JavaScript**：使用现代 JavaScript 特性，确保代码简洁高效
- **CSS3**：实现现代化的播放器界面和动画效果

## 项目结构

```
FunPlayer/
├── manifest.json          # Manifest V3 配置文件
├── background/
│   └── service-worker.js  # 后台服务 worker
├── content/
│   ├── content.js         # 内容脚本，检测 M3U8 链接
│   └── player.css         # 播放器样式
├── player/
│   ├── player.html        # 播放器 HTML 结构
│   └── player.js          # 播放器核心逻辑
├── lib/
│   └── hls.min.js         # hls.js 库
├── icons/                 # 插件图标
│   ├── icon16.png         # 16x16 图标
│   ├── icon48.png         # 48x48 图标
│   └── icon128.png        # 128x128 图标
└── README.md              # 插件说明文档
```

## 注意事项

- 📝 **加密流支持**：仅支持标准 HLS AES-128 加密流，不支持 DRM 加密
- 🔐 **网络限制**：对于需要特殊 Header 才能访问的密钥，可能无法正常播放
- 💾 **性能要求**：大文件播放可能会占用较多内存，请确保设备性能足够
- 🌐 **网络环境**：播放流畅度取决于网络带宽，请确保网络连接稳定

## 贡献指南

我们欢迎社区贡献，无论是功能改进、bug 修复还是文档完善。

### 如何贡献
1. Fork 本项目
2. 创建您的特性分支：`git checkout -b feature/AmazingFeature`
3. 提交您的更改：`git commit -m 'Add some AmazingFeature'`
4. 推送到分支：`git push origin feature/AmazingFeature`
5. 打开一个 Pull Request

### 开发规范
- 遵循 JavaScript 代码规范
- 确保代码兼容性
- 添加适当的注释
- 测试您的更改

## 许可证

本项目采用 MIT 许可证 - 详见 [LICENSE](LICENSE) 文件

## 版本历史

- **v1.0.0**：初始版本，实现基本功能
  - 自动识别 M3U8 链接
  - 基础播放器控制
  - 多链接选择
  - 加密流支持

## 联系方式

- **GitHub**：[https://github.com/yourusername/funplayer](https://github.com/yourusername/funplayer)
- **Issue**：如有问题或建议，请在 GitHub 上提交 Issue

---

**FunPlayer** - 让 M3U8 视频播放更简单、更流畅！ 🎉