App(param)

AppApp 是 ThingJS 库入口，提供加载场景、搜索、事件绑定、摄像机控制等功能

new App(param)
thing/src/core/App.js, line 68

App构造方法
Parameters:
Name Type Description
param object App初始化的参数
Properties
Name Type Attributes Default Description
container HTMLElement 渲染场景需要的dom元素
isEditor boolean <optional>
 false 是否在编辑器环境使用
enableDefaultLevelControl boolean <optional>
 true 是否默认开启层级控制
background? number | string | Array.<number> 背景
envMap string <optional>
 环境图url
url string <optional>
 场景url
onComplete function <optional>
 场景加载完成后的回调函数
onProgress function <optional>
 场景加载进度的回调函数
onError function <optional>
 场景加载失败后的回调函数
Example
// Load bundle scene
const app = new THING.App({
	 url: './scene-bundle',
	 onComplete: (e) => {
    console.log(e);
  }
});

// Load gltf scene
const app = new THING.App({
  url: './gltf/scene.gltf',
  onComplete: (e) => {
    console.log(e);
  }
});

Extends

Members

background :number|string|Array.<number>|THING.ImageTexture|THING.VideoTexture
thing/src/core/App.js, line 2350

获取/设置背景。
Example
THING.App.current.background = 'gray';
let ret = THING.App.current.background instanceof Array;
// @expect(ret == true )
// 设置背景为天空盒(多张)
THING.App.current.background = new THING.CubeTexture([
    './skyboxes/bluesky/posx.jpg', './skyboxes/bluesky/negx.jpg',
    './skyboxes/bluesky/posy.jpg', './skyboxes/bluesky/negy.jpg',
    './skyboxes/bluesky/posz.jpg', './skyboxes/bluesky/negz.jpg'
]);
// 设置背景为天空盒(单张)
// 使用环境贴图创建新的图像纹理，作为天空盒
THING.App.current.background = new THING.ImageTexture({url: "../texture/envmap.jpg",  mappingType: THING.ImageMappingType.EquirectangularReflection });
// 创建新的图像纹理，作为天空盒
THING.App.current.background = new THING.ImageTexture({url: "../texture/envmap.jpg" });
// 设置背景为图像路径，作为天空盒
THING.App.current.background = "../texture/envmap.jpg";

camera :THING.Camera
thing/src/core/App.js, line 1462

获取/设置 相机对象
Example
let camera = new THING.Camera();
camera.far = 100;
THING.App.current.camera = camera;
let ret = THING.App.current.camera.far == 100;
// @expect(ret == true)

readonly components :Map.<String, THING.BaseComponent>
thing/src/components/BaseComponentGroup.js, line 873

获取所有组件
Overrides:
Example
let obj = new THING.BaseObject();;
obj.addComponent(new THING.BaseComponent(), 'component1');
obj.addComponent(new THING.BaseComponent(), 'component2');
// @expect(obj.components.size == 2)

container :object
thing/src/core/App.js, line 1374

Get the container.
Example
//the html div id is div3d
let id = THING.App.current.container.id;
let ret = id == 'div3d';
// @expect(ret == true);

envMap :THING.CubeTexture
thing/src/core/App.js, line 2366

获取/设置场景默认的环境图。
Example
THING.App.current.envMap = new THING.CubeTexture('./skyboxes/bluesky');
let ret = THING.App.current.envMap.url == './skyboxes/bluesky';
// @expect(ret == true )

helper :THING.AppHelperComponent
thing/src/core/App.js, line 921

获取帮助对象

isApp :boolean
thing/src/core/App.js, line 2422

是否是app对象
Example
let app = THING.App.current;
if (app.isApp) {
		console.log(`It's app`);
	}

isEditor :boolean
thing/src/core/App.js, line 2431

是否在编辑器环境运行

level :THING.LevelManager
thing/src/core/App.js, line 960

获取层级管理器
Example
let app = THING.App.current;
let level = app.level;
let target = app.query('.Entity')[0];
level.change(target, {
  onComplete: function(){
		let ret = level.current == target;
		// @expect(ret == true);
  }
});

picker :THING.Picker
thing/src/core/App.js, line 880

获取拾取器
Example
let picker = app.picker;
// @expect(picker != null)
picker.enable = false;
// @expect(picker.enable == false)

