游戏开发图形学3D渲染【免费下载链接】openmwOpenMW is an open-source open-world RPG game engine that supports playing Morrowind. Main repo and issue tracker can be found here: https://gitlab.com/OpenMW/openmw/项目地址https://gitcode.com/gh_mirrors/op/openmw点击查看免费下载openmw.async是 OpenMW Lua 脚本系统内置的异步工具包为全局脚本、菜单脚本、局部脚本与玩家脚本提供三种时间基准模拟时间、游戏时间、真实时间下的定时器以及函数回调Callback包装机制。本文以官方 API 定义files/lua_api/openmw/async.lua为主线结合底层 C 实现components/lua/asyncpackage.cpp与components/lua/scriptscontainer.cpp与脚本指南docs/source/reference/lua-scripting/overview.rst系统讲解定时器的创建、保存/加载语义、暂停与对象失活行为并给出可复制的完整示例帮助你写出延迟执行、周期调度、跨存档保持的稳定游戏逻辑。包概览定位、上下文与加载方式openmw.async是 OpenMW 提供的 API 包API package与openmw.core、openmw.self等同属引擎内置包通过require加载且无法被同名 Lua 文件覆盖local async require(openmw.async)从官方声明看files/lua_api/openmw/async.lua该包包含定时器与协程工具timers and coroutine utilities所有函数都要求把包本身作为第一个参数传入即冒号调用async:newSimulationTimer(...)可用上下文为global|menu|local|player|load即全局脚本、菜单脚本、局部/玩家脚本以及加载脚本均可使用。包内共提供 8 个 API分为三组API用途是否可保存async:registerTimerCallback(name, func)注册具名回调返回TimerCallback——async:newSimulationTimer(delay, callback, arg)delay个模拟秒后调用callback(arg)是可保存async:newGameTimer(delay, callback, arg)delay个游戏秒后调用callback(arg)是可保存async:newRealTimeTimer(delay, callback, arg)delay个真实秒后调用callback(arg)是可保存async:newUnsavableSimulationTimer(delay, func)delay个模拟秒后调用func()否不可保存async:newUnsavableGameTimer(delay, func)delay个游戏秒后调用func()否不可保存async:newUnsavableRealTimeTimer(delay, func)delay个真实秒后调用func()否不可保存async:callback(func)把一个 Lua 函数包装为Callback对象——其中delay以秒为单位arg回调参数可以是nil。三种时间基准模拟时间、游戏时间与真实时间定时器的延迟语义取决于你选择的时钟。脚本指南docs/source/reference/lua-scripting/overview.rst 的 Timers 章节给出了明确定义模拟时间Simulation time从开始新游戏起游戏世界中经过的秒数即游戏未暂停时的秒数。openmw.core中对应的查询函数是core.getSimulationTime()。游戏时间Game time游戏世界当前时刻的秒数一般比模拟时间流逝得更快取决于游戏内时间流速。对应查询函数是core.getGameTime()。真实时间Real time机器上的真实秒数。在openmw_aux.time的辅助实现中通过os.time()获取见files/data/openmw_aux/time.lua。暂停行为当游戏暂停时所有定时器一并暂停——模拟时间与游戏时间本就随暂停停止推进而真实时间定时器在 C 层同样受processTimers调度控制见下文。C 侧用ScriptsContainer::TimerType区分三类时钟setupSerializableTimer与setupUnsavableTimer都会根据类型把定时器放入三个独立的最小堆队列之一mSimulationTimersQueue/mGameTimersQueue/mRealTimeTimersQueue见 components/lua/scriptscontainer.cpp。可靠定时器可保存从注册到触发的完整链路可靠定时器的核心约束是回调必须预先注册。原因在于存档时引擎只会记录回调的名字、触发时刻、回调参数而不会序列化函数本身——函数是 Lua 值无法被 OpenMW 的可序列化数据模型保存详见文档的 Serializable data 一节。因此读档后必须由脚本初始化阶段用同一个名字重新注册回调。官方示例脚本指南 Timers 章节——一个延迟传送功能local async require(openmw.async) -- 1. 注册回调teleport 是任意字符串名字 local teleportWithDelayCallback async:registerTimerCallback(teleport, function(data) data.actor:teleport(data.destCellName, data.destPos) end) -- 2. 创建定时器delay 秒后调用已注册的回调并传入参数表 local function teleportWithDelay(delay, actor, cellName, pos) async:newSimulationTimer(delay, teleportWithDelayCallback, { actor actor, destCellName cellName, destPos pos, }) end调用teleportWithDelay(10, actor, Vivec, pos)后10 个模拟秒过去传送即发生。这里registerTimerCallback返回的TimerCallback是一个轻量句柄它在 C 层由struct TimerCallback { AsyncPackageId mAsyncId; std::string mName; }表示components/lua/asyncpackage.cpp内部记录脚本 ID 与回调名创建定时器时newSimulationTimer会调用callback.mAsyncId.mContainer-setupSerializableTimer(TimerType::SIMULATION_TIME, simulationTimeFn() delay, callback.mAsyncId.mScriptId, callback.mName, std::move(callbackArg));即引擎把当前模拟时间 delay作为绝对触发时刻写入可保存定时器队列components/lua/asyncpackage.cpp。触发时ScriptsContainer::callTimer会从脚本的mRegisteredCallbacks表中按名字查找回调并调用components/lua/scriptscontainer.cpp若名字未注册例如脚本版本升级后删除了该回调引擎会抛出Callback xxx doesnt exist错误。这正是先注册、后使用规则的意义。三种时钟的可保存定时器在延迟传送示例中把newSimulationTimer换成另外两个即可获得不同语义-- 游戏时间delay 个游戏秒可能比模拟秒流逝更快 async:newGameTimer(delay, callback, arg) -- 真实时间delay 个真实秒仅在游戏运行时推进 async:newRealTimeTimer(delay, callback, arg)C 实现中三者唯一的差别是触发时刻的计算基准模拟时间用simulationTimeFn()、游戏时间用gameTimeFn()、真实时间用getRealTime()components/lua/asyncpackage.cpp其余保存/恢复逻辑完全一致。不可保存定时器临时回调的便捷与代价如果你只需要一次性延迟执行、不关心存档可以使用不可保存定时器。它不需要提前注册回调——直接把函数作为参数传入即可但代价是读档后定时器必然丢失local async require(openmw.async) local ui require(openmw.ui) return { engineHandlers { onKeyPress function(key) if key.symbol x then async:newUnsavableSimulationTimer( 10, function() ui.showMessage(You have pressed X 10 seconds ago) end) end end, } }底层实现上setupUnsavableTimer会把函数放入脚本的mTemporaryCallbacks表并以引擎自增计数器mTemporaryCallbackCounter作为临时 ID 存入定时器记录components/lua/scriptscontainer.cpp触发后临时回调即被销毁。因为存档时saveTimerFn会跳过所有mSerializable false的定时器components/lua/scriptscontainer.cpp所以游戏在进行中保存读档后该定时器消失。文档明确警告不要用不可保存定时器承担若丢失会让游戏世界进入不一致状态的逻辑例如正在进行的任务关键事件、必须完成的状态迁移。这类逻辑应改用可靠定时器。async:callback把任意 Lua 函数包装成 Callbackasync:callback(func)返回一个Callback对象它是对可在 async API 调用中使用的函数的包装。其本质是 C 侧Callback结构体内部以表形式保存 Lua 函数与AsyncPackageId并挂上带__call元方法的元表使包装后的对象可以直接像函数一样调用Callback::makeMetatable、Callback::make见 components/lua/asyncpackage.cpp。值得注意的实现细节Callback::fromLua校验表首元素是函数、次元素是AsyncPackageId否则抛出Expected an async:callback, received a tablecomponents/lua/asyncpackage.cpp。这意味着只有通过async:callback(...)生成的包装对象才是合法 Callback普通表不能冒充。当某个引擎接口要求Callback类型参数时用async:callback(fn)即可安全转换。定时器的行为语义暂停、对象失活与同帧触发游戏暂停当游戏暂停时所有定时器都暂停模拟时间与游戏时间自然停走真实时间定时器同样不触发。因此定时器不会在暂停菜单、对话框打开期间偷偷执行。对象失活时的回调延迟对于挂在游戏对象上的局部脚本定时器记录的是绝对触发时刻而不是剩余倒计时。当对象所在格子失活inactive时定时器不会暂停、也不会丢但回调只在对象重新激活时才被评估。文档给出了精确的例子某对象上有 3 个定时器延迟分别为 30、50、90 秒假设从第 15 秒到第 65 秒该对象一直处于失活状态则第 1、2 个回调都在第 65 秒对象恢复激活时同时触发第 3 个回调仍在第 90 秒触发。这是因为引擎按触发时刻是否已到来扫描队列失活期间不做评估一旦激活便集中补触发。同帧多定时器的执行顺序定时器队列在 C 层是最小堆insertTimer使用std::push_heapcomponents/lua/scriptscontainer.cppupdateTimerQueue每帧把触发时刻 当前时间的定时器依次弹出执行components/lua/scriptscontainer.cpp。因此同一帧到期的多个定时器按时间先后触发若同时到期则按堆内顺序即相对创建顺序。需要严格先后关系时应显式错开延迟或在一个回调里级联调度下一个。存档与读档定时器如何跨会话存活可靠定时器的持久化机制值得单独展开。存档时ScriptsContainer::save内的saveTimerFncomponents/lua/scriptscontainer.cpp每个定时器只保存触发时刻mTime时钟类型mType回调名字mCallbackName不保存函数本体回调参数mCallbackArgument必须可序列化。对真实时间定时器保存的是剩余秒数mTime - currentRealTime若已过期则为 0因为绝对真实时刻在另一台电脑上毫无意义。游戏时间与模拟时间定时器则保存绝对时刻。读档时ScriptsContainer::loadcomponents/lua/scriptscontainer.cpp引擎把真实时间定时器按当前真实时间 剩余秒数重建游戏/模拟时间定时器直接恢复绝对时刻同时反序列化回调参数。文档Timers 章节特别提醒读档恢复时引擎会对参数做一次反序列化-再序列化以更新其中的引用编号refnums——这样即使内容文件content files的加载顺序发生了变化定时器参数里携带的对象引用依然有效。由此可以得到两条工程建议回调注册必须放在脚本初始化文件顶层、onInit或onLoad阶段不能放在某个临时函数里——读档后引擎按名字找回调传给定时器的arg必须是 Serializable data数字、字符串、游戏对象、openmw.util类型、可序列化表不能包含函数、带元表的表、重复引用或循环引用。辅助包 openmw_aux.time周期调度与时间常量openmw_aux.*是官方用 Lua 实现的辅助库openmw_aux.time正是围绕定时器封装的便捷工具实现位于 files/data/openmw_aux/time.lua。它提供时间常量time.second 1 time.minute 60 time.hour 3600 time.day 3600 * 24时钟类型常量供runRepeatedly的options.type使用time.GameTime GameTime time.SimulationTime SimulationTime time.RealTime RealTime别名函数time.registerTimerCallback、time.newGameTimer、time.newSimulationTimer、time.newRealTimeTimer分别是async对应方法的薄封装参数与返回值完全一致。time.runRepeatedly(fn, period, options)按固定周期反复调用fn返回一个无参的停止函数stopFn。其行为要点period必须为正数否则报错Period must be positive并提示若想要尽可能短的间隔请改用引擎处理器onUpdateoptions.initialDelay首次调用前的延迟省略时取math.random() * period0 到 period 间的随机值——这是官方刻意为之避免所有脚本在同一帧做耗时操作起到性能分摊作用options.type默认time.SimulationTime也可选time.GameTime或time.RealTime注意runRepeatedly基于不可保存定时器实现读档会停止周期调度若需要跨存档持续执行应在脚本初始化阶段调用它每次触发后它根据基准时刻与周期的模运算计算下一次延迟1.5 * period - fmod(...)以保持整体节拍稳定。官方示例一每 5 秒打印一次并可在任意时刻停止local time require(openmw_aux.time) local stopFn time.runRepeatedly(function() print(Test) end, 5 * time.second) -- 每 5 秒打印 Test stopFn() -- 停止打印 -- 每 5 分钟打印一次首次延迟 30 秒 time.runRepeatedly( function() print(Test2) end, 5 * time.minute, { initialDelay 30 * time.second })官方示例二每个游戏日结束时调用doSomething()利用游戏时间local core require(openmw.core) local time require(openmw_aux.time) local timeBeforeMidnight time.day - core.getGameTime() % time.day local stopFn time.runRepeatedly(doSomething, time.day, { initialDelay timeBeforeMidnight, type time.GameTime, })选型决策定时器、onUpdate 还是事件系统理解了openmw.async的全部能力后这里给出与其他机制的对比帮助你在具体场景中做选择需求推荐方案理由一次性延迟动作存档后仍要生效可靠定时器registerTimerCallbacknew*Timer回调名与参数随存档保存一次性延迟动作临时、可丢失不可保存定时器无需注册回调写法最简固定周期循环节拍调度openmw_aux.time.runRepeatedly自带随机首延迟与停止函数每帧高频逻辑引擎处理器onUpdate周期定时器最小粒度受限runRepeatedly文档明确建议高频用onUpdate脚本间解耦通信事件系统sendEvent事件与定时器职责不同定时器只负责延时触发最后回顾包内全部 API 的完整签名files/lua_api/openmw/async.lua-- 注册回调 async:registerTimerCallback(name, func) -- - TimerCallback -- 可靠定时器 async:newSimulationTimer(delay, callback, arg) -- arg 可为 nil async:newGameTimer(delay, callback, arg) async:newRealTimeTimer(delay, callback, arg) -- delay 单位为真实秒 -- 不可保存定时器 async:newUnsavableSimulationTimer(delay, func) async:newUnsavableGameTimer(delay, func) async:newUnsavableRealTimeTimer(delay, func) -- delay 单位为真实秒 -- Callback 包装 async:callback(func) -- - Callback定时器是 OpenMW Lua 脚本里最常用的异步原语之一从延迟传送、定时刷怪到每日午夜结算技能冷却倒计时几乎都可以由openmw.async干净地实现。只要遵循可保存定时器先注册回调、参数保持可序列化、对象失活期间回调会积压这三点就能写出存档安全、行为可预期的异步逻辑。赞分享游戏开发图形学3D渲染【免费下载链接】openmwOpenMW is an open-source open-world RPG game engine that supports playing Morrowind. Main repo and issue tracker can be found here: https://gitlab.com/OpenMW/openmw/项目地址https://gitcode.com/gh_mirrors/op/openmw点击查看免费下载相关推荐Lark CLI 云文档 Memo/Brief 体裁契约让飞书文档 Agent 写出可决策、可核验的高层简报Lark CLI 云文档 Memo/Brief 体裁契约让飞书文档 Agent 写出可决策、可核验的高层简报 导读 在企业协同场景中「备忘录 / 简报」是最游戏开发图形学3D渲染DeerFlow 文件上传全链路解析API 端点、沙箱同步与 Agent 上下文注入机制DeerFlow 文件上传全链路解析API 端点、沙箱同步与 Agent 上下文注入机制 DeerFlow 后端为每个会话线程thread提供了线程隔离的人工智能大模型AI Agent自主智能体工具调用MCP 服务Agent 沙箱AI 技能后端前端ml5.js 异步编程指南Error-First Callback 与 Promise 双模式深度解析ml5.js 异步编程指南Error First Callback 与 Promise 双模式深度解析 导读 ml5.js 深受 p5.js 语法风格启发但人工智能机器学习深度学习计算机视觉NLP上一篇OpenAI重磅发布GPT OSS开放模型家族Hugging Face生态全面支持推理部署下一篇Midway.js 性能优化终极指南从代码到部署的10个高效调优技巧创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考