Object3D.getObjectByProperty()

getObjectByProperty 方法可以根据指定的属性值，在当前 Object3D 对象及其子对象中查找第一个符合条件的对象并返回。

语法

getObjectByProperty(name: string, value: any)

参数

• name：属性名，值为字符串类型。
• value：属性值，可以是任意类型。

返回值

返回符合条件的第一个 Object3D 子对象，如果没有匹配的对象则返回 undefined。

示例代码

以下是使用 getObjectByProperty 方法查找符合特定属性的子对象的示例代码：

const scene = new THREE.Scene();
const cube = new THREE.Mesh(
  new THREE.BoxGeometry(1, 1, 1),
  new THREE.MeshBasicMaterial({ color: 0x00ff00 })
);
cube.position.set(2, 0, 0);
scene.add(cube);

const sphere = new THREE.Mesh(
  new THREE.SphereGeometry(1, 16, 16),
  new THREE.MeshBasicMaterial({ color: 0xff0000 })
);
sphere.position.set(-2, 0, 0);
scene.add(sphere);

const cylinder = new THREE.Mesh(
  new THREE.CylinderGeometry(0.5, 0.5, 1, 16),
  new THREE.MeshBasicMaterial({ color: 0x0000ff })
);
cylinder.position.set(0, -2, 0);
scene.add(cylinder);

const mesh = scene.getObjectByProperty("uuid", sphere.uuid);
console.log(mesh); // 输出 sphere 对象

上述示例代码创建了一个场景，并添加了三个不同的对象：一个立方体、一个球体和一个圆柱体。通过 getObjectByProperty 方法查找属性值为 sphere.uuid 的子对象，即查找球体对象。最后，返回的 mesh 对象即为球体对象。

注意事项

• getObjectByProperty 方法只会返回当前 Object3D 对象的子对象中符合条件的第一个对象。如果需要查找全部符合条件的对象，可以使用 getObjectsByProperty 方法。
• getObjectByProperty 方法只适用于查找当前 Object3D 对象及其子对象中，具有已知属性值的对象。如果需要查找其他类型的对象，可以使用 Object3D.traverse 方法遍历整个场景，然后在遍历过程中进行条件判断。