Notifications et présence
Notifications envoyées depuis Unity
Le Game envoie les notifications au backend Web. NotificationManager.SaveNotification() lance la coroutine BackEndBase.SaveNotification(), qui effectue POST /saveNotification avec userUid, notificationType, isImportant et extraData.
userUid est le profil jeu du destinataire (products_code.game_oid); extraData.simUid identifie la simulation. NotificationController, protégé par AuthGuardUser, délègue à GameNotificationService.notifyGameProfile().
Le serveur vérifie le format, exclut les types réservés au serveur et contrôle que l'expéditeur et le destinataire appartiennent à la simulation BrainCloud. Le profil jeu destinataire est ensuite converti en compte Web pour NotificationService.notify().
La notification est enregistrée dans l'inbox Redis avant son annonce aux connexions du compte. Le push est tenté ensuite; un échec du push n'annule pas l'entrée enregistrée. L'inbox possède une limite de taille et une durée de rétention configurées dans NOTIFICATION_CONFIG.
Le Web charge GET /notifications, marque une entrée comme lue via POST /notifications/:notificationUid/read et la supprime via DELETE /notifications/:notificationUid. La réception live utilise notification.created sur le socket du compte /account.
Voir Notifications et Push pour le système Web, et Panel Web — interface superposée au jeu et intégration Unity pour son affichage au-dessus du jeu.
Trois mécanismes de présence
| Mécanisme | Donnée et usage | Code |
|---|---|---|
| Présence du compte Web | Statut online/away et jeu actif du compte; utilisé par les interfaces Web. | AccountSocketService, socket /account, updateStatus et updateGamePresence. |
| Heartbeat du Game | Session du jeu et derniers heartbeats utilisés par l'UI Unity pour les utilisateurs de la simulation. | User.DoHeartbeat(), endpoint /heartBeat et UsersLastHeartbeats. |
| Présence évaluée By Year | Participation enregistrée par étudiant, activité et année, utilisée pour calculer un score. | _command/set_presence.js et evaluation.presence[actUid][yearId]. |
Le nouveau statut Web ne remplace pas automatiquement les deux usages Game : le code local conserve des appels et des consommateurs distincts.
Présence Web du compte
AccountSocketService suit l'activité du navigateur, le focus et l'inactivité pour émettre online ou away. PageWebglComponent appelle setGamePresence(pid, gameUid) après validation de l'accès au jeu, puis clearGamePresence() à sa destruction.
À la reconnexion du socket, le service réémet le jeu actif conservé en mémoire. Cette information désigne le jeu ouvert; elle ne crée pas d'entrée de présence pédagogique dans BrainCloud.
Heartbeat utilisé par Unity
LoadUserState démarre le heartbeat. User.DoHeartbeat() utilise HEARTBEAT_RATE_SECONDS = 5 : l'intervalle d'attente est de 5 secondes entre les appels. La réponse peut mettre à jour les derniers heartbeats dans le controller de simulation.
SimulationBaseController.IsUserOnline() et ActivityBaseController.IsUserOnline() considèrent un utilisateur online si le dernier heartbeat date de moins de 5 × 12 = 60 secondes. ProfileImageControl consomme cet état pour l'affichage. Le heartbeat a donc encore un consommateur Unity.
Présence évaluée By Year
BackEndBrainCloud.SetPresence() appelle _command/set_presence. Le script traite seulement les utilisateurs avec isTeacher == 0, charge leur simulation et l'activité courante, puis enregistre la présence uniquement si currentYearState == 1.
setYearPresence() écrit true dans evaluation.presence[actUid][yearId] si l'entrée n'existe pas déjà, sauvegarde le document et envoie user_new_presence_eval à l'étudiant et au professeur.
getPresenceScore() compte les années enregistrées entre 0 et yearId, puis divise le cumul de 100 points par le nombre d'années. StudentState et ActivityByYearController appellent encore SetPresence() dans leurs transitions.
startYear() envoie le stub de score à chaque étudiant; il ne marque pas tous les étudiants présents. L'enregistrement effectif relève de set_presence.
Réouverture : point à contrôlerannuelle
utils_reopen_year.js appelle deleteYearPresence(student, actData.currentYear + 1, actData). Dansaprès laajustement versionde localel’année inspectée,courante. Ce flux appartient au cycle des évaluations By Year.
Usages conservés dans le helper utilise actUid sans le définir localement à partir de actData.uid. La suppression dépend donc d'une résolution externe de cette variable; ce parcours ne peut pas être présenté comme validé sans vérifier son contexte d'exécution.
Faut-il retirer la présence Game ?
Le code inspecté ne permet pas de la retirer comme un simple doublon : le heartbeat alimente l'UI Unity, et la présence By Year alimente les évaluations BrainCloud. Pour les remplacer par laLa présence Web,du ilcompte faudraitWeb migrerdécrit explicitementle compte connecté et son jeu actif; ces deux mécanismes Game conservent leurs consommateurs et la persistance des scores.propres.
Sources vérifiées
Game : Assets/Src/Game/Notifications/NotificationManager.cs, Game/BackEnd/BackEndBase.cs, BackEndBrainCloud.cs, Game/User.cs, Game/GameStates/StudentState.cs, LoadUserState.cs, les controllers de simulation/activité et UI/ProfileImageControl.cs. BrainCloud : _command/set_presence.js, _utils/utils_by_year.js, utils_eval.js et _utils/command/utils_reopen_year.js.
Web : uniksim-back-end/src/app.controller.ts, service/game-notification.service.ts, notification.service.ts; frontend : service/account/account-socket.service.ts et Pages/PageWebgl/PageWebgl.component.ts.
Vérification par lecture du code localGame et BrainCloud de la branche master/gamerefactor_notificationsmaster/node.js et du code Web de la branche uniksimwebmessagerie_fixes