Cocos学习笔记：骨骼动画时序、坐标转换与输入处理

一、骨骼动画的基准方向校准

骨骼动画中的旋转角度并非总是以世界坐标的上方向为零度。实际开发中，需要先将目标骨骼的 rotation 手动设为 0，观察其在世界空间中的真实指向。很多情况下，美术在制作动画时会让骨骼有一个默认的偏移角度，比如负六十多度，这意味着零度方向实际上是斜向的。

计算手臂瞄准角度时，不宜直接使用世界坐标的 Y 轴作为基准，因为骨骼自身的零度方向可能已经发生了偏移。更稳妥的做法是：以 X 轴正方向为基准计算目标向量与 X 轴的夹角，再将这个夹角与骨骼的原始偏移角度相加，得到最终需要设置的 rotation 值。这样无论美术最初把骨骼摆成什么姿势，程序都能正确计算相对转角。

二、二维向量夹角的计算与方向修正

用向量计算两个方向之间的夹角时，引擎返回的通常是弧度值，需要乘以 180 再除以 π 转换为度数。不同引擎对角度正负方向的定义可能不同，有的以逆时针为正，有的以顺时针为负，甚至可能与数学惯例完全相反。计算后应通过实际运行观察来验证方向，必要时将整个计算式取反，确保鼠标在右侧时角度为正，在左侧时为负。

三、骨骼更新时序与跨帧延迟

游戏引擎每一帧内部的执行顺序大致是：逻辑更新、 lateUpdate、骨骼动画数据更新、渲染。这意味着在本帧的 update 中修改了骨骼角度，绑定的挂点（socket）并不会立刻刷新到新的世界坐标，要等到骨骼动画系统完成更新后才能拿到准确位置。

如果在本帧内立即读取挂点坐标用于发射子弹，得到的其实是上一帧残留的旧位置，表现为子弹从错误的角度射出，或者手臂还没转到位子弹就先飞了出去。解决这个问题不宜用 setTimeout 延时零点几秒，因为定时器基于真实时间，无法严格对齐帧边界。应该使用引擎提供的调度器，将发射逻辑延迟到下一帧执行，延时参数写 0 即可，这样能保证在骨骼数据完整更新后再进行坐标读取和子弹生成。

四、引擎生命周期事件的妙用

导演类或核心循环中通常提供一系列系统级事件，例如物理更新前、物理更新后、渲染前、渲染后。在物理游戏中销毁带有刚体的物体时，若在碰撞回调中直接销毁，可能会与正在进行的物理计算冲突导致报错。将销毁操作注册到物理更新完成的事件中，就能安全地避开冲突。

同理，如果必须在渲染阶段获取骨骼的最终变换，也可以考虑渲染前后的事件。不过涉及跨帧的数据依赖，最稳妥的方式仍然是调度器的下一帧延迟，因为它不会破坏当前帧的完整执行周期，也不会干扰渲染流程。

五、角色镜像后的角度对称处理

当角色通过水平缩放实现左右翻转时，骨骼的角度计算也需要做对应的镜像处理。因为翻转本质上是围绕 Y 轴做了一个对称变换，原本在右侧计算出的角度不能直接套用到左侧。一种可行的处理方式是：先对计算出的角度取反，再叠加 180 度，这样能得到在镜像状态下的等效角度。

需要注意区分骨骼角度和子弹角度。子弹的旋转应与骨骼最终呈现的角度保持一致，但在做镜像换算时，只调整骨骼的显示角度即可，子弹自身的飞行方向仍由原始向量决定，避免二次反转导致方向错乱。

六、屏幕坐标与世界坐标的同步

鼠标或触摸输入返回的是屏幕坐标，其原点固定在屏幕左下角或左上角，不会随着摄像机移动而改变。当游戏中有跟随角色的移动摄像机时，必须把屏幕坐标叠加上摄像机的当前偏移量，才能得到准确的世界坐标。忽略这一步会导致无论角色走到哪里，子弹总是从屏幕固定位置发射，而不是从角色当前所在的位置发射。

七、输入系统的平台差异与冲突

在桌面端使用键盘控制方向、鼠标控制射击时，可能会遇到输入冲突：按住方向键不放的情况下点击鼠标，键盘事件会被意外触发为松开状态。这是特定平台输入系统的底层问题，在移动端使用虚拟摇杆和触摸按钮时通常不会出现。

开发过程中如果遇到方向键间歇性失灵的情况，可以检查是否与其他输入设备事件产生了干扰。对于跨平台游戏，输入模块最好做一层状态封装，统一维护按键的按下与释放状态，而不是完全依赖引擎原生的按键回调，这样能在一定程度上屏蔽平台差异带来的异常。

八、预制体朝向的标准化约定

子弹、箭矢等飞行物做成预制体时，建议让美术统一将其默认朝向设为 X 轴正方向。这样程序中计算出的瞄准角度可以直接赋值给子弹的 rotation，无需再做额外的方向校正。如果美术资源默认朝向上方或右上方，则需要在代码中补偿一个固定偏移角，增加不必要的维护成本。

子弹的锚点建议放在左侧中心位置，这样当子弹按计算角度旋转时，其尾部会自然位于发射点，前端指向目标方向，视觉上更符合直觉。