pixelRatio :number
thing/src/core/App.js, line 1504

获取/设置像素比例。设置/获取像素比例，默认为1，可以设置为0-1之间的值。值越大，渲染效果越清晰（帧率较低）；值越小，渲染效果越模糊（帧率较高）。在移动设备上，为了提高渲染帧率，可以将app.pixelRatio设置为小于1的值。
Example
let app = THING.App.current;
app.pixelRatio = 0.5;
let ret = app.pixelRatio == 0.5;
// @expect(ret == true)

relationshipManager :THING.RelationshipManager
thing/src/core/App.js, line 937

获取关系管理器

readonly relationships :Array.<THING.Relationship>
thing/src/core/App.js, line 1447

获取所有的对象关系。
Example
let app = THING.App.current;
 let count1 = app.relationships.length;
 app.relationshipManager.addRelationship({
		source: app.root,
	    target: app.root
 })
 let count2 = app.relationships.length;
 let ret = count2 - count1;
 // @expect(ret == 1)

renderSettings :RenderSettingsInfo
thing/src/core/App.js, line 835

root :THING.RootObject
thing/src/core/App.js, line 1425

获取根对象。
Example
let root = THING.App.current.root;
 // @expect(root.isRootObject == true)

size :Array.<number>
thing/src/core/App.js, line 1400

获取大小。
Example
// div3d的大小是1024*768
let size = THING.App.current.size;
// @expect(size[0] == 1024 && size[1] == 768);

tweenManager :THING.TweenManager
thing/src/core/App.js, line 929

获取TweenManager

workPath :string
thing/src/core/App.js, line 2445

设置/获取工作路径 调用app.resolveURL(url)时,如果url以"/"开头,会在url之前拼上workPath
Example
THING.App.current.workPath = 'project/root/';
let ret = THING.App.current.workPath;
// @expect(ret == 'project/root/' )

static current :THING.App
thing/src/core/App.js, line 83

当前App对象
Example
let app = THING.App.current;
let ret = app.picker != null;
// @expect(ret == true);

Methods

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:
Example
let obj = new THING.BaseObject();;
obj.addComponent(new THING.BaseComponent(), 'myComponent');
// @expect(obj.myComponent != null)

create(param) → {THING.BaseObject}
thing/src/core/App.js, line 648

创建对象2.0兼容1.0中通过app.create({type:'ClassName'})的方式创建对象，
但是推荐使用new THING.ClassName({xxx})的方式创建对象。
Parameters:
Name Type Description
param object The parameter list 参数列表
Properties
Name Type Description
type string Object type 类型
options? object Object create parameters 创建对于类型对象的初始化参数
Returns:
THING.BaseObject - 返回创建的对象
Deprecated:
  • Yes
Example
let app =  THING.App.current;
let box = app.create({
  type: 'Box',
  name: 'box',
  position: [1, 1, 1],
  onComplete: function() {
  	console.log('box01 created!');
  }
});
let ret = box instanceof THING.Box;
// @expect(ret == true);

dispose()
thing/src/core/App.js, line 548

销毁app
Example
let app = THING.App.current;
app.dispose();

find(condition) → {THING.BaseObject}
thing/src/core/App.js, line 1541

查询app下所有符合条件的对象并返回第一个
Parameters:
Name Type Description
condition string The conditions. 查询条件
Returns:
THING.BaseObject - 返回第一个符合条件的对象
Example
let obj = THING.App.current.find('.BaseObject');
 let ret = obj instanceof THING.BaseObject;
// @expect(ret == true)
 let cylinder = THING.App.current.find('.Cylinder');
 ret = cylinder == null;
// @expect(ret == true)

getAllComponents() → {Array.<THING.BaseComponent>}
thing/src/components/BaseComponentGroup.js, line 615

获取所有组件
Returns:
Array.<THING.BaseComponent>
Overrides:
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)

getComponentByName(name) → {THING.BaseComponent}
thing/src/components/BaseComponentGroup.js, line 538

根据名称获取组件对象
Parameters:
Name Type Description
name string 组件名称
Returns:
THING.BaseComponent
Overrides:
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:
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:
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)

getEvent(type, condition, tag) → {ObjectListenerInfo}
thing/src/core/App.js, line 2003

