UserService
Mostrar obsoleto
*Este contenido se traduce usando la IA (Beta) y puede contener errores. Para ver esta página en inglés, haz clic en aquí.
Un servicio que maneja consultas relacionadas con usuarios en la plataforma Roblox.
Resumen
Métodos
Devuelve un array de información de usuario, incluido el nombre de usuario y el nombre de visualización.
Propiedades
Métodos
GetUserInfosByUserIdsAsync
Esta función te permite solicitar información sobre usuarios fuera del actual DataModel en masa. Los valores de entrada y salida son ambos arrays.
- El orden de los objetos de información del usuario en el array de valor de devolución puede no coincidir con el orden de los UserIds enviados en el matriz/listadel parámetro de entrada.Usa el campo Id del objeto de información del usuario para identificar tu matriz de entrada con la matriz/listade salida.
- Es posible recibir menos objetos de información de usuario solicitados que los solicitados si uno o más de los UserIds en el array de solicitudes son no válido, como números negativos o ID de usuario que no tienen cuentas asociadas con ellos.Es posible recibir una respuesta con cero resultados si todos UserIds son no válido.
- Si un usuario de Roblox no tiene un DisplayName asociado con su cuenta, esta función devolverá en cambio la misma cadena que el nombre de usuario del usuario en el campo DisplayName de su objeto de información.Si bien el UserId de un usuario nunca cambiará, pueden cambiar su nombre de usuario o nombre de visualización, por lo que la misma entrada UserIds puede devolver una cadena diferente para estos campos de un día para otro.
- Dado que GetUserInfosByUserIdsAsync() hace una solicitud web externa, producirá y puede fallar si el servicio de backend está experimentando interrupciones.Asegúrese de que pueda manejar adecuadamente el tiempo de inactividad envolviendo este método con un pcall() .
- Los resultados están limitados a 250 por minuto, por lo que si recibe un error HTTP 429, intente de nuevo más tarde, idealmente después de reducir el número de UserIds en su matriz/listade entrada, reducir el número de llamadas de métodos o ambos.
La firma de un objeto de información de usuario singular es:
<th>Tipo</th><th>Descripción</th></tr></thead><tbody><tr><td><code>Id</code></td><td>número</td><td>La clase <code>Class.Player.UserId|UserId</code> asociada con el usuario.</td></tr><tr><td><code>Nombre de usuario</code></td><td>cadena</td><td>El nombre de usuario asociado al usuario.</td></tr><tr><td><code>Nombre de visualización</code></td><td>cadena</td><td>El <code>Class.Player.DisplayName|DisplayName</code> asociado con el usuario.</td></tr><tr><td><code>Insignia Verificada</code></td><td>booleno</td><td>El valor <code>Class.Player.HasVerifiedBadge|HasVerifiedBadge</code> asociado con el usuario.</td></tr></tbody>
Clave |
---|
Parámetros
Devuelve
Un array de objetos de diccionario que contienen información de usuario.
Muestras de código
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