SuperAPI AI 工具集

map-route

设计与创作

查看项目

更新于 11-02 05:49

技能介绍

用途

map-route 用于生成一段 3D 地图动画短片(reel 风格),表现从起点到目的地的行程。画面包含白色三维城市街区、公园和河流,一条彩色路线从起点自行绘制到终点,镜头跟随行进并在结尾拉远,同时显示倒计时 ETA 卡片,图钉落下后出现目的地卡片。

主要能力

  • 生成 3D 城市地图场景:白色块状建筑、公园、河流。
  • 路线动画:按固定形状(上、右、上、右,终点为图钉)绘制彩色路线,移动圆点随路线行进。
  • 镜头运动:沿路线移动,结尾拉远。
  • ETA 卡片:显示剩余分钟数并倒计时,到达后显示目的地名称卡片。
  • 可配置项:目的地、分钟数、距离、单位(km/mi)、5 个装饰性地点标签、强调色(路线、移动圆点、ETA 图标,图钉固定红色)、随机种子(改变建筑与公园布局)、结尾额外停留秒数、输出路径。

使用方式

  1. 首次使用:根据技能加载时显示的 Base directory 设置 SKILL_DIR,定位 kit 目录并检查 three.module.js 是否存在,缺失则运行 setup.sh。需要 ffmpeg 和 Node,渲染使用无头 Chrome 中的 WebGL。
  2. 获取行程信息:向用户取得目的地名称、分钟数和距离(例如“家到健身房,2.8 km,9 分钟”)。如果只提供分钟或距离之一,按步行约 12 分钟/公里、骑行约 4 分钟/公里、市内驾车约 2 分钟/公里估算另一项,并向用户说明。
  3. 编写规格文件 <name>.map.json,包含 destination、minutes、distance(必填)、unit(km 或 mi)、places(5 个灰色小标签,依次位于起点附近、最左侧公园、路线中段街区、最右侧公园、河流;需贴合用户城市,或用空字符串隐藏)、accent(十六进制颜色)、seed(整数,不同值改变布局)、可选 hold(结尾额外秒数)和 out(输出路径)。
  4. 构建:运行 python3 "$SKILL_DIR/build.py" <spec.json>。一次 3D 渲染约 1.5 分钟,大部分时间用于等待 WebGL(出现 sub_timeline_readiness_timeout 警告属正常)。可加 --snap 3.8 先检查最后一帧。
  5. 检查画面:目的地卡片完整显示,街道标签不与 ETA 卡片重叠。
  6. 交付 mp4 文件路径。

自定义路线

路线形状默认固定。如需更改,将 template.html 复制到规格文件同目录,修改副本中的 WP([x, z] 路径点;每个拐角必须落在街道上,街道沿 4 的倍数分布;x 范围 -36 到 36,z 范围 -88 到 24,北为负 z),并在规格文件中添加 "template": "template.html"。相机的最终拉远目标 new THREE.Vector3(3, 0, -27) 和标签位置 LBL 是针对默认路线调校的,修改路线时需一并调整,并用 --snap 检查。

适用场景

适合制作简短、风格干净的城市出行路线动画,用于展示从家到健身房等目的地行程。

限制

  • 路线形状固定,自定义需要手动修改模板并调整相机目标和标签位置。
  • 依赖 ffmpeg、Node 和无头 Chrome 的 WebGL 渲染环境。
  • 渲染耗时约 1.5 分钟。
  • 地点标签仅为装饰,不代表真实地理。
  • 目的地卡片约容纳 26 个字符。
  • 风格保持简洁:一条路线、一个图钉,无额外箭头或标注。