Bonjour ZEPETOScript

12min
Qu'est-ce que ZEPETOScript ?
ZEPETOScript est un langage de script utilisé pour créer ZEPETO World.
Il prend en charge le langage de programmation TypeScript.
ZEPETOScript est conçu pour définir des comportements et des fonctionnalités au sein de ZEPETO World, y compris :
Mouvement, physique et interactions des objets.
Gestion des événements, y compris les entrées utilisateur.
Hérite de la classe ZepetoScriptBehaviour, conçue pour être compatible avec l'interface MonoBehaviour de Unity.
Il peut être attaché à des GameObjects actifs dans la scène pour exécution.
❗️ Attention
Lors du développement pour ZEPETO World, les scripts C# ne sont pas inclus dans le package de construction.
Assurez-vous de n'implémenter qu'en utilisant ZEPETOScript.
Tutoriel Hello World
ÉTAPE 1 : Création d'un ZEPETOScript
Pour créer un nouveau fichier ZEPETOScript,
cliquez sur [Projet] et sélectionnez l'icône [+] dans le coin supérieur gauche du panneau, ou cliquez sur Actifs → Créer → ZEPETO → TypeScript.
﻿
﻿
Vous pouvez voir qu'un nouveau ZEPETOScript a été créé, comme indiqué ci-dessous.
﻿
﻿
ÉTAPE 2 : Ajouter ZEPETOScript à un GameObject
ZEPETOScript peut être attaché à un GameObject en tant que Composant, il suffit de faire glisser et déposer le fichier ZEPETOScript sur le GameObject.
﻿
👍 ASTUCE
Vous pouvez ajouter des composants via l'option Ajouter un Composant > Zepeto Script.
ÉTAPE 3 : Ajouter des codes de test ou émettre des journaux
Le ZEPETOScript nouvellement généré est montré ci-dessous. Vous pouvez éditer le script en utilisant les outils de développement de Unity.
NewTypescript
import { ZepetoScriptBehaviour } from 'ZEPETO.Script';

export default class NewTypescript extends ZepetoScriptBehaviour {

    Start() {    

    }

}
import { ZepetoScriptBehaviour } from 'ZEPETO.Script';

export default class NewTypescript extends ZepetoScriptBehaviour {

    Start() {    

    }

}
﻿
﻿
Essayez d'ajouter des codes de journal dans la fonction Start pour tester si le ZEPETOScript fonctionne.
HelloWorld
import { ZepetoScriptBehaviour } from 'ZEPETO.Script';

export default class HelloWorld extends ZepetoScriptBehaviour {

    Start() {
        console.log(`log : Bonjour le monde`);
        console.warn(`warn : Bonjour le monde`);
        console.error(`error : Bonjour le monde`);
    }

}
import { ZepetoScriptBehaviour } from 'ZEPETO.Script';

export default class HelloWorld extends ZepetoScriptBehaviour {

    Start() {
        console.log(`log : Bonjour le monde`);
        console.warn(`warn : Bonjour le monde`);
        console.error(`error : Bonjour le monde`);
    }

}
﻿
﻿
Consultez l'écran de sortie du code de test ci-dessous.
﻿
﻿
Félicitations pour avoir terminé le tutoriel ZEPETOScript !
Pour ceux qui ont déjà développé avec C# dans Unity ou ceux qui découvrent le développement dans ZEPETO World, plongeons dans les bases de ZEPETOScript.
﻿
Déclaration de variables dans ZEPETOScript
ZEPETOScript suit la syntaxe TypeScript.
Par conséquent, il est essentiel de déclarer le type lors de la déclaration d'une variable.
Exemple de déclaration de variable :
TypeScript
import { ZepetoScriptBehaviour } from 'ZEPETO.Script';
 
export default class HelloZepetoScript extends ZepetoScriptBehaviour {
 
    // Variables globales
    private number: number = 10;
    private floatNumber: number = 10.5;
    private word: string = "ZEPETO!";
    private isTrue: boolean = true;
    private list : number[] = [1,2,3];
    private listGeneric : Array<number> = [4,5,6];
 
    Start() {
        console.log(this.number);
        console.log(this.floatNumber);
        console.log(`Bonjour, ${this.word}`);
        console.log(this.isTrue);
        console.log(this.list);
        console.log(this.listGeneric);
         
        // Variables locales
        let a = 30;
        const b = 40;
        console.log(a);
        console.log(b);
    }
}
import { ZepetoScriptBehaviour } from 'ZEPETO.Script';
 
