Extends

• THING.Object3D

Members

active :boolean

thing/src/objects/Object3D.js, line 1993

激活状态主要影响可见性,类似与控制节点的可见性,与visible的区别是：
父物体active为false,孩子的active为true,孩子不可见
父物体visible为false,孩子的visible为true,孩子可见

Overrides:

• THING.Object3D#active

Example

let box = new THING.Box();
	let box2 = new THING.Box({parent: box});
	box.active = false;
	// @expect(box2.active == true);
	// @expect(box.active == false);

alwaysOnTop :boolean

thing/src/objects/Object3D.js, line 3140

设置/获取 是否开启渲染置顶

Overrides:

• THING.Object3D#alwaysOnTop

Example

// Keep object render as the top of render layer
object.alwaysOnTop = true;

angles :Array.<number>

thing/src/objects/Object3D.js, line 4185

设置/获取 世界坐标系下的旋转角度欧拉角（'XYZ'），单位为 degree（度）。

Overrides:

• THING.Object3D#angles

animationNames :Array.<string>

thing/src/objects/BaseEntity.js, line 139

获取资源自带的所有动画名称

Example

var UinoSpaceman = new THING.Entity({url:'.assets/models/UinoSpaceman/UinoSpaceman.gltf'});
UinoSpaceman.waitForComplete().then(() => {
  let animations = UinoSpaceman.animationNames;
  let ret = animations[0] == 'Walk';
	 // @expect(ret == true);
});

animations :Array.<AnimationResult>

thing/src/objects/BaseEntity.js, line 125

获取资源自带的所有动画信息

Example

var UinoSpaceman = new THING.Entity({url:'.assets/models/UinoSpaceman/UinoSpaceman.gltf'});
UinoSpaceman.waitForComplete().then(() => {
  let animations = UinoSpaceman.animations;
  let ret = animations[0].name == 'Walk';
	 // @expect(ret == true);
});

app :THING.App

thing/src/objects/BaseObject.js, line 800

获取app对象

Overrides:

• THING.Object3D#app

Example

let object = new THING.BaseObject();
let app = object.app;
let ret = app == THING.App.current;
// @expect(ret == true)

body :THING.BodyObject

thing/src/objects/Object3D.js, line 2777

获取body对象 body对象可以理解这个对象自身,不包含它的孩子.

Overrides:

• THING.Object3D#body

boundingBox :THING.Box3

thing/src/objects/Object3D.js, line 3503

获取世界坐标系下的包围盒数据 等同于getAABB(true,true,false)

Overrides:

• THING.Object3D#boundingBox

Example

let boundingBox = object.boundingBox;
	if (boundingBox.halfSize[1] > 100) {
		console.log('The object is so tall');
	}

brothers :THING.Selector

thing/src/objects/BaseObject.js, line 2326

获取兄弟节点(同级节点)

Overrides:

• THING.Object3D#brothers

Example

let box1 = new THING.Box();
	let box2 = new THING.Box({parent: box1});
	let box3 = new THING.Box({parent: box1});
	let brothers = box3.brothers;
 // @expect(brothers.length == 1);

children :THING.Selector

thing/src/objects/BaseObject.js, line 2341

获取孩子

Overrides:

• THING.Object3D#children

Example

let object = new THING.BaseObject();
let child= new THING.BaseObject({parent: object});
let children = object.children;
let ret = children.length == 1;
// @expect(ret == true)

collider :ColliderComponent

thing/src/objects/Object3D.js, line 1500

物体的碰撞检测组件

Overrides:

• THING.Object3D#collider

readonly components :Map.<String, THING.BaseComponent>

thing/src/components/BaseComponentGroup.js, line 873

获取所有组件

Overrides:

• THING.Object3D#components

Example

let obj = new THING.BaseObject();;
obj.addComponent(new THING.BaseComponent(), 'component1');
obj.addComponent(new THING.BaseComponent(), 'component2');
// @expect(obj.components.size == 2)

destroyable :boolean

thing/src/objects/BaseObject.js, line 1182

设置/获取 对象是否可以被销毁

Overrides:

• THING.Object3D#destroyable

Example

let object = new THING.BaseObject();
object.destroyable = true;
// @expect(object.destroyable == true)

dtType :string

thing/src/objects/BaseObject.js, line 826

设置/获取 孪生体类型

Overrides:

• THING.Object3D#dtType

Example

let object = new THING.BaseObject();
object.dtType = 'Equipment';
// @expect(object.dtType == 'Equipment')

events :Array.<ObjectListenerInfo>

thing/src/objects/BaseObject.js, line 1752

获取当前对象注册的所有事件监听器的详细列表。该属性返回一个 ObjectListenerInfo 类型的数组，每一项包含一个事件监听器的全部信息。ObjectListenerInfo 格式参考（常用字段如下）：- name: 事件名称（一般为小写，如 "click", "update", "mouseenter" 等）- callback: 回调函数，事件触发时调用- context: 回调函数的上下文对象- once: 是否为一次性监听（只会触发一次，之后移除）- filter: 事件过滤函数（可选）- id: 事件监听唯一标识（可选）- other: 可能包含的其他参数或元数据

Overrides:

• THING.Object3D#events

Example

let object = new THING.BaseObject();
object.on('click', function() { console.log('clicked'); });
// 获取所有事件监听器
let allEvents = object.events;
// @expect(Array.isArray(allEvents));
// @expect(allEvents.length >= 0);
// allEvents 结果类似：
// [{
//   name: 'click',
//   callback: ƒ,
//   context: object,
//   once: false,
//   filter: undefined,
//   id: 1
// }, ...]

frustumCulled :boolean

thing/src/objects/Object3D.js, line 2005

获取/设置视锥剔除状态。

Overrides:

• THING.Object3D#frustumCulled

helper :THING.HelperComponent

thing/src/objects/Object3D.js, line 1455

辅助组件 可显示坐标轴等

Overrides:

• THING.Object3D#helper

id :string

thing/src/objects/BaseObject.js, line 871

设置/获取 物体id

Overrides:

• THING.Object3D#id

Example

let object = new THING.BaseObject();
object.id = 'DEVICE_007';
// @expect(object.id == 'DEVICE_007')

ignoreParentTransform :THING.Transform

thing/src/objects/Object3D.js, line 4300

获取/设置是否忽略父物体的变换

Overrides:

• THING.Object3D#ignoreParentTransform

Example

object.ignoreParentTransform = THING.Transform.Rotation | THING.Transform.Scale;

inherit :InheritData

thing/src/objects/Object3D.js, line 1903

获取继承信息

Overrides:

• THING.Object3D#inherit

Example

object.inherit.style = THING.InheritType.Jump;
	object.inherit.visible = THING.InheritType.Break;
	object.inherit.pickable = THING.InheritType.Stop;

isDynamicLoad :string

thing/src/objects/Object3D.js, line 1574

设置/获取 对象为动态加载

Overrides:

• THING.Object3D#isDynamicLoad

Default Value:

• false

Example

object.isDynamicLoad = true;

isFlying :boolean

thing/src/objects/Object3D.js, line 3627

获取飞行状态

Overrides:

• THING.Object3D#isFlying

keepSize :boolean

thing/src/objects/Object3D.js, line 2050

是否自适应大小(缩放时保持像素级别大小不变)

Overrides:

• THING.Object3D#keepSize

Example

let keepSize = object.keepSize;
	if (keepSize) {
		console.log('object is keep size to render');
	}

keepSizeUseBodyLocalScale :boolean

thing/src/objects/Object3D.js, line 4290

获取/设置 keepSize 时是否使用 body.localScale（true）而不是 object.localScale（false，默认）。

Overrides:

• THING.Object3D#keepSizeUseBodyLocalScale

Default Value:

• false

Example

// 使用 body.localScale 来保持大小
object.keepSizeUseBodyLocalScale = true;
object.keepSize = true;

layerMask :number

thing/src/objects/Object3D.js, line 1623

取/设置遮罩层（LayerMask）。默认值为 1。通过"按位与"的计算，来判定物体在指定摄像机中的layerMask的值。

Overrides:

• THING.Object3D#layerMask

Example

// Hide object by changing layer mask
object.layerMask = 0;

lerp :THING.LerpComponent

thing/src/objects/Object3D.js, line 1463

物体的插值组件(可控制属性动态的修改)

Overrides:

• THING.Object3D#lerp

level :THING.LevelComponent

thing/src/objects/Object3D.js, line 1478

物体的层级组件

Overrides:

• THING.Object3D#level

localAngles :Array.<number>

thing/src/objects/Object3D.js, line 4143

设置/获取 相对于父物体坐标系的旋转角度欧拉角（'XYZ'），单位为 degree（度）。

Overrides:

• THING.Object3D#localAngles

localPosition :Array.<number>

thing/src/objects/Object3D.js, line 4134

设置/获取 相对于父物体坐标系的位置(偏移)

Overrides:

• THING.Object3D#localPosition

localQuaternion :Array.<number>

thing/src/objects/Object3D.js, line 4160

设置/获取 相对于父物体坐标系的四元数

Overrides:

• THING.Object3D#localQuaternion

localRotation :Array.<number>

thing/src/objects/Object3D.js, line 4152

等同于localAngles欧拉角（'XYZ'），单位为 degree（度）。

Overrides:

• THING.Object3D#localRotation

localScale :Array.<number>

thing/src/objects/Object3D.js, line 4168

设置/获取 父物体坐标系下的缩放

Overrides:

• THING.Object3D#localScale

name :string

thing/src/objects/Object3D.js, line 1557

设置/获取 对象名称

Overrides:

• THING.Object3D#name

Example

object.name = 'MyObject';

orientedBox :OrientedBoxResult

thing/src/objects/Object3D.js, line 3515

获取旋转后的包围盒数据 包围盒坐标轴一般是物体自身坐标轴 等同于getOBB(true,true,false)

Overrides:

• THING.Object3D#orientedBox

Example

let orientedBox = object.orientedBox;
	if (orientedBox.angles[1] > 0) {
		console.log('The object has rotated by Y-axis');
	}

parent :THING.BaseObject

thing/src/objects/BaseObject.js, line 2268

设置/获取 父物体

Overrides:

• THING.Object3D#parent

Example

let parent = new THING.BaseObject();
 let child = new THING.BaseObject({parent: parent});
	let ret = child.parent == parent;
	// @expect(ret == true);

parents :THING.Selector

thing/src/objects/BaseObject.js, line 2311

获取所有的祖先(父物体,父物体的父物体等,直到查询到根节点--app.root)

Overrides:

• THING.Object3D#parents

Example

let box1 = new THING.Box();
	let box2 = new THING.Box({parent: box1});
	let parents = box2.parents;
 // @expect(parents.length == 2);

pickable :boolean

