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

Visibility

À 40 joueurs, un snapshot de toute la salle suffit. À 200, non. Une zone de visibilité décide qui reçoit quoi, sous la forme d’un prédicat déclaré et non d’un interrupteur à actionner objet par objet. La diffusion et les paquets par acteur sont deux modes de livraison déclarés d’un même modèle : passer de l’un à l’autre est une affaire de configuration, pas de réécriture. C’est une optimisation du canal, pas une permission — pour cela, voyez Access & Roles.

Un même modèle déclaré — le prédicat, les couches, les niveaux de détail (detail tier) — se lit de deux façons :

Ce qui ne doit pas fuiter est absent du paquet, et non masqué côté client : ce n’est jamais envoyé, ce qui en fait une propriété de sécurité et non une question de bande passante.

Quand l’utiliser

• Vos salles deviennent trop grandes pour diffuser toute la salle : 200 joueurs ont besoin de flux de voisinage par client, pas de chaque delta.
• L’état ne doit pas fuiter : le brouillard de guerre et les champs réservés au propriétaire ne doivent jamais être envoyés, plutôt qu’être masqués côté client.
• Plusieurs sessions partagent une même carte (map) et ne doivent pas se voir : une couche n’est qu’un prédicat de plus.
• La taille des paquets doit rester prévisible dans une foule : plafonnez le nombre d’objets et déclarez l’ordre, pour que « les N plus proches » soit une promesse et non un hasard de densité.
• Un joueur placé à une frontière doit voir au-delà : déclarez quelles zones voisines sont visibles, car par défaut seule la sienne l’est.
• Inutile quand la salle est petite : le mode de livraison (delivery mode) par paquet partagé suffit.

Qui fait quoi

En bref

[Entity("tank")]
[Visible(Radius = 60)]                           // spatial
[Visible(Rule.SameLayer)]                        // layers of one map
public class Tank
{
    [Sync] public Vector3 Position;
    [Sync(To = Scope.Owner)] public int Ammo;    // per-field scope
}

@Entity('tank')
@Visible({ radius: 60 })                       // spatial
@Visible(Rule.SameLayer)                       // layers of one map
export class Tank {
  @Sync() position!: Vector3;
  @Sync({ to: Scope.Owner }) ammo = 0;         // per-field scope
}

@entity("tank")
@visible(radius=60)                              # spatial
@visible(Rule.SAME_LAYER)                        # layers of one map
class Tank:
    position: Vector3 = sync()
    ammo: int = sync(to=Scope.OWNER)             # per-field scope

// multi-entry values are one quoted list (a specifier value is a single token)
UCLASS(PSEntity = "tank",
       PSVisible = "radius:60, rule:SameMapInstance")   // spatial + instances of one map
class UTank : public UObject
{
    GENERATED_BODY()

    UPROPERTY(PSSync)                  FVector3f Position;
    UPROPERTY(PSSync = (To = "Owner")) int32     Ammo;   // per-field scope
};
// declarations compile into the same pushed model — playserv push from the UE project or CI

[Entity("tank")]
[Visible(Radius = 60)]                           // spatial
[Visible(Rule.SameLayer)]                        // layers of one map
public class Tank
{
    [Sync] public Vector3 Position;
    [Sync(To = Scope.Owner)] public int Ammo;    // per-field scope
}

Le modèle

Ce que déclare une règle de visibilité.

Ce qui vaut pour toute zone.

Erreurs

• Une cible d’abonnement (subscription) non déclarée donne lieu à un refus de validation.
• L’absence de permission pour s’abonner répond forbidden ou not found, selon que l’existence de la cible est secrète ou non : le refus lui-même ne doit pas trahir ce qu’il refuse.
• Une position de reprise illisible est une requête invalide, pas un redémarrage silencieux à partir de maintenant.
• Un abonnement fermé par la plateforme et un nombre d’abonnements épuisé sont tous deux des conflits.
• Élargir une vue relève de fn. Accorder une vue de surcharge et régler les niveaux de détail sont refusés avec forbidden à une session joueur, dont la vue reste inchangée : un client spectateur ne peut pas élargir les droits qui lui ont été accordés (grant).
• Une instance que la vue de l’appelant exclut répond not found, comme une instance qui n’existe pas : un forbidden confirmerait que quelque chose se trouve derrière le mur.
• Lire le coût des paquets par acteur relève de fn adm : une fonction cloud ou le panneau, jamais un client.

Limites

Les chiffres viendront avec le chapitre sur les limites de la plateforme ; ce qui se passe à chaque plafond, lui, est déjà fixé.

• Le coût d’un paquet par acteur : une fois le budget épuisé, dégradation déclarée vers le paquet partagé, avec un avis, jamais de perte arbitraire de destinataires.
• Objets par règle : plafonnés, avec un ordre déclaré et un indicateur de troncature observable.
• Abonnements par acteur : un nouvel abonnement est refusé, et les existants continuent.
• Taille du delta : le delta est découpé plutôt que tronqué, et le découpage est observable.
• Le rythme d’envoi : une borne supérieure, pas une garantie.