ctx.scene 控制主游戏舞台中的场景。

API

方法返回值说明
change(id)void | Promise<void>将主舞台切换到指定场景
show(id)void | Promise<void>显示场景
hide(id)void | Promise<void>隐藏场景但保留实例
destroy(id)void | Promise<void>销毁指定场景实例
destroyAll()void | Promise<void>销毁全部场景实例

案例:切换到学校天台

输入: 项目中存在 id 为 school-rooftop 的场景。
await ctx.scene.change("school-rooftop");
输出: Promise 完成后,主舞台显示 school-rooftop 的图层;调用结果没有业务数据,解析值为 undefined 如果只是暂时遮住场景,可以使用 hide(),之后再用 show() 恢复:
await ctx.scene.hide("school-rooftop");
await ctx.scene.show("school-rooftop");
鉴赏、缩略图等“只预览、不改变当前游戏场景”的需求,请使用 ctx.sceneRender