编程元件更新日志

1014更新

1. 新增接口：使用技能（UseSkill）。
2. 新增接口：获取技能名称（GetName）。
3. 新增接口：获取技能冷却（GetCD）。
4. 新增接口：获取技能当前冷却（GetCurrentCD）。
5. 新增接口：获取商品信息（GetGoodsInfo）。
6. 新增接口：Element类新增轨迹线功能相关接口5个（AddSpline、RemoveSpline、UpdateSplinePoints、UpdateSplineColor、SetSplineSpeed）。
7. 新增接口：UI类新增列表控件（ListView）相关接口5个，滚动列表控件（ScrollView）相关接口2个。
8. 新增接口：Setting类新增：是否切换至竖屏（SwitchToVerticalScreen）。
9. 新增接口：FakeCharacter类新增是否开启角色布娃娃效果（EnableRagdoll），是否开启角色全身物理模拟（EnableSimulatePhysics）等10个接口。
10. SetScale支持使用number类型作为参数。
11. GetTeamPlayerArray获取的玩家ID数组类型由字符串变更为number类型。
12. 设置玩家头像SetCustomHeadIcon，参数头像图片更改为number类型，可使用图片资源。
13. 修复了StartBehaviorTree失效的问题。
14. 修复了pause定时器后，获取定时器剩余时间结果错误的问题。

0930更新

1. 修复了UI:UIPositionToScreenPosition返回值类型是string的问题。
2. 修复了SetNativeUIVisible设置为显示时不生效的问题。

0918更新

1. 新增接口：设置动效是否循环播放（SetEffectLoop）。
2. 新增接口：获取图片原生尺寸（GetImageNativeSize）。
3. 新增接口：获取UI控件的名称（GetUIName）。
4. 新增接口：获取UI系统分辨率（GetUISize）。
5. 新增接口：设置生物模型（SetCreatureModel）。
6. 新增接口：停止元件运动表演（StopElementMotion）。
7. 新增接口：角色使用道具（UseProp）。
8. 新增接口：停止元件移动运动（StopMoveTo）。
9. 新增接口：停止元件旋转（StopRotateTo）。
10. 新增接口：停止元件缩放（StopScaleTo）。
11. 优化了元件类SpawnElement，尺寸参数支持number类型。
12. 优化了让元件圆周运动（CircularMotion），支持调整圆周运动旋转轴。
13. 修复了单人多场景切换场景后，主场景编程元件失效的问题。

0904更新

1. 音效类接口：部分旧接口暂时屏蔽，新增播放3D音效（PlaySFXAudio3DInTarget），播放2D音效（PlaySFXAudio2D），停止播放音效（StopSFXAudio）。
2. 新增接口：UI坐标转为屏幕坐标（UIPositionToScreenPosition）。
3. 新增接口：获取胶囊体内随机点（RandomPositionWithCapsule），获取球体内随机点（RandomPositionWithSphere），获取立方体内随机点（RandomPositionWithCube）。
4. 新增接口：获取相机朝向（GetForward）。
5. 新增接口：获取当前CPU时间（GetClock）。
6. 新增接口：打印服务端日志（PrintServerLog）。
7. 新增接口：获取定时器剩下的时间/帧数（GetTimerLeft），重启定时器（RestartTimer）。
8. 优化了部分接口的描述。
9. 原生控件枚举更新，新增拍照、游戏设置等枚举。
10. 设置目标指引图案（SetGuidePicture）支持使用自定义图片作为参数。
11. 修复了【当角色受伤前】和【当角色治疗前】事件，多人客户端未生效的问题。
12. 修复了Animation:PlayAnimSplice播放动画报错的问题。

0819更新