thing/src/objects/Object3D.js, line 1961

获取/设置可拾取状态。此属性操作会影响自身以及所有子对象。

Overrides:

• THING.Object3D#pickable

Example

let object = new THING.Box();
	object.pickable = false;

pivot :Array.<number>

thing/src/objects/Object3D.js, line 2068

获取/设置轴心点信息。轴心点参考原点为自身包围盒的 [left, bottom, back] 的位置。数组每个分类的取值为0-1

Overrides:

• THING.Object3D#pivot

Example

// Make object origin to [right, top, front] position
	object.pivot = [1, 1, 1];

position :Array.<number>

thing/src/objects/Object3D.js, line 4176

设置/获取 世界坐标系下的位置

Overrides:

• THING.Object3D#position

quaternion :Array.<number>

thing/src/objects/Object3D.js, line 4202

设置/获取 世界坐标系下的四元数

Overrides:

• THING.Object3D#quaternion

queryable :boolean

thing/src/objects/BaseObject.js, line 1202

设置/获取 对象是否可以被查询

Overrides:

• THING.Object3D#queryable

Example

let object = new THING.BaseObject();
object.name = 'Hidden';
let ret = app.query('Hidden');
// @expect(ret[0].name = 'Hidden')
object.queryable = false;
ret = app.query('Hidden');
// @expect(ret.length = 0)

relationships :Array.<THING.Relationship>

thing/src/objects/BaseObject.js, line 2297

设置/获取 关系

Overrides:

• THING.Object3D#relationships

Example

let object = new THING.Object3D();
let source = new THING.Object3D();
let target = new THING.Object3D();
let relationship = new THING.Relationship({
     type: 'control',
     source: source,
     target: target
});
object.addRelationship(relationship);
let ret = object.relationships[0].type == 'control';
// @expect(ret == true)

renderOrder :number

thing/src/objects/Object3D.js, line 3109

获取/设置渲染顺序，绘制顺序从低到高。

Overrides:

• THING.Object3D#renderOrder

rotation :Array.<number>

thing/src/objects/Object3D.js, line 4194

等同于angles欧拉角（'XYZ'），单位为 degree（度）。

Overrides:

• THING.Object3D#rotation

scale :Array.<number>

thing/src/objects/Object3D.js, line 4210

设置/获取 世界坐标系下的缩放

Overrides:

• THING.Object3D#scale

style :THING.Style

thing/src/objects/Object3D.js, line 2399

获取/设置样式

Overrides:

• THING.Object3D#style

Example

let style = object.style;
	style.color = 'red';
	style.opacity = 0.1;

styleTag :string

thing/src/objects/Object3D.js, line 1637

样式标签

Overrides:

• THING.Object3D#styleTag

tags :Set.<string>

thing/src/objects/BaseObject.js, line 917

设置/获取 物体标签

Overrides:

• THING.Object3D#tags

Example

// Get tags
	let tags = object.tags;
 console.log(tags);

 // Set tags by array
 object.tags = ['one','two','three'];

 // Set tags by set
 object.tags = new Set(['one','two','three']);

type :string

thing/src/objects/BaseObject.js, line 813

获取类型

Overrides:

• THING.Object3D#type

Example

let object = new THING.BaseObject();
let type = object.type;
// @expect(type == 'BaseObject')

userData :object

thing/src/objects/BaseObject.js, line 948

设置/获取 物体的自定义属性

Overrides:

• THING.Object3D#userData

Example

let object = new THING.BaseObject();
object.userData['Notebook'] = {
	name: 'FlyingCar',
	price: 100
};
let name = object.userData['Notebook'].name;
// @expect(name == 'FlyingCar')
let price = object.userData['Notebook'].price
// @expect(price == 100)

uuid :string

thing/src/objects/BaseObject.js, line 890

设置/获取 物体的唯一标识

Overrides:

• THING.Object3D#uuid

Example

let object = new THING.BaseObject({uuid: 10000});
// @expect(object.uuid == 10000)
object.uuid = THING.Math.generateUUID();
// @expect(object.id != 10000)

visible :boolean

thing/src/objects/Object3D.js, line 1937

获取/设置显示状态，此属性操作会影响自身以及所有子对象。

Overrides:

• THING.Object3D#visible

Example

let object = new THING.Box();
	// @expect(object.visible == true)
	object.visible = false;
	// @expect(object.visible == false)

Methods

add(object, options) → {boolean}

thing/src/objects/Object3D.js, line 2147

添加对象作为自己的孩子

Parameters:

Name	Type	Description
object	THING.Object3D	待添加对象
options	object	选项 Properties Name Type Attributes Default Description subNodeName string 子节点名称 localPosition Array.<number> 相对父物体的位置 localAngles Array.<number> 相对父物体的旋转角度 attachMode boolean <optional> true 表示是否保持世界坐标系下的位置不变 ignoreScale boolean <optional> false 是否忽略缩放 indexOfParent boolean <optional> 对象在子节点中的索引

Returns:

boolean - 添加成功返回true，否则返回false

Overrides:

• THING.Object3D#add

Example

// Keep local transform of box to be added to object
	object.add(new THING.Box({ localPosition: [0, 10, 0]}), { attachMode: false });

addComponent(component, name, args?) → {boolean}

thing/src/components/BaseComponentGroup.js, line 388

添加组件

Parameters:

Name	Type	Description
component	THING.BaseComponent | object	组件对象类名或者组件对象实例
name	string	组件名称
args?	object	初始化具体组件的参数对象 如果第一个参数是一个类名而不是一个实例,添加时会根据初始化参数和类名创建一个组件实例

Returns:

boolean - 是否成功 如果给obj添加了一个name为myComponent的组件,添加成功后,可通过obj.myComponent获取该组件对象

Overrides:

• THING.Object3D#addComponent

Example

let obj = new THING.BaseObject();;
obj.addComponent(new THING.BaseComponent(), 'myComponent');
// @expect(obj.myComponent != null)

bindSubNode(target, subNodeName) → {boolean}

thing/src/objects/Object3D.js, line 4841

绑定子节点，绑定后将自动根据子节点更新世界坐标。绑定后位置、角度和缩放会锁定。

Parameters:

Name	Type	Description
target	THING.Object3D	目标对象。
subNodeName	string	子节点名称。

Returns:

boolean - 是否绑定成功。

Overrides:

• THING.Object3D#bindSubNode

Example

let box = new THING.Box();
	box.bindSubNode(car, 'chair');

blendAnimation(param) → {void}

thing/src/objects/BaseEntity.js, line 194

播放动画,播放时不会影响该物体正在播放的其他动画

Parameters:

Name	Type	Description
param	PlayAnimationArgs	动画播放参数

Returns:

void - 无返回值

Example

var UinoSpaceman = new THING.Entity({url:'.assets/models/UinoSpaceman/UinoSpaceman.gltf'});
UinoSpaceman.waitForComplete().then(() => {
  UinoSpaceman.blendAnimation({ name: 'Walk', loopType: "Repeat" });
  let ret = UinoSpaceman.isAnimationPlaying('Walk');
  // @expect(ret == true);
});

clone(recursive, parent, options) → {THING.Object3D}

thing/src/objects/Object3D.js, line 2455

克隆对象

Parameters:

Name	Type	Description
recursive	boolean	是否克隆所有的孩子
parent	THING.BaseObject	指定克隆出的对象父物体 默认用app.root作为父物体
options	object	选项

Returns:

THING.Object3D - 克隆出来的物体

Overrides:

• THING.Object3D#clone

Example

// Clone the object and move up
	let otherObject = object.clone();
	otherObject.translateY(10);

copy(object, options) → {Promise.<any>}

thing/src/objects/Object3D.js, line 2846

拷贝对象(不拷贝uuid和parent),拷贝对象会重新加载资源

Parameters:

Name	Type	Description
object	THING.BaseObject	源对象
options	object	选项

Returns:

Promise.<any> - 返回一个Promise对象

Overrides:

• THING.Object3D#copy

Example

// 从查询结果拷贝对象
	let sourceObject = app.query('#master')[0];
	if (sourceObject) {
		object.copy(sourceObject);
	}

destroy() → {boolean}

thing/src/objects/BaseObject.js, line 1143

销毁物体

Returns:

boolean - 返回一个布尔值，表示是否销毁成功

Overrides:

• THING.Object3D#destroy

Example

let object = new THING.BaseObject();
// @expect(object.destroyed == false);
object.destroy();
// @expect(object.destroyed == true)

disableInstancing() → {boolean}

thing/src/objects/Object3D.js, line 3274

禁用实例化节点。

Returns:

boolean - 是否禁用成功

Overrides:

• THING.Object3D#disableInstancing

Example

// 禁用实例化渲染
object.disableInstancing();

distanceTo(target) → {number}

thing/src/objects/Object3D.js, line 2031

获取距离另一个Object3D对象或者一个三维坐标的距离

Parameters:

Name	Type	Description
target	THING.Object3D | Array.<number>	目标物体或者世界坐标

Returns:

number - 距离

Overrides:

• THING.Object3D#distanceTo

Example

let distance = object.distanceTo([0, 10, 0]);
	if (distance > 5000) {
		console.log('object is so far from specified position');
	}

enableInstancing(options) → {Promise.<boolean>}

thing/src/objects/Object3D.js, line 3264

启用实例化节点（启用后将使主体节点不可见）。

Parameters:

Name	Type	Description
options	InstancingNodeOptions	选项。

Returns:

Promise.<boolean> - 是否启用成功

Overrides:

• THING.Object3D#enableInstancing

Example

// 启用实例化渲染,设置最大数量为31104个实例
object.enableInstancing({
  maxNumber: 31104,
  number: 0,
  matrices: [], // 包含所有实例的变换矩阵
  pickedIds: pickedIds, // 可选,包含所有实例的拾取ID
  colors: colors // 可选,包含所有实例的颜色
});

fadeIn(param)

thing/src/objects/Object3D.js, line 3920

对象渐现

Parameters:

Name	Type	Description
param	LerpArgs	The parameters. 插值参数

Overrides:

• THING.Object3D#fadeIn

Example

object.fadeIn({
  duration: 2000,
  onComplete: () => {
    console.log('Fade in completed');
  }
});

fadeInAsync(param) → {Promise}

thing/src/objects/Object3D.js, line 3946

异步将对象渐现。

Parameters:

Name	Type	Description
param	LerpArgs	The parameters. 插值参数

Returns:

Promise - 一个在渐现完成时解析的承诺。

Overrides:

• THING.Object3D#fadeInAsync

Example

await object.fadeInAsync({
  duration: 2000
});

fadeOut(param)

thing/src/objects/Object3D.js, line 3934

对象渐隐

Parameters:

Name	Type	Description
param	LerpArgs	The parameters. 插值参数

