# AI Video Frame Sequence Player

**Repository Path**: hirohana/ai-video-frame-sequence-player

## Basic Information

- **Project Name**: AI Video Frame Sequence Player
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-01-18
- **Last Updated**: 2026-01-18

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# c | 序列帧实验室

![Project Logo](https://img.shields.io/badge/Tech-MediaPipe_Hands-black?style=for-the-badge)
![Project License](https://img.shields.io/badge/License-MIT-white?style=for-the-badge)

这是一个极简风格、高性能的 AI 视频帧序列播放器。它不仅支持传统的播放控制，还集成了 **MediaPipe Hands**，允许通过手势（握拳到张开）来实时控制视频帧的展开与折叠，模拟“原力控制”摄影机拆解的效果。

## ✨ 核心特性

- **🖐️ 手势交互控制**：基于 MediaPipe Hands 实现实时手势识别。握拳对应初始帧（组装），张开对应最终帧（拆解）。
- **🌊 丝滑过渡算法**：集成 EMA（指数移动平均）滤波和帧过渡缓动算法，消除手势抖动，确保画面切换极其流畅。
- **📁 多序列文件夹自动检测**：只需将图片序列存放在 `/frames` 的子文件夹下，播放器将自动识别并提供切换选项。
- **🌑 极简美学设计**：采用纯黑、白、灰配色方案（背景色 `rgb(246,248,247)`），支持玻璃拟态（Glassmorphism）交互界面。
- **⚙️ 全功能控制器**：支持正/反向自动播放、倍速调节、进度条拖拽、滚轮控制及键盘快捷键。

## 🚀 快速开始

### 1. 准备帧序列
将你的视频用**FFmpeg**等工具转换为图片帧（建议命名格式：`frame_0001.jpg`, `frame_0002.jpg`...），并按以下结构放置：

```text
/
├── index.html
├── frames/
│   ├── camera/        # 序列名称
│   │   ├── frame_0001.jpg
│   │   ├── frame_0002.jpg
│   │   └── ...
│   └── drone/         # 另一个序列
│       └── ...
```

### 2. 运行项目
推荐使用 VS Code 的 **Live Server** 扩展或任何静态服务器：

```bash
npx live-server .
```

访问 `http://127.0.0.1:5500` 即可开始使用。

## 🎹 键盘快捷键

| 按键 | 功能 |
| :--- | :--- |
| `Space` | 播放 / 暂停 |
| `←` / `→` | 单步快退 / 快进 |
| `F` | 切换正向播放 (Forward) |
| `R` | 切换逆向播放 (Reverse) |
| `Home` / `End` | 跳转至首帧 / 尾帧 |

## 🛠️ 技术栈

- **Frontend**: HTML5, Vanilla JavaScript
- **Styling**: Tailwind CSS (CDN)
- **AI/ML**: [MediaPipe Hands](https://ai.google.dev/edge/mediapipe/solutions/vision/hand_landmarker)
- **Fonts**: Inter (Google Fonts)

## 🤝 贡献与反馈

如果你有任何建议或发现了 Bug，欢迎提交 Issue 或 Pull Request。

---

*Made with ❤️ for AI Creators and Concept Engineers.*