---
title: Bonjour ZEPETOScript
slug: world-sdk-guide-fr/bonjour-zepetoscript
docTags: 
createdAt: 2024-09-02T08:34:13.135Z
---

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

:::hint{type="danger"}
**❗️ 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.

![](https://api.archbee.com/api/optimize/fCt3n1oCa8rgNJ8fw9I2N-W7_oSAQJMVKn1HXIKkcZn-20240904-102418.png)



Vous pouvez voir qu'un nouveau ZEPETOScript a été créé, comme indiqué ci-dessous.

::Image[]{src="https://api.archbee.com/api/optimize/fCt3n1oCa8rgNJ8fw9I2N-jWaWZgzsGBAfZGeKXQIMv-20240904-102418.png" size="70" width="592" height="432" position="center" showCaption="false"}



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

![](https://api.archbee.com/api/optimize/xv-TGeWVTX2GDZMFGOf1Y/kt-hSmMqXIK8wXfK09n6P_image.png)



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

![](https://api.archbee.com/api/optimize/xv-TGeWVTX2GDZMFGOf1Y/2x7IOeRiQzr6Vkxe74kwt_image.png)



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

![](https://api.archbee.com/api/optimize/xv-TGeWVTX2GDZMFGOf1Y/7fV1BDKL4rDv-gbq0dJLX_image.png)



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

![](https://api.archbee.com/api/optimize/xv-TGeWVTX2GDZMFGOf1Y/QZ8N-e1qp5BHUJyhZGJ9Z_image.png)



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

![](https://api.archbee.com/api/optimize/xv-TGeWVTX2GDZMFGOf1Y/-xe1rspwelXIyUeM3abbD_image.png)



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

:::CodeblockTabs
NewTypescript

```typescript
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.

:::CodeblockTabs
HelloWorld

```typescript
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.

![](https://api.archbee.com/api/optimize/fCt3n1oCa8rgNJ8fw9I2N-5To_fp4pJMCsmAIhSpK-5-20240904-102418.png)



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 :

:::CodeblockTabs
TypeScript

```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);
    }
}
```
:::



## 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 :

:::CodeblockTabs
TypeScript

```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"));
    }
}
```
:::



## 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 :

:::CodeblockTabs
TypeScript

```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) {}
}
```
:::



:::hint{type="info"}
- Pour une syntaxe plus détaillée, veuillez vous référer à la documentation TypeScript
  - [https://www.typescriptlang.org/docs/](https://www.typescriptlang.org/docs/)
:::