Overrides:

• THING.Object3D#fadeOut

Example

object.fadeOut({
  duration: 2000,
  onComplete: () => {
    console.log('Fade out completed');
  }
});

fadeOutAsync(param) → {Promise}

thing/src/objects/Object3D.js, line 3958

异步将对象渐隐。

Parameters:

Name	Type	Description
param	LerpArgs	The parameters. 插值参数

Returns:

Promise - 一个在渐隐完成时解析的承诺。

Overrides:

• THING.Object3D#fadeOutAsync

Example

await object.fadeOutAsync({
  duration: 2000
});

fit(param) → {boolean}

thing/src/objects/Object3D.js, line 4055

根据目标对象计算最佳位置 一般用于调整摄像机最佳视角
注意参数中 times 和 duration 不起作用

Parameters:

Name	Type	Description
param	THING.BaseObject | LerpFlyToArgs	可传入BaseObject或参数

Returns:

boolean - 是否计算成功

Overrides:

• THING.Object3D#fit

Example

app.camera.fit(otherTarget);

flyTo(param) → {boolean}

thing/src/objects/Object3D.js, line 4030

物体在特定时间内飞行到特定位置

Parameters:

Name	Type	Description
param	THING.BaseObject | LerpFlyToArgs	可传入BaseObject或飞行参数

Returns:

boolean - 是否飞行成功

Overrides:

• THING.Object3D#flyTo

Example

object.flyTo(baseObject);//飞到物体

	object.flyTo({
		target: otherTarget,
		horzAngle: 0,
		vertAngle: 45
	});

	object.flyTo({
		position: [0,10,0],
   target:[0,0,0],
		up:[0,0,1]
	});

getAABB(recursiveopt, updateMatrixopt, localopt) → {THING.Box3}

thing/src/objects/Object3D.js, line 3536

获取包围盒

Parameters:

Name	Type	Attributes	Default	Description
recursive	boolean	<optional>	true	计算aabb时是否考虑孩子
updateMatrix	boolean	<optional>	true	计算aabb时是否更新自己和孩子的矩阵
local	boolean	<optional>	false	计算出的aabb的轴向是基于父物体坐标系,还是相对于世界坐标系(计算出的包围盒是不同的)

Returns:

THING.Box3 - 包围盒对象

Overrides:

• THING.Object3D#getAABB

Example

let boundingBox = object.getAABB();
	console.log(boundingBox);

getAllComponents() → {Array.<THING.BaseComponent>}

thing/src/components/BaseComponentGroup.js, line 615

获取所有组件

Returns:

Array.<THING.BaseComponent>

Overrides:

• THING.Object3D#getAllComponents

Example

let obj = new THING.BaseObject();;
obj.addComponent(new THING.BaseComponent(), 'component1');
obj.addComponent(new THING.BaseComponent(), 'component2');
let components = obj.getAllComponents();
// @expect(components.length == 2)

getAnimation(name) → {AnimationResult}

thing/src/objects/BaseEntity.js, line 351

根据名称获取动画信息

Parameters:

Name	Type	Description
name	string	动画名称

Returns:

AnimationResult - 动画信息

Example

var UinoSpaceman = new THING.Entity({url:'.assets/models/UinoSpaceman/UinoSpaceman.gltf'});
UinoSpaceman.waitForComplete().then(() => {
  let animation = UinoSpaceman.getAnimation('Walk');
  let ret = animation.name == 'Walk';
	 // @expect(ret == true);
});

getAnimationDirectionType(name) → {AnimationDirectionType}

thing/src/objects/BaseEntity.js, line 398

获取动画播放的方向(正向/反向)
获取动画的方向类型。

Parameters:

Name	Type	Description
name	string	动画名称

Returns:

AnimationDirectionType

Example

var UinoSpaceman = new THING.Entity({url:'.assets/models/UinoSpaceman/UinoSpaceman.gltf'});
UinoSpaceman.waitForComplete().then(() => {
  let direction = UinoSpaceman.getAnimationDirectionType('Walk');
  let ret = direction == 'Normal';
	 // @expect(ret == true);
});

getAnimationSpeed(name) → {number}

thing/src/objects/BaseEntity.js, line 431

获取动画速度

Parameters:

Name	Type	Description
name	string	动画名称

Returns:

number - 播放速度

Example

var UinoSpaceman = new THING.Entity({url:'.assets/models/UinoSpaceman/UinoSpaceman.gltf'});
UinoSpaceman.waitForComplete().then(() => {
  UinoSpaceman.playAnimation({ name: 'Walk', loopType: "Repeat", speed: 10 });
  let speed = UinoSpaceman.getAnimationSpeed('Walk');
  let ret = speed == 10;
	 // @expect(ret == true);
});

getAnimationState(name) → {PlayState}

thing/src/objects/BaseEntity.js, line 367

根据名称获取动画播放状态

Parameters:

Name	Type	Description
name	string	动画名称

Returns:

PlayState

Example

var UinoSpaceman = new THING.Entity({url:'.assets/models/UinoSpaceman/UinoSpaceman.gltf'});
UinoSpaceman.waitForComplete().then(() => {
  UinoSpaceman.playAnimation({ name: 'Walk', loopType: "Repeat" });
  let state = UinoSpaceman.getAnimationState('Walk');
  let ret = state == 'Playing';
	 // @expect(ret == true);
});

getAnimationWeight(name) → {number}

thing/src/objects/BaseEntity.js, line 465

获取动画权重

Parameters:

Name	Type	Description
name	string	动画名称

Returns:

number - 播放权重

Example

var UinoSpaceman = new THING.Entity({url:'.assets/models/UinoSpaceman/UinoSpaceman.gltf'});
UinoSpaceman.waitForComplete().then(() => {
  UinoSpaceman.playAnimation({ name: 'Walk', loopType: "Repeat", speed: 10 });
  let weight = UinoSpaceman.getAnimationWeight('Walk');
  let ret = weight == 0;
	 // @expect(ret == true);
});

getAttribute(key, separator) → {*}

thing/src/objects/BaseObject.js, line 741

根据name获取属性值

Parameters:

Name	Type	Default	Description
key	string		属性名称,支持嵌套,例如获取object.a.b.c 可以使用object.getAttribute('a/b/c')
separator	string	/	分隔符,默认是'/'

Returns:

* - 返回指定属性的值

Overrides:

• THING.Object3D#getAttribute

Example

let object = new THING.BaseObject();
object.userData['power'] = 100;
let power = object.getAttribute('userData/power');
// @expect(power == 100)

getComponentByName(name) → {THING.BaseComponent}

thing/src/components/BaseComponentGroup.js, line 538

根据名称获取组件对象

Parameters:

Name	Type	Description
name	string	组件名称

Returns:

THING.BaseComponent

Overrides:

• THING.Object3D#getComponentByName

Example

let obj = new THING.BaseObject();;
obj.addComponent(new THING.BaseComponent(), 'myComponent');
let component = obj.getComponentByName('myComponent');
// @expect(component != null)

getComponentByType(type) → {THING.BaseComponent}

thing/src/components/BaseComponentGroup.js, line 565

根据类型获取组件对象 返回符合条件的第一个组件

Parameters:

Name	Type	Description
type	*	组件类型

Returns:

THING.BaseComponent

Overrides:

• THING.Object3D#getComponentByType

Example

let obj = new THING.BaseObject();;
obj.addComponent(new THING.BaseComponent(), 'myComponent');
let component = obj.getComponentByType(THING.BaseComponent);
// @expect(component != null)

getComponentsByType(type) → {Array.<THING.BaseComponent>}

thing/src/components/BaseComponentGroup.js, line 595

根据类型获取组件对象的集合

Parameters:

Name	Type	Description
type	*	组件类型

Returns:

Array.<THING.BaseComponent>

Overrides:

• THING.Object3D#getComponentsByType

Example

let obj = new THING.BaseObject();;
obj.addComponent(new THING.BaseComponent(), 'component1');
obj.addComponent(new THING.BaseComponent(), 'component2');
let components = obj.getComponentsByType(THING.BaseComponent);
// @expect(components.length == 2)

getEvents(type) → {Array.<ObjectListenerInfo>}

thing/src/objects/BaseObject.js, line 1267

获取指定类型的事件。

Parameters:

Name	Type	Description
type	string	事件类型，为null表示获取所有事件。

Returns:

Array.<ObjectListenerInfo> - 返回一个数组，包含所有指定类型的事件

Overrides:

• THING.Object3D#getEvents

Example

let object = new THING.BaseObject();
let events = object.getEvents();
// @expect(events.length > 0);

getFrustumCulled() → {boolean}

thing/src/objects/Object3D.js, line 1760

获取视锥剔除状态。

Returns:

boolean - 视锥剔除状态。

Overrides:

• THING.Object3D#getFrustumCulled

Example

let frustumCulled = object.getFrustumCulled();
	if (frustumCulled) {
		console.log('object is frustum culled');
	}

getInstancedCount() → {number}

thing/src/objects/Object3D.js, line 3405

获取实例化数量。

Returns:

number - 实例化数量

Overrides:

• THING.Object3D#getInstancedCount

Example

// 获取当前实例的数量
const count = object.getInstancedCount();
console.log('Current instance count:', count);

getInstancing() → {InstancingNodeOptions}

thing/src/objects/Object3D.js, line 3303

获取实例化节点信息。

Returns:

InstancingNodeOptions - 实例化节点信息

Overrides:

• THING.Object3D#getInstancing

Example

// 获取实例化渲染的当前参数
const info = object.getInstancing();
console.log(info.number); // 当前实例数量
console.log(info.maxNumber); // 最大实例数量

getInstancingAttribute(name) → {any}

thing/src/objects/Object3D.js, line 3460

获取实例化属性。

Parameters:

Name	Type	Description
name	string	名称。

Returns:

any - 实例化属性

Overrides:

• THING.Object3D#getInstancingAttribute

Example

// 获取颜色属性的状态
const useColors = object.getInstancingAttribute('Colors');
console.log('Using colors:', useColors);

getInstancingClearOutColor(index) → {boolean}

thing/src/objects/Object3D.js, line 3345

获取实例化清除颜色。

Parameters:

Name	Type	Description
index	number	索引。

Returns:

boolean - 是否获取成功

Overrides:

• THING.Object3D#getInstancingClearOutColor

Example

// 获取第一个实例的清除颜色
const clearOutColor = object.getInstancingClearOutColor(0);
console.log('Instance 0 clear out color:', clearOutColor);

getInstancingDiffuseUVTransform(index, target) → {Array.<number>}

thing/src/objects/Object3D.js, line 3370

获取实例化漫反射UV变换。

Parameters:

Name	Type	Description
index	number	索引。
target	Array.<number>	目标。

