# ios_video
**Repository Path**: RoseKissYou/ios_video
## Basic Information
- **Project Name**: ios_video
- **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-02
- **Last Updated**: 2026-01-03
## Categories & Tags
**Categories**: Uncategorized
**Tags**: None
## README
# myMedia - iOS 视频播放器
**一款简洁优雅的 iOS 视频播放器应用**
[功能特性](#-功能特性) • [快速开始](#-快速开始) • [更新日志](#-更新日志) • [文档](#-文档)
---
## 📱 功能特性
### ✨ 核心功能
- 🎬 **视频浏览** - 支持浏览设备照片库中的所有视频
- 🎮 **完整播放控制** - 播放/暂停、快进/快退、上一个/下一个
- ❤️ **收藏管理** - 标记喜欢的视频，集中管理
- 🗑️ **智能待删除** - 设置最大数量，自动删除最早的文件
- 👆 **手势操作** - 上下滑动切换视频，左右滑动收藏/删除
### 🆕 v1.0.1 新增功能
- ✅ 待删除数量管理（1-20个可配置）
- ✅ 超过限制自动删除最早的文件
- ✅ 优化播放器控制界面布局
- ✅ 标记待删除后自动播放下一个视频
- ✅ 数据持久化保存
---
## 🚀 快速开始
### 环境要求
- macOS 13.0+
- Xcode 15.0+
- iOS 17.0+ 设备或模拟器
- Swift 5.9+
### 安装运行
```bash
# 1. 克隆项目
cd /Users/houjiaying/code/mac_app/myMedia
# 2. 打开项目
open myMedia/myMedia.xcodeproj
# 3. 在 Xcode 中按 ⌘R 运行
```
### 权限配置
确保 `Info.plist` 包含以下权限：
```xml
NSPhotoLibraryUsageDescription
需要访问照片库以浏览和播放视频
NSPhotoLibraryAddUsageDescription
需要修改照片库以删除视频
```
---
## 🎮 使用指南
### 播放控制
|
**按钮控制**
- 顶部：关闭 / 收藏 / 待删除
- 底部：上一个 / 快退 / 播放 / 快进 / 下一个
- 点击屏幕：显示/隐藏控制栏
|
**手势操作**
- 上滑 ⬆️：下一个视频
- 下滑 ⬇️：上一个视频
- 右滑 ➡️：添加收藏
- 左滑 ⬅️：标记待删除
|
### 待删除管理
1. 打开 **设置** → **待删除设置**
2. 设置"最大待删除数量"（1-20）
3. 标记的视频超过数量后，最早的会被自动删除
4. 点击"立即删除所有"清空待删除列表
---
## 📂 项目结构
```
myMedia/
├── Models/
│ └── VideoItem.swift # 视频数据模型
├── ViewModels/
│ ├── VideoManager.swift # 视频列表管理
│ └── PendingDeleteManager.swift # 待删除管理 ⭐
├── Views/
│ ├── HomeView.swift # 首页列表视图
│ ├── VideoPlayerView.swift # 视频播放器 ⭐
│ └── SettingsView.swift # 设置界面 ⭐
└── Assets/
└── Assets.xcassets # 资源文件
```
⭐ 表示 v1.0.1 版本中新增或重大修改的文件
---
## 📚 文档
### 快速访问
- [快速开始指南](快速开始.md) - 5分钟上手
- [功能更新说明](iOS功能更新说明.md) - 详细更新内容
- [更新摘要](更新摘要.md) - 快速了解更新（中英文）
### 技术文档
- [Android-iOS实现对比](Android-iOS实现对比.md) - 跨平台技术对比
- [修改总结](修改总结.md) - 代码修改详情
- [测试清单](测试清单.md) - 完整测试指南
---
## 🔄 更新日志
### v1.0.1 (2026-01-03)
**参考 Android 版本 3.0.2.3 进行功能对齐**
#### 新增
- ✅ 待删除数量管理功能
- ✅ PendingDeleteManager 管理器
- ✅ 设置界面待删除配置区域
#### 改进
- ✅ 重构播放器控制界面布局
- ✅ 优化顶部按钮（透明背景，毛玻璃效果）
- ✅ 增强底部控制栏（完整播放控制）
- ✅ 标记待删除后自动切换视频
#### 优化
- ✅ 去除视频画面遮罩，完全清晰
- ✅ 按钮状态颜色反馈
- ✅ 边界按钮智能禁用
### v1.0.0 (2026-01-02)
- 🎉 初始版本发布
- 视频浏览和播放
- 收藏和待删除标记
- 滑动手势操作
---
## 🛠️ 技术栈
|
**开发框架**
- SwiftUI
- AVKit
- Photos Framework
- Combine
|
**架构模式**
- MVVM
- 单例模式
- 观察者模式
- 声明式 UI
|
---
## 🎯 与 Android 版本功能对齐
| 功能 | Android 3.0.2.3 | iOS 1.0.1 | 状态 |
|------|-----------------|-----------|------|
| 待删除管理 | ✅ | ✅ | ✅ 已对齐 |
| 界面优化 | ✅ | ✅ | ✅ 已对齐 |
| 自动切换 | ✅ | ✅ | ✅ 已对齐 |
| 滑动手势 | ✅ | ✅ | ✅ 已对齐 |
| 收藏功能 | ✅ | ✅ | ✅ 已对齐 |
| 设置界面 | ✅ | ✅ | ✅ 已对齐 |
---
## 🐛 已知问题
1. **iCloud 照片**: 如果视频存储在 iCloud 中，删除操作可能需要网络连接
2. **删除延迟**: PHPhotoLibrary 的删除操作是异步的，可能需要一些时间完成
3. **列表刷新**: 删除后需要手动下拉刷新视频列表
---
## 🚧 开发计划
### 短期目标
- [ ] 添加视频真实缩略图
- [ ] 批量操作功能
- [ ] 搜索和筛选功能
### 长期目标
- [ ] iCloud 同步支持
- [ ] 分享功能
- [ ] 播放记录和断点续播
- [ ] 回收站功能
---
## 🤝 贡献
欢迎提交 Issue 和 Pull Request！
### 开发指南
1. Fork 本仓库
2. 创建特性分支 (`git checkout -b feature/AmazingFeature`)
3. 提交更改 (`git commit -m 'Add some AmazingFeature'`)
4. 推送到分支 (`git push origin feature/AmazingFeature`)
5. 开启 Pull Request
---
## 📧 联系方式
- **开发者**: houjiaying
- **邮箱**: 15521288734@163.com
- **项目**: myMedia iOS Video Player
---
## 📄 许可证
本项目基于 Apache License 2.0 开源协议
---
## ⭐ Star History
如果这个项目对你有帮助，请给它一个 Star ⭐️
---
**Made with ❤️ by houjiaying**