坐标、锚点与空间变换
后端常把 (x,y) 当成一组普通字段;游戏里它还必须携带“属于哪个空间”的含义。敌人的世界位置、背包格子的本地位置、手指在屏幕上的位置,即使数值相同也不能直接比较。把坐标空间当成单位,像避免把元和分相加一样,可以提前消除大量点击偏移、换父节点跳动和镜头跟随错误。
从一张场景图读出位置
设关卡节点在世界空间向右移动 100,角色在关卡本地空间的位置为 (20,30);没有旋转缩放时,角色世界位置是 (120,30)。如果关卡再旋转 90 度,角色的本地 x 方向就不再指向屏幕右边;此时不能继续逐项相加。二维仿射变换通常写成矩阵,位置需要依次经过缩放、旋转、平移。父子层级的世界矩阵为 父世界矩阵 × 子本地矩阵,变换顺序一般不可交换。
Cocos Creator 3.8 采用右手世界坐标,x 向右、y 向上;节点 position 表达相对父节点的位置,worldPosition 表达统一世界空间的位置。2D 仍处在 3D 场景系统中,只是通常在 XY 平面活动。不要从图片编辑器的左上角原点习惯,推断引擎所有 API 都是 y 向下。
区分“点”和“向量”也很重要。将世界点转换到本地空间需要考虑平移,而将朝向转换空间只需要旋转与缩放。枪口偏移是相对角色原点的点;子弹方向是向量。把方向当世界点去转换,会意外带入角色的位置。
锚点不等于节点位置
UITransform 的宽高定义矩形,锚点定义矩形相对节点原点如何展开。宽 100、锚点 x=0.5 的图,局部左右边界是 -50 与 50;锚点改成 0,边界变成 0 与 100,但节点原点没有因此自动平移。旋转、缩放围绕节点原点发生,所以更换角色图后“脚在滑动”常来自锚点或透明边界不一致。
锚点和像素裁切需要一起管理。一个人物每帧都应有相同的逻辑脚底基准;自动裁去透明边缘后,可以通过 SpriteFrame 的原始尺寸与偏移保持显示位置。不能要求所有美术文件都塞满矩形,再在代码里为每帧补一个神秘偏移。血条则往往使用左侧锚点,使缩放表示从右侧减少,而不是向两边收缩。
输入坐标走一条明确的转换链
点击场景中的怪物,过程是“设备输入坐标 → 相机看到的世界空间 → 目标父节点的本地空间”。UI 上的拖拽还要考虑 Canvas 的设计分辨率与适配策略。Cocos 的 EventTouch.getUILocation() 与普通屏幕位置用途不同;应选择与目标转换 API 匹配的坐标,不自行乘一个设备像素比试运气。
下面片段只用于 Canvas 内常规 UI 拖拽:container 是拖拽物的父节点,目标在同一 UI 体系内。世界中的单位应使用对应游戏相机做屏幕与世界转换。
import { EventTouch, Node, UITransform, Vec3 } from 'cc';
const local = new Vec3();
const uiPoint = new Vec3();
function placeInContainer(event: EventTouch, container: Node, item: Node) {
const p = event.getUILocation();
uiPoint.set(p.x, p.y, 0);
container.getComponent(UITransform)!.convertToNodeSpaceAR(uiPoint, local);
item.setPosition(local);
}
转换函数名称里的 AR 表示以锚点为参考。选择一次正确转换后,把空间写入变量名,例如 screenPoint、worldTarget、localOffset。跨组件传位置时也声明合同:攻击系统接收世界点,界面系统接收 UI 本地点。大型项目可以用 TypeScript 品牌类型约束空间;小游戏起步阶段,清晰命名和集中转换函数通常已经足够。
用十字线定位,而不是盲改常数
画出节点原点、矩形边界、点击点和转换后的目标点。若偏移是固定值,先查锚点与父节点位置;若随屏幕比例变化,查输入空间和 Canvas 适配;若随父节点旋转变化,查是否直接相加;若只在镜头移动后失效,查是否绕过相机。换父节点时先决定保持本地位置还是世界位置,再选对应 API,而不是移动后补偿。
渲染节点可以拥有负缩放来翻转朝向,但物理节点最好保持稳定尺度,图像放子节点。非均匀缩放与旋转组合会使直觉失效;需要精确碰撞、距离或法线时,回到统一世界空间计算。物理世界、地图网格与显示像素可以有不同单位,转换应集中在边界。
微信小游戏上,竖屏、横屏、安全区和高分辨率设备都会改变输入到画面的映射。浏览器把窗口缩成手机大小只能验证部分布局;真实触摸、多指和平台适配需要微信真机确认。在 实验室 建立四角点击场景,显示原始输入和最终本地坐标,能比一张“看起来没问题”的截图提供更多证据。
变换边界要显式处理
世界到本地的转换本质上使用逆矩阵。父节点某一轴缩放为零时,变换不可逆;接近零也会放大数值误差。因此“先把节点缩成零藏起来,再让它参与拖拽转换”不是可靠方案,隐藏可使用显示状态,计算层保留可逆尺度。负缩放虽然可逆,却会翻转方向与几何朝向,涉及左右判断时需要额外留意。
位置转换还有深度前提。屏幕上一个点在三维世界通常对应一条射线,而不是唯一世界点;平面游戏需要声明交互平面或固定深度,再求交点。即使画面全是二维图片,多相机、不同视口或透视投影也可能让一个简单的屏幕点不再能直接落到目标平面。把平面假设写进适配函数,后续镜头改动时才知道哪里需要重验。
拖拽还要保存抓取偏移。手指按在道具左上角时,若移动时把道具原点直接设到手指位置,道具会瞬间跳到手指中心;正确做法是按下时在同一空间保存“道具原点减触点”,之后一直应用该偏移。中途容器变换时则重新定义抓取合同,不能混用按下时本地偏移与当前世界坐标。
多人协作时,关卡文档最好在图上标出原点、正方向、格中心和角色基准,而不只写“坐标沿用引擎默认”。接口日志也同时记录空间与单位;错误坐标在另一层恰好抵消的情况可能暂时显示正确,只有往返转换和父节点扰动测试才能揭露。
交给 AI 的具体任务
用 Cocos Creator 3.8.8/TypeScript 制作坐标调试场景:一个可移动、旋转、缩放的父容器和一个可拖拽子精灵。显示子节点本地/世界坐标、锚点、UI 点击点。拖拽统一经过转换函数;增加保持世界位置的换父节点操作。列出适用的 Canvas 与相机前提,不添加固定像素补偿。
验收时把父容器设为 (100,50)、旋转 30 度、缩放 1.5;手指应始终贴住拖拽物的指定抓取点。换父节点前后世界位置应在浮点误差范围内不变。分别检查宽屏、长屏四个角,并在微信真机记录设备与适配策略。后续学习 向量与运动 时,继续沿用这些空间命名。
来源与适用边界
核查日期:2026-11-17。具体 API 面向 Creator 3.8 系列,项目示例目标为 3.8.8;本文没有执行编辑器或微信真机测试。
- Cocos 3.8:坐标系和节点变换,核对本地/世界空间与轴向。
- Cocos 3.8:UITransform,核对矩形、尺寸和锚点职责。