# 开发者常见问题
# 1.Block中的data在什么地方使用
data使用有具体需求,此处不建议开发者使用。开发者尽可能使用已封装过的没有data的新接口
# 2.自定义的Block和Item应该如何获取ID (或 data?)(用于 setBlock、spawnItem 等)
有两种办法可以获取到自定义类型的ID，<1>使用手持触发器去点击获取 <2>依赖相关的触发事件去打印ID 比如，如果是自定义的方块或者生物，可以将其放置在地图里然后用手持触发器去点击获取信息，也可以通过触发相关事件去打印出ID。 代码示例如下：
Callback_ClickBlock = function(event_args)
local blockid = event_args['blockid']
Chat:sendSystemMsg('点击的方块ID为'..blockid)
end
ScriptSupportEvent:registerEvent([=[Player.ClickBlock]=], Callback_ClickBlock)
# 4.Block 接口中的 setBlockAllForNotify/setBlockAllForUpdate 方法的参数 flag 需要更多信息
setBlockAllForNotify/setBlockAllForUpdate方法中的flag和data参数对开发者来说都是不可用的，新版wiki描述上已修正
# 5.ObjectLib 方法里的 uuid 该如何获取
目前开发者暂时没法直接获取到，我们会在下一版里迭代更新，详情请关注更新通知
# 6.World:playParticalEffect 方法的 particleId 参数需要更多信息
最新一期Wiki会放出particleId表，与触发器内的特效库同步
# 7.World:playSoundEffectOnPos 方法的 soundId 参数需要更多信息
最新一期Wiki会放出soundId表，与触发器内的音效库同步
# 8.World 类中可否提供一个获取有所有 Actor 的方法，或者历遍其的方法 (非 World:getActorsByBox)
由于游戏机制及效率考虑的原因，此功能不给予提供。但我们会提供触发器生物库的ActorId表
# 9.Event 需要更详细的用法及参数解释
Event即为开发者事件，是指玩家在游戏内进行了某些操作后触发的对应事件。比如玩家点击了某个方块， 这时就会触发玩家的点击方块事件，即名为"Player.ClickBlock"的事件，开发者只要注册监听该事件就能进行点击方块后的对应操作。 注册监听事件的方法如下：ScriptSupportEvent:registerEvent([=[Player.ClickBlock]=], function(event_args) ... end)。 而开发者事件在进行回调时会传回来一些对应的参数，每个开发者事件对应的参数可参考wiki中的事件系统部分。
# 10.UI 接口中的 setGBattleUI/setShapeLine/setShapeCircle 方法的参数 name 及 uiname 需要更多信息
1)setGBattleUI方法的参数name是string类型的枚举值，可选值有如下几种情况:
| name | value type | value describe |
|---|---|---|
| 'left_title' | string | 左标题（第1） |
| 'right_title' | string | 右标题（/40） |
| 'left_desc' | string | 左描述（大吉大利，我是第一） |
| 'left_little_desc' | string | 左简述（排名1） |
| 'right_little_desc' | string | 右简述（战胜4） |
| 'battle_btn' | boolean | 比分导航栏面板按钮显示 |
| 'result' | boolean | 比赛结果显示 |
| 'result_bkg' | boolean | 比赛结果底板显示 |
| 'reopen' | boolean | 再来一局按钮显示 |
2)setShapeLine及setShapeCircle这两个接口目前暂时无效果，可不用理会。后面自定义用户界面(Custom UI)完成后可将其替代
# 11.UI:ShowScreenEffect 方法的 type 需要更多信息
该接口是用于显示屏幕特效，其中type的值为1表示speedline，2表示powerline，3表示fog
# 12.Game:addRenderGlobalEffect 方法的 path 参数需要更多信息
path即为全局特效的路径，目前可用的是path只有"particles/Fog.ent"，详情可参考范例集合里面给出的例子
# 13.Game:getDefString 方法的 id 需要更多信息
不提倡开发者使用上述接口，鼓励开发者使用自己定义的字符串
# 14.Player:setActionAttrState 方法的 actionattr 参数需要更多信息
setActionAttrState是设置玩家特殊属性的状态(例如可移动、可攻击等)的接口，actionattr参数可参考PLAYERATTR_ENABLE
# 15.Team 接口中的 teamid 参数需要更多信息
目前我们游戏中最多支持六个队伍，六个队伍的ID及颜色对应如下：
| 队伍 | 对应颜色 | TeamID |
|---|---|---|
| 队伍1 | 红色 | 1 |
| 队伍2 | 蓝色 | 2 |
| 队伍3 | 绿色 | 3 |
| 队伍4 | 黄色 | 4 |
| 队伍5 | 橙色 | 5 |
| 队伍6 | 紫色 | 6 |
| 观战队 | 无 | 999 |
Team相关接口中，可以teamid使用-1表示全部队伍。玩家或生物如果不设置队伍的话默认teamid是为0，也是无队伍的一种
# 16.appendSpeed 接口中的x,y,z参数信息
该接口的参数x,y,z表示设定一个移动距离，需要传入整数。
案例：假设把Z设定为5，当执行一次该接口后，那么objid就会向+z轴移动5格的距离
写法：appendSpeed(objid,0,0,5)
# 17.getBlockPowerStatus 接口中的pos的使用方法
假设想判断坐标为（7、7、7）位置的方块通电状态，
正确的写法：
local pos = {x=7,y=7,z=7}
Block:getBlockPowerStatus(pos)
常见错误写法：
local pos = {7,7,7}
Block:getBlockPowerStatus(pos)