Cette page n’est pas encore traduite : la version anglaise est affichée.

Le schéma dans le code

Déclarez le modèle dans le code, publiez-le, récupérez les types. C’est ainsi que le développeur travaille avec le schéma : le panneau d’administration et le code décrivent le même modèle, et la génération de code boucle la boucle pour chaque moteur.

Quand l’utiliser

• Votre modèle de données doit vivre dans le code et être relu comme du code : déclarer, schema diff, schema push.
• Les types du moteur ne doivent jamais s’écarter du modèle déployé : schema codegen régénère le code Unreal C++ et Unity C#.
• Un changement incompatible doit pouvoir être lu, et annulé, avant de s’exécuter : proposer → planifier → appliquer.
• Vous réutilisez le même ensemble (Stat, Interactable) d’un projet à l’autre : déclarez-le une fois comme preset.
• Inutile si un opérateur se contente d’ajuster des valeurs dans le panneau d’administration. La modification du modèle revient quand même dans le code par le diff.

Qui fait quoi

En bref

[Entity("item")]
public class Item
{
    public string Name = "";
    public Rarity Rarity;              // an enum declared the same way
    public Stats Stats = new();        // a part — embedded, no lifecycle of its own
}

[Part("stats")]
public class Stats { public int Power; public int Weight; }

@Entity('item')
export class Item {
  name = '';
  rarity!: Rarity;                   // an enum declared the same way
  stats = new Stats();               // a part — embedded, no lifecycle of its own
}

@Part('stats')
export class Stats { power = 0; weight = 0; }

@entity("item")
class Item:
    name: str = ""
    rarity: Rarity                     # an enum declared the same way
    stats: Stats = Stats()             # a part — embedded, no lifecycle of its own

@part("stats")
class Stats:
    power: int = 0
    weight: int = 0

USTRUCT(PSPart = "stats")
struct FItemStats
{
    GENERATED_BODY()

    UPROPERTY() int32 Power;
    UPROPERTY() int32 Weight;
};

UCLASS(PSEntity = "item")
class UItem : public UObject
{
    GENERATED_BODY()

    UPROPERTY() FString    Name;
    UPROPERTY() EPSRarity  Rarity;       // an enum declared the same way
    UPROPERTY() FItemStats Stats;        // a part — embedded, no lifecycle of its own
};
// declarations compile into the same pushed model — playserv push from the UE project or CI

[Entity("item")]
public class Item
{
    public string Name = "";
    public Rarity Rarity;              // an enum declared the same way
    public Stats Stats = new();        // a part — embedded, no lifecycle of its own
}

[Part("stats")]
public class Stats { public int Power; public int Weight; }

playserv schema diff       # local declarations vs deployed schema
playserv schema push       # with a revision precondition — no blind overwrites
playserv schema codegen    # regenerate Unreal C++ / Unity C# types

Le modèle

Ce que contient une déclaration.

Ce que garantit une publication.

Ce que garantit la génération de code.

Ce que garantit une migration.

Erreurs

• Un appelant sans le rôle reçoit forbidden, et le modèle déployé reste intact : un refus n’est jamais une publication partielle. Ce refus diffère de celui d’une révision périmée, qui renvoie precondition_failed : le diff a été calculé par rapport à un schéma qui a changé depuis. Recalculez le diff et publiez à nouveau.
• Une valeur hors des bornes déclarées est refusée à l’écriture, jamais ramenée dans l’intervalle, tout comme une chaîne qui dépasse sa longueur déclarée. La borner donnerait une valeur valide, mais fausse.
• Une séquence UTF-8 invalide est rejetée à l’écriture, pas réparée.
• Un changement persistant incompatible sans migration déclarée ne peut tout simplement pas être publié.

Limites

Les plafonds liés à la déclaration sont vérifiés au moment de la déclaration — au déploiement ou à la publication — plutôt qu’à la première utilisation, partout où le symptôme à l’exécution ne ressemblerait pas à un refus. Les valeurs chiffrées arriveront avec le chapitre sur les limites de la plateforme.