レイキャスト

3min
Raycast関数は、Unityのシーン内でオブジェクトを効率的に見つけるために使用できます。
UnityプログラミングにおけるRaycastは、シーン内の位置から発射され、コライダーに衝突するまで飛ぶレーザービームの一種です。

コライダーに衝突すると、衝突したオブジェクトの情報（RaycastHit）とシーン内の位置が返されます。
Unity Raycastの詳細については、Unityガイドを確認してください。
📘 Unity Raycast
https://docs.unity3d.com/Manual/CameraRays.html﻿
﻿
Unity Raycastは、次の手順を完了することでZEPETO.Scriptで使用できます：
まず、Raycast関連のクラスをインポートします。
TypeScript
import { Physics, RaycastHit } from 'UnityEngine';
import { Physics, RaycastHit } from 'UnityEngine';
﻿
以下はRaycast関数のサンプルコードです：
Raycast
import { ZepetoScriptBehaviour } from 'ZEPETO.Script';
import { Physics, RaycastHit, Input, Camera } from 'UnityEngine';
 
export default class RaycastSample extends ZepetoScriptBehaviour {
 
    Update() {
        this.MouseControl();
    }
      
    MouseControl() {
        if (Input.GetMouseButtonDown(0)) {
            let ray = Camera.main.ScreenPointToRay(Input.mousePosition);
      
            // RaycastHit情報を出力パラメータとして保持するためには、$refタグでラップする必要があります。
            // out修飾子をパラメータとして必要とするため、オブジェクトを実際に作成せずに参照を作成します。        
            let ref = $ref<RaycastHit>();
      
            if (Physics.Raycast(ray, ref, 1000)) {
                // 返されたRaycastヒットデータを確認するには、$unrefを使用して参照をアンラップすることを忘れないでください。
                let hitInfo = $unref(ref);
      
                console.log(`ヒットを検出！`);
                console.log(`hitInfo.collider.name : ${hitInfo.collider.name}`);
            } else {
                console.log(`衝突の検出に失敗しました`);
            }
        }
    }
 
}
import { ZepetoScriptBehaviour } from 'ZEPETO.Script';
import { Physics, RaycastHit, Input, Camera } from 'UnityEngine';
 
export default class RaycastSample extends ZepetoScriptBehaviour {
 
    Update() {
        this.MouseControl();
    }
      
    MouseControl() {
        if (Input.GetMouseButtonDown(0)) {
            let ray = Camera.main.ScreenPointToRay(Input.mousePosition);
      
            // RaycastHit情報を出力パラメータとして保持するためには、$refタグでラップする必要があります。
            // out修飾子をパラメータとして必要とするため、オブジェクトを実際に作成せずに参照を作成します。        
            let ref = $ref<RaycastHit>();
      
            if (Physics.Raycast(ray, ref, 1000)) {
                // 返されたRaycastヒットデータを確認するには、$unrefを使用して参照をアンラップすることを忘れないでください。
                let hitInfo = $unref(ref);
      
                console.log(`ヒットを検出！`);
                console.log(`hitInfo.collider.name : ${hitInfo.collider.name}`);
            } else {
                console.log(`衝突の検出に失敗しました`);
            }
        }
    }
 
}
﻿
﻿
📘 スクリプトで使用されている$refと$unrefの説明については、以下のガイドを参照してください。 [$ref と $unref﻿]
﻿
テストコードを通じて、シーン内のキューブをマウスポインタでクリックすることでオブジェクトの情報が出力されることを確認できます。
﻿
﻿
ZEPETO.Scriptで使用されているRaycast APIに関する詳細情報は、以下のリンクにアクセスしてください。
📘 Raycast
https://docs.unity3d.com/ScriptReference/Physics.Raycast.html﻿
﻿
更新日 11 Oct 2024
このページは役に立ちましたか？
タグ & レイヤー
$ref と $unref