LCCObject::intersectsCapsule

胶囊体碰撞测试。

可基于该接口实现数字人碰撞功能。

版本要求

SDK v0.4.1+

引擎支持

Three.js

API

LCCObject::intersectsCapsule(param: IntersectsCapsuleParam): IntersectsCapsuleResult

参数

参数	类型	必选	默认值	描述
`param.start`	`{ x: number, y: number, z: number }`	是	-	胶囊体底部点。
`param.end`	`{ x: number, y: number, z: number }`	是	-	胶囊体顶部点。
`param.radius`	`number`	是	-	胶囊体半径。
`param.noDelta`	`boolean`	否	-	设置为 `true` 时不计算碰撞偏移量，检测速度更快；设置为 `false` 时计算碰撞偏移量。

返回值

属性	类型	描述
`hit`	`boolean`	是否发生碰撞。
`delta`	`{ x: number, y: number, z: number }`	碰撞偏移量，可用于调整数字人位置。偏移量方向朝向胶囊体。仅在 `noDelta` 为 `false` 时有效。

使用示例

const ret = lccObject.hasCollision();
if (ret) {
    const start = { x: 10, y: 10, z: 0 };
    const end = { x: 10, y: 10, z: 1.7 };
    const radius = 1;
    const noDelta = false;
    let intersectResult = lccObject.intersectsCapsule({ start, end, radius, noDelta });
    if (intersectResult.hit) {
        console.log('Collision occurs, delta: ', intersectResult.delta);
    }
} else {
    // Collision function not supported
}

注意事项

此接口需在 LCCRender.load() 的成功回调函数触发后调用。
使用前应先通过 hasCollision() 查询是否支持碰撞检测。
SDK 只加载相机位置附近范围的碰撞数据。