Returns:

Array.<number> - 漫反射UV变换

Overrides:

• THING.Object3D#getInstancingDiffuseUVTransform

Example

// 获取第一个实例的漫反射UV变换
const diffuseUVTransform = object.getInstancingDiffuseUVTransform(0);
console.log('Instance 0 diffuse UV transform:', diffuseUVTransform);

getInstancingMatrix(index, target?) → {Array.<number>}

thing/src/objects/Object3D.js, line 3436

获取按索引的实例化矩阵。

Parameters:

Name	Type	Description
index	number	索引。
target?	Array.<number>	目标。

Returns:

Array.<number> - 实例化矩阵

Overrides:

• THING.Object3D#getInstancingMatrix

Example

// 获取第一个实例的变换矩阵
const matrix = object.getInstancingMatrix(0);
console.log('Instance 0 matrix:', matrix);

getInstancingVisible(index) → {boolean}

thing/src/objects/Object3D.js, line 3394

获取按索引的实例化可见性。

Parameters:

Name	Type	Description
index	number	索引。

Returns:

boolean - 是否获取成功

Overrides:

• THING.Object3D#getInstancingVisible

Example

// 检查第一个实例是否可见
const visible = object.getInstancingVisible(0);
console.log('Instance 0 visible:', visible);

getOBB(recursiveopt, updateMatrixopt, localopt) → {OrientedBoxResult}

thing/src/objects/Object3D.js, line 3559

获取旋转后的包围盒

Parameters:

Name	Type	Attributes	Default	Description
recursive	boolean	<optional>	true	计算obb时是否考虑孩子
updateMatrix	boolean	<optional>	true	计算obb时是否更新自己和孩子的矩阵
local	boolean	<optional>	false	描述obb时的参数是基于父物体还是世界坐标系(算出的包围盒是一样的,只是描述不同)

Returns:

OrientedBoxResult - 旋转包围盒对象

Overrides:

• THING.Object3D#getOBB

Example

let orientedBox = object.getOBB();
	console.log(orientedBox);

getPlayingAnimations() → {Array.<AnimationResult>}

thing/src/objects/BaseEntity.js, line 382

获取所有正在播放的动画

Returns:

Array.<AnimationResult>

Example

var UinoSpaceman = new THING.Entity({url:'.assets/models/UinoSpaceman/UinoSpaceman.gltf'});
UinoSpaceman.waitForComplete().then(() => {
  UinoSpaceman.playAnimation({ name: 'Walk', loopType: "Repeat" });
  let animations = UinoSpaceman.getPlayingAnimations();
  let ret = animations[0].state == 'Playing';
	 // @expect(ret == true);
});

getRenderOrder() → {number}

thing/src/objects/Object3D.js, line 3154

获取渲染顺序。

Returns:

number - 渲染顺序

Overrides:

• THING.Object3D#getRenderOrder

Example

let renderOrder = object.renderOrder;
	console.log(renderOrder);

getVisible() → {boolean}

thing/src/objects/Object3D.js, line 1669

获取visible的状态

Returns:

boolean - 可见状态。

Overrides:

• THING.Object3D#getVisible

Example

let visible = object.getVisible();
	if (visible) {
		console.log('object is showing');
	}

hasAnimation(name) → {boolean}

thing/src/objects/BaseEntity.js, line 216

根据动画名称检查该对象身上是否有这个动画

Parameters:

Name	Type	Description
name	string	动画名称

Returns:

boolean - 返回一个布尔值，表示是否有指定名称的动画

Example

var UinoSpaceman = new THING.Entity({url:'.assets/models/UinoSpaceman/UinoSpaceman.gltf'});
UinoSpaceman.waitForComplete().then(() => {
  let ret = UinoSpaceman.hasAnimation('Walk');
  // @expect(ret == true);
});

hasAttribute(name, separator) → {boolean}

thing/src/objects/BaseObject.js, line 725

检查是否含有属性名为name的属性

Parameters:

Name	Type	Default	Description
name	string		属性名称,支持嵌套,例如查询object.a.b.c 可以使用object.hasAttribute('a/b/c')
separator	string	/	分隔符,默认是'/'

Returns:

boolean - 返回一个布尔值，表示是否存在指定的属性

Overrides:

• THING.Object3D#hasAttribute

Example

let object = new THING.BaseObject();
object.userData['power'] = 100;
let ret = object.hasAttribute('userData/power');
// @expect(ret == true)

hasComponent(name) → {boolean}

thing/src/components/BaseComponentGroup.js, line 644

判断是否含有特定名称的组件

Parameters:

Name	Type	Description
name	string	组件名称

Returns:

boolean

Overrides:

• THING.Object3D#hasComponent

Example

let obj = new THING.BaseObject();;
obj.addComponent(new THING.BaseComponent(), 'myComponent');
let ret = obj.hasComponent('myComponent')
// @expect(ret == true)

async invoke(type, condition, data, tagName) → {*}

thing/src/objects/BaseObject.js, line 1589

触发并等待事件完成

Parameters:

Name	Type	Description
type	string	事件类型。
condition	string | object	事件条件 或 事件数据。
data	object | string	事件数据 或 事件标签。
tagName	string	事件标签名称。

Returns:

* - 返回一个Promise对象，包含指定类型的事件

Overrides:

• THING.Object3D#invoke

isAnimationPlaying() → {boolean}

thing/src/objects/BaseEntity.js, line 230

该名称的动画是否正在播放

Returns:

boolean

Example

var UinoSpaceman = new THING.Entity({url:'.assets/models/UinoSpaceman/UinoSpaceman.gltf'});
UinoSpaceman.waitForComplete().then(() => {
  UinoSpaceman.playAnimation({ name: 'Walk', loopType: "Repeat" });
  let ret = UinoSpaceman.isAnimationPlaying('Walk');
	 // @expect(ret == true);
});

loadResource(recursiveopt, optionsopt) → {Promise.<any>}

thing/src/objects/Object3D.js, line 2619

加载资源 返回一个Promise对象

Parameters:

Name	Type	Attributes	Default	Description
recursive	boolean	<optional>	true	是否加载所有孩子的资源
options	ResourceResult	<optional>	{}	加载选项

Returns:

Promise.<any> - 返回一个Promise对象

Overrides:

• THING.Object3D#loadResource

Example

// 等待物体加载资源完成
	await object.loadResource();

localToWorld(position, ignoreScaleopt) → {Array.<number>}

thing/src/objects/Object3D.js, line 4722

相对于父物体的坐标转为世界坐标

Parameters:

Name	Type	Attributes	Default	Description
position	Array.<number>			相对于父物体的坐标
ignoreScale	boolean	<optional>	false	转换时是否忽略缩放 默认不忽略

Returns:

Array.<number> - 返回世界坐标

Overrides:

• THING.Object3D#localToWorld

Example

let parentObj = new THING.Object3D({
	position: [0, 5, 0]
});

let childObj = new THING.Object3D({
	localPosition: [0, 10, 0],
 parent: parentObj
});

let worldPos = childObj.localToWorld([0, -5, 0]);

// print [0, 0, 0]
console.log(worldPos);

lookAt(target, param) → {boolean}

thing/src/objects/Object3D.js, line 4652

看对象或一个目标位置

Parameters:

Name	Type	Description
target	Array.<number> | THING.Object3D	要看的对象或目标位置
param	LookAtArgs	参数列表

Returns:

boolean - 是否看成功

Overrides:

• THING.Object3D#lookAt

makeInstancedDrawing(value, options) → {boolean}

thing/src/objects/Object3D.js, line 3217

开启/关闭批量渲染模式。

Parameters:

Name	Type	Default	Description
value	boolean	true	是否开启
options	object		选项 Properties Name Type Attributes Default Description renderMode string <optional> 'InstancedRendering' 渲染模式 InstancedRendering/SharedRenderingSharedRendering代表材质共用但是drawCall还是多个 InstancedRendering代表材质共用,drawCall只有一次

Returns:

boolean - 是否开启成功

Overrides:

• THING.Object3D#makeInstancedDrawing

Example

// 开启批量渲染模式
	if (object.makeInstancedDrawing()) {
		console.log('Enable instanced drawing');
	}

movePath(value, param) → {boolean}

thing/src/objects/Object3D.js, line 3720

对象沿路径移动

Parameters:

Name	Type	Description
value	Array.<Array.<number>>	组成路径的坐标的集合
param	MovePathLerpArgs	移动参数

Returns:

boolean - 是否移动成功

Overrides:

• THING.Object3D#movePath

Example

let path = [
	[100, 0, 0],
	[100, 0, 100],
	[0, 0, 100],
[0, 0, 0],
];

object.movePath(path.map(point => object.selfToWorld(point)), {
	duration: 5 * 1000,
	loopType: THING.LoopType.Repeat,
});
object.movePath({
	path: path.map(point => object.selfToWorld(point)),
	duration: 5 * 1000,
	loopType: THING.LoopType.Repeat,
});

movePathAsync(value, param) → {Promise.<any>}

thing/src/objects/Object3D.js, line 3744

对象沿路径移动 返回一个Promise对象

Parameters:

Name	Type	Description
value	Array.<Array.<number>>	组成路径的坐标的集合
param	MovePathLerpArgs	移动参数

Returns:

Promise.<any> - 返回一个Promise对象

Overrides:

• THING.Object3D#movePathAsync

Example

let path = [
	[100, 0, 0],
	[100, 0, 100],
	[0, 0, 100],
[0, 0, 0],
];

await object.movePathAsync(path.map(point => object.selfToWorld(point)), {
	duration: 5 * 1000
});
await object.movePathAsync({
	path: path.map(point => object.selfToWorld(point)),
	duration: 5 * 1000
});

moveTo(value, param) → {boolean}

thing/src/objects/Object3D.js, line 3681

对象移动到目标位置

Parameters:

Name	Type	Description
value	Array.<number>	目标位置
param	MovePathLerpArgs	移动的参数

Returns:

boolean - 是否移动成功

Overrides:

• THING.Object3D#moveTo

Example

object.moveTo(object.selfToWorld(THING.Math.randomVector([-200, -5, -200], [200, 5, 200])), {
		loopType: THING.LoopType.PingPong,
		duration: THING.Math.randomInt(1000, 5000)
});
object.moveTo({
	to: object.selfToWorld(THING.Math.randomVector([-200, -5, -200], [200, 5, 200])),
	duration: THING.Math.randomInt(1000, 5000)
})

off(type, condition, tag)

thing/src/objects/BaseObject.js, line 1410

注销事件

Parameters:

Name	Type	Description
type	string	事件类型
condition	string	注册事件的条件
tag	string	事件的tag

Overrides:

• THING.Object3D#off

Example