export default class HelloZepetoScript extends ZepetoScriptBehaviour {
 
    // Variables globales
    private number: number = 10;
    private floatNumber: number = 10.5;
    private word: string = "ZEPETO!";
    private isTrue: boolean = true;
    private list : number[] = [1,2,3];
    private listGeneric : Array<number> = [4,5,6];
 
    Start() {
        console.log(this.number);
        console.log(this.floatNumber);
        console.log(`Bonjour, ${this.word}`);
        console.log(this.isTrue);
        console.log(this.list);
        console.log(this.listGeneric);
         
        // Variables locales
        let a = 30;
        const b = 40;
        console.log(a);
        console.log(b);
    }
}
﻿
﻿
Utiliser le type de données Map
Au lieu du type de données Dictionary de C#, utilisez le type de données Map de TypeScript pour stocker et gérer des paires clé-valeur.
Ce type de données est particulièrement pratique pour gérer les données des joueurs lors de l'implémentation d'un monde multijoueur.
Exemple d'utilisation simple de Map :
TypeScript
import { ZepetoScriptBehaviour } from 'ZEPETO.Script';
 
export default class HelloZepetoScript extends ZepetoScriptBehaviour {
 
    private myMap = new Map<string, string>();
     
    Start() {
        this.myMap.set("Player1", "Ze");
        this.myMap.set("Player2", "pe");
        this.myMap.set("Player3", "to");
         
        this.myMap.forEach((value, key) => {
            console.log(key, value);
        });
 
        if(this.myMap.has("Player2")) {
            let value: string | undefined = this.myMap.get("Player2");
            console.log(value);
        }
 
        this.myMap.delete("Player2");
 
        console.log(this.myMap.has("Player2"));
    }
}
import { ZepetoScriptBehaviour } from 'ZEPETO.Script';
 
export default class HelloZepetoScript extends ZepetoScriptBehaviour {
 
    private myMap = new Map<string, string>();
     
    Start() {
        this.myMap.set("Player1", "Ze");
        this.myMap.set("Player2", "pe");
        this.myMap.set("Player3", "to");
         
        this.myMap.forEach((value, key) => {
            console.log(key, value);
        });
 
        if(this.myMap.has("Player2")) {
            let value: string | undefined = this.myMap.get("Player2");
            console.log(value);
        }
 
        this.myMap.delete("Player2");
 
        console.log(this.myMap.has("Player2"));
    }
}
﻿
﻿
Utiliser JSON
Lorsque vous travaillez avec des données au format JSON, vous pouvez utiliser les fonctions intégrées de TypeScript.
Conversion d'une chaîne JSON en objet
Utilisez le JSON.parse() méthode.
Conversion d'un objet en chaîne JSON
Utilisez le JSON.stringify() méthode.
Exemple d'utilisation de JSON :
TypeScript
import { ZepetoScriptBehaviour } from 'ZEPETO.Script';
 
export default class HelloZepetoScript extends ZepetoScriptBehaviour {
     
    Start() {
        let jsonData = '{"id":"USER1234", "name":"zepeto", "age":15}';
 
        // Conversion d'une chaîne JSON en objet
        let userObject : User = JSON.parse(jsonData);
        console.log(userObject.id);
        console.log(userObject.name);
        console.log(userObject.age);
         
        userObject.age = 16;
 
        // Conversion d'un objet en chaîne JSON
        let newJsonData = JSON.stringify(userObject);
        console.log(newJsonData);
    }
}
 
class User {
    constructor(public id: string, public name: string, public age: number) {}
}
import { ZepetoScriptBehaviour } from 'ZEPETO.Script';
 
export default class HelloZepetoScript extends ZepetoScriptBehaviour {
     
    Start() {
        let jsonData = '{"id":"USER1234", "name":"zepeto", "age":15}';
 
        // Conversion d'une chaîne JSON en objet
        let userObject : User = JSON.parse(jsonData);
        console.log(userObject.id);
        console.log(userObject.name);
        console.log(userObject.age);
         
        userObject.age = 16;
 
        // Conversion d'un objet en chaîne JSON
        let newJsonData = JSON.stringify(userObject);
        console.log(newJsonData);
    }
}
 
class User {
    constructor(public id: string, public name: string, public age: number) {}
}
﻿
﻿
Pour une syntaxe plus détaillée, veuillez vous référer à la documentation TypeScript
﻿https://www.typescriptlang.org/docs/﻿
﻿
Mis à jour 10 Oct 2024
Cette page vous a-t-elle aidée?
Aperçu
Propriété