毕业实战:按钮开门

一、需求:造一扇比第一章更聪明的门

还记得课程前半程那扇「按一下、开 5 秒、自动关」的门吗?那是当时的你能造出的最好机关。现在你的背包里多了并发三兄弟、事件的两种听法、map 和 option、甚至 <persistable>——是时候把毕业作品升级到 2.0 了。新需求一共四条:

还记得课程前半程那扇「按一下、开 5 秒、自动关」的门吗?那是当时的你能造出的最好机关。现在你的背包里多了并发的几种玩法、事件的两种听法(Bind 回调 / 在线里直接等)、随时可查的键值表和「可能没有」的可选值、甚至每人一份的存档——是时候把毕业作品升级到 2.0 了。新需求一共四条:

• ▢ 玩家按下门边按钮,屏障消失,路打通;
• ◇ 超时自动关门——没人管它,它也会在倒计时结束后自己关上;
• △ 开门期间再按一次按钮 = 提前关门,门从此听得懂两种指令;
• ★ 自动关门的秒数不写死在代码里,策划在编辑器面板就能调。

第三条是真正的难点:门开着的时候,「倒计时走完」和「玩家又按了一次」两件事在赛跑,谁先发生听谁的,而且输家必须被干净地掐掉,不能留下幽灵倒计时。这正是 race「赛跑」(race)的主场。先清点一下这扇门要用到的技能石:

二、拆解:先当设计师,再当程序员

要哪些设备?关卡里两台现成设备:Button Device(按钮)负责接收交互,Barrier Device(屏障)就是门本体。再加上我们手写的第三台 door_controller——它不干体力活,只当指挥官。

要哪些插槽?三个 @editable:OpenButton 和 Door 指向两台真实设备,AutoCloseDelay:float = 5.0 是自动关门秒数。三个开了 Instance Editable 小眼睛的变量:OpenButton 和 Door 是两个设备引用,分别指向关卡里真实的按钮和屏障;AutoCloseDelay 是个小数(float)变量,默认 5.0,就是自动关门秒数。把秒数做成插槽是 2.0 的新招——数值策划在 Details 面板拖一下就能改,不用碰一行代码,也不用重新编译。

要什么状态?一个 var IsDoorOpen:logic = false。一个布尔变量 IsDoorOpen(在变量面板新建,类型 logic 就是蓝图里的 Boolean),默认 false。有趣的是,升级版里它不再是防连按的门卫——防重复触发这件事,由主循环的结构天然保证(循环没回到「等按钮」那一步,新的开门流程就不可能开始)。留着它,是给日志、给其他系统(比如拓展页里的计分器)一个随时可查的「门现在开着吗」。

流程长什么样?旧版和新版的对比,一张表看清:

官方在并发文档里的建议是:能用结构化并发(sync / race / rush / branch)就不用非结构化的 spawn。2.0 把「等 5 秒然后关门」从 spawn 分身重构成了 race 赛跑,只保留一处 spawn——在 OnBegin 里把常驻主循环 DoorLoop() 派出去。这是 spawn 最正当的用法:启动一个与设备同寿命的长期流程。整条流程串起来:loop 等按钮 → 开门 → race(倒计时 vs 再按)→ 关门 → 回到 loop 顶部。照图施工!

官方的建议是:能用「有结构、看得见头尾」的并发(sync / race / rush / branch,都是几条执行线一起跑、由结构框住起止的写法)就别用「岔出去就不管」的 spawn。2.0 把「等 5 秒然后关门」从「岔一条线倒计时」重构成了「两条线赛跑」,只在一处岔线——Event BeginPlay 里把常驻主循环 DoorLoop 岔出去跑。这是 spawn 最正当的用法:启动一条和设备同寿命的长期后台线。整条流程串起来:自绕循环等按钮 → 开门 → 两条线赛跑(倒计时 vs 再按)→ 关门 → 绕回循环顶部。照图施工!

三、door_controller.verse:一行行跑给你看

下面是完整的毕业作品 2.0,42 行。右边的运行面板才是本课的主菜:点「运行下一步」,亲眼看这扇门从上电、派分身、待命,到开门、赛跑、再关上的完整一生。

读图翻译:整段代码 = Event BeginPlay 里先 Print String 报个到,再岔出一条常驻后台线跑 DoorLoop;DoorLoop 是一个自绕的无限循环,每圈只做四件事——等按钮事件响 → 开门(Set 状态为 true + 给 Barrier 连 Disable 节点 + Print)→ 两条线赛跑(一条 Delay 倒计时、一条再等一次按钮,谁先到听谁的,输的那条被自动剪断)→ 关门(Set 状态为 false + 给 Barrier 连 Enable 节点 + Print)→ 绕回顶部继续等。下面这台步进器会把这套连线一步步演给你看。

