---
title: IPC 精彩时刻通用方案 - 精彩时刻全量相册
summary: IPC 精彩时刻通用方案的全量相册模块，展示精彩时刻全量视频片段，支持视频下载、AI 编辑、删除。依赖 albumVideoFileList（获取全量视频文件列表）和 albumFileDelete（删除视频文件）两个 API。
---

## 精彩时刻全量相册

### 功能介绍

<div style="marginTop: 20px;">
<img alt="精彩时刻全量相册" src="https://images.tuyacn.com/rms-static/c0938a00-2b09-11f0-9fb9-e1834df84344-1746598133408.png?tyName=ipc_highlights_full_album.png" width="250">
</div>

1. 精彩时刻全量相册主要包含以下内容：精彩时刻全量视频片段，支持视频下载、AI编辑、删除；

2. 精彩时刻服务详情设置，主要依赖以下2个关键能力：

- **获取精彩时刻文件列表**  
   开发者可通过 [albumVideoFileList](/cn/miniapp/develop/ray/api/ipc/highlight/timeAlbum/albumVideoFileList) API 获取精彩时刻全量视频文件列表。

- **删除精彩时刻视频文件**  
   首次配置精彩时刻服务信息时，开发者可通过 [albumFileDelete](/cn/miniapp/develop/ray/api/ipc/highlight/timeAlbum/albumFileDelete) API 保存精彩时刻视频文件。

### 交互流程

```mermaid
sequenceDiagram
    participant 用户
    participant 面板
    participant 云端

    rect rgb(227, 242, 253)
        Note over 用户,面板: 初始化阶段
        用户 ->> 面板: 进入精彩时刻面板
        面板 ->> 云端: albumVideoFileList-api
        云端 -->> 面板: 返回全量视频文件列表
        面板 ->> 用户: 展示视频列表UI
        Note right of 面板: 网格布局展示<br>包含缩略图+文件名+删除按钮
    end

    rect rgb(255, 243, 224)
        Note over 用户,云端: 删除操作阶段
        用户 ->> 面板: 点击删除按钮(文件ID:123)
        面板 ->> 用户: 显示确认对话框
        用户 ->> 面板: 确认删除

        面板 ->> 云端: albumFileDelete-api<br>(参数: fileId=123)
        云端 ->> 云端: 执行删除操作
        alt 删除成功
            云端 -->> 面板: 返回成功状态
            面板 ->> 用户: 显示成功toast
            面板 ->> 面板: 更新本地列表
        else 删除失败
            云端 -->> 面板: 返回错误信息
            面板 ->> 用户: 显示错误toast
        end
    end
```