1.22

2021.04.08：版本号（v1.22 BE1.16.10）

• 重大更新

  1. 新增自定义场景，场景内支持以下元素： 1）摄像机 2）骨骼模型 3）序列帧与粒子特效 4）文字面板

     详见虚拟世界

  2. 常用的原版界面（例如：背包、熔炉、合成台、箱子）可挂接自定义控件，详见 原生界面修改文档 。

• 新增

1. 新增GetNativeScreenManagerCls，获得NativeScreenManager类

2. 新增GetCustomUIControlProxyCls，获得原生界面自定义UI代理基类

3. 新增SetHudChatStackVisible，设置HUD界面左上小聊天窗口可见性接口

4. 新增SetHudChatStackPosition，设置HUD界面左上小聊天窗口位置接口

5. 新增SpawnResourcesSilkTouched，模拟方块精准采集掉落

6. 新增GetDestroyTotalTime，获取使用物品破坏方块需要的时间

7. 新增GetOpenContainerItem，获取开放容器的物品

8. 新增GetRecipesByInput，通过输入物品查询配方

9. 新增SetEntityLookAtPos，设置非玩家实体看向某个位置

10. 新增AddActorAnimationController，增加生物渲染动画控制器

11. 新增RemoveActorAnimationController，移除生物渲染动画控制器

12. 新增AddPlayerParticleEffect，增加玩家特效资源

13. 新增AddActorParticleEffect，增加生物特效资源

14. 新增AddPlayerSoundEffect，增加玩家音效资源

15. 新增AddActorSoundEffect，增加生物音效资源

16. 新增AddPlayerAnimationIntoState，在玩家的动画控制器中的状态添加动画

17. 新增AddActorScriptAnimate，在生物的客户端实体定义（minecraft:client_entity）json中的scripts/animate节点添加动画/动画控制器

18. 新增AddActorAnimation，增加生物渲染动画

19. 新增isEntityInLava，获取实体是否在岩浆中

20. 新增isEntityOnGround，获取实体是否触地

21. 新增GetDestroyTotalTime，获取使用物品破坏方块需要的时间

22. 新增PlayTpAnimation，第三人称视角播放玩家通用动作

23. 新增StopAnimation，停止播放玩家通用动作

24. 新增GetRecipesByInput，通过输入物品查询配方

25. 新增LockLocalPlayerRot，在分离摄像机时，锁定本地玩家的头部角度

26. 新增SetPlayerLookAtPos，设置本地玩家看向某个位置

27. 新增VirtualWorldCreate，创建虚拟世界

28. 新增VirtualWorldDestroy，销毁虚拟世界

29. 新增VirtualWorldToggleVisibility，设置虚拟世界是否显示

30. 新增VirtualWorldSetCollidersVisible，设置虚拟世界中模型的包围盒是否显示

31. 新增CameraSetPos，设置相机位置

32. 新增CameraGetPos，返回相机位置

33. 新增CameraSetFov，设置相机视野大小

34. 新增CameraGetFov，获取相机视野大小

35. 新增CameraSetZoom，设置相机缩放

36. 新增CameraLookAt，修改相机朝向

37. 新增CameraMoveTo，设置相机移动动画

38. 新增CameraStopActions，停止相机移动动画

39. 新增CameraGetZoom，获取相机的缩放值

40. 新增CameraGetClickModel，获取相机当前指向的模型的id

41. 新增ModelCreateObject，在虚拟世界中创建模型

42. 新增ModelSetVisible，设置模型可见性

43. 新增ModelIsVisible，返回模型可见性

44. 新增ModelPlayAnimation，模型播放动画

45. 新增ModelSetBoxCollider，设置模型的包围盒

46. 新增ModelRemove，销毁模型

47. 新增ModelRotate，模型绕某个轴旋转多少度

48. 新增ModelSetPos，设置模型的坐标

49. 新增ModelGetPos，获取模型的坐标

50. 新增ModelSetRot，设置模型的旋转角度

51. 新增ModelGetRot，返回模型的旋转角度

52. 新增ModelSetScale，设置模型的缩放值

53. 新增ModelMoveTo，设置模型平移运动

54. 新增ModelRotateTo，设置模型旋转运动

55. 新增ModelStopActions，停止模型的移动和旋转运动

56. 新增MoveToVirtualWorld，把对象从主世界移到虚拟世界

57. 新增BindModel，对象绑定到模型上

58. 新增BindVirtualWorldModel，绑定虚拟世界中的模型