let object = new THING.BaseObject();
let markOff = 0;
object.on('testOff', function(ev) {
		markOff = 1;
});
object.trigger('testOff');
// @expect(markOff == 1);
markOff = 0;
object.off('testOff');
object.trigger('testOff');
// @expect(markOff == 0);

on(type, condition, callback, tag, priority, options)

thing/src/objects/BaseObject.js, line 1362

注册事件

Parameters:

Name	Type	Description
type	string	事件类型
condition	string	注册事件前先进行查询,对符合条件的对象进行注册
callback	EventCallback	事件回调函数
tag	string	事件的tag
priority	number	优先级 默认0
options	ObjectEventOptions	事件参数

Overrides:

• THING.Object3D#on

Example

let object = new THING.BaseObject();
let mark = 0;
object.on('click', function(ev){
	mark = 1;
}, 'MyClick');
object.trigger('click');
// @expect(mark == 1)
let mark2 = 0;
object.on('click', '.Box', function(ev){
	mark2 = 1;
}, 'MyClick');
// @expect(mark2 == 0)

once(type, condition, callback, tag, priority, options)

thing/src/objects/BaseObject.js, line 1387

注册一次性的事件，此事件响应只会触发一次，触发后会被自动注销

Parameters:

Name	Type	Description
type	string	事件类型
condition	string	注册事件前先进行查询,对符合条件的对象进行注册
callback	EventCallback	事件回调函数
tag	string	事件的tag
priority	number	优先级 默认0
options	ObjectEventOptions	事件参数

Overrides:

• THING.Object3D#once

Example

let object = new THING.BaseObject();
let markOnce = 0;
object.once('testOnce', function(ev) {
		markOnce = 1;
});
object.trigger('testOnce');
// @expect(markOnce == 1);
markOnce = 0;
object.trigger('testOnce');
// @expect(markOnce == 0);

pauseAllAnimations()

thing/src/objects/BaseEntity.js, line 261

暂停所有动画

Example

var UinoSpaceman = new THING.Entity({url:'.assets/models/UinoSpaceman/UinoSpaceman.gltf'});
UinoSpaceman.waitForComplete().then(() => {
  UinoSpaceman.playAnimation({ name: 'Walk', loopType: "Repeat" });
  let ret1 = UinoSpaceman.isAnimationPlaying('Walk');
  UinoSpaceman.pauseAllAnimations();
  let ret2 = UinoSpaceman.getAnimationState() == 'Paused';
	 // @expect(ret1 == true && ret2 == true);
});

pauseAnimation(name)

thing/src/objects/BaseEntity.js, line 246

暂停动画(暂停名称匹配的所有动画)

Parameters:

Name	Type	Description
name	string | Array.<string>	动画名称或动画名称的数组

Example

var UinoSpaceman = new THING.Entity({url:'.assets/models/UinoSpaceman/UinoSpaceman.gltf'});
UinoSpaceman.waitForComplete().then(() => {
  UinoSpaceman.playAnimation({ name: 'Walk', loopType: "Repeat" });
  let ret1 = UinoSpaceman.isAnimationPlaying('Walk');
  UinoSpaceman.pauseAnimation('Walk');
  let ret2 = UinoSpaceman.getAnimationState() == 'Paused';
	 // @expect(ret1 == true && ret2 == true);
});

pauseEvent(type, condition, tag)

thing/src/objects/BaseObject.js, line 1444

暂停事件

Parameters:

Name	Type	Description
type	string	事件类型
condition	string	注册事件的条件
tag	string	事件的tag

Overrides:

• THING.Object3D#pauseEvent

Example

let object = new THING.BaseObject();
let markPause = 0;
object.on('testPause', function(ev) {
		markPause = 1;
});
object.trigger('testPause');
// @expect(markPause == 1);
markPause = 0;
object.pauseEvent('testPause');
object.trigger('testPause');
// @expect(markPause == 0);
app.on('test', ".Box", (e) => {
	console.log(e.object)
}, 'MyTag');
app.pauseEvent('test', '.Box', 'MyTag');

pauseFading()

thing/src/objects/Object3D.js, line 3898

暂停淡入淡出动作。

Overrides:

• THING.Object3D#pauseFading

Example

object.pauseFading();

pauseFlying()

thing/src/objects/Object3D.js, line 3974

暂停飞行

Overrides:

• THING.Object3D#pauseFlying

Example

object.pauseFlying();

pauseMoving()

thing/src/objects/Object3D.js, line 3655

暂停移动

Overrides:

• THING.Object3D#pauseMoving

Example

object.pauseMoving();

pauseRotating()

thing/src/objects/Object3D.js, line 3819

暂停旋转

Overrides:

• THING.Object3D#pauseRotating

Example

object.pauseRotating();

pauseScaling() → {boolean}

thing/src/objects/Object3D.js, line 3762

暂停缩放动画

Returns:

boolean - 是否暂停成功

Overrides:

• THING.Object3D#pauseScaling

Example

object.pauseScaling();

pauseUVTransform(slotType) → {boolean}

thing/src/objects/Object3D.js, line 4075

暂停UV变化

Parameters:

Name	Type	Description
slotType	ImageSlotType	指定纹理类型

Returns:

boolean - 是否暂停成功

Overrides:

• THING.Object3D#pauseUVTransform

Example

object.pauseUVTransform(THING.ImageSlotType.Map);

playAnimation(param)

thing/src/objects/BaseEntity.js, line 164

播放动画，会停止所有其他正在播放的动画

Parameters:

Name	Type	Description
param	PlayAnimationArgs	参数

Example

var UinoSpaceman = new THING.Entity({url:'.assets/models/UinoSpaceman/UinoSpaceman.gltf'});
UinoSpaceman.waitForComplete().then(() => {
  UinoSpaceman.playAnimation({ name: 'Walk', loopType: "Repeat" });
  let ret = UinoSpaceman.isAnimationPlaying('Walk');
	 // @expect(ret == true);
});

query(condition) → {THING.Selector}

thing/src/objects/BaseObject.js, line 2385

根据条件查询孩子 返回所有满足条件的对象集合

Parameters:

Name	Type	Description
condition	ObjectQueryOptions | string	查询条件

Returns:

THING.Selector - 查询结果

Overrides:

• THING.Object3D#query

Example

let object = new THING.BaseObject();
let child= new THING.BaseObject({parent: object});
child.userData = {power: 1000};
let children = object.children.query('[userData/power>100]');
let ret = children.length == 1;
// @expect(ret == true)

queryAll(condition) → {THING.Selector}

thing/src/objects/BaseObject.js, line 2495

根据条件查询孩子 返回所有满足条件的对象集合（忽略 queryable 属性）

Parameters:

Name	Type	Description
condition	ObjectQueryOptions | string	查询条件

Returns:

THING.Selector - 查询结果

Overrides:

• THING.Object3D#queryAll

Example

let object = new THING.BaseObject();
let child= new THING.BaseObject({parent: object});
child.userData = {power: 1000};
let children = object.children.queryAll('[userData/power>100]');
let ret = children.length == 1;
// @expect(ret == true)

queryByDTType(condition, options) → {THING.Selector}

thing/src/objects/BaseObject.js, line 2693

根据孪生体类型查询孩子

Parameters:

Name	Type	Description
condition	string	查询条件
options	ObjectQueryOptions	查询参数

Returns:

THING.Selector - 查询结果

Overrides:

• THING.Object3D#queryByDTType

Example

let object = new THING.BaseObject();
let child1= new THING.BaseObject({parent: object});
child1.dtType = 'Equipment';
let child2= new THING.BaseObject({parent: object});
let result = object.queryByDTType('Equipment');
let ret = result[0].dtType == 'Equipment';
 //@expect(ret == true)

queryById(condition, options) → {THING.Selector}

thing/src/objects/BaseObject.js, line 2621

根据id查询孩子

Parameters:

Name	Type	Description
condition	string	查询条件
options	ObjectQueryOptions	查询参数

Returns:

THING.Selector - 查询结果

Overrides:

• THING.Object3D#queryById

Example

let object = new THING.BaseObject();
let child1= new THING.BaseObject({parent: object});
child1.id = '10000';
let child2= new THING.BaseObject({parent: object});
let result = object.queryById('10000');
let ret = result[0].id == '10000';
 //@expect(ret == true)

queryByName(condition, options) → {THING.Selector}

thing/src/objects/BaseObject.js, line 2603

根据名称查询孩子

Parameters:

Name	Type	Description
condition	string	查询条件
options	ObjectQueryOptions	查询参数 主要包括是否递归查询和是否包含自身

Returns:

THING.Selector - 查询结果

Overrides:

• THING.Object3D#queryByName

Example

let object = new THING.BaseObject();
let child= new THING.BaseObject({parent: object, name: 'liming'});
let result = object.queryByName('liming');
let ret = result[0].name == 'liming';
// @expect(ret == true)

queryByRegExp(condition, options) → {THING.Selector}

thing/src/objects/BaseObject.js, line 2744

根据正则表达式查询孩子

Parameters:

Name	Type	Description
condition	string	正则表达式
options	ObjectQueryOptions	查询参数

Returns:

THING.Selector - 查询结果

Overrides:

• THING.Object3D#queryByRegExp

Example

let object = new THING.BaseObject();
let child1= new THING.BaseObject({parent: object, name: 'car1'});
let child2= new THING.BaseObject({parent: object, name: 'car2'});
let result = object.queryByRegExp(/car/);
let ret = result.length == 2;
 //@expect(ret == true)

queryByTags(condition, options) → {THING.Selector}

thing/src/objects/BaseObject.js, line 2639

根据tag查询孩子

Parameters:

Name	Type	Description
condition	string	查询条件
options	ObjectQueryOptions	查询参数

Returns:

THING.Selector - 查询结果

Overrides:

• THING.Object3D#queryByTags

Example

let object = new THING.BaseObject();
let child1= new THING.Object3D({parent: object, name: 'car1'});
child1.tags.add('testCar');
let child2= new THING.BaseObject({parent: object, name: 'car2'});
let result = object.queryByTags('testCar');
let ret = result.length == 1;
 //@expect(ret == true)

queryByType(condition, options) → {THING.Selector}

thing/src/objects/BaseObject.js, line 2673

根据类型查询孩子

Parameters:

Name	Type	Description
condition	string	查询条件
options	ObjectQueryOptions	查询参数

Returns:

THING.Selector - 查询结果

Overrides:

• THING.Object3D#queryByType

Example

let object = new THING.BaseObject();
let child1= new THING.Box({parent: object, id: '10000'});
let child2= new THING.BaseObject({parent: object});
let result = object.queryByType('Box');
let ret = result[0].id == '10000';
 //@expect(ret == true)

queryByUUID(condition, options) → {THING.Selector}

thing/src/objects/BaseObject.js, line 2656

