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é.
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 :
- La distance entre le Character et l'entité.
- Si le joueur contrôle un Base Pawn.
- Si le Character attrape un Prop.
- Si le Character tient un Base Pickable.
- Si le Character conduit un Base Vehicle.
- Si le Character vient de tirer sur une entité (par ex. Prop, Base Pickable, Base Vehicle, etc.).
- Si le Character vient de percuter un Character avec un véhicule.
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().
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).
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
NetworkAuthorityChangeest 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é.
| Couleur | Signification | |
|---|---|---|
| ■ | BLEU | Vous ê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. |
| ■ | CYAN | Vous ê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. |
| ■ | MAGENTA | Vous ê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. |
| ■ | BLANC | Vous 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. |
| ■ | VERT | Vous n'êtes pas la Network Authority et l'entité est synchronisée à une cadence parfaite (pas de lag : moins de 2 frames, < 66 ms). |
| ■ | JAUNE | Vous n'êtes pas la Network Authority et l'entité est synchronisée à une bonne cadence (léger lag : moins de 4 frames, < 132 ms). |
| ■ | ORANGE | Vous n'êtes pas la Network Authority et l'entité est synchronisée à une cadence correcte (lag moyen : moins de 6 frames, < 198 ms). |
| ■ | ROUGE | Vous 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). |
| ■ | NOIR | Vous 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.
| Couleur | Signification |
|---|---|
| VERT | L'entité reçoit des paquets à une cadence parfaite (pas plus de 2 frames de retard). |
| JAUNE | L'entité ne reçoit aucun paquet pendant plus de 2 et moins de 4 frames. |
| ORANGE | L'entité ne reçoit aucun paquet pendant plus de 4 et moins de 6 frames. |
| ROUGE | L'entité ne reçoit aucun paquet pendant plus de 6 frames. |