78 lines
1.7 KiB
Markdown
78 lines
1.7 KiB
Markdown
## Context
|
||
|
||
混剪功能需要将多种比例的素材统一输出为 9:16 竖屏视频（720x1280）。
|
||
阿里云 ICE 支持视频裁剪和缩放，需要在 Timeline 中配置正确的参数。
|
||
|
||
## Goals / Non-Goals
|
||
|
||
**Goals:**
|
||
- 支持横屏 (16:9) 素材自动裁剪为竖屏 (9:16)
|
||
- 支持多种裁剪模式（居中、智能、填充）
|
||
- 保持视频质量，避免过度拉伸
|
||
|
||
**Non-Goals:**
|
||
- 不实现自定义裁剪区域选择
|
||
- 不实现实时预览
|
||
|
||
## Decisions
|
||
|
||
### 裁剪模式设计
|
||
|
||
| 模式 | 说明 | 适用场景 |
|
||
|------|------|----------|
|
||
| `center` | 居中裁剪，保持原始比例 | 主体在画面中央 |
|
||
| `smart` | 智能裁剪（ICE AI 识别主体） | 人物/产品展示 |
|
||
| `fill` | 填充黑边，不裁剪 | 保留完整画面 |
|
||
|
||
### ICE 参数方案
|
||
|
||
**方案 A：使用 CropX/CropY/CropW/CropH**
|
||
```json
|
||
{
|
||
"MediaURL": "xxx",
|
||
"CropX": 280,
|
||
"CropY": 0,
|
||
"CropW": 720,
|
||
"CropH": 1280
|
||
}
|
||
```
|
||
|
||
**方案 B：使用 Effects + Crop**
|
||
```json
|
||
{
|
||
"Effects": [{
|
||
"Type": "Crop",
|
||
"X": 280,
|
||
"Y": 0,
|
||
"Width": 720,
|
||
"Height": 1280
|
||
}]
|
||
}
|
||
```
|
||
|
||
### 裁剪计算公式
|
||
|
||
对于 16:9 横屏素材 (1920x1080) 裁剪为 9:16：
|
||
```
|
||
目标比例 = 9/16 = 0.5625
|
||
源比例 = 16/9 = 1.778
|
||
|
||
// 居中裁剪
|
||
cropHeight = sourceHeight = 1080
|
||
cropWidth = cropHeight * (9/16) = 607.5 ≈ 608
|
||
cropX = (sourceWidth - cropWidth) / 2 = (1920 - 608) / 2 = 656
|
||
cropY = 0
|
||
```
|
||
|
||
## Risks / Trade-offs
|
||
|
||
- **画面损失**：居中裁剪会丢失左右两侧内容
|
||
- **缩放失真**：填充模式会缩小画面
|
||
- **ICE 兼容性**：需确认 ICE 版本支持的参数
|
||
|
||
## Open Questions
|
||
|
||
1. ICE 是否支持智能主体识别裁剪？
|
||
2. 是否需要前端预览裁剪效果？
|
||
3. 默认裁剪模式选择哪种？
|