Passer au contenu principal
Version: bleeding-edge 🩸

Notions d'autorité

Tout ce qu'il faut savoir sur les notions d'Authority et de Network Authority.

Autorité​

Certaines classes ne peuvent être créées que par le serveur, d'autres ne peuvent être créées que par le client, et il y en a quelques-unes qui peuvent être créées à la fois par le serveur ou par le client. Le côté où la classe apparaît s'appelle l'Authority.

Disponibilité des méthodes et des événements​

Certaines méthodes et certains événements de l'API ne sont disponibles que d'un côté précis (client ou serveur), d'autres seulement du côté qui a créé l'entité (côté Authority) :

Côté serveur​

  • Méthodes : ne peuvent être appelées que côté serveur.
  • Événements : ne sont déclenchés que côté serveur.
  • Classes : ne peuvent être créées que côté serveur.

Côté client​

  • Méthodes : ne peuvent être appelées que côté client.
  • Événements : ne sont déclenchés que côté client.
  • Classes : ne peuvent être créées que côté client. (Elles ne seront pas synchronisées avec les autres joueurs).

Côté Authority​

  • Méthodes : ne peuvent être appelées que du côté qui a créé cette entité.
  • Événements : ne sont déclenchés que du côté qui a créé cette entité.

Côté Network Authority​

  • Méthodes : ne peuvent être appelées que côté serveur, et aussi côté client si le joueur local est la Network Authority de cette entité.
  • Événements : ne sont déclenchés que côté serveur, et aussi côté client si le joueur local est la Network Authority de cette entité.

Des deux côtés​

  • Méthodes : peuvent être appelées côté serveur et côté client.
  • Événements : sont déclenchés côté serveur et côté client.
  • Classes : peuvent être créées côté serveur et côté client. Si vous la créez côté client, elle ne sera pas synchronisée avec les autres joueurs.

Des deux côtés (Network. Authority en premier)​

  • Méthodes : ne s'applique qu'aux événements.
  • Événements : sont déclenchés côté serveur et côté client. Mais l'événement sera d'abord appelé sur le client qui est Network Authority (avant d'être envoyé au serveur). Par ex. vous n'avez pas besoin d'attendre que le serveur l'appelle sur tous les clients : il est appelé immédiatement sur le client qui est la Network Authority de cette entité.
tip

Toutes les entités créées sur le serveur sont automatiquement synchronisées sur le client. Par ex. vous pouvez accéder à ses méthodes et obtenir toutes les données sans avoir besoin de la synchroniser manuellement.

De la même façon, les entités créées sur le client n'existent que pour ce client : essayer de les envoyer au serveur provoquera des erreurs.

Autorité Réseau​

Une autre notion importante dans nanos world est la Network Authority. Nous utilisons une « autorité réseau distribuée » : le calcul de la physique est automatiquement attribué et réparti entre les clients.

En général, si un Base Actor est proche d'un Character en jeu, sa physique est calculée par l'ordinateur de ce joueur. Le joueur chargé de calculer et de partager les résultats s'appelle la Network Authority.

Le joueur désigné est déterminé automatiquement par le serveur, qui tient compte de plusieurs éléments :

Dans tous ces cas, le joueur devient automatiquement la Network Authority de cet objet. Ce calcul n'a lieu que si le joueur contrôle un Character.

Outrepasser l'Autorité Réseau actuelle​

On peut forcer la Network Authority d'une entité précise avec la méthode :SetNetworkAuthority().

tip

Dans certains cas, les Actors ne sont pas en mode Distributed Network Authority. On ne peut alors pas changer leur Network Authority actuelle. Par exemple, un joueur qui conduit un véhicule ou utilise une arme en est obligatoirement la Network Authority, et on ne peut pas changer ça par script. Pour vérifier si on peut la changer sur un Actor, utilisez la méthode :IsNetworkDistributed().

Vous pouvez aussi empêcher qu'elle soit automatiquement attribuée à d'autres joueurs en appelant :SetNetworkAuthorityAutoDistributed(false).

attention

Pensez toujours à rétablir la distribution automatique de la Network Authority en appelant :SetNetworkAuthorityAutoDistributed(true). Sinon, l'entité risque de se comporter de façon très étrange.

Vérifier l'autorité par script​

  • :HasAuthority() indique si le côté actuel a créé cette entité (c'est-à-dire s'il est le côté Authority).
  • :HasNetworkAuthority() indique si le joueur local est la Network Authority actuelle de cet Actor.
  • L'événement NetworkAuthorityChange est déclenché quand la Network Authority d'un Actor change.

Pour une vue d'ensemble de ce qui est synchronisé et comment, consultez le guide Réseau et réplication.

Déboguer le réseau et la Network Authority​

Une option des paramètres permet d'afficher les informations de débogage réseau dans le monde (Settings -> Debug -> Draw Network Debug) : elle dessine des carrés sur chaque entité et des traces qui représentent leurs mouvements synchronisés.

Signification des couleurs des carrés ■ sur les entités​

Le carré sur les entités représente l'état de l'Autorité Réseau et sa santé.

CouleurSignification
■BLEUVous êtes la Network Authority actuelle de cette entité, et l'entité est en veille.
Vous partagez des données de synchronisation avec les autres joueurs.
■CYANVous êtes la Network Authority actuelle de cette entité et vous transmettez des données en ce moment.
Vous partagez des données de synchronisation avec les autres joueurs.
■MAGENTAVous êtes l'Authority de cette entité.
L'entité a été créée côté client, vous n'envoyez donc pas de données de synchronisation.
■BLANCVous n'êtes pas la Network Authority et l'entité est en veille ou attachée.
La Network Authority actuelle n'envoie pas de données de synchronisation, car l'entité est en veille ou attachée.
■VERTVous n'êtes pas la Network Authority et l'entité est synchronisée à une cadence parfaite (pas de lag : moins de 2 frames, < 66 ms).
■JAUNEVous n'êtes pas la Network Authority et l'entité est synchronisée à une bonne cadence (léger lag : moins de 4 frames, < 132 ms).
■ORANGEVous n'êtes pas la Network Authority et l'entité est synchronisée à une cadence correcte (lag moyen : moins de 6 frames, < 198 ms).
■ROUGEVous n'êtes pas la Network Authority et l'entité est synchronisée à une mauvaise cadence (gros lag : plus de 6 frames, > 198 ms, voire avec perte de paquets).
■NOIRVous n'êtes pas la Network Authority et l'entité ignore des paquets reçus du réseau parce qu'ils arrivent dans le désordre (à cause d'une mauvaise connexion, voire avec perte de paquets).

Signification des couleurs des flèches → sur les entités​

Les flèches sur les entités représentent les données réseau reçues du serveur. Si vous êtes la Network Authority, vous ne verrez pas les flèches. La flèche pointe à partir de l'endroit où l'entité se trouve actuellement sur votre machine et où elle devrait être en conséquence à l'Autorité Réseau.

CouleurSignification
VERTL'entité reçoit des paquets à une cadence parfaite (pas plus de 2 frames de retard).
JAUNEL'entité ne reçoit aucun paquet pendant plus de 2 et moins de 4 frames.
ORANGEL'entité ne reçoit aucun paquet pendant plus de 4 et moins de 6 frames.
ROUGEL'entité ne reçoit aucun paquet pendant plus de 6 frames.