UserService

Afficher les obsolètes

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

Création impossible
Service

Un service qui gère les requêtes relatives aux utilisateurs sur la plateformeRoblox.

Propriétés

Méthodes

GetUserInfosByUserIdsAsync

Rendement

Cette fonction vous permet de demander des informations sur les utilisateurs en dehors de l'actuel DataModel en vrac. Les valeurs d'entrée et de sortie sont toutes deux des tableaux.

  • L'ordre des objets d'information de l'utilisateur dans l'array de la valeur de retour peut ne pas correspondre à l'ordre des UserIds envoyés dans l'array du paramètre d'entrée.Utilisez le champ Id de l'objet d'information de l'utilisateur pour identifier votre matrice d'entrée avec la matrice de sortie.
  • Il est possible de recevoir moins d'objets d'information utilisateur que demandé si l'un ou plusieurs des UserIds dans l'array de la demande sont invalides, tels que des nombres négatifs ou des identifiants d'utilisateur qui n'ont pas d' comptes associés à eux.Il est possible de recevoir une réponse avec zéro résultat si tous les UserIds sont invalides.
  • Si un utilisateur de Roblox n'a pas de DisplayName associé à son compte, cette fonction retournera plutôt la même chaîne que le nom d'utilisateur de l'utilisateur dans le champ DisplayName de son objet d'information.Bien que l'adresse e-mail d'un utilisateur ne change jamais, il peut changer son nom d'utilisateur ou son nom d'affichage, de sorte que la même entrée peut retourner une chaîne différente pour ces champs d'un jour à l'autre.
  • Puisque GetUserInfosByUserIdsAsync() fait une demande web externe, elle générera et échouera peut-être si le service arrière-plan connaît des interruptions.Assurez-vous de pouvoir gérer correctement les temps d'arrêt en enveloppant cette méthode avec un pcall() .
  • Les résultats sont limités à 250 par minute, donc si vous recevez une erreur HTTP 429, réessayez plus tard, idéalement après avoir réduit le nombre de UserIds dans votre matrice d'entrée, réduit le nombre d'appels de méthode, ou les deux.

La signature d'un objet d'information utilisateur singulier est :


<th>Type</th>
<th>Avertissement</th>
</tr>
</thead>
<tbody>
<tr>
<td><code>Id</code></td>
<td>numéro</td>
<td>La classe <code>Class.Player.UserId|UserId</code> associée à l'utilisateur.</td>
</tr>
<tr>
<td><code>Nom d'utilisateur</code></td>
<td>chaîne</td>
<td>Le nom d'utilisateur associé à l'utilisateur.</td>
</tr>
<tr>
<td><code>Nom à afficher</code></td>
<td>chaîne</td>
<td>La classe <code>Class.Player.DisplayName|DisplayName</code> associée à l'utilisateur.</td>
</tr>
<tr>
<td><code>Badge vérifié</code></td>
<td>booléen</td>
<td>La valeur <code>Class.Player.HasVerifiedBadge|HasVerifiedBadge</code> associée à l'utilisateur.</td>
</tr>
</tbody>
Clé

Paramètres

userIds: Array

Un ensemble de UserIds demandé.

Valeur par défaut : ""

Retours

Un ensemble d'objets de dictionnaire qui contiennent des informations sur l'utilisateur.

Échantillons de code

UserService:GetUserInfosByUserIdsAsync Example

local UserService = game:GetService("UserService")
local success, result = pcall(function()
return UserService:GetUserInfosByUserIdsAsync({ 156, 1, 735878936 })
end)
if success then
for _, userInfo in ipairs(result) do
print("Id:", userInfo.Id)
print("Username:", userInfo.Username)
print("DisplayName:", userInfo.DisplayName)
end
else
-- An error occurred
end

Évènements