Stockage de Données Mondial

7min
Le DataStorage de ZEPETO est une base de données distante qui stocke et gère les données de jeu des utilisateurs sur une base par monde.
Il est adapté pour stocker les données de jeu des utilisateurs qui doivent être maintenues ou mises à jour lors de plusieurs sessions de jeu, car elles sont stockées et gérées par l'UserID.
Gérez les données de jeu de vos utilisateurs en utilisant l'API disponible sur le serveur ZEPETO Multiplay.
Vous pouvez visualiser et modifier les données de jeu spécifiques aux utilisateurs stockées dans le Data Storage depuis le menu de gestion des données du monde dans ZEPETO Studio.
📘 Veuillez vous référer au guide suivant.  [Gestion des Données Mondiales﻿]
﻿
API de stockage de données
📘 Veuillez vous référer à la référence API suivante. API ZEPETO.Multiplay.DataStorage﻿
Veuillez remplir le code du serveur index.ts Sandbox.
Sur le serveur local dans l'environnement de l'éditeur Unity, les données ne sont pas préservées lorsque le serveur est arrêté et redémarré.
Après le déploiement du monde, les données sont stockées dans la base de données ZEPETO et maintenues.
Les données ne seront pas enregistrées si les règles ci-dessous ne sont pas satisfaites :
Aucune valeur n'est fournie
Une valeur qui ne peut pas être stockée est saisie
Contraintes de stockage des données
Limite de longueur de clé : 50 caractères
Seules les lettres, les chiffres et le soulignement (_) sont autorisés dans la clé
Nombre maximum de clés : 1000 par ID utilisateur
Taille maximale des données de valeur : 500 000 caractères
Notez que les données de valeur sont sérialisées avec un identifiant interne lorsqu'elles sont stockées sur le serveur réel. Utilisez avec une marge de sécurité.
﻿
Lire / Écrire / Supprimer des données pour une seule clé
Vous pouvez lire, écrire et supprimer des données pour une seule clé dans le DataStorage du joueur local en utilisant DataStorage.get, DataStorage.set et DataStorage.remove.
TypeScript
import { DataStorage } from 'ZEPETO.Multiplay.DataStorage';

export default class extends Sandbox {

    //...

    async onJoin(client: SandboxPlayer) {
        // Charger le stockage de données du joueur local
        const playerStorage: DataStorage = client.loadDataStorage();

        // Obtenir la valeur associée à la clé 'level' 
	      let playerLevel = await playerStorage.get("level") as number;
        if (playerLevel == null) {
            playerLevel += 1; 
        }

        // Stocker la valeur incrémentée
        await playerStorage.set("level", playerLevel);

        // Supprimer les données
        await playerStorage.remove("level");
    }
}
import { DataStorage } from 'ZEPETO.Multiplay.DataStorage';

export default class extends Sandbox {

    //...

    async onJoin(client: SandboxPlayer) {
        // Charger le stockage de données du joueur local
        const playerStorage: DataStorage = client.loadDataStorage();

        // Obtenir la valeur associée à la clé 'level' 
	      let playerLevel = await playerStorage.get("level") as number;
        if (playerLevel == null) {
            playerLevel += 1; 
        }

        // Stocker la valeur incrémentée
        await playerStorage.set("level", playerLevel);

        // Supprimer les données
        await playerStorage.remove("level");
    }
}
﻿
﻿
Lire / Écrire des données pour plusieurs clés
Vous pouvez lire, écrire et supprimer des données pour plusieurs clés dans le stockage de données du joueur local en utilisant DataStorage.mget et DataStorage.mset.
TypeScript
import { DataStorage } from 'ZEPETO.Multiplay.DataStorage';

export default class extends Sandbox {

    //...

    async onJoin(client: SandboxPlayer) {
        const storage = client.loadDataStorage();
        // mset (multi key-value) store
        const success = await storage.mset<number>([
            { key: 'key1', value: 1 },
            { key: 'key2', value: 2 }
        ]);
        // Si réussi
        if (success) {
            // Obtenez les valeurs de key1 et key2 en une seule fois
            const keys = ['key1', 'key2'];
            const keyValeus = await storage.mget(keys);
            keys.forEach(key => {
                const value = keyValeus[key];
                console.log(value);
            });
        }
    }
}
import { DataStorage } from 'ZEPETO.Multiplay.DataStorage';

export default class extends Sandbox {

    //...

    async onJoin(client: SandboxPlayer) {
        const storage = client.loadDataStorage();
        // mset (multi key-value) store
        const success = await storage.mset<number>([
            { key: 'key1', value: 1 },
            { key: 'key2', value: 2 }
        ]);
        // Si réussi
        if (success) {
            // Obtenez les valeurs de key1 et key2 en une seule fois
            const keys = ['key1', 'key2'];
            const keyValeus = await storage.mget(keys);
            keys.forEach(key => {
                const value = keyValeus[key];
                console.log(value);
            });
        }
    }
}
﻿
﻿
Gestion des erreurs
Vous pouvez mettre en œuvre une gestion appropriée des exceptions qui se produisent lors de l'appel de l'API DataStorage en vous référant aux types d'erreurs définis dans DataStorageError.
TypeScript
import { DataStorage } from 'ZEPETO.Multiplay.DataStorage';

export default class extends Sandbox {

    //...

    async onJoin(client: SandboxPlayer) {
        // Charger le stockage de données du joueur local
        const playerStorage: DataStorage = client.loadDataStorage();

        try {
            let playerLevel = await playerStorage.get("level") as number;
        } catch (error) {
            let systemError = (error as SystemError);

            if (systemError.code === DataStorageError.Unknown || systemError.code === DataStorageError.NetworkError) {
                // Erreur système ou erreur réseau
                console.log(systemError.message);

            } else if (systemError.code === DataStorageError.KeyConstraintViolated) {
                // Contrainte de clé violée
                console.log(systemError.message);
                
            } else if (systemError.code === DataStorageError.ValueConstraintViolated) {
                // Contrainte de valeur violée
                console.log(systemError.message);
            }
        }
    }
}
import { DataStorage } from 'ZEPETO.Multiplay.DataStorage';

export default class extends Sandbox {

    //...

    async onJoin(client: SandboxPlayer) {
        // Charger le stockage de données du joueur local
        const playerStorage: DataStorage = client.loadDataStorage();

        try {
            let playerLevel = await playerStorage.get("level") as number;
        } catch (error) {
            let systemError = (error as SystemError);

            if (systemError.code === DataStorageError.Unknown || systemError.code === DataStorageError.NetworkError) {
                // Erreur système ou erreur réseau
                console.log(systemError.message);

            } else if (systemError.code === DataStorageError.KeyConstraintViolated) {
                // Contrainte de clé violée
                console.log(systemError.message);
                
            } else if (systemError.code === DataStorageError.ValueConstraintViolated) {
                // Contrainte de valeur violée
                console.log(systemError.message);
            }
        }
    }
}
﻿
﻿
Accéder au stockage de données par ID utilisateur
Il est également possible d'accéder au stockage de données d'un utilisateur spécifique par UserID en utilisant DataStorage.loadDataStorage, au lieu du stockage de données du joueur local.
TypeScript
    const userStorage: DataStorage = await loadDataStorage(userId);
    const userStorage: DataStorage = await loadDataStorage(userId);
﻿
﻿
👍 Conseil
Si vous souhaitez stocker des données entre différents mondes, implémentez-le en utilisant httpService﻿ 
﻿
Mis à jour 10 Oct 2024
Cette page vous a-t-elle aidée?
Requête HTTP du serveur Multiplay
PlayerPrefs - Sauvegarder les données sur l'appareil