根据uuid查询孩子

Parameters:

Name	Type	Description
condition	string	查询条件
options	ObjectQueryOptions	查询参数

Returns:

THING.Selector - 查询结果

Overrides:

• THING.Object3D#queryByUUID

Example

let object = new THING.BaseObject();
let child1= new THING.BaseObject({parent: object, uuid: '1000'});
let child2= new THING.BaseObject({parent: object});
let result = object.queryByUUID('1000');
let ret = result[0].uuid == '1000';
 //@expect(ret == true)

queryByUserData(condition, options) → {THING.Selector}

thing/src/objects/BaseObject.js, line 2712

根据userData(用户数据)查询孩子

Parameters:

Name	Type	Description
condition	string	查询条件
options	ObjectQueryOptions	查询参数

Returns:

THING.Selector - 查询结果

Overrides:

• THING.Object3D#queryByUserData

Example

let object = new THING.BaseObject();
let child1= new THING.Box({parent: object});
child1.userData['power'] = 100;
let child2= new THING.BaseObject({parent: object});
let result = object.queryByUserData('power=100');
let ret = result[0].userData.power == 100;
 //@expect(ret == true)

raycast(ray, recursiveopt) → {Array.<RaycastResult>}

thing/src/objects/Object3D.js, line 2301

射线检测,检测射线是否与对象相交

Parameters:

Name	Type	Attributes	Default	Description
ray	RaycastInfo			射线信息
recursive	boolean	<optional>	true	是否对所有子对象进行检测

Returns:

Array.<RaycastResult> - 检测结果(按距离从近到远排序)

Overrides:

• THING.Object3D#raycast

Example

// 示例1: 创建一个向前的射线
let results = object.raycast({
  origin: [0, 0, 0],    // 起点
  direction: [0, 0, 1]  // 向前
});
if (results.length) {
  let nearest = results[0];  // 获取最近的相交点
  console.log('击中物体:', nearest.object);
  console.log('击中位置:', nearest.position);
  console.log('击中距离:', nearest.distance);
}

// 示例2: 创建一个指向目标的射线
let direction = THING.Math.normalizeVector(
  THING.Math.subVector(targetPos, startPos)  // 目标点减起点
);
console.log('从起点:', startPos, '朝向:', direction, '进行射线检测');
let hits = object.raycast({
  origin: startPos,
  direction: direction
});
console.log('射线检测结果:', hits);

remove(object, options) → {boolean}

thing/src/objects/BaseObject.js, line 2072

从自己的孩子中移除BaseObject

Parameters:

Name	Type	Description
object	THING.BaseObject	待移除物体
options	object	选项

Returns:

boolean - 返回一个布尔值，表示是否移除成功

Overrides:

• THING.Object3D#remove

Example

let parent = new THING.BaseObject();
let child = new THING.BaseObject();
parent.add(child);
let ret = child.isChildOf(parent);
 // @expect(ret == true);
	parent.remove(child);
ret = child.isChildOf(parent);
	// @expect(ret == false);

removeAllComponents()

thing/src/components/BaseComponentGroup.js, line 458

移除所有组件

Overrides:

• THING.Object3D#removeAllComponents

Example

let obj = new THING.BaseObject();;
obj.addComponent(new THING.BaseComponent(), 'component1');
obj.addComponent(new THING.BaseComponent(), 'component2');
obj.removeAllComponents();
// @expect(obj.components.size == 0)

removeComponent(name)

thing/src/components/BaseComponentGroup.js, line 434

根据名称移除组件

Parameters:

Name	Type	Description
name	string	The name. 组件名称

Overrides:

• THING.Object3D#removeComponent

Example

let obj = new THING.BaseObject();;
obj.addComponent(new THING.BaseComponent(), 'myComponent');
obj.removeComponent('myComponent');
// @expect(obj.components.size == 0)

resumeAllAnimations()

thing/src/objects/BaseEntity.js, line 296

恢复所有动画

Example

var UinoSpaceman = new THING.Entity({url:'.assets/models/UinoSpaceman/UinoSpaceman.gltf'});
UinoSpaceman.waitForComplete().then(() => {
  UinoSpaceman.playAnimation({ name: 'Walk', loopType: "Repeat" });
  let ret1 = UinoSpaceman.isAnimationPlaying('Walk');
  UinoSpaceman.pauseAnimation('Walk');
  let ret2 = UinoSpaceman.getAnimationState() == 'Paused';
	 UinoSpaceman.resumeAllAnimations();
  let ret3 = UinoSpaceman.isAnimationPlaying('Walk');
	 // @expect(ret1 == true && ret2 == true && ret3 == true);
});

resumeAnimation(name)

thing/src/objects/BaseEntity.js, line 279

恢复动画(恢复名称匹配的所有动画)

Parameters:

Name	Type	Description
name	string | Array.<string>	动画名称或动画名称的数组

Example

var UinoSpaceman = new THING.Entity({url:'.assets/models/UinoSpaceman/UinoSpaceman.gltf'});
UinoSpaceman.waitForComplete().then(() => {
  UinoSpaceman.playAnimation({ name: 'Walk', loopType: "Repeat" });
  let ret1 = UinoSpaceman.isAnimationPlaying('Walk');
  UinoSpaceman.pauseAnimation('Walk');
  let ret2 = UinoSpaceman.getAnimationState() == 'Paused';
	 UinoSpaceman.resumeAnimation('Walk');
  let ret3 = UinoSpaceman.isAnimationPlaying('Walk');
	 // @expect(ret1 == true && ret2 == true && ret3 == true);
});

resumeEvent(type, condition, tag)

thing/src/objects/BaseObject.js, line 1475

恢复事件

Parameters:

Name	Type	Description
type	string	事件类型
condition	string	注册事件的条件
tag	string	事件的tag

Overrides:

• THING.Object3D#resumeEvent

Example

let object = new THING.BaseObject();
let markResume = 0;
object.on('testResume', function(ev) {
		markResume = 1;
});
object.trigger('testResume');
// @expect(markResume == 1);
markResume = 0;
object.pauseEvent('testResume');
object.trigger('testResume');
// @expect(markResume == 0);
object.resumeEvent('testResume');
object.trigger('testResume');
// @expect(markResume == 1);
app.on('test', ".Box", (e) => {
	console.log(e.object)
}, 'MyTag');
app.pauseEvent('test', '.Box', 'MyTag');
app.resumeEvent('test', '.Box', 'MyTag');

resumeFading()

thing/src/objects/Object3D.js, line 3906

恢复淡入淡出动作。

Overrides:

• THING.Object3D#resumeFading

Example

object.resumeFading();

resumeFlying()

thing/src/objects/Object3D.js, line 3982

恢复飞行

Overrides:

• THING.Object3D#resumeFlying

Example

object.resumeFlying();

resumeMoving()

thing/src/objects/Object3D.js, line 3663

恢复移动

Overrides:

• THING.Object3D#resumeMoving

Example

object.resumeMoving();

resumeRotating()

thing/src/objects/Object3D.js, line 3827

恢复旋转

Overrides:

• THING.Object3D#resumeRotating

Example

object.resumeRotating();

resumeScaling() → {boolean}

thing/src/objects/Object3D.js, line 3771

恢复缩放动画

Returns:

boolean - 是否恢复成功

Overrides:

• THING.Object3D#resumeScaling

Example

object.resumeScaling();

resumeUVTransform(slotType) → {boolean}

thing/src/objects/Object3D.js, line 4085

恢复UV变化

Parameters:

Name	Type	Description
slotType	ImageSlotType	指定纹理类型

Returns:

boolean - 是否恢复成功

Overrides:

• THING.Object3D#resumeUVTransform

Example

object.resumeUVTransform(THING.ImageSlotType.Map);

rotate(axis, angle, lerpParam) → {boolean}

thing/src/objects/Object3D.js, line 4402

等同于rotateOnAxis

Parameters:

Name	Type	Description
axis	Array.<number>	在自身坐标系下的轴向信息
angle	number	旋转角度
lerpParam	LerpArgs	插值信息

Returns:

boolean - 是否旋转成功

Overrides:

• THING.Object3D#rotate

Example

let box = new THING.Box();
	box.rotate(THING.Utils.xAxis, 45);
	// @expect(THING.Math.equalsVector3([45, 0, 0], box.angles) == true);

rotateOnAxis(axis, angle, lerpParam) → {boolean}

thing/src/objects/Object3D.js, line 4416

绕固定轴旋转特定角度

Parameters:

Name	Type	Description
axis	Array.<number>	在自身坐标系下的轴向信息
angle	number	旋转角度
lerpParam	LerpArgs	插值信息

Returns:

boolean - 是否旋转成功

Overrides:

• THING.Object3D#rotateOnAxis

Example

let box = new THING.Box();
	box.rotateOnAxis(THING.Utils.xAxis, 45);
	//@expect(THING.Math.equalsVector3([45, 0, 0], box.angles) == true);

rotateTo(value, param) → {boolean}

thing/src/objects/Object3D.js, line 3845

旋转对象

Parameters:

Name	Type	Description
value	Array.<number>	三个轴向的旋转角度
param	LerpWithSpaceTypeArgs	插值参数

Returns:

boolean - 是否旋转成功

Overrides:

• THING.Object3D#rotateTo

Example

object.rotateTo([0, 360, 0], {
	loopType: THING.LoopType.Repeat,
	duration: 10 * 1000
});
object.rotateTo({
	to: [0, 360, 0],
	duration: 10 * 1000
});

rotateX(angle, lerpParam) → {boolean}

thing/src/objects/Object3D.js, line 4430

绕自身坐标系下的x轴进行旋转

Parameters:

Name	Type	Description
angle	number	旋转角度
lerpParam	LerpArgs	插值信息

Returns:

boolean - 是否旋转成功

Overrides:

• THING.Object3D#rotateX

rotateY(angle, lerpParam) → {boolean}

thing/src/objects/Object3D.js, line 4444

绕自身坐标系下的y轴进行旋转

Parameters:

Name	Type	Description
angle	number	旋转角度
lerpParam	LerpArgs	插值信息

Returns:

boolean - 是否旋转成功

Overrides:

• THING.Object3D#rotateY

rotateZ(angle, lerpParam) → {boolean}

thing/src/objects/Object3D.js, line 4458

绕自身坐标系下的z轴进行旋转

Parameters:

Name	Type	Description
angle	number	旋转角度
lerpParam	LerpArgs	插值信息

Returns:

boolean - 是否旋转成功

Overrides:

• THING.Object3D#rotateZ

scaleTo(value, param) → {boolean}

thing/src/objects/Object3D.js, line 3789

缩放动画

Parameters:

Name	Type	Description
value	Array.<number>	要缩放到三个轴向的倍数
param	LerpWithSpaceTypeArgs	插值参数