using { /Fortnite.com/Devices }
using { /Verse.org/Simulation }
using { /UnrealEngine.com/Temporary/Diagnostics }

# 毕业实战 2.0:loop 主循环 + race 限时赛跑,超时自动关门
door_controller := class(creative_device):

    # 三个 @editable:两台设备 + 一个可调秒数,全在 Details 面板配置
    @editable
    OpenButton:button_device = button_device{}

    @editable
    Door:barrier_device = barrier_device{}

    @editable
    AutoCloseDelay:float = 5.0

    # 门的状态:false = 关着,true = 开着
    var IsDoorOpen:logic = false

    OnBegin<override>()<suspends>:void =
        Print("门禁系统上线,主循环出发。")
        spawn{ DoorLoop() }

    DoorLoop()<suspends>:void =
        loop:
            OpenButton.InteractedWithEvent.Await()
            OpenDoor()
            race:
                Sleep(AutoCloseDelay)
                OpenButton.InteractedWithEvent.Await()
            CloseDoor()

    OpenDoor():void =
        set IsDoorOpen = true
        Door.Disable()
        Print("大门开启,倒计时开始;再按一次可提前关门。")

    CloseDoor():void =
        set IsDoorOpen = false
        Door.Enable()
        Print("大门已关闭,机关待命。")

四个函数各司其职:OnBegin 是点火器,报到之后把常驻主循环 spawn 出去就退场;DoorLoop 是这扇门的灵魂,带着 <suspends> 牌子,一辈子只做四件事的循环;OpenDoor / CloseDoor 是一对普通帮手函数,把「改状态 + 拨屏障 + 喊日志」打包,顺便消灭了 Enable/Disable 极性搞反的隐患——代码里从此只出现「开门」「关门」,不出现「启用」「禁用」。

四个函数各司其职:Event BeginPlay 是点火器,报到之后把常驻主循环 DoorLoop 岔出去跑就退场;DoorLoop 是这扇门的灵魂,挂着小钟表(能等待的 latent 函数),一辈子只做四步的循环;OpenDoor / CloseDoor 是一对普通蓝图帮手函数,把「Set 状态 + 拨屏障 + Print 喊话」打包,顺便消灭了 Enable/Disable 极性搞反的隐患——图里从此只出现「开门」「关门」,不出现「启用」「禁用」。

两个容易忽略的细节。其一:race 至少需要两条异步赛道,只放一条是编译错误;如果你想回到 1.0 的「开门期间按钮无效」,直接删掉 race 和赛道 B,只留 Sleep(AutoCloseDelay) 一行就好。其二:同一个事件别混用两种听法——如果你既 Subscribe 了 InteractedWithEvent,又在 race 里 Await 它,一次按钮会同时惊动两边,开关门逻辑直接翻倍触发。一个事件,一种听法,提前定好。

两个容易忽略的细节。其一:赛跑(race)至少要两条能等待的赛道,只放一条会 Compile 报错;如果你想回到 1.0 的「开门期间按钮无效」,直接删掉赛跑和赛道 B,只留 Delay(时长 AutoCloseDelay)一格就好。其二:同一个事件别混用两种听法——如果你既 Bind 了 InteractedWithEvent 的回调,又在赛跑里等它响,一次按钮会同时惊动两边,开关门逻辑直接翻倍触发。一个事件,一种听法,提前定好。

四、搭建上线:四步走

代码只是灵魂,还得给它一副身体。UEFN 是 UE6 面向 Fortnite 的创作环境,下面以它为例——这套流程在 UE6 的各个创作环境里都是一致的:

之后每次改动代码,都要重新 Build 并推送更改到会话——这一步忘掉的话,场景里跑的还是旧版本,下一节的排雷手册里它榜上有名。

五、编译坑清单:毕业考排雷手册

下面六个坑,覆盖了这类「事件 + 并发 + 设备」项目九成以上的翻车现场。提前在脑子里踩一遍,正式上场就稳了:

六、关卡挑战

毕业考最后一关。先热手补全核心零件,再答三道题。答对拿星星 ★,答错可以一直重试——就像这扇门,永远给你留着下一次机会。

# 补全三个空:派分身的关键字、等待资格的牌子、限时赛跑的块
OnBegin<override>()<suspends>:void =
    ____{ DoorLoop() }

DoorLoop()<____>:void =
    loop:
        OpenButton.InteractedWithEvent.Await()
        OpenDoor()
        ____:
            Sleep(AutoCloseDelay)
            OpenButton.InteractedWithEvent.Await()
        CloseDoor()

拓展阅读