D01-局外资源与大厅商城
相关视频教程
【内秀刘】商城与货币局外资源
【一念天堂】局外商城使用上 【一念天堂】局外商城使用下 【了秋cc】局内外商城使用
【广告时间】做教程得贡献度，贡献度可提现可定制，可高倍率抵扣服务器成本，不知道做什么可以看悬赏单
局外资源
局外资源是游戏局外使用云变量记录数量的资源。使用局外资源可以实现游戏代币、付费礼包等货币和商品配置。
局外资源的类型
货币类型
配置局外商城所需的货币。每个货币类型局外资源必须配置对应的货币云变量名。
注意：人民币和星火币的兑换比例是1比10，请开发者合理设计游戏货币的数值。
凭证类型
凭证类型的局外资源可以简单理解为限时资源，在一定时间内有效，过期移除。在触发器中可以用『获取凭证剩余时间』语句查询该局外资源的剩余时间。
通行证类型
为通行证设计的局外资源类型， 此类型已废弃，解锁高级通行证使用自定义类型+通行证库触发语句，具体可见这篇文档
自定义类型
可以配置局外商城的商品等资源。获取该资源后，会执行自定义类型资源获取函数，可以在该函数中执行云变量相关操作。
配置局外资源
下面以货币型局外资源为例，简单介绍局外资源的配置方法。
- 在数据编辑器中点击齿轮，将隐藏的『局外资源』展示出来。
- 新建一个局外资源蓝图，选择局外资源模板，并取名为『火焰晶石』。
- 局外资源类型选择 『货币类型』 ，填写对应的货币云变量名，并且配置一下物品图标以及作为货币的小图标。
自定义类型资源获取函数
自定义类型的局外资源获取后，并不会对云变量产生任何影响，需要用户自行填写自定义类型资源获取函数 ，以改变想要修改的云变量，或执行其他逻辑。
在『自定义类型资源获取函数』中，默认带了一个 『云变量提交对象』。在该函数中，需要对玩家这个资源相关的云变量进行赋值（例：是否购买xxx），或是增加某种货币型云变量的值。这样在游戏局中就可以知道玩家已经获得或增加了该资源。
注意：云变量添加操作语句中，玩家和提交请求必须用参数提供的值，并且禁止提交任何云变量。
为什么我们要这么设计呢？
玩家购买了『火之高兴』后，（1）开发者修改了『是否购买火之高兴』，（2）并且商城模块将『火之高兴』添加给了玩家；但是（1）和（2）如果是依次执行的任务，就可能存在（1）成功，（2）不成功的情况，所以这里开发者不需要提交相关变更，我们会统一将（1+2）合并在一个云变量提交中提交，避免出现隐患。
大厅商城
大厅商城（局外商城）可以通过局外资源购买游戏内物品，一般用于实现氪金道具、礼包等需要充值付费的商品。
安装大厅商城库
在预制功能库中将右侧的『大厅商城-D01』拖到左侧，然后点击应用。
如何配置商城
本节以普通商品页为例，介绍如何配置商品页、资产等大厅商城配置项。
- 在数编的局外资源分类中新建商品蓝图，需要和商品一一对应。商品资源需要配置成自定义类型；货币资源配置成货币类型。
- 打开数编中任意数据-[大厅商城]商品列表，配置大厅商城的商品页。
①商品列表：商城中所有商品页的集合
②商品页节点：每一个商品页可以显示不同的商品，并配置不同的顶部货币资源条
③商品节点：需要展示的商品，可以配置限购次数和刷新时间
④局外资源：配置单个商品购买后获得的局外资源种类和数量
- 通过触发语句在游戏局内调出局外商城，或是在开发者中心中配置大厅局外商城模块，在大厅中调出局外商城。
如果需要在非编辑器环境中从局内调出商城，请确保上传项目后，在【大厅配置】里勾选了【进入游戏保留大厅局】
配置好的商城如图所示：
- 如果想要自定义资源稀有度的边框颜色和样式，需要在数编 [大厅通用资源]资源稀有度中配置。
注意： 四个表中的数据是对应关系，比如稀有度0对应的是白色（#FFFFFF）、品质框灰。
- 如果想在商城的首页配置活动页，请参考这篇文档
常用商城示例1：货币商品配置
- 需要将对应的MOD商品页节点勾选上『是否星火币商品页』
勾选后在商城的对应商品页右上角可以看到代币数量和快捷充值拉起按钮。
- 需要将对应的MOD商品节点勾选上『是否星火币』
勾选后对应的商品改为以对应游戏MOD货币购买，例如仙侠MOD的货币为『灵玉』，回响MOD的货币为『回响结晶』。
注意事项
建议的思路为设计一套自己的代币，用MOD货币来购买自己的代币，再用自己的代币消费。
原因：开发者无法为玩家补发游戏MOD货币，但是可以为玩家补发自己的代币。
这里以《十殿阎魔》为例，是采用灵玉（游戏MOD货币）兑换金铢（自己的代币）的逻辑：
常用商城示例2：随机物品盲盒的实现
自定义局外资源可以通过创建局外资源实例，实现随机物品盲盒，并可以在局外商城中购买使用。
- 默认情况下，自定义类型资源获取函数返回一个内容为空的数组，表示按正常逻辑返回成功，没有特殊处理：
- 如果有错误情况需要终止提交，需要返回空值，注意空值和内容为空的数组的区别。
这里会有空值显示红色感叹号的问题，可以忽视，但不要勾上返回值类型的（可为空）选项，否则会因为类型不符导致无法保存。
- 如果需要显示不同资源图标/数量，需要在数组中加入对应资源的配置，内容如下：
返回值中的资源只影响显示效果，因此实际云变量的值还需要自行处理添加逻辑，此处不建议使用【获得局外资源】语句，以免造成局外资源的递归获得（当然保证逻辑正确的情况下一定要用也可以用）
以商店为例，最终呈现出的效果如下：
