LCCObject::intersectsSphere
球体コリジョンテストを行います。
バージョン要件
SDK v0.4.1+
エンジンサポート
Three.js
API
LCCObject::intersectsSphere(param: IntersectsSphereParam): IntersectsSphereResult
パラメータ
| パラメータ | 型 | 必須 | デフォルト値 | 説明 |
|---|---|---|---|---|
param.center | { 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 center = { x: 10, y: 10, z: 10 };
const radius = 1;
const noDelta = true;
let intersectResult = lccObject.intersectsSphere({ center, radius, noDelta });
if (intersectResult.hit) {
console.log('Collision occurs');
}
} else {
// Collision function not supported
}
注意事項
- このメソッドは
LCCRender.load()の成功コールバックが発生した後に呼び出す必要があります。 - 使用前に
hasCollision()でコリジョンのサポートを確認してください。 - SDK はカメラ位置の近傍のコリジョンデータのみを読み込みます。
関連 API
LCCObject::hasCollision()LCCObject::intersectsCapsule()