1. 新增接口：打开邀请好友界面（OpenMidJoinInvitePanel）。
2. 新增接口：设置自定义属性（SetCustomProperty、SetCustomPropertyArray）。
3. 元件预设中，可以获取到自定义预设元件的预设ID。
4. 新增接口：创建元件（SpawnElement）支持创建元件预设并且性能更好，SpawnElementWithTransform后续将不再维护。
5. 新增接口：获取元件的颜色（GetColor），设置元件皮肤（SetSkin），设置元件皮肤参数（SetSkinParams）。
6. 优化了API文档的部分接口描述。
7. 修复了多场景上传代码后退出草稿再重进地图，无法下载工程文件的问题。
8. 修复了仅子场景上传的按钮事件，切回主场景后按钮事件也会生效的问题。
9. 修复了设置自定义属性（图片素材）失效的问题。
10. 修复了获取指定层级UI（GetWidgetByLevel）与获取控件叠放顺序（GetWidgetZOrder）无法获取动效控件的值的问题。
11. 修复了控件锚点类型为按照轴时使用通过锚点参数改变控件的位置（SetPositionByAnchor）时会改变控件的形状大小的问题。
12. 修复了设置编组内控件大小在下次试玩时控件位置不一样的问题。
13. 修复了当玩家开始/结束语音聊天、当玩家开始/结束文本聊天事件在多场景下不生效的问题。
14. 修复了当接受任务事件（ON_TASK_ACCEPT），有时会不触发的问题。
15. 修复了当玩家分享成功事件（ON_SHARING_SUCCESS）传参类型不符的问题。
16. 修复了GetElementsInSphere返回值内会有string类型的问题。
17. 修复了Creature:GetCreatureInSphere和Creature:GetCreatureInCuboid联网客户端下未生效的问题。
18. 修复了将相机挂载到指定位置（BindOnWorldPositon）移动时会先重置位置的问题。
19. 修复了获取物品基础信息（GetItemInfo）返回部分物品的图标为nil的问题。
20. 修复了模组已知问题：不会触发相关触发盒事件、可视性设置无效、元件遮罩设置无效的问题。
21. 修复了设置元件可见性接口传入模组参数时，设置可见性失效的问题。
22. 修复了设置元件物理属性接口传入模组参数时有报错的问题。
23. 修复了创建的生物播放拼接动作，只播放拼接动作的第一个动作且不会循环的问题。

0807更新

1. 新增接口：设置按钮是否接收点击（SetHittable），设置所有按钮是否接收点击（SetAllHittable）。
2. 新增接口：对玩家弹出对话框（ShowDialogue）。
3. 新增接口：获取指定层级UI（GetWidgetByLevel）、设置控件叠放顺序（SetWidgetZOrder）、获取控件叠放顺序（GetWidgetZOrder）、设置锚点类型（SetAnchorType）、从屏幕坐标检测首个控件（CheckWidgetByScreenPosition）、让控件移动到指定位置（MoveTo）、设置控件允许拖动（SetDraggable）。
4. 新增接口：设置质量（SetMass），设置扑克牌（SetPoker）。
5. 优化接口：获取物品基础信息（GetItemInfo）支持获取图片类型ID了。

0724更新

1. 编程元件弹窗新增跳转至官方网站的链接。
2. 新增事件：当玩家发送聊天消息（Events.ON_SEND_MSG）。
3. 新增事件：当玩家购买商品成功（ON_SHOP_BUY_SUCCESS）。
4. 新增事件：当按钮按下（Events.ON_BUTTON_PRESSED）、当按钮松开（Events.ON_BUTTON_RELEASED）、当按钮拖动（Events.ON_BUTTON_MOVED）、当按钮点击（Events.ON_BUTTON_CLICKED）。
5. 新增控件动画相关接口：动效控件进行播放（EffectStartPlay）、动效控件暂停播放（EffectPausePlay）、动效控件恢复播放（EffectResumePlay）。
6. 自定义图片引用：现在编程元件，可以通过使用自定义属性来获取自定义图片的引用，并用于设置图片。相关接口：SetImage、SetProgressBackgroundImage、SetPictureBoardImage。
7. 新增物品相关接口：获取物品基础信息（GetItemInfo）、获取背包物品数量（GetItemCount）、获取背包所有物品（GetAllItem）、切换装备栏（SwitchEquipByIndex）。
8. 修复了获取球形区域内所有生物（GetElementInSphere）、获取长方体区域内所有生物（GetCreatureInCuboid）、获取触发盒中所有生物（GetCreatureInTrigger）返回的生物id组类型是string，非number的问题。
9. 修复了场景中存在多个编程元件的时候，编程元件脚本中的事件会触发多次的问题。
10. 修复了编程元件自定义控件组属性，保存为编组后，跨地图使用编组资源，自定义控件绑定失效的问题。
11. 修复了屏幕坐标转世界坐标（ScreenToWorld）无法返回正确的值的问题。
12. 修复了多场景地图多人测试时编程元件逻辑未生效的问题。
13. 修复了给生物添加道具（AddProp）失效的问题。
14. 修复了创建生物后创建元件附加到生物多人单人表现不一致的问题。
15. 修复了获取玩家属性值最大生命值返回值为0的问题。
16. 修复了游玩地图后再来一局时动态创建的元件会残留在游戏里的问题。

