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.
Un service qui gère les requêtes liées aux utilisateurs sur la plateformeRoblox.
Résumé
Méthodes
Renvoie un tableau d'informations de l'utilisateur, y compris le nom de l'utilisateur et le nom d'affichage.
Propriétés
Méthodes
GetUserInfosByUserIdsAsync
Cette fonction vous permet de demander des informations sur les utilisateurs en dehors du DataModel actuel en masse. Les valeurs d'entrée et de sortie sont tous des tableaux.
- L'ordre des objets d'information de l'utilisateur dans le tableau de valeur de retour peut ne pas correspondre à l'ordre des UserIds envoyés dans le matricede paramètres d'entrée. Utilisez le champ Id de l'objet d'information de l'utilisateur pour identifier votre tableau d'entrée avec le matricede sortie.
- Il est possible de recevoir moins d'objets d'information sur l'utilisateur que demandé si l'un ou plusieurs des UserIds dans le tableau de demande sont invalides, tels que des numéros négatifs ou des ID d'utilisateur qui n'ont pas d' comptes associés avec eux. Il est possible de recevoir une réponse avec zéro résultats si tous les UserIds sont invalides.
- Si un utilisateur Roblox n'a pas de DisplayName associé à son compte, cette fonction renverra plutôt la même chaîne que le Nom d'affichaged'utilisateur de l'utilisateur dans le champ DisplayName de son objet d'information. Bien que le
- Puisque GetUserInfosByUserIdsAsync() fait une demande web externe, il générera et peut échouer si le service de backend est en cours d'interruption. Assurez-vous que vous pouvez gérer le temps d'arrêt appropriément en enroulant cette méthode avec un pcall() .
- Les résultats sont limités à 250 par minute, donc si vous recevez une erreur HTTP 429, essayez à nouveau plus tard, idéalement après avoir réduit le nombre de UserIds dans votre matriced'entrée, réduisant le nombre de méthodes ou les deux.
La signature d'un objet d'information d'un utilisateur unique est :
<tbody><tr><td><code>Id)</code></td><td>number</td><td>Le <code>Class.Player.UserId|userId</code> associé à l'utilisateur.</td></tr><tr><td><code>Nom d'utilisateur</code></td><td>chaîne</td><td>Nom d'utilisateur associé à l'utilisateur.</td></tr><tr><td><code>Nom d'affichage</code></td><td>chaîne</td><td>Le <code>Class.Player.DisplayName|DisplayName</code> associé à l'utilisateur.</td></tr><tr><td><code>Badge vérifié</code></td><td>boîtier</td><td>La valeur <code>Class.Player.HasVerifiedBadge|HasVerifiedBadge</code> associée à l'utilisateur.</td></tr></tbody>
Clé | Type | Description |
---|
Paramètres
Retours
Un tableau d'objets de dictionnaire qui contient 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