暂事件。
Parameters:
Name Type Description
type string 事件类型。
condition string 选择对象的条件。
tag string 事件标签。
Returns:
ObjectListenerInfo - 返回事件信息
Example
let app = THING.App.current;
let event = app.getEvent('test', '.BaseObject', 'test');
let ret = event instanceof THING.ObjectListenerInfo;
// @expect(ret == true);

getEvents(type) → {Array.<ObjectListenerInfo>}
thing/src/core/App.js, line 1986

根据类型获取事件。
Parameters:
Name Type Description
type string 事件类型，null 表示获取所有事件。
Returns:
Array.<ObjectListenerInfo> - 返回事件信息数组
Example
let app = THING.App.current;
let events = app.getEvents();
let ret = events.length > 0;
// @expect(ret == true);

hasComponent(name) → {boolean}
thing/src/components/BaseComponentGroup.js, line 644

判断是否含有特定名称的组件
Parameters:
Name Type Description
name string 组件名称
Returns:
boolean
Overrides:
Example
let obj = new THING.BaseObject();;
obj.addComponent(new THING.BaseComponent(), 'myComponent');
let ret = obj.hasComponent('myComponent')
// @expect(ret == true)

invoke(type, condition, data, tagName) → {Promis}
thing/src/core/App.js, line 2243

触发事件。
Parameters:
Name Type Description
type string 事件类型。
condition string 事件条件。
data object 事件数据
tagName string 事件标签名称。
Returns:
Promis - 返回Promise

load(url, options) → {Promise}
thing/src/core/App.js, line 696

加载场景
Parameters:
Name Type Description
url string | object 场景url
options object 加载参数
Properties
Name Type Description
dynamic boolean 是否动态加载
hidden boolean 加载时是否隐藏
useDefaultTheme boolean 是否使用场景自带的样式
useDefaultViewpoint boolean 是否使用场景自带的相机视角
useDefaultRenderSettings boolean 是否使用场景自带的环境参数
position Array.<number> 场景位置
rotation Array.<number> 场景的旋转角度
onComplete function 加载完成的回调
onProgress function 加载进度的回调
onError function 加载异常的回调
Returns:
Promise - 由于加载时异步过程,返回一个Promise对象
Example
THING.App.current.load('./assets/scenes/scene.gltf').then((ev) => {
    let objs = ev.objects;
	   let count =  objs.length;
   // @expect(count > 0);
})

loadCubeTexture(url, sampler) → {THING.CubeTexture}
thing/src/core/App.js, line 749

Load cube texture。
Parameters:
Name Type Description
url string The resource url
sampler LoadTextureResourceSamplerInfo The sampler info.
Returns:
THING.CubeTexture - 返回立方体纹理
Example
let image = THING.App.current.loadCubeTexture([
	'./skyboxes/bluesky/posx.jpg', './skyboxes/bluesky/negx.jpg',
	'./skyboxes/bluesky/posy.jpg', './skyboxes/bluesky/negy.jpg',
	'./skyboxes/bluesky/posz.jpg', './skyboxes/bluesky/negz.jpg'
]);

loadImageTexture(url, sampler) → {THING.ImageTexture}
thing/src/core/App.js, line 732

加载图片纹理
Parameters:
Name Type Description
url string 资源路径
sampler LoadTextureResourceSamplerInfo 纹理采样参数
Returns:
THING.ImageTexture - 返回图片纹理
Example
let image = THING.App.current.loadImageTexture('./flower.png');
	await image.waitForComplete();
	console.log(image);

loadPlugin(url, options) → {Promise}
thing/src/core/App.js, line 714

加载插件
Parameters:
Name Type Description
url string 插件路径
options object 加载参数
Properties
Name Type Description
name string 插件名称
onComplete function 加载成功的回调
onError function 加载失败的回调
Returns:
Promise - Promise对象
Example
THING.App.current.loadPlugin('./assets/plugins/plugin.json').then((plugin)=>{
	console.log(plugin);
});

off(type, condition, tag)
thing/src/core/App.js, line 2127

