Propriété

5 min

Découvrez les propriétés exposées par ZEPETOScript.

Une propriété est un paramètre de composant et une option qui peut être modifiée dans l'Inspecteur.

En utilisant des propriétés, vous pouvez gérer l'état et les données des GameObjects ou d'autres composants, et contrôler l'accès de l'extérieur.

ZEPETOScript est basé sur TypeScript comme langage de programmation, par conséquent, la syntaxe suivante est utilisée pour la déclaration de propriété.

AccessModifier propertyName: propertyType;

ex)
public playerNumber: float;
private playerLocation: Vector3;

Les propriétés déclarées de cette manière sont visibles dans l'inspecteur, où vous pouvez leur assigner des valeurs ou des objets. Les valeurs que vous assignez seront ensuite initialisées à l'exécution.

import { ZepetoScriptBehaviour } from 'ZEPETO.Script';
import { Vector3, GameObject, Transform } from 'UnityEngine';
 
export default class Properties extends ZepetoScriptBehaviour {
 
    public floatValue: float;
    public strValue: string;
 
    public gameObj: GameObject;
    public transformValue: Transform;
    public vectorValue : Vector3;
 
}

Pour accéder aux propriétés depuis l'intérieur de ZEPETOScript, utilisez this.property Name.

import { ZepetoScriptBehaviour } from 'ZEPETO.Script';
import { Vector3, GameObject, Transform } from 'UnityEngine';
 
export default class Properties extends ZepetoScriptBehaviour {
 
    public floatValue: float;
    public strValue: string;
 
    public gameObj: GameObject;
    public transformValue: Transform;
    public vectorValue : Vector3;
     
     
    Start() {
        console.log(`floatValue : ${this.floatValue}`);
        console.log(`strValue : ${this.strValue}`);
    }
     
    Update() {
        // Faire tourner Cube_A
        const transform = this.gameObj.GetComponent<Transform>();
        transform.Rotate(this.vectorValue);
 
        // Faire tourner Cube_B
        this.transformValue.Rotate(this.vectorValue);
    }
}

Lors de l'utilisation de plusieurs propriétés, déclarez-les dans un tableau dans ZEPETOScript. Les propriétés sont affichées dans un tableau dans l'Inspecteur, où vous pouvez saisir des données pour différents éléments.

public floatValues: float[];

Si vous déclarez un Attribut dans le script, vous pouvez contrôler la Propriété dans l'Inspecteur.

import { ZepetoScriptBehaviour } from 'ZEPETO.Script';
import { Transform } from 'UnityEngine';
 
export default class Attribute extends ZepetoScriptBehaviour {
 
    // Propriété publique qui n'a pas besoin d'être sérialisée
    @NonSerialized()
    public strValue: string;
 
// Propriété qui ne doit pas être exposée dans l'Inspecteur
    @HideInInspector()
    public strValue2: string;
 
// Propriété privée qui doit être sérialisée
    @SerializeField()
    private strValue3: string;
 
// Ajout d'un en-tête au-dessus de la Propriété
    @Header("Titre de l'en-tête")
    public stringProperty: string;
 
// Ajout d'espaces entre les Propriétés
    @Space(10)
    public numberProperty: number;
 
// Ajout d'un tooltip qui apparaît lorsque la souris est positionnée sur la Propriété
    @Tooltip("Ceci est un Tooltip")
    public transformProperty: Transform;
 
    Start() {   
 
    }
 
}

Ci-dessous un exemple d'écran lorsque l'attribut est appliqué.

Pour les attributs disponibles dans ZEPETOScript, veuillez vous référer au guide suivant

📘 Veuillez vous référer au guide suivant. [Liste des Fonctions Unity Disponibles dans le Monde ZEPETO]