Model

属性

DimensionUnit  DimensionUnit
模型尺寸

MaterialTemplate  MaterialType
材料类型

ModelAssetType  TextureId
设置模型的材质，即资源id

ColorQuad  Color
模型的颜色

ModelAssetType  ModelId
模型id，即资源id

float  Gravity
模型重力

float  Friction
模型摩擦力

float  Restitution
模型反弹力，比如物体撞击在地面上会根据此值来计算反弹高度

float  Mass
模型质量

Vector3  Velocity
模型移动速度

Vector3  AngleVelocity
模型角速度

Vector3  Size
模型的包围盒大小

Vector3  Center
模型的中心点所在世界坐标

bool  EnableGravity
模型是否支持重力

bool  Anchored
锚定状态，为true时此物体不受外部环境物理影响，但是会给外部提供物理输入。例如：有外来物体撞击到此物体，此物体不会产生移动，但是会对外来物体产生碰撞反弹力。

PhysicsType  PhysXType
物理类型

bool  EnablePhysics
开启此物体的物理状态。为true时物体的物理属性可以使用

bool  CanCollide
是否可以碰撞。设为false时为trigger状态

bool  CanTouch
是否触发碰撞回调函数：Touched和TouchEnded事件

int  CollideGroupID
int)，可以通过PhysXService:SetCollideInfo函数设置任意两个组之间是否会产生碰撞

CullLayer  CullLayer
消隐层

bool  IgnoreStreamSync
忽略流同步

bool  TextureOverride
材质贴图覆盖

bool  CastShadow
是否打开阴影

bool  CanRideOn
能否跟着走

bool  DrawPhysicsCollider
显示物理包围盒

bool  ReceiveShadow
是否接受投影

bool  CanBePushed
是否接受投影

bool  IsStatic
是否接受投影

bool  OutlineActive
是否激活描边

int  OutlineColorIndex

bool  Climbable
是否可被攀爬

成员函数

bool  PlayAnimation (string id, float speed, int loop)
播放动画

bool  PlayAnimationEx (string id, float speed, int loop, int priority, float weight)
播放动画Ex

bool  StopAnimation (string id)
停止动画

bool  StopAnimationEx (string id, bool reset)
停止动画Ex

bool  StopAllAnimation (bool reset)
停止所有动画

void  EnableAnimationEvent (bool enable)
开启或关闭动画事件

table  GetAnimationIDs ()
获取动画ID

int  GetAnimationPriority (int seqid)
获取动画优先级

void  SetAnimationPriority (int seqid, int value)
设置动画优先级

float  GetAnimationWeight (int seqid)
获取动画权重

void  SetAnimationWeight (int seqid, float value)
设置动画权重

table  GetBones ()
获取动画骨骼

void  SetBoneRotate (string boneName, Quaternion qua, float scale)
设置骨骼动画旋转

Vector3  AnchorWorldPos (int id, Vector3 offset)
获取锚点世界坐标（仅脚本可用）

bool  IsBinded (bool set)
是否绑定

void  AddForce (Vector3 force)
添加力

void  AddTorque (Vector3 torque)
添加扭矩

void  AddForceAtPosition (Vector3 force, Vector3 position, int mode)
添加力位置

void  SetMaterial (string skinMeshRenderCompName, string materialid, int index)
设置材质

int  SetMaterialNew (string meshRenderCompName, string materialid, int index, LuaFunction callback)
设置材质

SandboxNode  GetMaterialByNameOrIndex (string findKey, bool byName, bool isSkinMeshRender, int materialIndex)
获取材质节点

void  SetMaterialByNameOrIndex (string findKey, bool byName, bool isSkinMeshRender, int materialIndex, string resId, LuaFunction callback)
设置材质

SandboxNode  GetLegacyAnimation ()
获取骨骼动画

SandboxNode  GetAnimation ()
获取模型动画

SandboxNode  GetAttributeAnimation ()
获取属性动画

SandboxNode  GetSkeletonAnimation ()
获取骨骼动画

SandboxNode  GetHumanAnimation ()
获取人形动画

SandboxNode  GetAnimator ()
获取动画制作器

SandboxNode  GetMaterialInstance (table ids, uint32_t idx)
获取材料实例

bool  IsLoadFinish ()
是否加载完成

Vector3  GetRenderPosition ()
获取渲染位置

Quaternion  GetRenderRotation ()
获取渲染旋转

Vector3  GetRenderEuler ()
获取渲染欧拉角

SandboxNode  GetBoneNodeChildByName (SandboxNode parentBoneNode, string name)
通过节点名查询该骨骼节点对象

SandboxNode  GetBoneNodeByName (string name)
按名称获取骨骼节点

void  SetMaterialResId (string materialResId)
设置材质资源实例

0,1,2  GetLoadedResType ()
获取已经加载的资源类型

SandboxNode  GetAssetContent (table , AssetResType , int )

bool  SetAssetContent (SandboxNode , table , int )

SandboxNode  GetSnapShot ()

void  SetRenderersShadow (string , int , bool )

void  SetRendererShadow (table , int , bool )

table  GetAllTextureRefPaths ()
获取所有TextureRef路径

bool  IntersectRayPos (Ray 射线(Ray))
获取射线点中的模型的面

Vector3  GetIntersectRayPos ()

Vector2  GetIntersectRayUv ()

int  GetIntersectRayMaterialCount ()

SandboxNode  GetIntersectRayMaterial (int )

void  SetBonePostScale (string , Vector3 , unsignedchar )

void  SetBonePostPos (string , Vector3 , unsignedchar )

void  ClearBone (string )

void  SetBoneEffect (ReflexMap )

ReflexMap  GetBlendShapeInfo (string )

bool  SetBlendShapeWeight (string , int , float )

void  ShowBones (bool )

事件

SBXSignal  Touched (SandboxNode node, Vector3 pos, Vector3 normal)
模型被其他模型碰撞时，会触发一个Touched通知

SBXSignal  TouchEnded (SandboxNode node)
模型被其他模型碰撞结束时，会触发一个TouchEnded通知

SBXSignal  AnimationEvent (int a, int b)
模型触发动画事件时发送一个AnimationEvent通知

SBXSignal  AnimationFrameEvent (int a, constchar* b, int c)
动画帧事件触发

SBXSignal  LoadFinish (bool isFinish)
加载完成时触发事件

代码示例

--创建实例
local newModel= SandboxNode.new('Model')
--设置名字
newModel.Name = "my_model"
--设置模型
newModel.ModelId = string.format("sandboxAsset://entity/%s/body.omod","100010")
--设置位置
newModel.Position = Vector3.new(500,700,500)
--设置父节点 将模型节点添加到Workspace中
newModel:SetParent(Workspace)

--播放动画
local player = game:GetService("Players").LocalPlayer.Character
player:PlayAnimation("100114", 1.0, 0, 1, 1.0) --"100114 吃的动作"
player:StopAnimation("100114") --"100114 某个指定动作"