注销事件
Parameters:
Name Type Description
type string 事件类型。
condition string 选择对象的条件。注册事件的条件。
tag string 事件标签。用于标识事件。
Example
let app = THING.App.current;
let markOff = 0;
app.on('testOff', function(ev) {
		markOff = 1;
});
app.trigger('testOff');
// @expect(markOff == 1);
markOff = 0;
app.off('testOff');
app.trigger('testOff');
// @expect(markOff == 0);

on(type, condition, callback, tag, priority, options)
thing/src/core/App.js, line 2079

注册事件
Parameters:
Name Type Description
type string 事件类型。
condition string 选择对象的条件。在注册事件之前进行查询，对符合条件的对象进行注册。
callback EventCallback 回调函数。事件触发时执行的函数。
tag string 事件标签。用于标识事件。
priority number 优先级值（默认为0，数值越高，优先级越高）。
options ObjectEventOptions 事件参数。
Example
let app = THING.App.current;
let markOn = 0;
app.on('testOn', function(ev) {
		markOn = 1;
});
app.trigger('testOn');
// @expect(markOn == 1);

once(type, condition, callback, tag, priority, options)
thing/src/core/App.js, line 2104

注册一次性的事件，此事件响应只会触发一次，触发后会被自动注销。
Parameters:
Name Type Description
type string 事件类型
condition string 选择对象的条件。在注册事件之前进行查询，对符合条件的对象进行注册。
callback EventCallback 回调函数。事件触发时执行的函数。
tag string 事件标签。用于标识事件。
priority number 优先级值（默认为0，数值越高，优先级越高）。
options ObjectEventOptions 事件参数。
Example
let app = THING.App.current;
let markOnce = 0;
app.once('testOnce', function(ev) {
		markOnce = 1;
});
app.trigger('testOnce');
// @expect(markOnce == 1);
markOnce = 0;
app.trigger('testOnce');
// @expect(markOnce == 0);

pauseEvent(type, condition, tag) → {boolean}
thing/src/core/App.js, line 2151

暂停事件
Parameters:
Name Type Description
type string 事件类型
condition string 注册事件的条件
tag string 事件的tag
Returns:
boolean - 返回是否暂停成功
Example
let app = THING.App.current;
let markPause = 0;
app.on('testPause', function(ev) {
		markPause = 1;
});
app.trigger('testPause');
// @expect(markPause == 1);
markPause = 0;
app.pauseEvent('testPause');
app.trigger('testPause');
// @expect(markPause == 0);

query(condition, options) → {THING.Selector}
thing/src/core/App.js, line 1683

根据条件查询对象 返回所有满足条件的对象集合
Parameters:
Name Type Description
condition string 查询条件
options ObjectQueryOptions 查询参数 主要包括是否递归查询和是否包含自身
Returns:
THING.Selector - 查询结果
Example
// 1. 基本查询
let obj = THING.App.current.query('.BaseObject');
let ret = obj[0] instanceof THING.BaseObject;
// @expect(ret == true)

// 2. 按对象名称查询
let car = app.query('car01'); // 精确匹配名称
let door = app.query('正门摄像头'); // 查询名称为"正门摄像头"的对象

// 3. 按正则表达式查询名称
// 方式一: 直接使用正则
let frontDoors = app.query(/正门/); // 查询名称包含"正门"的对象

// 方式二: 构造正则
let regex = new RegExp("南天门");
let gates = app.query(regex);

// 方式三: 使用正则组合
let doors = app.query(/(正门|侧门|后门)/); // 查询包含任意门的对象

// 方式四: 动态构造正则
let name = "南天门";
let dynamicRegex = eval("/"+name+"/");
let dynamicResult = app.query(dynamicRegex);

// 4. 按对象类查询
let points = app.query('.GeoBasePoint'); // 查询所有地图点对象
let campus = app.query('.Campus'); // 查询园区类
let buildings = app.query('.Building'); // 查询建筑类
let floors = app.query('.Floor'); // 查询楼层类
let rooms = app.query('.Room'); // 查询房间类
let devices = app.query('.Device'); // 查询设备类对象
let groups = app.query('.Group'); // 查询组
let cabinets = app.query('.Cabinet'); // 查询机柜
let racks = app.query('.Rack'); // 查询柜内架式设备

// 5. 按对象ID查询 (注意: ID查询通常只返回一个对象,建议加[0])
let obj1 = app.query('#100')[0]; // id查询需要加#
let earth = app.query('[uuid=earthRoot]')[0]; // 获取地图根对象

