Raycast

4min
La fonction Raycast peut être utilisée pour trouver efficacement un objet dans une scène dans Unity.
Raycast dans la programmation Unity est une sorte de faisceau laser, qui sera tiré d'un emplacement dans une scène et tirera jusqu'à ce qu'il touche un Collider.

Lorsqu'il entre en collision avec un Collider, les informations (RaycastHit) de l'objet en collision et sa position dans la scène seront renvoyées.
Pour plus de détails sur Unity Raycast, veuillez consulter le guide Unity.
📘 Unity Raycast
https://docs.unity3d.com/Manual/CameraRays.html﻿
﻿
Le Raycast Unity peut être utilisé dans ZEPETO.Script en complétant les étapes suivantes :
Tout d'abord, importez la classe liée au Raycast.
TypeScript
import { Physics, RaycastHit } from 'UnityEngine';
import { Physics, RaycastHit } from 'UnityEngine';
﻿
Voici un exemple de code pour la fonction 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);
      
            // Veuillez noter que pour conserver les informations RaycastHit en tant que paramètre de sortie, il doit être enveloppé dans une balise $ref.
            // Parce que nous avons besoin du qualificateur out en tant que paramètre, nous créons une référence sans réellement créer un objet.        
            let ref = $ref<RaycastHit>();
      
            if (Physics.Raycast(ray, ref, 1000)) {
                // Pour vérifier les données de collision Raycast renvoyées, veuillez vous rappeler de déballer la référence en utilisant $unref
                let hitInfo = $unref(ref);
      
                console.log(`Détection de collision !`);
                console.log(`hitInfo.collider.name : ${hitInfo.collider.name}`);
            } else {
                console.log(`Échec de la détection de collision`);
            }
        }
    }
 
}
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);
      
            // Veuillez noter que pour conserver les informations RaycastHit en tant que paramètre de sortie, il doit être enveloppé dans une balise $ref.
            // Parce que nous avons besoin du qualificateur out en tant que paramètre, nous créons une référence sans réellement créer un objet.        
            let ref = $ref<RaycastHit>();
      
            if (Physics.Raycast(ray, ref, 1000)) {
                // Pour vérifier les données de collision Raycast renvoyées, veuillez vous rappeler de déballer la référence en utilisant $unref
                let hitInfo = $unref(ref);
      
                console.log(`Détection de collision !`);
                console.log(`hitInfo.collider.name : ${hitInfo.collider.name}`);
            } else {
                console.log(`Échec de la détection de collision`);
            }
        }
    }
 
}
﻿
﻿
📘 Veuillez vous référer au guide suivant pour des explications sur le $ref et le $unref utilisés dans le script. [$ref & $unref﻿]
﻿
À travers le code de test, vous pouvez vérifier que les informations de l'objet sont affichées en cliquant sur le Cube avec le pointeur de la souris dans la Scène.
﻿
﻿
Trouvez plus d'informations sur l'API Raycast utilisée dans le ZEPETO.Script en allant au lien ci-dessous.
📘 Raycast
https://docs.unity3d.com/ScriptReference/Physics.Raycast.html﻿
﻿
Mis à jour 10 Oct 2024
Cette page vous a-t-elle aidée?
Étiquette & Couche
$ref & $unref