Quick Start - 快速开始#

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

前置条件#

  • GenesisLab已安装

  • Genesis已安装

  • AMO模型文件（用于演示）

最简单的例子#

1. Chase模式跟踪机器人#

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. 查看结果#

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

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

尝试不同视角#

第一人称视角#

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

侧面视角#

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

俯视视角#

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）#

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）#

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：

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,
)

验证安装#

运行测试确保功能正常：

# 配置测试
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!

下一步#

常见问题#

Q: 没有生成视频文件？

  • 检查output/目录是否存在（会自动创建）

  • 确保运行了足够的steps（至少100+）

  • 查看console输出是否有错误

Q: 视频是黑色的？

Q: 程序报错？

  • 查看API Fixes了解已知问题

  • 确保GenesisLab和Genesis版本是最新的