UserService

此功能允许您批量请求当前 DataModel 外的用户。输入和输出值都是阵列。

• 在返回值的阵列中，用户信息对象的顺序可能与 UserIds 发送在输入参数的数组中发送的顺序不匹配。使用用户信息对象的 Id 字段来确定用户信息对象在输入参数的阵列中与输出参数组的顺序。
• 如果要求中的一个或多个 UserIds 无效，例如为负数或用户ID 无关的用户ID，或为用户ID 无关的用户ID，或为用户ID 无关的用户ID，或为用户ID 无关的用户ID，或为用户ID 无关的用户ID，或为用户ID 无关的用户ID，或为用户ID 无关的用户ID，或为用户ID 无关的用户ID，
• 如果Roblox用户没有与其帐户关联的DisplayName，此功能将返回用户在其信息对象的DisplayName字段上的用户名和密码。虽然用户的 Class.Player.UserId|UserIds
• 因为 GetUserInfosByUserIdsAsync() 使用了外部 web 请求，它会产生并可能会导致后端服务中断。请确保您可以适当地处理停止工作时间，包装此方法使用 pcall() 。
• 结果受到 250 每分钟限制，因此如果您收到 HTTP 429 错误，请稍后重试，通常在减少输入阵数组中的 UserIds 数量后，减少方法调用或两者。

单个用户信息对象的签名是：

<tbody>
  <tr>
    <td><code>id</code></td>
    <td>数</td>
    <td>Class.Player.UserId|userId 与用户关联。</td>
  </tr>

  <tr>
    <td><code>用户名</code></td>
    <td>字符串</td>
    <td>与用户相关的用户名。</td>
  </tr>

  <tr>
    <td><code>显示名称</code></td>
    <td>字符串</td>
    <td>与用户关联的 <code>Class.Player.DisplayName|DisplayName</code>。</td>
  </tr>

  <tr>
    <td><code>已验证徽章</code></td>
    <td>boolean</td>
    <td>与用户相关的 <code>Class.Player.HasVerifiedBadge|HasVerifiedBadge</code> 值。</td>
  </tr>
</tbody>

参数

返回

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