LCCObject::intersectsRayExt

基于碰撞体的射线检测，支持通过屏幕点击获取坐标位置。

版本要求

SDK v0.5.0+

引擎支持

Three.js

API

LCCObject::intersectsRayExt(param: IntersectsRayExtParam): IntersectsResult | null

参数

参数	类型	必选	默认值	描述
`param.evt`	`MouseEvent` / `PointerEvent`	是	-	鼠标点击事件。
`param.maxDistance`	`number`	是	-	检测距离，单位为米。

返回值

检测成功时返回包含 point 和 normal 的对象；检测失败时返回 null。

属性	类型	描述
`point`	`{ x: number, y: number, z: number }`	碰撞点坐标，世界坐标空间的值。
`normal`	`{ x: number, y: number, z: number }`	碰撞点法线，世界坐标空间的值。

使用示例

const cond = lccObject.hasCollision();
if (cond) {
    document.addEventListener('mousedown', (evt) => {
        let ret = lccObject.intersectsRayExt({ evt: evt, maxDistance: 10 });
        if (ret) {
            console.log('point: ', ret.point.x, ret.point.y, ret.point.z);
            console.log('normal: ', ret.normal.x, ret.normal.y, ret.normal.z);
        } else {
            // No point detected
        }
    });
} else {
    // Collision function not supported
}

注意事项

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