ctx.curtain 控制覆盖主舞台的幕布。

​
API

方法返回值说明
fadeIn(options?)void | Promise<void>幕布渐入并合上
fadeOut(options?)void | Promise<void>幕布渐出并打开
show(options?)void | Promise<void>显示幕布
hide(options?)void | Promise<void>隐藏幕布
常用选项为 duration（毫秒）和 color。

​
案例：黑场切换场景

输入： 当前场景为教室，要用 500ms 黑场过渡到 school-rooftop。 
await ctx.curtain.fadeIn({ duration: 500, color: "#000000" });
await ctx.scene.change("school-rooftop");
await ctx.curtain.fadeOut({ duration: 500, color: "#000000" });
输出： 画面先在 500ms 内被黑色幕布完全覆盖；场景在黑场中切换；幕布再用 500ms 打开，最终显示学校天台。每一步完成后的解析值均为 undefined。