0710更新

1. 新增接口：设置元件是否进行客户端和服务端同步（SetReplicates）。
2. 优化接口：复制UI控件（DuplicateWidget），现在支持复制编组UI了。
3. 当玩家使用物品新增注意事项：目前仅在使用充电宝与自制物品时可以触发该事件。
4. 修复了编程元件lua脚本加载时的报错，在vscode下没有输出的问题。
5. 修复了当角色被创建ON_CHARACTER_CREATED传出参数playerId类型为string的问题。
6. 修复了给玩家添加物品（AddItem）在添加失败时没有返回0的问题。
7. 修复了复制出来的UI通过GetAnchoredPosition接口获取的坐标错误的问题。
8. 修复了UI处于编组内，控件设置大小无效问题。
9. 修复了带控件分享的编程元件，使用时不显示控件的问题。
10. 修复了带控件分享的编程元件，控件图层顺序有误的问题。
11. 修复了四元数设置元件旋转不生效的问题。

0624更新

1. 支持下载编程元件中的脚本文件。
2. 自定义属性取值接口，现在支持界面控件了。
3. 新增Lua接口：事件（Events）类新增”Events.ON_TASK_FINISH”。
4. 新增Lua接口：摄像机（Camera）类新增”ChangeShakeBlendTimeByIndex”与”GetRealPosition”。
5. 新增Lua接口：数学（UMath）类新增”SmoothLerp_Vector”等5个接口。
6. 新增Lua接口：其他服务（MiscService）类新增”Table2JsonStr”与”JsonStr2Table”，支持将数组与字符串相互转换。
7. 新增Lua接口：音乐（Music）类新增”GetMusicName”，支持获取音乐名字。
8. 新增Lua接口：控件（UI）类新增进度”SetProgressBackgroundOverlayColor”与”SetProgressOverlayColor”，支持改变进度条颜色。
9. 新增Lua接口：元件基础（Element）类新增”PartToWordPosition”。
10. 新增Lua接口：元件基础（Element）类新增”GetMotionCenter”，支持获取元件运动中心。
11. 新增Lua接口：商店（Shop）类新增”GetAllGodsInShop”，支持获取商店内全部商品ID。
12. 新增Lua接口：技能（Skill）类新增”UseRechargedAbility”等12个充能大招相关接口。
13. 优化了游玩交互（PlayInteractive）类中的射线检测相关接口，支持在试玩时绘制Debug射线。
14. 优化了控件（UI）类中的”DuplicateWidget”，现在复制出来的控件层级是放置到最上层。
15. 修复了多人游玩时”GetHomeowner”返回值错误的问题。
16. 修复了”SetMidJoinOpen”无效的问题。
17. 修复了”SetPlayerLeaveOB”多人失效的问题。
18. 部分列表新增一二级分类，更方便查找。
19. 充能大招列表新增”反弹护盾”。
20. 图片列表新增44条。
21. UI控件的进度条支持修改颜色和背景色。
22. 屏蔽了社交类、互动数值类及部分阵营积分相关API。

新增API列表：

类	接口	描述
Events	Events.ON_TASK_FINISH	当完成任务
Element	PartToWordPosition	将元件自身编辑中心坐标系中的相对坐标转化为世界坐标中的位置
Element	GetMotionCenter	获取元件运动中心位置
UMath	QuatSlerp	四元数的球面线性插值，会自动处理对齐保证插值走最短路径
UMath	SmoothLerp_Vector	平滑地将一个向量从当前值过渡到目标值
UMath	SmoothDamp_Vector	平滑地将一个向量从当前值过渡到目标值，带有阻尼效果
UMath	DegToRad	角度转弧度
UMath	RadToDeg	弧度转角度
Camera	GetRealPosition	获取相机真实位置
Camera	ChangeShakeBlendTimeByIndex	修改相机晃动信息索引对应的晃动混入混出时间
MiscService	Table2JsonStr	将table解析成json格式的字符串
MiscService	JsonStr2Table	将json格式的字符串还原成table
Music	GetMusicName	获取音乐名字
UI	SetProgressBackgroundOverlayColor	设置进度条背景叠加色
UI	SetProgressOverlayColor	设置进度条叠加色
Shop	GetAllGoodsInShop	获取商店中所有的商品ID
Skill	OpenRechargedAbilityUI	通知玩家打开充能大招选中界面
Skill	SetRechargedAbility	设置玩家当前充能大招
Skill	GetRechargedAbility	获取玩家当前充能大招
Skill	SetRechargedAbilityEnergy	设置玩家当前充能大招充能点数
Skill	GetRechargedAbilityEnergy	获取玩家当前充能大招充能点数
Skill	SetRechargedAbilityCostEnergy	设置玩家当前充能大招所需充能点数
Skill	GetRechargedAbilityCostEnergy	获取玩家当前充能大招所需充能点数
Skill	SetRechargedAbilityAddPreEnergy	设置玩家当前充能大招每秒增加多少充能点数
Skill	GetRechargedAbilityAddPreEnergy	获取玩家当前充能大招每秒增加多少充能点数
Skill	SetRechargedAbilityEnabled	设置玩家充能大招能否使用
Skill	UseRechargedAbility	玩家朝某方向释放充能大招
Skill	ClearRechargedAbility	清除玩家充能大招

