# 桌面播放器卡片需求文档

## 介绍

桌面播放器卡片是一个系统级的小组件，允许用户在不打开主应用的情况下直接在桌面上控制音乐播放。该卡片将提供基本的播放控制功能和当前播放信息的显示，为用户提供便捷的音乐控制体验。

## 需求

### 需求 1：基本播放控制

**用户故事：** 作为音乐爱好者，我希望能在桌面卡片上直接控制音乐播放，这样我就不需要每次都打开应用来操作播放器。

#### 验收标准

1. 当用户点击播放/暂停按钮时，系统应该切换当前音乐的播放状态
2. 当用户点击上一首按钮时，系统应该切换到播放列表中的上一首歌曲
3. 当用户点击下一首按钮时，系统应该切换到播放列表中的下一首歌曲
4. 当没有音乐正在播放时，播放控制按钮应该显示为禁用状态
5. 当播放列表为空时，上一首和下一首按钮应该显示为禁用状态

### 需求 2：音乐信息显示

**用户故事：** 作为用户，我希望在桌面卡片上看到当前播放音乐的详细信息，这样我就能快速了解正在播放的内容。

#### 验收标准

1. 当有音乐正在播放时，卡片应该显示歌曲名称
2. 当有音乐正在播放时，卡片应该显示艺术家名称
3. 当有音乐正在播放时，卡片应该显示专辑封面（如果可用）
4. 当没有音乐播放时，卡片应该显示默认的占位信息
5. 当音乐信息过长时，文本应该支持滚动或省略显示

### 需求 3：播放进度显示

**用户故事：** 作为用户，我希望在桌面卡片上看到当前音乐的播放进度，这样我就能了解歌曲播放的进度情况。

#### 验收标准

1. 当音乐正在播放时，卡片应该显示播放进度条
2. 进度条应该实时更新以反映当前播放位置
3. 卡片应该显示当前播放时间和总时长
4. 当用户点击进度条时，系统应该跳转到对应的播放位置
5. 当没有音乐播放时，进度条应该显示为空状态

### 需求 4：卡片状态同步

**用户故事：** 作为用户，我希望桌面卡片能与主应用保持同步，这样无论我在哪里控制播放器，状态都能保持一致。

#### 验收标准

1. 当主应用中的播放状态改变时，桌面卡片应该立即更新
2. 当主应用切换歌曲时，桌面卡片应该显示新的歌曲信息
3. 当主应用调整播放进度时，桌面卡片的进度条应该同步更新
4. 当主应用关闭时，桌面卡片应该保持最后的状态信息
5. 当系统重启后，桌面卡片应该能恢复到关闭前的状态

### 需求 5：卡片尺寸适配

**用户故事：** 作为用户，我希望能选择不同尺寸的桌面卡片，这样我就能根据桌面空间和个人喜好来调整卡片大小。

#### 验收标准

1. 系统应该支持小尺寸卡片（2x1），显示基本播放控制和歌曲名称
2. 系统应该支持中等尺寸卡片（4x2），显示完整的播放信息和控制按钮
3. 系统应该支持大尺寸卡片（4x3），显示专辑封面、完整信息和扩展控制
4. 当用户调整卡片尺寸时，界面布局应该自动适配
5. 不同尺寸的卡片都应该保持良好的视觉效果和可用性

### 需求 6：快速启动功能

**用户故事：** 作为用户，我希望能通过点击桌面卡片快速打开主应用，这样我就能进行更详细的音乐管理操作。

#### 验收标准

1. 当用户点击卡片的非控制区域时，系统应该打开主应用
2. 当用户点击歌曲信息区域时，系统应该打开主应用并跳转到当前播放页面
3. 当用户长按卡片时，系统应该显示卡片配置选项
4. 当主应用未运行时，点击卡片应该启动应用并恢复播放状态
5. 卡片启动应用的响应时间应该在1秒以内