Read this manual in English

集合工厂

集合工厂组件用于在游戏运行时创建一组保存于集合之中的嵌套的游戏对象.

Defold 提供了集合或者称为 “prefabs” 的可重用模板机制 . 关于集合概述, 请见 Defold 组成. 使用集合可以在编辑器, 或者在运行时动态插入游戏内容.

使用集合工厂可以依照一个集合文件向游戏世界插入内容. 这与游戏对象工厂的做法类似只不过集合工厂能创建一组含有父子嵌套层级关系的游戏对象. 典型用法比如动态生成一组敌人 (敌人对象和其武器对象的组合).

创建集合

假设有一个角色对象, 在它的子集有个盾牌对象. 我们就可以把这种含嵌套层级关系的组合保存为一个集合文件 “bean.collection”.

把 集合工厂 加入游戏对象然后设置其 原型 为 “bean.collection”:

这样只需调用 collectionfactory.create() 函数即可创建角色加盾牌的组合了:

local bean_ids = collectionfactory.create("#bean_factory")

此函数有5个参数:

url

要使用的集合工厂组件的id.

[position]

(可选) 新建游戏对象组合的世界坐标位置. 以 vector3 表示. 如果不指定位置, 默认位置是集合工厂所在游戏对象的位置.

[rotation]

(可选) 新创建游戏对象组合的世界坐标旋转. 以 quat 表示.

[properties]

(可选) 新创建游戏对象组合的 id-table 属性初始化 Lua 表. 关于此表结果见下文.

[scale]

(可选) 新创建游戏对象组合的等比缩放. 以 number (大于 0) 表示. 或者以 vector3 表示每个坐标轴上的非等比缩放.

collectionfactory.create() 返回一个包含每个新建对象id的表. 表的内容是集合内每个对象id对应运行时每个对象id:

local bean_ids = collectionfactory.create("#bean_factory")
go.set_scale(0.5, bean_ids[hash("/bean")])
pprint(bean_ids)
-- DEBUG:SCRIPT:
-- {
--   hash: [/shield] = hash: [/collection0/shield], -- <1>
--   hash: [/bean] = hash: [/collection0/bean],
-- }

1. 前缀 /collection[N]/ 中, [N] 是计数器, 以确保每个id的唯一性:

属性

创建集合的对象时, 可以把属性表作为参数传给集合工厂. 表里的键是对象id, 值是这个对象需要设置的属性表.

local props = {}
props[hash("/bean")] = { shield = false }
local ids = collectionfactory.create("#bean_factory", nil, nil, props)

假设 “bean.collection” 里的 “bean” 对象有一个叫 “shield” 的脚本属性. 关于脚本属性详情请见 脚本属性教程.

-- bean/controller.script
go.property("shield", true)

function init(self)
    if not self.shield then
        go.delete("shield")
    end     
end

工厂资源的动态加载

开启工厂属性的 Load Dynamically, 工厂资源将会被延迟加载.

关闭动态加载, 则加载集合工厂组件时会同时加载其需要的资源以便工厂可以尽快创建新游戏对象.

开启动态加载, 有两种用法:

同步加载

调用 collectionfactory.create() 函数创建新对象时. 资源会同步加载, 这意味着游戏可能会卡一下, 加载完成后再创建新对象.

function init(self)
    -- 集合工厂父级集合加载时
    -- 集合工厂资源不会被加载. 调用 create 函数
    -- 会把资源进行同步加载.
    self.go_ids = collectionfactory.create("#collectionfactory")
end

function final(self)  
    -- 删掉游戏对象, 资源引用计数减少
    -- 本例中集合工厂资源也会被卸载
    -- 因为集合工厂组件不包含对资源的引用.
    go.delete(self.go_ids)

    -- 因为集合工厂组件不包含对资源的引用
    -- 所以对集合工厂调用 unload 没有意义
    collectionfactory.unload("#factory")
end

异步加载

调用 collectionfactory.load() 函数进行资源的异步加载. 资源加载完毕后, 回调用回调函数.

function load_complete(self, url, result)
    -- 资源加载完成, 可以新建对象
    self.go_ids = collectionfactory.create(url)
end

function init(self)
    -- 集合工厂父级集合加载时
    -- 集合工厂资源不被加载. 调用 load 函数进行资源异步加载.
    collectionfactory.load("#factory", load_complete)
end

function final(self)
    -- 删掉游戏对象, 资源引用计数减少
    -- 本例中集合工厂资源不会被卸载
    -- 因为集合工厂组件包含对资源的引用.
    go.delete(self.go_ids)

    -- 调用 unload 函数, 集合工厂对资源引用被释放,
    -- 这样资源才会被卸载.
    collectionfactory.unload("#factory")
end

动态 prototype

可以通过点选集合工厂的 Dynamic Prototype 选项来更改它的 Prototype.

当 Dynamic Prototype 选项被选中, 则集合工厂组件就可使用 collectionfactory.set_prototype() 函数更改其原型. 例如:

collectionfactory.unload("#factory") -- 卸载之前的资源
collectionfactory.set_prototype("#factory", "/main/levels/level1.collectionc")
local ids = collectionfactory.create("#factory")