// 6. 按对象分类查询
let alarms = app.query('[alarm]'); // 查询有alarm属性的对象
let cameras = app.query('[twinType=摄像头]'); // 查询分类为摄像头的对象

// 7. 按对象属性查询 (注意: 条件需要用[]括起来)
// 7.1 自定义属性查询
let chinaDevices = app.query('[userData/DATA/产地=中国]');

// 7.2 系统属性查询
let dbObj = app.query('[userData/_DBID_=7499775862803471]'); // 按数据库ID查询
let ciObj = app.query('[userData/_CICODE_=7366821180693235]'); // 按CICODE查询
let typeObj = app.query('[userData/_SHOWTYPE_=建筑]'); // 按对象分类查询
let childObj = app.query('[userData/_PARENT_=优锘产业园_PARK]'); // 按父对象编号查询
let parentNameObj = app.query('[userData/_PARENTNAME_=T1]'); // 按父对象名称查询

// 7.3 其他属性查询
let upperFloors = app.query('[levelNum>2]'); // 查询2层以上的楼层
let hasChildren = app.query('[children!=""]'); // 查询有子对象的对象
let visibleObj = app.query('[visible=1]'); // 查询可见对象
let hiddenObj = app.query('[visible="0"]'); // 查询隐藏对象
let uuidObj = app.query('[uuid="xxxx"]'); // 查询指定uuid的对象

// 8. 按监控数据查询
let tempObj = app.query('[MONITOR/_/_/温度/value=38]'); // 查询温度为38的对象
let highTempObj = app.query('[MONITOR/_/_/温度/value>18.8]'); // 查询温度大于18.8的对象

// 9. 查询全部对象
// 9.1 按类型查询全部
let allDevices = app.query('.Device'); // 查询全部设备
let allThings = app.query('.Thing'); // 查询全部物体对象(含设备、标记)
let allTwins = app.query('[twinType]'); // 获取孪生体管理中全部对象

// 9.2 查询所有可管理对象
let allObjects = app.query('.BaseObject');
// 或使用以下方式
let objects1 = app.query('[isBaseObject=1]');
let objects2 = app.query('[queryID]');
let objects3 = app.query('[pickable=1]');

// 9.3 通配符查询
let everything1 = app.query('*'); // 使用星号通配符

// 9.4 查询所有对象(包括运行时创建的)
let all = app.query('/');

// 10. 局部查询
let building = app.query('.Building')[0];
let upperFloors = building.query('[levelNum > 1]'); // 查询该建筑二层以上楼层

// 11. 多条件查询
let visibleTrains = app.query('[businessType=高铁列车]&&[visible=1]'); // 与查询
let floorsAndBuildings = app.query('.Floor || .Building'); // 或查询

// 12. 筛选查询
// 12.1 链式查询
let ibmDevices = app.query('.Device').query('[userData/DATA/品牌=IBM]');

// 12.2 组合查询
let brandAA = app.query('[userData/DATA/品牌=AA]');
let deviceOrBrandAA = app.query('.Device').add(brandAA); // 并集
let devicesExceptCar = app.query('.Device').not('car01'); // 差集

// 13. 查询结果操作
// 13.1 批量修改基本属性
app.query('.Building').visible = false; // 隐藏所有建筑

// 13.2 遍历操作
app.query('.Building').forEach(building => {
  console.log(building.name);
});

// 13.3 层级访问
app.query('.Building').forEach(building => {
  building.floors.forEach(floor => { // 访问建筑的楼层
    floor.style.opacity = 0.5;
  });
});

// 14. 根据标签查询
// 查询包含 Floor 标签的对象
let floors = app.query('tags:Floor');

// 使用 and 操作符查询同时包含多个标签的对象
let objects = app.query('tags:and(Floor,Wall)');

// 使用 or 操作符查询包含任一标签的对象
let objects = app.query('tags:or(Floor,Wall)');

// 使用 not 操作符查询不包含指定标签的对象
let objects = app.query('tags:not(Floor)');

queryAll(condition, options) → {THING.Selector}
thing/src/core/App.js, line 1705

