game-code-4/data/schema/camera.schema.json

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "camera.schema.json",
  "title": "camera 表 schema v0（per-hall 相机 rig 数据行，架构 §4.3 / W3 新增）",
  "description": "为什么独立成表而不是给 halls.csv 加列：① halls.csv 是「世界身份行」（殿门/解锁批/色板/pacing），被经济核心、sim、UI、引用完整性校验广泛消费；给相机参数加列会让每次手感微调都重写整张十殿表并波及所有消费者；② 相机参数生命周期与数值表不同（灰盒试玩期会高频手调），独立成表后调整 = 只改自己的行；③ 仍是「一行一殿」，年更「新冤案包」= 加一行，check_references 可断言每殿恰一行；④ 全局标量（弹簧刚度/阻尼/平滑时间常数）不随殿变，按既有纪律进 balance_tuning.csv。band_screens = 该 band 占几屏宽（@1280 基准，架构 §4.3 的 2-3 屏）；layer_*_scroll = 四层视差滚动系数（0 = 无限远静止，1.0 = 与近景地面同步，>1 = 前景走得更快）；focus_ratio = 进度焦点钉在视口的横向比例（0.66 = 右 1/3，GDD §2.4 焦点可见性）；arena_* = 殿王战推近时的缩放与构图锚点。",
  "x-supported-keywords": [
    "type", "properties", "required", "items", "enum", "pattern",
    "minimum", "maximum", "minLength", "minItems", "maxItems",
    "additionalProperties", "const"
  ],
  "x-unique": ["id", "hall_id"],
  "type": "object",
  "required": ["sheet", "schema_version", "columns", "rows"],
  "properties": {
    "sheet": { "const": "camera" },
    "schema_version": { "const": 0 },
    "columns": {
      "type": "array",
      "items": { "type": "string" },
      "minItems": 11
    },
    "rows": {
      "type": "array",
      "minItems": 10,
      "maxItems": 10,
      "items": {
        "type": "object",
        "required": [
          "id", "hall_id", "band_screens",
          "layer_far_scroll", "layer_mid_scroll", "layer_near_scroll", "layer_fore_scroll",
          "focus_ratio", "idle_zoom", "arena_zoom", "arena_focus_ratio"
        ],
        "properties": {
          "id": {
            "type": "string",
            "pattern": "^cam_hall_[0-9]{2}$",
            "description": "稳定字符串 ID；永不重编号（年更=加行）"
          },
          "hall_id": {
            "type": "string",
            "pattern": "^hall_[0-9]{2}_[a-z]+$",
            "description": "halls.csv 行 ID（每殿恰一行，由 BalanceData.check_references 断言）"
          },
          "band_screens": {
            "type": "number",
            "minimum": 1,
            "maximum": 6,
            "description": "该 band 横向屏宽数（@1280 基准；架构 §4.3 规定 2-3 屏）"
          },
          "layer_far_scroll": {
            "type": "number",
            "minimum": 0,
            "maximum": 1,
            "description": "远景水墨层滚动系数（越小越远）"
          },
          "layer_mid_scroll": {
            "type": "number",
            "minimum": 0,
            "maximum": 1,
            "description": "中景剪影套件层滚动系数（架构 §4.3 定 0.4）"
          },
          "layer_near_scroll": {
            "type": "number",
            "minimum": 0,
            "maximum": 1.5,
            "description": "近景地面层滚动系数（架构 §4.3 定 1.0）"
          },
          "layer_fore_scroll": {
            "type": "number",
            "minimum": 1,
            "maximum": 2,
            "description": "前景层滚动系数（>1 = 比相机走得快）"
          },
          "focus_ratio": {
            "type": "number",
            "minimum": 0,
            "maximum": 1,
            "description": "军列前线/下一道殿门钉在视口的比例（0.66 = 右 1/3）"
          },
          "idle_zoom": {
            "type": "number",
            "minimum": 0.5,
            "maximum": 3,
            "description": "巡游状态基准缩放"
          },
          "arena_zoom": {
            "type": "number",
            "minimum": 0.5,
            "maximum": 4,
            "description": "殿王战推近缩放（应 > idle_zoom）"
          },
          "arena_focus_ratio": {
            "type": "number",
            "minimum": 0,
            "maximum": 1,
            "description": "殿王战 arena 中心钉在视口的比例（0.5 = 居中）"
          }
        },
        "additionalProperties": false
      }
    }
  },
  "additionalProperties": false
}