0612更新

1. 修复了多场景地图多人测试时无Log信息打印的问题。
2. 修复了文档中的部分文字及描述错误。
3. 新增动画：毕业啦。

0529更新

1. 编程元件现在可以手动切换工程目录。
2. 编程元件现在支持自动同步，开启【是否自动更新】，在VSCode保存代码后会自动打包文件上传，可直接试玩观察变化。
3. 临时隐藏的事件除了5条事件其余API已重新开放。
4. 部分API新增关于使用所需开启设置的详细备注。
5. 新增Story类及1条API：PlayDialogue与1条剧情相关事件API。
6. 新增Task类及1条API：UpdateTaskProgress。
7. 新增GetSize等5条UI类API，支持获取控件尺寸、位置与转换坐标。
8. 新增FindChildWithName等4条UI类API，支持通过名字、索引或路径获取子控件id。
9. UI现在支持通过API播放UI动画，新增4条UI动画相关API，如：PlayUIAnimation、StopUIAnimation等。
10. 新增2条连线特效相关API：CreateChainParticle、UpdateChainParticle。
11. 新增1条Character类API：SetCharacterWithCreature。
12. Archive类中的HasPlayerData与GetPlayerData运行范围更改为仅服务端。
13. 屏蔽了Creature类中的CreatureAsPlayer。
14. 屏蔽了AICharacter类。
15. 图片列表新增53个图片对应的参数。
16. 新增5个特效。

0515更新

1. Animation类新增2条拼接动作相关API。
2. UI类新增19条API。
3. 新增Skill类及2条API。
4. 新增充能大招列表。

0429更新

1. 修复了网站中的部分文字错误。
2. 因部分参数需要调整，部分事件API临时隐藏，将在下次更新时重新开放。
3. 修复了PlayAnimAIGC播放视频动作无效的问题。
4. 修复了Character:SetScale；Character:Move等Character类api，联网服务端未生效的问题。
5. 修复了设置描边颜色Character:SetOutLineColor的问题。
6. Camera类新增了6条电影相机相关的API。
7. Setting类新增”是否显示开局倒计时”API。
8. 新增12条天空滤镜相关API及天空滤镜列表。
9. MiscService类新增两条日志相关API。
10. Creature类新增”设置生物最大血量”等4条API。
11. Damage新增”获取生物当前生命值”API。
12. Particle类新增2条连线特效相关API。
13. 新增PhysicsElement类及获取麻将花色与台球球号的API。
14. FuncElement类新增12条API。
15. 新增LogicElement类及9条API。
16. 新增Music类及7条API。

0417更新

1. 修复了网站中的部分错误。
2. Animation类运行范围更改为仅客户端。
3. 新增PublicDB和Social类。
4. PlayInteractive类新增射线检测相关API。
5. 以下是其他新增API：

类	接口	描述	运行范围
Character	SetCanUseInteractiveProp	设置角色互动道具使用权限	服务端、客户端
Character	SetCanUseInteractiveVehicle	设置角色载具使用权限	服务端、客户端
MiscService	SetQuitGameResult	设置玩家中途退出结算结果	服务端
MiscService	SetQuitGameText	设置玩家中途退出弹窗提示	服务端

6. 以下是新增枚举：

类	枚举	描述
MiscService	MiscService.EQuitGameTextType	中途退出弹窗提示文本类型

7. 以下API已修复：

类	接口	描述
Events	Events.ON_CREATURE_DESTROYED	当生物被销毁
Events	Events.ON_CREATURE_TAKE_DAMAGE	当生物受到伤害
Events	Events.ON_CREATURE_KILLED	当生物被击败

8. 带积木逻辑的地图中角色掉落后会触发两次销毁的BUG已修复。