Utilisateurs et identifiants d'utilisateur spécifiques

*Ce contenu est traduit en utilisant l'IA (Beta) et peut contenir des erreurs. Pour consulter cette page en anglais, clique ici.

Roblox expose un identifiant d'utilisateur efficace pour chaque utilisateur dans chaque jeu, groupe ou application. En fonction de l'historique de l'utilisateur avec ce domaine, son identifiant d'utilisateur efficace est soit son identifiant d'utilisateur global, soit un identifiant d'utilisateur spécifique. Cette page explique comment fonctionnent les identifiants d'utilisateur efficaces et comment utiliser le type User dans le code de votre jeu.

Les concepts suivants sont centraux à l'identification des utilisateurs :

ConceptDescription
UtilisateurUn compte persistant sur Roblox.
JoueurLa représentation d'un utilisateur dans le modèle de données d'un jeu en cours d'exécution (voir Joueurs).
Type de données UserUn type de données qui porte l'identifiant d'utilisateur efficace d'un utilisateur et son contexte de domaine. C'est l'identifiant standard pour référencer les utilisateurs dans le code du jeu.
Identifiant d'utilisateur globalL'identifiant d'utilisateur au niveau de la plateforme que Roblox attribue à chaque compte. Il est globalement unique à travers Roblox.
Identifiant d'utilisateur spécifiqueUn identifiant d'utilisateur attribué dans un domaine spécifique. Les identifiants d'utilisateur spécifiques d'un utilisateur sont différents dans chaque jeu, groupe ou application.
Identifiant d'utilisateur efficaceL'unique identifiant d'utilisateur que Roblox expose pour un utilisateur dans un domaine.
Utilisateur avant déploiementUn utilisateur qui a d'abord interagi avec un domaine avant le déploiement des identifiants d'utilisateur spécifiques. Dans ce domaine, son identifiant d'utilisateur efficace reste son identifiant d'utilisateur global.
Utilisateur après déploiementUn utilisateur qui a d'abord interagi avec un domaine après le déploiement des identifiants d'utilisateur spécifiques. Dans ce domaine, son identifiant d'utilisateur efficace est un identifiant d'utilisateur spécifique.

Identifiants d'utilisateur efficaces et domaines

Chaque utilisateur a un identifiant d'utilisateur efficace dans un jeu, groupe ou application spécifique. Roblox n'expose pas d'identifiants d'utilisateur globaux et spécifiques séparés pour le même utilisateur dans ce domaine :

  • Un utilisateur avant déploiement a son identifiant d'utilisateur global comme son identifiant d'utilisateur efficace.
  • Un utilisateur après déploiement a un identifiant d'utilisateur spécifique comme son identifiant d'utilisateur efficace. Cet identifiant n'a de signification que dans ce domaine.

Dans le code du jeu, Player.UserId et Player.User.Id renvoient tous deux cet identifiant d'utilisateur efficace et ont toujours la même valeur numérique (Player.User.Id est égal à Player.UserId), donc votre code n'a pas besoin de logique de branchement pour choisir entre eux.

Roblox scope l'identité des utilisateurs à travers trois types de domaines :

DomaineSpécifique àExemple
Expérience (Enum.DomainType.EXPERIENCE)Une expérience spécifiqueL'identifiant d'un joueur dans votre expérience
GroupeUn groupe Roblox spécifique (communauté)L'identifiant d'un membre dans votre groupe
Application OAuth (Enum.DomainType.OAUTH)Une application OAuth spécifiqueL'identifiant d'un utilisateur dans votre outil externe

Comment fonctionnent les identifiants d'utilisateur efficaces

Lorsqu'un joueur rejoint votre jeu, il a un identifiant d'utilisateur efficace pour ce jeu. L'identifiant d'utilisateur efficace d'un utilisateur après déploiement est un identifiant d'utilisateur spécifique unique à ce jeu. Il reçoit un identifiant d'utilisateur spécifique différent dans tout autre jeu, groupe ou application où il est également un utilisateur après déploiement. Cela signifie :

  • Les identifiants d'utilisateur efficaces sont des entiers, qu'ils soient globaux ou spécifiques.
  • Les identifiants d'utilisateur efficaces sont stables à travers les sessions dans le même domaine.
  • Un identifiant d'utilisateur spécifique ne rentre pas en collision avec un identifiant d'utilisateur global existant.
  • La même valeur numérique peut apparaître dans différents domaines pour différents utilisateurs. La clé unique est la combinaison du domaine (type de domaine et ID de domaine) et de l'identifiant d'utilisateur efficace.

Scénario d'exemple

L'exemple suivant démontre comment différents jeux référencent le même utilisateur :

ScénarioContexte utilisateurIdentifiant d'utilisateur efficace vu par le jeu
L'utilisateur se connecte à Jeu AUtilisateur avant déploiement123 (identifiant d'utilisateur global, inchangé)
L'utilisateur se connecte à Jeu BUtilisateur après déploiement500789 (identifiant d'utilisateur spécifique pour Jeu B)
L'utilisateur se connecte à Jeu CUtilisateur après déploiement302441 (identifiant d'utilisateur spécifique pour Jeu C)

