用途
map-route 用于生成一段 3D 地图动画短片(reel 风格),表现从起点到目的地的行程。画面包含白色三维城市街区、公园和河流,一条彩色路线从起点自行绘制到终点,镜头跟随行进并在结尾拉远,同时显示倒计时 ETA 卡片,图钉落下后出现目的地卡片。
主要能力
- 生成 3D 城市地图场景:白色块状建筑、公园、河流。
- 路线动画:按固定形状(上、右、上、右,终点为图钉)绘制彩色路线,移动圆点随路线行进。
- 镜头运动:沿路线移动,结尾拉远。
- ETA 卡片:显示剩余分钟数并倒计时,到达后显示目的地名称卡片。
- 可配置项:目的地、分钟数、距离、单位(km/mi)、5 个装饰性地点标签、强调色(路线、移动圆点、ETA 图标,图钉固定红色)、随机种子(改变建筑与公园布局)、结尾额外停留秒数、输出路径。
使用方式
- 首次使用:根据技能加载时显示的 Base directory 设置
SKILL_DIR,定位kit目录并检查 three.module.js 是否存在,缺失则运行setup.sh。需要 ffmpeg 和 Node,渲染使用无头 Chrome 中的 WebGL。 - 获取行程信息:向用户取得目的地名称、分钟数和距离(例如“家到健身房,2.8 km,9 分钟”)。如果只提供分钟或距离之一,按步行约 12 分钟/公里、骑行约 4 分钟/公里、市内驾车约 2 分钟/公里估算另一项,并向用户说明。
- 编写规格文件
<name>.map.json,包含destination、minutes、distance(必填)、unit(km 或 mi)、places(5 个灰色小标签,依次位于起点附近、最左侧公园、路线中段街区、最右侧公园、河流;需贴合用户城市,或用空字符串隐藏)、accent(十六进制颜色)、seed(整数,不同值改变布局)、可选hold(结尾额外秒数)和out(输出路径)。 - 构建:运行
python3 "$SKILL_DIR/build.py" <spec.json>。一次 3D 渲染约 1.5 分钟,大部分时间用于等待 WebGL(出现sub_timeline_readiness_timeout警告属正常)。可加--snap 3.8先检查最后一帧。 - 检查画面:目的地卡片完整显示,街道标签不与 ETA 卡片重叠。
- 交付 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 个字符。
- 风格保持简洁:一条路线、一个图钉,无额外箭头或标注。