UserService
Mostrar obsoleto
*Este conteúdo é traduzido por IA (Beta) e pode conter erros. Para ver a página em inglês, clique aqui.
Um serviço que lida com consultas relativas a usuários na plataforma Roblox.
Resumo
Métodos
Retorna um array de informações do usuário, incluindo o nome do usuário e o nome de exibição.
Propriedades
Métodos
GetUserInfosByUserIdsAsync
Essa função permite que você solicite informações sobre usuários fora do atual DataModel em grande quantidade. Os valores de entrada e saída são ambos arrays.
- A ordem dos objetos de informação do usuário no array do valor de retorno pode não corresponder à ordem do UserIds enviado no matriz / listado parâmetro de entrada.Use o campo Id do objeto de informações do usuário para identificar seu array de entrada com o matriz / listade saída.
- É possível receber menos objetos de informação de usuário do que solicitado se um ou mais dos UserIds na matriz de solicitações forem inválidos, como números negativos ou IDs de usuário que não têm contas associadas a eles.É possível receber uma resposta com zero resultados se todos os UserIds forem inválidos.
- Se um usuário do Roblox não tiver um DisplayName associado à sua conta, esta função retornará, em vez disso, a mesma string que o nome de usuário do usuário no campo DisplayName do Objetode informação dele.Enquanto o UserId de um usuário nunca mudará, eles podem mudar seu nome de usuário ou nome de exibição, então o mesmo input UserIds pode retornar uma string diferente para esses campos de um dia para o outro.
- Como GetUserInfosByUserIdsAsync() faz um solicitar / pedirde web externo, ele produzirá e pode falhar se o serviço de backend estiver experimentando interrupções.Certifique-se de poder lidar com interrupções de forma adequada, envolvendo este método com um pcall() .
- Os resultados são limitados a 250 por minuto, então, se você receber um erro HTTP 429, tente novamente mais tarde, idealmente depois de reduzir o número de UserIds em seu matriz / listade entrada, reduzindo o número de chamadas de método ou ambos.
A assinatura de um objeto de informação de usuário singular é:
<th>Tipo</th><th>Descrição</th></tr></thead><tbody><tr><td><code>Id</code></td><td>número</td><td>A classe <code>Class.Player.UserId|UserId</code> associada ao usuário.</td></tr><tr><td><code>Nome de usuário</code></td><td>string / cadeia / texto</td><td>O nome de usuário associado ao usuário.</td></tr><tr><td><code>Nome de Exibição</code></td><td>string / cadeia / texto</td><td>A classe <code>Class.Player.DisplayName|DisplayName</code> associada ao usuário.</td></tr><tr><td><code>Badge Verificado HasVerified</code></td><td>booleano</td><td>O valor <code>Class.Player.HasVerifiedBadge|HasVerifiedBadge</code> associado ao usuário.</td></tr></tbody>
Chave |
---|
Parâmetros
Devolução
Um conjunto de objetos dicionários que contêm informações do usuário.
Amostras 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