3.1 KiB
3.1 KiB
顺序赛最小配置模板
本文档提供一份 顺序赛（classic-sequential）最小可跑配置模板。
目标：
- 只保留顺序赛跑通所需的最少字段
- 适合快速起活动、联调、排查配置链
- 每个字段都带简要说明
1. 最小模板
{
"schemaVersion": "1",
"version": "2026.03.30",
"app": {
"id": "sample-classic-minimal-001",
"title": "顺序赛最小示例"
},
"map": {
"tiles": "../map/lxcb-001/tiles/",
"mapmeta": "../map/lxcb-001/tiles/meta.json"
},
"playfield": {
"kind": "course",
"source": {
"type": "kml",
"url": "../kml/lxcb-001/10/c01.kml"
}
},
"game": {
"mode": "classic-sequential",
"punch": {
"policy": "enter-confirm",
"radiusMeters": 5
}
}
}
2. 字段说明
schemaVersion
- 类型：
string - 必填：是
- 说明：配置结构版本
- 当前建议值：
"1"
version
- 类型：
string - 必填：是
- 说明：配置版本号
app.id
- 类型：
string - 必填：是
- 说明：活动配置实例 ID
app.title
- 类型：
string - 必填：是
- 说明：活动标题 / 比赛名称
map.tiles
- 类型：
string - 必填：是
- 说明：地图瓦片根路径
map.mapmeta
- 类型：
string - 必填：是
- 说明：地图 meta 文件路径
playfield.kind
- 类型：
string - 必填：是
- 说明：空间对象类型
- 顺序赛固定使用：
course
playfield.source.type
- 类型：
string - 必填：是
- 说明：空间底稿来源类型
- 当前推荐值：
kml
playfield.source.url
- 类型：
string - 必填：是
- 说明：KML 文件路径
game.mode
- 类型：
string - 必填：是
- 说明：玩法模式
- 顺序赛固定值：
classic-sequential
game.punch.policy
- 类型：
string - 必填：是
- 说明：打点策略
- 当前常用值：
enter-confirm：进入范围后用户再点击确认打点enter：进入范围自动打点
game.punch.radiusMeters
- 类型：
number - 必填：是
- 说明：打点判定半径，单位米
- 建议默认值：
5
3. 当前默认逻辑
如果你不写下面这些字段，顺序赛会按当前客户端默认逻辑运行：
map.declination- 默认按
0处理
- 默认按
map.initialView.zoom- 默认由客户端初始视口逻辑接管
playfield.CPRadius- 默认按客户端内置值处理
game.session.*- 默认手动开始、要求起点打卡、终点打卡
game.sequence.skip.*- 默认不启用跳点
game.guidance.*- 默认使用当前引导逻辑
resources.*- 默认 profile
debug.*- 默认关闭
4. 适用场景
这份模板适合：
- 快速验证顺序赛主流程
- 联调地图和 KML
- 后台先跑通最小顺序赛配置
如果要看更完整版本，请继续参考：