跳到主要内容

其它对象

适用版本:中国版 3.10。仅中国版可用。

本文主要记录其它对象相关的接口,共 2 个。

网易官方文档

BindModel​

客户端

该接口只能在客户端脚本(mod.client.extraClientApi)中调用。
VirtualWorldCompClient

获取组件:clientApi.GetEngineCompFactory().CreateVirtualWorld(clientApi.GetLevelId())

把对象绑定到模型上, 支持绑定序列帧,粒子,文本和其它模型。

BindModel(
virtualWorldObjectType: int,
objId: int,
targetId: int,
posOffset: Tuple[float, float, float],
rotOffset: Tuple[float, float, float],
boneName: str,
) -> bool
  • virtualWorldObjectType: int,对象类型枚举, 支持 VirtualWorldObjectType.Sfx, VirtualWorldObjectType.Textboard 和 VirtualWorldObjectType.Particle, VirtualWorldObjectType.Model。
  • objId: int,要被绑定的对象的 id。
  • targetId: int,绑定到的目标对象的 id, 该对象删掉时,绑定在上面的对象也会删除。
  • posOffset: Tuple[float, float, float],绑定后相对目标的位置偏移。
  • rotOffset: Tuple[float, float, float],绑定后相对目标的旋转角度偏移。
  • boneName: str,要绑定到目标对象哪个骨骼,默认为 root。

返回值:bool,是否成功。

备注

  • 模型绑定模型暂时不支持绑定到具体骨骼。
  • 模型绑定仅支持原版模型绑定原版模型,或者网易骨骼模型绑定网易骨骼模型,不支持原版模型绑定到网易骨骼模型这种类型交错的绑定。
  • 序列帧,文本,粒子的生命周期与可见性需要玩家自己管理,虚拟世界在隐藏或者销毁时不做处理。

MoveToVirtualWorld​

客户端

该接口只能在客户端脚本(mod.client.extraClientApi)中调用。
VirtualWorldCompClient

获取组件:clientApi.GetEngineCompFactory().CreateVirtualWorld(clientApi.GetLevelId())

把对象从主世界移到虚拟世界, 非绑定的序列帧,文本,粒子需要调用该方法后才会出现在虚拟世界中,绑定的可以省略调用该方法。

MoveToVirtualWorld(virtualWorldObjectType: int, objId: int) -> bool
  • virtualWorldObjectType: int,对象类型枚举, 支持 VirtualWorldObjectType.Sfx, VirtualWorldObjectType.Textboard 和 VirtualWorldObjectType.Particle。
  • objId: int,要移动的对象的 id。

返回值:bool,是否成功。