This translation is community contributed and may not be up to date. We only maintain the English version of the documentation. Read this manual in English
脚本组件允许您使用 Lua 编程语言 创建游戏逻辑。
Defold 中有三种类型的 Lua 脚本,每种脚本都有不同的 Defold 库可用。
Defold 将 Lua 脚本作为引擎生命周期的一部分执行,并通过一组预定义的回调函数暴露生命周期。当您将脚本组件添加到游戏对象时,该脚本成为游戏对象及其组件生命周期的一部分。脚本在加载时在 Lua 上下文中评估,然后引擎执行以下函数,并将对当前脚本组件实例的引用作为参数传递。您可以使用这个 self
引用在组件实例中存储状态。
self
是一个 userdata 对象,其行为类似于 Lua 表,但您不能使用 pairs()
或 ipairs()
对其进行迭代,也不能使用 pprint()
打印它。
init(self)
组件初始化时调用。
function init(self)
-- 这些变量在组件实例的整个生命周期中都可用
self.my_var = "something"
self.age = 0
end
final(self)
组件被删除时调用。这对于清理目的很有用,例如,如果您生成了应该在组件被删除时删除的游戏对象。
function final(self)
if self.my_var == "something" then
-- 进行一些清理
end
end
update(self, dt)
每帧调用一次。dt
包含自上一帧以来的增量时间。
function update(self, dt)
self.age = self.age + dt -- 使用时间步长增加年龄
end
fixed_update(self, dt)
与帧率无关的更新。dt
包含自上次更新以来的增量时间。当启用 engine.fixed_update_frequency
(!= 0)时调用此函数。当在 game.project 中启用 physics.use_fixed_timestep
时,如果您希望以固定间隔操作物理对象以实现稳定的物理模拟,这很有用。
function fixed_update(self, dt)
msg.post("#co", "apply_force", {force = vmath.vector3(1, 0, 0), position = go.get_world_position()})
end
当通过 msg.post()
将消息发送到脚本组件时,引擎会调用接收器组件的此函数。了解更多关于消息传递的信息。
function on_message(self, message_id, message, sender)
if message_id == hash("increase_score") then
self.total_score = self.total_score + message.score
end
end
on_input(self, action_id, action)
如果此组件已获取输入焦点(请参阅 acquire_input_focus
),则在注册输入时引擎会调用此函数。了解更多关于输入处理的信息。
function on_input(self, action_id, action)
if action_id == hash("touch") and action.pressed then
print("Touch", action.x, action.y)
end
end
on_reload(self)
当通过热重载编辑器功能(Edit ▸ Reload Resource)重载脚本时调用此函数。这对于调试、测试和调整目的非常有用。了解更多关于热重载的信息。
function on_reload(self)
print(self.age) -- 打印此游戏对象的年龄
end
带有脚本组件的游戏对象实现了一些逻辑。通常,该逻辑依赖于某些外部因素。敌人 AI 可能会对玩家位于 AI 一定半径内做出反应;门可能因玩家交互而解锁和打开,等等。
update()
函数允许您实现定义为每帧运行的状态机的复杂行为——有时这是足够的方法。但是每次调用 update()
都有关联的成本。除非您确实需要该函数,否则应该删除它,而是尝试以_反应式_方式构建您的逻辑。被动等待某些消息触发响应比主动探测游戏世界以获取要响应的数据更便宜。此外,以反应式方式解决设计问题通常也会导致更清洁、更稳定的设计和实现。
让我们看一个具体的例子。假设您希望脚本组件在初始化后 2 秒发送一条消息。然后它应该等待某个响应消息,并在收到响应后 5 秒再发送另一条消息。非反应式代码看起来像这样:
function init(self)
-- 用于跟踪时间的计数器
self.counter = 0
-- 我们需要这个来跟踪我们的状态
self.state = "first"
end
function update(self, dt)
self.counter = self.counter + dt
if self.counter >= 2.0 and self.state == "first" then
-- 2秒后发送消息
msg.post("some_object", "some_message")
self.state = "waiting"
end
if self.counter >= 5.0 and self.state == "second" then
-- 收到"response"后5秒发送消息
msg.post("another_object", "another_message")
-- 将状态设为nil,这样我们就不会再次到达这个状态块
self.state = nil
end
end
function on_message(self, message_id, message, sender)
if message_id == hash("response") then
-- "first"状态完成。进入下一个
self.state = "second"
-- 将计数器归零
self.counter = 0
end
end
即使在这个相当简单的情况下,我们的逻辑也变得相当复杂。借助模块中的协程(见下文)可以使这看起来更好,但让我们尝试使其成为反应式的并使用内置的计时机制。
local function send_first()
msg.post("some_object", "some_message")
end
function init(self)
-- 等待2秒然后调用send_first()
timer.delay(2, false, send_first)
end
local function send_second()
msg.post("another_object", "another_message")
end
function on_message(self, message_id, message, sender)
if message_id == hash("response") then
-- 等待5秒然后调用send_second()
timer.delay(5, false, send_second)
end
end
这更清洁,更容易理解。我们摆脱了在逻辑中通常难以跟踪的内部状态变量——这可能导致微妙的错误。我们还完全摆脱了 update()
函数。这使引擎免于每秒调用我们的脚本 60 次,即使它只是在空闲状态。
可以使用 Lua 预处理器和特殊标记根据构建变体有条件地包含代码。示例:
-- 使用以下关键字之一:RELEASE、DEBUG 或 HEADLESS
--#IF DEBUG
local lives_num = 999
--#ELSE
local lives_num = 3
--#ENDIF
预处理器作为构建扩展可用。在 GitHub 上的扩展页面 了解更多关于如何安装和使用它的信息。
Defold 编辑器支持带有语法着色和自动补全功能的 Lua 脚本编辑。要填写 Defold 函数名,请按 Ctrl+Space 弹出与您正在键入的内容匹配的函数列表。
Did you spot an error or do you have a suggestion? Please let us know on GitHub!
GITHUB