LCCObject::intersectsRayFromOriginExt

基於碰撞體的射線檢測，支持自定義起點和方向。

版本要求

SDK v0.5.0+

引擎支持

Three.js

API

LCCObject::intersectsRayFromOriginExt(param: IntersectsRayFromOriginExtParam): IntersectsResult | null

參數

參數	類型	必選	默認值	描述
`param.origin`	`{ x: number, y: number, z: number }`	是	-	射線原點。
`param.direction`	`{ x: number, y: number, z: number }`	是	-	射線方向。
`param.maxDistance`	`number`	是	-	檢測距離，單位為米。

返回值

檢測成功時返回包含 point 和 normal 的對象；檢測失敗時返回 null。

屬性	類型	描述
`point`	`{ x: number, y: number, z: number }`	碰撞點坐標，世界坐標空間的值。
`normal`	`{ x: number, y: number, z: number }`	碰撞點法線，世界坐標空間的值。

使用示例

const ret = lccObject.hasCollision();
if (ret) {
    const origin = { x: 10, y: 10, z: 10 };
    const direction = { x: 1, y: 0, z: 0 };
    const maxDistance = 10;
    let result = lccObject.intersectsRayFromOriginExt({ origin, direction, maxDistance });
    if (result) {
        console.log('point: ', result.point.x, result.point.y, result.point.z);
        console.log('normal: ', result.normal.x, result.normal.y, result.normal.z);
    } else {
        // No point detected
    }
} else {
    // Collision function not supported
}

注意事項

此接口需在 LCCRender.load() 的成功回調函數觸發後調用。
使用前應先通過 hasCollision() 查詢是否支持碰撞檢測。
SDK 只加載相機位置附近範圍的碰撞數據。