ctx.camera 对当前主舞台的摄像机应用镜头效果。

API

方法返回值说明
pan(options)void | Promise<void>平移、缩放或调整镜头参数
shake(options)void | Promise<void>播放镜头震动
reset()void | Promise<void>恢复默认镜头状态

案例:制造一次短促震动

输入: 当前正在显示战斗场景,希望在命中时产生 300ms 的双轴震动。
await ctx.camera.shake({
  amplitude: 10,
  frequency: 18,
  duration: 300,
  falloff: "expo",
  axis: "both",
});
输出: 镜头在 X、Y 轴产生最大约 10px 的短促位移,并在 300ms 内衰减到 0;Promise 完成时画面不再震动,解析值为 undefined 需要回到初始镜头时:
await ctx.camera.reset();
这会把缩放和偏移恢复到默认状态,并结束正在运行的镜头效果。