查询app下所有符合条件的对象并返回所有匹配的结果
Parameters:
Name Type Description
condition string The conditions. 查询条件
options ObjectQueryOptions 查询参数 主要包括是否递归查询和是否包含自身
Returns:
THING.Selector - 查询结果
Example
let objects = THING.App.current.queryAll('.BaseObject');
	let ret = objects.length > 0;
// @expect(ret == true)
	let cylinders = THING.App.current.queryAll('.Cylinder');
	ret = cylinders.length == 0;
// @expect(ret == true)

queryByDTType(condition, options) → {THING.Selector}
thing/src/core/App.js, line 1837

根据孪生体类型查询
Parameters:
Name Type Description
condition string 查询条件
options ObjectQueryOptions 查询参数
Returns:
THING.Selector - 查询结果
Example
let equipment = THING.App.current.queryByDTType('Equipment')
	let ret = equipment.length == 0;
// @expect(ret == true)
 let sensor = THING.App.current.queryByDTType('Sensor')
 ret = sensor[0].dtType == 'Sensor';
// @expect(ret == true)

queryById(condition, options) → {THING.Selector}
thing/src/core/App.js, line 1749

根据id查询
Parameters:
Name Type Description
condition string 查询条件
options ObjectQueryOptions 查询参数
Returns:
THING.Selector - 查询结果
Example
let car = THING.App.current.queryById('1')
	let ret = car.length == 0;
 // @expect(ret == true);
 car = THING.App.current.queryById('car01')
 ret = car[0].id == 'car01';
 // @expect(ret == true)

queryByName(condition, options) → {THING.Selector}
thing/src/core/App.js, line 1727

根据名称查询
Parameters:
Name Type Description
condition string 查询条件
options ObjectQueryOptions 查询参数 主要包括是否递归查询和是否包含自身
Returns:
THING.Selector - 查询结果
Example
let car = THING.App.current.queryByName('car01')
	let ret = car.length == 0;
	// @expect(ret == true)
 car = THING.App.current.queryByName('car1')
 ret = car[0].name == 'car1';
// @expect(ret == true)

queryByRegExp(condition, options) → {THING.Selector}
thing/src/core/App.js, line 1897

根据正则表达式查询
Parameters:
Name Type Description
condition string 正则表达式
options ObjectQueryOptions 查询参数
Returns:
THING.Selector - 查询结果
Example
let car = THING.App.current.queryByRegExp(/car/);
	let ret = car.length == 4;
 //@expect(ret == true)

queryByTags(condition, options) → {THING.Selector}
thing/src/core/App.js, line 1771

根据tag查询
Parameters:
Name Type Description
condition string 查询条件
options ObjectQueryOptions 查询参数
Returns:
THING.Selector - 查询结果
Example
let car = THING.App.current.queryByTags('car');
	let ret = car.length == 0;
 // @expect(ret == true)
	let entity = THING.App.current.queryByTags('Entity');
	ret = entity[0].tags.has('Entity');
 // @expect(ret == true)

queryByType(condition, options) → {THING.Selector}
thing/src/core/App.js, line 1815

根据类型查询
Parameters:
Name Type Description
condition string 查询条件
options ObjectQueryOptions 查询参数
Returns:
THING.Selector - 查询结果
Example
let car = THING.App.current.queryByType('car')
	let ret = car.length == 0;
// @expect(ret == true)
 let obj = THING.App.current.queryByType('Entity')
 ret = obj[0].type == 'Entity';
// @expect(ret == true)

queryByUUID(condition, options) → {THING.Selector}
thing/src/core/App.js, line 1793

根据uuid查询
Parameters:
Name Type Description
condition string 查询条件
options ObjectQueryOptions 查询参数
Returns:
THING.Selector - 查询结果
Example
let car = app.queryByUUID('1')
	let ret = car.length == 0;
 // @expect(ret == true);
 car = app.queryByUUID('1605')
 ret = car[0].uuid == '1605';
 // @expect(ret == true)

queryByUserData(condition, options) → {THING.Selector}
thing/src/core/App.js, line 1859

根据userData(用户数据)查询
Parameters:
Name Type Description
condition string 查询条件
options ObjectQueryOptions 查询参数
Returns:
THING.Selector - 查询结果
Example
let car = THING.App.current.queryByUserData('test=1');
	let ret = car.length == 0;
 // @expect(ret == true)
 car = THING.App.current.queryByUserData('id=666');
 ret = car[0].userData.id == 666;