Returns:

boolean - 是否缩放成功

Overrides:

• THING.Object3D#scaleTo

Example

object.scaleTo(THING.Math.randomVector([1, 1, 1], [3, 3, 3]), {
	loopType: THING.LoopType.PingPong,
	duration: THING.Math.randomInt(1000, 5000)
});
object.scaleTo({
	to: THING.Math.randomVector([1, 1, 1], [3, 3, 3]),
	duration: THING.Math.randomInt(1000, 5000)
});

selfToWorld(position, ignoreScaleopt) → {Array.<number>}

thing/src/objects/Object3D.js, line 4699

自身坐标转世界坐标

Parameters:

Name	Type	Attributes	Default	Description
position	Array.<number>			自身坐标系下的坐标
ignoreScale	boolean	<optional>	false	转换时是否忽略缩放 默认不忽略

Returns:

Array.<number> - 返回世界坐标

Overrides:

• THING.Object3D#selfToWorld

Example

let obj = new THING.Object3D({ position: [0, 15, 0] });
let worldPos = obj.selfToWorld([0, -15, 0]);
// print [0, 0, 0]
console.log(worldPos);

setAnimationDirectionType(name, value) → {boolean}

thing/src/objects/BaseEntity.js, line 415

设置动画的方向类型。

Parameters:

Name	Type	Description
name	string	动画名称
value	AnimationDirectionType	方向类型(THING.AnimationDirectionType.Normal/THING.AnimationDirectionType.Reverse)

Returns:

boolean - 返回一个布尔值，表示是否设置成功

Example

var UinoSpaceman = new THING.Entity({url:'.assets/models/UinoSpaceman/UinoSpaceman.gltf'});
UinoSpaceman.waitForComplete().then(() => {
  UinoSpaceman.setAnimationDirectionType('Walk', 'Reverse');
  let direction = UinoSpaceman.getAnimationDirectionType('Walk');
  let ret = direction == 'Reverse';
	 // @expect(ret == true);
});

setAnimationSpeed(name, value) → {boolean}

thing/src/objects/BaseEntity.js, line 449

设置动画速度

Parameters:

Name	Type	Description
name	string	动画名称
value	number	速度

Returns:

boolean

Example

var UinoSpaceman = new THING.Entity({url:'.assets/models/UinoSpaceman/UinoSpaceman.gltf'});
UinoSpaceman.waitForComplete().then(() => {
  UinoSpaceman.playAnimation({ name: 'Walk', loopType: "Repeat", speed: 10 });
	 UinoSpaceman.setAnimationSpeed('Walk', 20)
  let speed = UinoSpaceman.getAnimationSpeed('Walk');
  let ret = speed == 20;
	 // @expect(ret == true);
});

setAnimationWeight(name, value) → {boolean}

thing/src/objects/BaseEntity.js, line 483

设置动画速度

Parameters:

Name	Type	Description
name	string	动画名称
value	number	权重

Returns:

boolean

Example

var UinoSpaceman = new THING.Entity({url:'.assets/models/UinoSpaceman/UinoSpaceman.gltf'});
UinoSpaceman.waitForComplete().then(() => {
  UinoSpaceman.playAnimation({ name: 'Walk', loopType: "Repeat", speed: 10 });
	 UinoSpaceman.setAnimationWeight('Walk', 0.5)
  let weight = UinoSpaceman.getAnimationWeight('Walk');
  let ret = weight == 0.5;
	 // @expect(ret == true);
});

setAttribute(key, value, separator)

thing/src/objects/BaseObject.js, line 757

设置属性名称为key的属性值

Parameters:

Name	Type	Default	Description
key	string		属性名称,支持嵌套,例如设置object.a.b.c=1 可以使用object.setAttribute('a/b/c',1)
value	*		属性值
separator	string	/	分隔符,默认是'/'

Overrides:

• THING.Object3D#setAttribute

Example

let object = new THING.BaseObject();
object.setAttribute('userData/power', 200);
let power = object.getAttribute('userData/power');
// @expect(power == 200)

setAttributes(attributes, overwriteopt, separator)

thing/src/objects/BaseObject.js, line 778

设置属性

Parameters:

Name	Type	Attributes	Default	Description
attributes	object			属性对象
overwrite	boolean	<optional>	true	是否覆盖
separator	string		/	分隔符,默认是'/'

Overrides:

• THING.Object3D#setAttributes

Example

let object = new THING.BaseObject();
object.setAttributes({
  "userData/name": 'Mr.Door',
  "userData/age": 18
})
let name = object.getAttribute('userData/name');
// @expect(name == 'Mr.Door')
let age = object.getAttribute('userData/age');
// @expect(age == 18)

setFrustumCulled(value, recursiveopt)

thing/src/objects/Object3D.js, line 1772

设置视锥剔除状态。

Parameters:

Name	Type	Attributes	Default	Description
value	boolean			为真表示启用视锥剔除，否则不启用。
recursive	boolean	<optional>	false	为真表示处理所有子对象。

Overrides:

• THING.Object3D#setFrustumCulled

Example

object.setFrustumCulled(true, true);

setInstancing(options) → {boolean}

thing/src/objects/Object3D.js, line 3291

设置/更新实例化节点选项。

Parameters:

Name	Type	Description
options	InstancingNodeOptions	选项。

Returns:

boolean - 是否设置成功

Overrides:

• THING.Object3D#setInstancing

Example

// 更新实例化渲染的参数
object.setInstancing({
  maxNumber: 31104,
  number: 31104,
  matrices: matrices, // 包含所有实例的变换矩阵
  pickedIds: pickedIds, // 可选,包含所有实例的拾取ID
  colors: colors // 可选,包含所有实例的颜色
});

setInstancingAttribute(name, value) → {boolean}

thing/src/objects/Object3D.js, line 3448

设置实例化属性。

Parameters:

Name	Type	Description
name	string	名称。
value	any	值。

Returns:

boolean - 是否设置成功

Overrides:

• THING.Object3D#setInstancingAttribute

Example

// 启用颜色属性
object.setInstancingAttribute('Colors', true);

setInstancingClearOutColor(index, value) → {boolean}

thing/src/objects/Object3D.js, line 3333

按索引设置实例化清除颜色。

Parameters:

Name	Type	Description
index	number	索引。
value	boolean	是否清除颜色。

Returns:

boolean - 是否设置成功

Overrides:

• THING.Object3D#setInstancingClearOutColor

Example

// 清除第一个实例的颜色
object.setInstancingClearOutColor(0, true);

setInstancingColor(index, color) → {boolean}

thing/src/objects/Object3D.js, line 3321

按索引设置实例化颜色。

Parameters:

Name	Type	Description
index	number	索引。
color	Array.<number>	颜色。

Returns:

boolean - 是否设置成功

Overrides:

• THING.Object3D#setInstancingColor

Example

// 将第30个实例设置为绿色
object.setInstancingColor(30, [0, 1, 0]);

// 随机将一些实例设置为红色警告色
for(let i = 0; i < warnCount; i++) {
  const index = Math.floor(Math.random() * 31104);
  object.setInstancingColor(index, [1, 0, 0]);
}

setInstancingDiffuseUVTransform(index, diffuseUVTransform) → {boolean}

thing/src/objects/Object3D.js, line 3357

按索引设置实例化漫反射UV变换。

Parameters:

Name	Type	Description
index	number	索引。
diffuseUVTransform	Array.<number>	漫反射UV变换。

Returns:

boolean - 是否设置成功

Overrides:

• THING.Object3D#setInstancingDiffuseUVTransform

Example

// 设置第一个实例的漫反射UV变换
object.setInstancingDiffuseUVTransform(0, [0, 0, 1, 1]);

setInstancingMatrix(index, matrix) → {boolean}

thing/src/objects/Object3D.js, line 3423

按索引设置实例化矩阵。

Parameters:

Name	Type	Description
index	number	索引。
matrix	Array.<number>	矩阵。

Returns:

boolean - 是否设置成功

Overrides:

• THING.Object3D#setInstancingMatrix

Example

// 修改第30个实例的变换矩阵,将其Y轴位置上移1个单位
const matrices = options[0].matrices[30];
object.setInstancingMatrix(30, [
  1, 0, 0, matrices[3],
  0, 1, 0, matrices[7] + 1,
  0, 0, 1, matrices[11],
  0, 0, 0, 1
]);

setInstancingVisible(index, visible) → {boolean}

thing/src/objects/Object3D.js, line 3382

按索引设置实例化可见性。

Parameters:

Name	Type	Description
index	number	索引。
visible	boolean	可见性。

Returns:

boolean - 是否设置成功

Overrides:

• THING.Object3D#setInstancingVisible

Example

// 隐藏第一个实例
object.setInstancingVisible(0, false);

setPickable(value, recursiveopt)

thing/src/objects/Object3D.js, line 1744

设置可拾取状态。

Parameters:

Name	Type	Attributes	Default	Description
value	boolean			可拾取状态。
recursive	boolean	<optional>	false	为真表示处理所有子对象。

Overrides:

• THING.Object3D#setPickable

Example

object.setPickable(true, true);

setRenderOrder(value, recursive) → {boolean}

thing/src/objects/Object3D.js, line 3165

设置渲染顺序。

Parameters:

Name	Type	Description
value	number	渲染顺序的值，渲染顺序从低到高。
recursive	boolean	为真表示处理所有子对象。

Returns:

boolean - 是否设置成功

Overrides:

• THING.Object3D#setRenderOrder

Example

object.setRenderOrder(10);

setStyle(value, recursiveopt)

thing/src/objects/Object3D.js, line 2376

整体设置样式

Parameters:

Name	Type	Attributes	Default	Description
value	object			样式对象
recursive	boolean	<optional>	false	是否影响孩子样式

Overrides:

• THING.Object3D#setStyle

Example

let box1 = new THING.Box();
	let box2 = new THING.Box({parent: box1});
	box1.setStyle({color: 'red'});
	// @expect(box1.style.color[0] == 1);
	// @expect(box1.style.color[1] == 0);
	// @expect(box1.style.color[2] == 0);
	// @expect(box2.style.color == null);

setVisible(value, recursiveopt)

thing/src/objects/Object3D.js, line 1689

设置visible的状态

Parameters:

Name	Type	Attributes	Default	Description
value	boolean			是否显示
recursive	boolean | ProcessObjectCallback	<optional>	false	是否同时影响它的孩子

Overrides:

• THING.Object3D#setVisible

Example

// Hide object self only, exclude all children
	object.setVisible(false, false);

	// Hide object(s) but exclude children what name equals to 'stone'
	object.setVisible(false, (obj) => {
		if (obj.name == 'stone') {
			return false;
		}
	});