59. 新增UpdateScreen，刷新界面，重新计算各个控件的相关数据

60. 新增SetHighestY，设置绘制地图的最大高度

61. 新增SetLayer，外放SetLayer接口

62. 新增ZoomIn，放大地图

63. 新增SetHighestY，设置绘制地图的最大高度

64. 新增InventoryItemChangedServerEvent，玩家背包物品变化时的服务端事件

65. 新增CraftItemOutputChangeServerEvent，拿出生成物品时抛出的事件。

66. 新增OnRainLevelChangeServerEvent，下雨强度改变事件。

67. 新增OnLightningLevelChangeServerEvent，打雷强度改变事件。

68. 新增PlaySoundClientEvent，播放场景音效或UI音效事件

69. 新增PlayMusicClientEvent，播放背景音乐事件

70. 新增InventoryItemChangedClientEvent，玩家背包物品变化时的客户端事件

71. 新增TimeEaseType，时间变化类型

72. 新增VirtualWorldObjectType，虚拟世界对象类型

• 调整

1. 调整StartRecordPacket，添加仅支持租赁服与Apollo环境的说明

2. 调整StopRecordPacket，添加仅支持租赁服与Apollo环境的说明

3. 调整StartRecordEvent，添加仅支持租赁服与Apollo环境的说明

4. 调整StopRecordEvent，添加仅支持租赁服与Apollo环境的说明

5. 调整SetAttrValue，新增对AttrType.LAVA_SPEED的支持，可设置实体在岩浆中的移动速度

6. 调整GetAttrValue，新增对AttrType.LAVA_SPEED的支持，可获取实体在岩浆中的移动速度

7. 调整SetAttrMaxValue，新增对AttrType.LAVA_SPEED的支持，可设置实体在岩浆中的最大移动速度

8. 调整PlayerDestoryBlock，新增particle参数，用于设置是否开启破坏粒子效果,1:开启,0:关闭,默认为1

9. 调整SpawnResources，新增是否随机采集参数allowRandomness

10. 调整ChangeEntityDimension，该接口无法对玩家使用，玩家请使用ChangePlayerDimension

11. 调整CreateDimension，支持自定义维度的创建

12. 调整UpgradeMapDimensionVersion，增加使用时机限制的说明：建议仅在游戏启动初始化的时期调用

13. 调整GetItemBasicInfo，新增itemCategory,itemType,itemTierLevel字段

14. 调整SetPlayerRespawnPos，新增参数dimensionId，支持设置复活维度

15. 调整SetCameraPos，调整设置效果为不存档

16. 调整SetCameraOffset，调整设置效果为不存档

17. 调整SetCameraAnchor，调整设置效果为不存档

18. 调整SetCameraPitchLimit，调整设置效果为不存档

19. 调整GetItemBasicInfo，新增itemCategory,itemType,itemTierLevel字段

20. 调整SetVisible，添加说明可以设置componentPath为空字符串（""）调整整个JSON的显示/隐藏

21. 调整Clone，增加是否同步刷新参数

22. 调整SetVisible，添加说明可以通过传入空字符串（""）的方式来调整整个JSON的显示/隐藏

23. 调整WillTeleportToServerEvent，补完参数说明中缺失的部分

24. 调整OnNewArmorExchangeServerEvent，修改当装备为空时，关键字oldArmorDict、newArmorDict的内容说明

• 修复

1. 修复SetDisableDropItem，修复了禁止丢弃物品后仍可在容器内（如背包、箱子）丢弃物品的问题。

2. 修复SetDefaultGameType，修复了联机时可能不生效的问题

3. 修复GetGameRulesInfoServer，修复了always_day可能为错误值的问题

4. 修复AddBannedItem，修复禁用打火石后引燃TNT仍起效问题

5. 修复SetItemTierLevel，修复了等级3及以上时对哭泣的黑曜石无效的问题

6. 修复SetCameraRot，修复第一人称下无法设置相机转向问题

• 废弃（将在未来不可用）

1. 废弃HidePlayerName，该接口改名为HideNameTag

2. 废弃SetHurtBy，请使用SetAttackTarget

3. 废弃ResetHurtBy，请使用ResetAttackTarget

4. 废弃GetHurtBy，请使用GetAttackTarget

5. 废弃SpawnItemToPlayerOffHand，请使用接口SetEntityItem

6. 废弃SpawnItemToArmor，请使用SetEntityItem

7. 废弃isInLava，请使用isEntityInLava

8. 废弃isOnGround，请使用isEntityOnGround