# Quick Start - 快速开始

5分钟快速上手GenesisLab camera和recording功能。

## 前置条件

- GenesisLab已安装
- Genesis已安装
- AMO模型文件（用于演示）

## 最简单的例子

### 1. Chase模式跟踪机器人

```bash
cd /home/ununtu/code/glab/genesislab

python third_party/genPiHub/scripts/amo/genesislab/play_amo_mesh_terrain.py \
    --headless \
    --record-video \
    --camera-track chase \
    --max-steps 500
```

**这会做什么？**
- ✅ Headless模式运行（无viewer窗口）
- ✅ Camera自动跟随机器人（chase追逐镜头）
- ✅ 录制视频到 `output/amo_mesh_terrain.mp4`
- ✅ 运行500步（约10秒）

### 2. 查看结果

```bash
ls -lh output/amo_mesh_terrain.mp4
# 应该看到生成的视频文件
```

用任何视频播放器打开查看！

## 尝试不同视角

### 第一人称视角
```bash
python third_party/genPiHub/scripts/amo/genesislab/play_amo_mesh_terrain.py \
    --headless \
    --record-video \
    --camera-track first_person \
    --video-path output/first_person.mp4 \
    --max-steps 500
```

### 侧面视角
```bash
python third_party/genPiHub/scripts/amo/genesislab/play_amo_mesh_terrain.py \
    --headless \
    --record-video \
    --camera-track side \
    --video-path output/side.mp4 \
    --max-steps 500
```

### 俯视视角
```bash
python third_party/genPiHub/scripts/amo/genesislab/play_amo_mesh_terrain.py \
    --headless \
    --record-video \
    --camera-track top \
    --video-path output/top.mp4 \
    --max-steps 500
```

## 调整视频质量

### 高质量（1080p, 60fps）
```bash
python third_party/genPiHub/scripts/amo/genesislab/play_amo_mesh_terrain.py \
    --headless \
    --record-video \
    --camera-track chase \
    --camera-res 1920 1080 \
    --video-fps 60 \
    --max-steps 1000
```

### 快速调试（480p）
```bash
python third_party/genPiHub/scripts/amo/genesislab/play_amo_mesh_terrain.py \
    --headless \
    --record-video \
    --camera-track chase \
    --camera-res 640 480 \
    --max-steps 100
```

## 编程方式

如果你想在代码中配置camera和recording：

```python
from genesislab.engine.scene import CameraCfg, RecordingCfg

# 在env配置中添加
cfg.scene.camera = CameraCfg(
    track_mode="chase",      # 追逐镜头
    entity_name="robot",     # 跟踪robot
    res=(1920, 1080),        # 1080p
)

cfg.scene.recording = RecordingCfg(
    enabled=True,
    save_path="output/my_video.mp4",
    fps=60,
)
```

## 验证安装

运行测试确保功能正常：

```bash
# 配置测试
python third_party/genesislab-doc/tests/test_camera_tracking.py
python third_party/genesislab-doc/tests/test_camera_recording.py
```

应该看到：
```
✅ All tracking tests passed!
✅ All tests passed!
```

## 下一步

- 学习[基本概念](basic_concepts.md)了解camera和recording的工作原理
- 查看[机器人跟踪指南](../user_guide/camera/tracking.md)深入了解tracking功能
- 浏览[示例](../examples/)查看更多用法

## 常见问题

**Q: 没有生成视频文件？**
- 检查`output/`目录是否存在（会自动创建）
- 确保运行了足够的steps（至少100+）
- 查看console输出是否有错误

**Q: 视频是黑色的？**
- 确保场景中有光源
- 尝试调整camera位置
- 查看[Troubleshooting](../troubleshooting/common_issues.md)

**Q: 程序报错？**
- 查看[API Fixes](../troubleshooting/api_fixes.md)了解已知问题
- 确保GenesisLab和Genesis版本是最新的