启动脚本

初级 程序员

启动脚本在被添加到场景或从场景移除时运行。

public class Example : StartupScript
{
    public override void Start()
    {
        // 脚本加载时执行的操作
    }
    
    public override void Cancel()
    {
        // 脚本卸载时执行的操作
    }
}

何时使用

启动脚本用于在场景加载时，或脚本附加到的实体被添加到场景时，执行一次代码。它们用于初始化其他脚本和实体，但不会每帧控制它们。

不过，如果你的代码需要等待异步方法，那么建议改为使用异步脚本。

可重写的方法

启动脚本具有 2 个可重写的方法，用于执行游戏逻辑。

Note

这些方法只会在运行时被调用 - 它们永远不会在 Game Studio 中被调用。

Start()

Start 方法在脚本被添加到游戏时被调用。例如：

• 当脚本所在的场景被加载时
• 当包含该脚本的新实体被添加到场景时
• 当脚本被添加到已存在的实体时

如果脚本附加到的实体先从场景中移除、随后又被添加回来，该方法可能会执行多次。

Cancel()

Cancel 方法在脚本从游戏中移除时被调用。包括：

• 当脚本所在的场景被卸载时
• 当脚本附加到的实体从其场景中移除时
• 当脚本从场景实体上移除时
• 当游戏关闭时

如果脚本附加到的实体先被重新添加、随后又从场景中移除，该方法可能会执行多次。