Utilisateurs avant déploiement

Si un joueur est un utilisateur avant déploiement dans votre jeu, son identifiant d'utilisateur efficace reste son identifiant d'utilisateur global dans ce jeu. Tant Player.UserId que Player.User.Id renvoient cet identifiant d'utilisateur global. Roblox n'expose pas un second identifiant d'utilisateur pour le joueur dans ce jeu. Cela garantit que les clés de magasin de données existantes, les classements et les inventaires continuent de fonctionner sans aucun changement.

Domaine de groupe

Chaque groupe Roblox est son propre domaine. Un utilisateur a un identifiant d'utilisateur efficace au sein d'un groupe, distinct de son identifiant d'utilisateur efficace dans tout jeu ou application OAuth :

Travailler avec le type Utilisateur

User est la manière standard d'identifier les utilisateurs dans le code du jeu. Une valeur User porte l'identifiant d'utilisateur efficace ainsi que le type de domaine et l'ID de domaine, de sorte que le contexte d'identité voyage toujours avec l'identifiant. Pour des détails complets sur l'API, voir la référence User.

Obtenir un Utilisateur à partir d'un Joueur

La principale façon d'obtenir un User est à partir d'un Player connecté via Player.User :

local Players = game:GetService("Players")
Players.PlayerAdded:Connect(function(player)
local user = player.User
print("Identifiant d'utilisateur efficace :", user.Id) -- Correspond toujours à player.UserId
print("Type de domaine :", user.DomainType)
print("ID de domaine :", user.DomainId)
end)

Construire un Utilisateur à partir d'un ID

Pour créer un User à partir d'un identifiant d'utilisateur efficace connu dans le jeu actuel, utilisez User.fromId() :

local user = User.fromId(knownUserId)

Utiliser l'Utilisateur avec les API du moteur

Les API du moteur qui acceptent un paramètre d'identifiant d'utilisateur acceptent également directement les valeurs User. L'utilisation de User est recommandée :

-- Les deux formes fonctionnent :
BadgeService:AwardBadge(player.User, badgeId) -- Recommandé
BadgeService:AwardBadge(player.UserId, badgeId)
-- Les deux formes fonctionnent :
local target = Players:GetPlayerByUserId(player.User) -- Recommandé
local target = Players:GetPlayerByUserId(someUserId)

Lorsqu'un identifiant d'utilisateur numérique est passé à une API du moteur qui accepte des identifiants d'utilisateur, il est automatiquement enveloppé dans un User en interne.

APIs du moteur qui retournent des identifiants d'utilisateur

Les APIs du moteur qui retournent des identifiants d'utilisateur numériques retournent l'identifiant d'utilisateur efficace de l'utilisateur :

  • Utilisateurs avant déploiement — l'API retourne l'identifiant d'utilisateur global de l'utilisateur.
  • Utilisateurs après déploiement — l'API retourne l'identifiant d'utilisateur spécifique de l'utilisateur.

Player.UserId, Player.User.Id, et d'autres APIs du moteur retournent tous ce même identifiant d'utilisateur efficace pour un utilisateur dans votre jeu, donc le code existant qui lit les champs d'identifiant d'utilisateur numériques continue de fonctionner sans logique de branchement.

Les requêtes et réponses Open Cloud utilisent le même identifiant d'utilisateur efficace pour le domaine cible. Elles n'exposent pas un second identifiant d'utilisateur pour le même utilisateur dans ce domaine.

Stocker l'identité de l'utilisateur

Utilisez un identifiant d'utilisateur efficace numérique uniquement pour identifier un utilisateur dans un seul domaine. Une clé de magasin de données dans un jeu peut utiliser user.Id directement :

local key = ("player_%d"):format(player.User.Id)
PlayerDataStore:SetAsync(key, data)

Lorsque un autre domaine lit l'identité stockée, comme une application OAuth qui modère les utilisateurs, stockez la chaîne provenant de ToString(). La chaîne encode le contexte de domaine avec l'identifiant d'utilisateur efficace. Utiliser uniquement l'entier peut appliquer une action au mauvais utilisateur lorsque le même nombre identifie un utilisateur différent dans un autre domaine.

local encoded = player.User:ToString()
SomeDataStore:SetAsync("support_ticket_user", encoded)
-- Plus tard, restaurer à partir de la chaîne
local user = User.fromString(encoded)

Pour plus de détails sur les garanties de sérialisation, voir la référence User.

Meilleures pratiques

  • Utilisez Player.User comme identifiant standard dans le nouveau code.
  • Utilisez l'identifiant d'utilisateur efficace numérique uniquement dans un seul domaine, comme les clés de magasin de données pour un jeu.
  • Utilisez ToString() et fromString() lorsque un autre domaine lit l'identité stockée.

Quand utiliser Utilisateur ou Joueur

  • Utilisez Player pour les actions en serveur : mouvement de personnage, GUI, téléportation, chat, inventaire.
  • Utilisez User pour l'identité qui survit à une session : magasins de données, outils Open Cloud, références entre jeux.
©2026 Société Roblox. Roblox, le logo Roblox et Powering Imagination font partie de nos marques déposées aux États-Unis et dans d'autres pays.