stopAllAnimations()

thing/src/objects/BaseEntity.js, line 327

停止所有动画

Example

var UinoSpaceman = new THING.Entity({url:'.assets/models/UinoSpaceman/UinoSpaceman.gltf'});
UinoSpaceman.waitForComplete().then(() => {
  UinoSpaceman.playAnimation({ name: 'Walk', loopType: "Repeat" });
  let ret1 = UinoSpaceman.isAnimationPlaying('Walk');
  UinoSpaceman.stopAllAnimations();
  let ret2 = UinoSpaceman.getAnimationState() == 'Stopped';
	 // @expect(ret1 == true && ret2 == true);
});

stopAnimation(name)

thing/src/objects/BaseEntity.js, line 312

停止动画

Parameters:

Name	Type	Description
name	string	动画名称

Example

var UinoSpaceman = new THING.Entity({url:'.assets/models/UinoSpaceman/UinoSpaceman.gltf'});
UinoSpaceman.waitForComplete().then(() => {
  UinoSpaceman.playAnimation({ name: 'Walk', loopType: "Repeat" });
  let ret1 = UinoSpaceman.isAnimationPlaying('Walk');
  UinoSpaceman.stopAnimation('Walk');
  let ret2 = UinoSpaceman.getAnimationState() == 'Stopped';
	 // @expect(ret1 == true && ret2 == true);
});

stopFading()

thing/src/objects/Object3D.js, line 3890

停止淡入淡出动作。

Overrides:

• THING.Object3D#stopFading

Example

object.stopFading();

stopFlying()

thing/src/objects/Object3D.js, line 3966

停止飞行

Overrides:

• THING.Object3D#stopFlying

Example

object.stopFlying();

stopMoving()

thing/src/objects/Object3D.js, line 3647

停止移动

Overrides:

• THING.Object3D#stopMoving

Example

object.stopMoving();

stopRotating()

thing/src/objects/Object3D.js, line 3811

停止旋转

Overrides:

• THING.Object3D#stopRotating

Example

object.stopRotating();

stopScaling() → {boolean}

thing/src/objects/Object3D.js, line 3753

停止缩放动画

Returns:

boolean - 是否停止成功

Overrides:

• THING.Object3D#stopScaling

Example

object.stopScaling();

stopUVTransform(slotType) → {boolean}

thing/src/objects/Object3D.js, line 4065

停止UV变化 主要用于贴图动画

Parameters:

Name	Type	Description
slotType	ImageSlotType	指定纹理类型

Returns:

boolean - 是否停止成功

Overrides:

• THING.Object3D#stopUVTransform

Example

object.stopUVTransform(THING.ImageSlotType.Map);

translate(offset, lerpParamopt) → {boolean}

thing/src/objects/Object3D.js, line 4537

沿三个轴向对物体做偏移

Parameters:

Name	Type	Attributes	Description
offset	Array.<number>		三个轴向的偏移 单位米
lerpParam	LerpArgs	<optional>	插值信息

Returns:

boolean - 是否平移成功

Overrides:

• THING.Object3D#translate

Example

object.translate([10, 10, 10], {time: 1000})

translateX(distance, lerpParamopt) → {boolean}

thing/src/objects/Object3D.js, line 4489

沿着自身X轴对物体做偏移

Parameters:

Name	Type	Attributes	Description
distance	number		偏移距离 单位米
lerpParam	LerpArgs	<optional>	插值信息

Returns:

boolean - 是否平移成功

Overrides:

• THING.Object3D#translateX

Example

object.translateX(10, {time: 1000})

translateY(distance, lerpParamopt) → {boolean}

thing/src/objects/Object3D.js, line 4505

沿着自身Y轴对物体做偏移

Parameters:

Name	Type	Attributes	Description
distance	number		偏移距离 单位米
lerpParam	LerpArgs	<optional>	插值信息

Returns:

boolean - 是否平移成功

Overrides:

• THING.Object3D#translateY

Example

object.translateY(10, {time: 1000})

translateZ(distance, lerpParamopt) → {boolean}

thing/src/objects/Object3D.js, line 4521

沿着自身Z轴对物体做偏移

Parameters:

Name	Type	Attributes	Description
distance	number		偏移距离 单位米
lerpParam	LerpArgs	<optional>	插值信息

Returns:

boolean - 是否平移成功

Overrides:

• THING.Object3D#translateZ

Example

object.translateZ(10, {time: 1000})

traverse(callback)

thing/src/objects/BaseObject.js, line 2100

递归遍历自己和自己的孩子 这个方法会遍历到所有的后代节点(孩子,孩子的孩子等)

Parameters:

Name	Type	Description
callback	function	The callback function. 执行遍历时执行的方法

Overrides:

• THING.Object3D#traverse

Example

let parent = new THING.BaseObject();
let child1 = new THING.BaseObject({parent: parent});
let child2 = new THING.BaseObject({parent: parent});
let mark = 0;
parent.traverse((child) => {
		mark++;
});
// @expect(mark == 3)

traverseComponentByType(type, callback)

thing/src/components/BaseComponentGroup.js, line 511

根据类型遍历查找组件

Parameters:

Name	Type	Description
type	*	组件类型
callback	TraverseComponentByTypeCallback	回调函数

Overrides:

• THING.Object3D#traverseComponentByType

Example

object.addComponent(new MyComponent(), 'myComponent');
	object.traverseComponentByType(MyComponent, (component, name) => {
		console.log(component, name);
	});

trigger(type, condition, data, tagName) → {*}

thing/src/objects/BaseObject.js, line 1530

抛出事件

Parameters:

Name	Type	Description
type	string	事件类型。
condition	string | object	事件条件 或 事件数据。
data	object | string	事件数据 或 事件标签。
tagName	string	事件标签名称。

Returns:

* - 返回一个对象，包含指定类型的事件

Overrides:

• THING.Object3D#trigger

Example

let object = new THING.BaseObject();
 let markTrigger = {};
	object.on('myEvent', function(ev) {
		markTrigger = ev;
	});
	object.trigger('myEvent', { result: true });
 let ret = markTrigger.result;
 // @expect(ret == true);

new THING.Box();

 app.on('test', (e) => {
     console.log('无条件+tag1', e)
 }, 'MyTag1');
 app.on('test', (e) => {
     console.log('无条件+tag2', e)
 }, 'MyTag2');

app.on('test', ".Box", (e) => {
	    console.log('条件+tag1', e)
}, 'MyTag1');
app.on('test', ".Box", (e) => {
	    console.log('条件+tag2', e)
}, 'MyTag2');

// 事件类型 + 事件条件，触发事件。
app.trigger('test', '.Box');
// 事件类型 + 事件数据，触发事件
app.trigger('test', { result: true });
// 事件类型 + 事件条件 + 事件标签，触发事件
app.trigger('test', '.Box', 'MyTag2');
// 事件类型 + 事件条件 + 事件参数，触发事件
app.trigger('test', '.Box', { result: true });
// 事件类型 + 事件条件 + 事件数据 + 事件标签，触发事件
app.trigger('test', '.Box', { result: true },'MyTag2');

// 注意事项:
// 1. 事件标签不能单独使用，否则事件标签和事件条件无法区分。
app.trigger('test', null, 'MyTag2');
// 2. 事件数据兼容了数组的情况，如果传了数组将无法从参数中获取object。
app.trigger('test', '.Box', [{ result: 'r1' },{ result: 'r2' }], 'MyTag2')

unbindSubNode()

thing/src/objects/Object3D.js, line 4851

解绑子节点。

Overrides:

• THING.Object3D#unbindSubNode

Example

let box = new THING.Box();
	box.bindSubNode(car, 'chair');
	box.unbindSubNode();

unloadResource(recursiveopt) → {Promise.<any>}

thing/src/objects/Object3D.js, line 2671

卸载资源 返回一个Promise对象

Parameters:

Name	Type	Attributes	Default	Description
recursive	boolean	<optional>	true	是否卸载所有孩子的资源

Returns:

Promise.<any> - 返回一个Promise对象

Overrides:

• THING.Object3D#unloadResource

Example

// 等待物体卸载资源完成
	await object.unloadResource();

uvTransformTo(slotType, value) → {boolean}

thing/src/objects/Object3D.js, line 4104

开始UV变化

Parameters:

Name	Type	Description
slotType	ImageSlotType	指定纹理类型 (diffuseMap,alphaMap,emissiveMap等)
value	LerpArgs	插值参数 参数中需指定UV对象中要变化哪个属性 包含以下四种 {number[]} offset,{number[]} repeat,{number[]} center(number[]),{number} rotation

Returns:

boolean - 是否开始成功

Overrides:

• THING.Object3D#uvTransformTo

Example

// Lerp UV offset from [0, 0] to [-1, 0] in 2 seconds by repeat mode
object.uvTransformTo(THING.ImageSlotType.Map, {
	from: { offset: [0, 0] },
	to: { offset: [-1, 0] },
	duration: 2000,
	loopType: THING.LoopType.Repeat,
	times: 3
});

waitForComplete() → {Promise.<any>}

thing/src/objects/Object3D.js, line 2516

等待物体资源加载完成 返回一个Promise对象

Returns:

Promise.<any> - 返回一个Promise对象

Overrides:

• THING.Object3D#waitForComplete

Example

// 等待物体资源加载完成
	await object.waitForComplete();
	app.camera.fit(object);

worldToLocal(position, ignoreScaleopt) → {Array.<number>}

thing/src/objects/Object3D.js, line 4745

世界坐标转为相对于父物体的坐标

Parameters:

Name	Type	Attributes	Default	Description
position	Array.<number>			世界坐标
ignoreScale	boolean	<optional>	false	转换时是否忽略缩放 默认不忽略

Returns:

Array.<number> - 返回相对于父物体的坐标

Overrides:

• THING.Object3D#worldToLocal

Example

let parentObj = new THING.Object3D({
	position: [0, 5, 0]
});

let childObj = new THING.Object3D({
	localPosition: [0, 10, 0],
	parent: parentObj
});

let localPosition = childObj.worldToLocal([0, 5, 0]);

// print [0, 0, 0]
console.log(localPosition);

worldToSelf(position, ignoreScaleopt) → {Array.<number>}

thing/src/objects/Object3D.js, line 4685

世界坐标转自身坐标

Parameters:

Name	Type	Attributes	Default	Description
position	Array.<number>			世界坐标
ignoreScale	boolean	<optional>	false	转换时是否忽略缩放 默认不忽略

Returns:

Array.<number>

Overrides:

• THING.Object3D#worldToSelf

Example

let worldPos = [5, 10, 0];
let obj = new THING.Object3D({position: worldPos});
let selfPos = obj.worldToSelf(worldPos);
// print [0, 0, 0]
console.log(selfPos);