// @expect(ret == true)

queryRelationships(options) → {Array.<THING.Relationship>}
thing/src/core/App.js, line 1963

查询关系
Parameters:
Name Type Description
options object 参数
Properties
Name Type Description
type string 关系类型
name string 关系名称
Returns:
Array.<THING.Relationship> - 返回关系数组
Example
let lightSwitch = new THING.Box();
let light = new THING.Box();
let rel = new THING.Relationship({
     type: 'control',
     source: lightSwitch,
     target: light
});
let relationships = app.queryRelationships({type: 'control'});
let ret1 = relationships[0].source == lightSwitch;
let ret2 = relationships[0].target == light;
// @expect(ret1 == true && ret2 == true);

removeAllComponents()
thing/src/components/BaseComponentGroup.js, line 458

移除所有组件
Overrides:
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:
Example
let obj = new THING.BaseObject();;
obj.addComponent(new THING.BaseComponent(), 'myComponent');
obj.removeComponent('myComponent');
// @expect(obj.components.size == 0)

resize(width, height)
thing/src/core/App.js, line 2386

重置尺寸。
Parameters:
Name Type Description
width number 像素宽度。
height number 像素高度。
Example
let app = THING.App.current;
app.resize(100, 100);

resolveURL(url) → {string}
thing/src/core/App.js, line 2462

解析url
Parameters:
Name Type Description
url string 带解析的url 解析时会根据app.workPath进行url的拼接
Returns:
string - 解析后的url
Example
let app = THING.App.current;
let url = app.resolveURL('test.png');
// @expect(url == 'project/root/test.png');

resumeEvent(type, condition, tag) → {boolean}
thing/src/core/App.js, line 2178

恢复事件
Parameters:
Name Type Description
type string 事件类型。
condition string 选择对象的条件。注册事件的条件。
tag string 事件标签。用于标识事件。
Returns:
boolean - 返回是否恢复成功
Example
let app = THING.App.current;
let markResume = 0;
app.on('testResume', function(ev) {
		markResume = 1;
});
app.trigger('testResume');
// @expect(markResume == 1);
markResume = 0;
app.pauseEvent('testResume');
app.trigger('testResume');
// @expect(markResume == 0);
app.resumeEvent('testResume');
app.trigger('testResume');
// @expect(markResume == 1);

run()
thing/src/core/App.js, line 1189

启动app的运行和渲染
Example
let app = THING.App.current;
app.run();

stop()
thing/src/core/App.js, line 1246

停止app的渲染
Example
let app = THING.App.current;
app.stop();

traverseComponentByType(type, callback)
thing/src/components/BaseComponentGroup.js, line 511

根据类型遍历查找组件
Parameters:
Name Type Description
type * 组件类型
callback TraverseComponentByTypeCallback 回调函数
Overrides:
Example
object.addComponent(new MyComponent(), 'myComponent');
	object.traverseComponentByType(MyComponent, (component, name) => {
		console.log(component, name);
	});

trigger(type, condition, data, tagName) → {*}
thing/src/core/App.js, line 2230

触发事件。
Parameters:
Name Type Description
type string 事件类型。
condition string 事件条件。
data object 事件数据
tagName string 事件标签名称。
Returns:
* - 返回事件信息
Example
let markTrigger = {};
	THING.App.current.on('myEvent', function(ev) {
		markTrigger = ev;
	});
	THING.App.current.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');

// 注意事项:
// 事件标签不能单独使用，否则事件标签和事件条件无法区分。
app.trigger('test', null, 'MyTag2');

uninstall(name) → {boolean}
thing/src/core/App.js, line 761

根据名称卸载插件
Parameters:
Name Type Description
name string 插件名称
Returns:
boolean - 是否卸载成功
Example
THING.App.current.uninstall(plugin.name);

static addCompleteCallback(callback, priority)
thing/src/core/App.js, line 120

App实例初始化结束的回调
Parameters:
Name Type Default Description
callback function 回调函数
priority number 0 优先级
Example
THING.App.addCompleteCallback((app)=>{
		console.log(The app instantiation is complete.);
},-10);