# 播放器卡片模板 — 使用说明

一个 AE 脚本,自动生成"AI写真 + 播放器卡片UI + 歌词滚动 + 闪白转场"的视频工程。换图换歌就能复用。

## 文件结构

```
视频模板/
├── 播放器卡片模板.jsx   ← AE 脚本(双击运行)
├── 使用说明.md          ← 本文件
└── assets/              ← 放素材(自己建)
    ├── scene1.png       ← 第一段开场图(夜场/CG/任意), 1920x1080
    ├── scene2.png       ← 第二段主图(人像/写真/风光), 1920x1080
    ├── card.png         ← 左侧播放器卡片UI(可选, 没有会用形状占位)
    └── music.mp3        ← 背景音乐(可选)
```

## 第一次使用

1. 装好 Adobe After Effects(任意近几版都行)
2. 建 `assets` 文件夹,把素材放进去(至少 scene1 + scene2)
3. 打开 AE → 菜单 **文件 → 脚本 → 运行脚本文件…** → 选 `播放器卡片模板.jsx`
4. 脚本自动生成合成,名为 **"播放器卡片_主合成"**,直接在时间轴预览

## 以后换内容(套用)

| 想换什么 | 怎么做 |
|---------|--------|
| 换开场图 | 替换 `assets/scene1.png`,重跑脚本 |
| 换主图 | 替换 `assets/scene2.png`,重跑脚本 |
| 换歌 | 替换 `assets/music.mp3`,重跑脚本 |
| 换歌词 | 用记事本打开 .jsx,改顶部 `LYRICS` 数组(每句一行) |
| 调节奏 | 改 `TOP_DURATION`(开场秒数)、`SCALE_END`(推进幅度)、`LYRIC_SPEED`(歌词速度) |
| 换唱片转速 | 改 `ROTATE_SPEED`(默认 360 度/秒) |
| 换卡片UI | 自己 PS/AI 做一张 42% 宽的卡片 PNG 存成 `card.png` |

> 注意:重跑脚本会**重建整个工程**(之前手改的内容会丢)。所以素材/歌词一次性配好再跑;跑完在 AE 里做的手工微调不会被下次重跑保留——如果要长期复用,重跑后另存为新项目。

## 脚本生成的图层结构(便于手工微调)

```
播放器卡片_主合成
├── 开场图 (0-1.9s, 带提亮)
├── 闪白转场 (1.85-2.2s 白场)
├── 主画面_右侧 (右侧58%, Ken Burns 100→110%)
├── 播放器卡片UI (左侧42%, 淡入)
├── 标题_FASHION / SELF-PORTRAIT
├── 黑胶唱片 (旋转动画, 表达式 time*360)
├── 歌词_1~6 (逐行上滚)
├── 进度条/时间/控制键
├── 水印黑条 + XiaoErDuo-For you
├── 背景音乐
└── 全局柔光暖色 (调整层)
```

## 高级提示

- **Ken Burns 更丝滑**:选中"主画面_右侧"图层的 Scale,按 F9 做缓动(脚本已自动加了缓出)
- **唱片更真实**:把中心贴纸换成自己照片,或加一层"唱片纹理"图叠上去
- **歌词对齐**:歌词上滚速度固定,如果某句对不上音乐,单独选中那句改它的表达式里的起始值
- **导出**:AE 菜单 合成 → 添加到渲染队列 → 选 H.264 → 输出 1080p/30fps

## 常见问题

- **运行报错 "无法导入"**:assets 里少了文件,或文件名不对(严格用 scene1/scene2/card/music)
- **歌词显示乱码**:字体 "Microsoft YaHei" 没装?改成你系统有的中文字体
- **想要不同尺寸**:改脚本顶部 `COMP_W / COMP_H`(如 1080x1920 竖版)