Bonjour ZEPETOScript

11 min

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

Pour ajouter le ZEPETOScript précédemment créé en tant que composant à un GameObject, cliquez sur le bouton Add Component dans la fenêtre Inspector du GameObject.

Dans la fenêtre Add Component, sélectionnez Zepeto Script Component.

Cliquez sur le bouton Attach Zepeto Script dans le Zepeto Script Component.

Dans la fenêtre Attach Zepeto Script, sélectionnez le fichier HelloWorld ZEPETOScript que vous avez créé précédemment.

Vous pouvez ajouter le fichier HelloWorld ZEPETOScript en tant que Component au GameObject comme indiqué dans l'écran ci-dessous.

É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.

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.

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 :

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 :

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 :

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/